jose 1.4.1 Release Notes


==========================
jose - 1.4.0 Release Notes
==========================

jose-chess.sourceforge.net


==================
Files for Download
==================

* jose-140-windows.exe             Installer program for Windows; requires JRE 1.4 or later
* jose-140-windows-jre.exe         Installer program for Windows; includes JRE 1.5.0

* jose-140-linux.zip               zip archive for Linux with Intel processors; requires JRE 1.4 or later
* jose-140-linux-jre.zip           zip archive for Linux with Intel processors; includes JRE 1.5.0 
* jose-140-macosx.dmg          	   disk image for Mac OS X; requires JRE 1.4 or later

* jose-140-*-update.zip            Update packages for older versions
* jose-140-source.zip              Source Code


* jose-3d-windows.zip              3D package for Windows
* jose-3d-linux.zip                3D package for Linux
* jose-sounds.zip                  Move Announcements in various languages (optional)

* database-10k.jose                Database containing 10.000 grandmaster games
* database-500k.jose               Database containing more than 500.000 games
* database-1700k.jose              Database containing more than 1.7 million games

============
Requirements
============

* Operating Systems: 
   - Windows 98 or later
   - Linux on Intel Archtitecture processor
   - Mac OS X 10.3 or later

* Java Runtime Environment 1.4 or later
  (Sun JRE 1.5.0 recommended)

  Some installation packages (those with "-jre") 
  already contain the Runtime Environment. 
  It will be installed along with jose (without affecting 
  existing installations).
  
  Alternatively, you can download the JRE from:
    http://java.sun.com/j2se/1.5.0/download.jsp
  Linux users might also have a look at:
    http://www.blackdown.org
  
  If you don't know which version of Java is installed on your system,
  open a command prompt and type "java -version".
  
  Please note that jose will not run with Microsoft's JRE
  (but the installation program will).

  
====================
Windows Installation
====================

* Run the installer program "jose-140-windows.exe", resp. "jose-140-windows-jre.exe"
* follow the instructions...

* You can start jose by double-clicking "jose.exe"
  or you can start it from the command line with
     java -jar jose.jar

* DirectX 8, or later, is recommended for the 3D board display.

* jose includes a number of TrueType fonts for displaying chess figurines.
  If you like to use these fonts with other applications,
  copy them from jose\fonts to C:\Windows\Fonts


==================
Linux Installation
==================

* Unpack the zip file into a directory of your choice, e.g.
     unzip -D /usr/share/games jose-140-linux.zip

* Start jose with the script "jose.sh"
  or you can start it from the command line with
     java -jar jose.jar


=====================
Mac OS X Installation
=====================

* Double click the downloaded file: a new volumne "jose for Mac" will appear on your desktop
* Open the volume "jose for Mac", drag the icon to its final destination, e.g. the Applications folder
* (avoid starting jose from the mounted disk image)

* start jose by double clicking the jose icon
  or you can start it by double clicking jose.jar
  or you can start it from the command line with
     open jose.app
  or   
     java -jar jose.jar

* jose includes a number of TrueType fonts for displaying chess figurines.
  If you like to use these fonts with other applications, install them with
  the Font Utility.


===============
3D Installation
===============

* You need an existing jose installation
* unpack the downloaded zip file into your jose installation directory

* WINDOWS System Requirements:
    - Windows 2000 or Windows XP
    - DirectX 8, or OpenGL 1.1

* LINUX System Requirements:
  - Graphics adapter with driver that supports the GLX extension:
    GLX 1.3 or later and OpenGL 1.2 or later

* Mac OS X System Requirements:
	see http://www.apple.com/downloads/macosx/apple/java3dandjavaadvancedimagingupdate.html





====================   
Upgrade Instructions
====================

* You need an existing jose installation
* The upgrade package will update any version to the current release version
* Unzip the package into your existing installation directory. 
  When asked for overwriting files, click "Yes to All".    
  
* You can perform the update automatically by choosing "Online Update" from the Help menu.
  If the online update fails, you can simply unzip the downloaded file, as described above.

=====================================
Installing the Sample Games Databases
=====================================

* choose Open... from the File menu
* select a database archive file (*.jose)
* opening an archive file may take some time.
  However, the import need only be run once.
  After the archive has been copied into your personal
  database, it will be available immediately.


=========================  
Removing the Installation
=========================

* Windows: run the program jose/Uninstall.exe
  - jose will be removed from your system
  - the game database WILL NOT be removed automatically. 
    To remove the database, delete the directory jose/database.
  
* Mac OS X: drag the jose icon into the Trash.
  - if you want to keep a backup copy of the game database, 
    just copy the folder jose.app/database

=========================

Have fun,
Peter