		GNU Typist 2.4 Installation instructions

This program can be compiled under Unix and under Windows/DOS.

Compilation under Unix 
----------------------

In order to compile this program, you must have:
- The 'ncurses' or the 'curses' library

* Uncompress the sources distribution:
	tar xvfz gtypist-2.4.tar.gz

* Change to the sources directory
	cd gtypist-2.4

* Configure the package. By default the program will be installed at
/usr/local/bin and the lessons and international support in
/usr/local/share/gtypist (you can change with the option --prefix). By 
default it will install Native Language Support (you can disable this
with the option --disable-nls)
	./configure 

* Compile
	make

* Become root and install
	su
	umask 022
	make install

* To test your installation type
	gtypist
  or
	/usr/local/bin/gtypist


Compilation under Windows/DOS
-----------------------------

You must have:

- DJGPP compiler. Available at
    http://www.delorie.com/djgpp/zip-picker.html
  You only will need the C compiler.

- Emulation of the curses library pdcurses v2.4. Available at
    ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2tk/pdcur24b.zip

* Decompress the sources distribution 
* Open a DOS session, change to the sources directory
	cd gtypist-2.4

* Configure the package
	configur

* Compile
	make

* To install it, you should create a directory (e.g. c:\GTypist) and
  copy into it the lessons of directory 'lessons' \ and the program
  gtypist.exe:

	mkdir c:\GTypist
	copy gtypist.exe c:\GTypist
	copy lessons\*.typ c:\GTypist

* If you distribute it, then you might want to remove symbols from gtypist.exe:
	
	strip --strip-all gtypist.exe

* If you want to use lessons which contain 8bit characters, then you need
  to convert these lessons with a program like "recode" (on GNU/Linux):
	for i in *.typ
	do
		recode latin1..ibmpc $i
	done
  Furthermore, I've had trouble with infozip: zip 2.0.1 does not work,
  but 2.3 (or above) seem to work
	
* To use it go to the directory where you installed it and run gtypist.exe
	cd GTypist
	gtypist

Problems and their solution
---------------------------

Configuration with Native Language Support under Unix:

	* If you configured first without NLS and now you want NLS, go
	  to directory intl remove libintl.h and configure again.
	* If your Unix doesn't have Native Language Support, the sources
	  of gtypist come with a limited version, to use it configure with:
		./configure --with-included-gettext
	  And before running gtypist set the environment variable LC_ALL/LANG
	  to your language and country codes (LL_CC, as described in the
	  manual, node "Environment Variables"). See the manual for the
          list of supported languages. Using this option it was possible
          to compile and run gtypist under AIX.

Dvorak Keyboard under GNU/Linux (Ben Armstrong <synrg@sanctuary.nslug.ns.ca>)

	To get Dvorak keymaps, run the 'loadkeys' command on the appropriate keymap
        file. For example if your keymaps are at /usr/share/keymaps

	loadkeys /usr/share/keymaps/i386/dvorak/dvorak.kmap.gz

        To switch to your default keyboard mappings, run loadkeys on
        the default keymap file:

	loadkeys /etc/console-tools/default.map.gz

        If you are in X, please visit the Dvorak home page at
        http://www.mwbrooks.com/dvorak/ for more information.

Keyboard under DOS/Windows:

	* You could experience some problems with the keyboard under
          DOS/Windows, instead of the [Return] key you should use
          [Control]+[J]. And instead of the F1, F2 .. F11, F12 keys
          use the keys 1,2 .. 10, A, S respectively.

Compilation under DOS without Long File Name support or in Windows NT

	* It is possible. You only need to rename the library
    	  libpdcurses.a in the lib directory of the DJGPP distribution
  	  to something with less than 8 characters for example
	  libpdc.a. Then modify the makefile of gtypist (don't use
	  edit since it doesn't preserve TABs) and change pdcurses
          with pdc. Finally compile and use it!

