==Quick installation instrutions====================
Last updated for Lexstats 2.0 by jorn@nl.linux.org

>>Introduction

This document will guide you through the Lexstats installation process.

[ Power users, this package uses autoconf. So when you are root installation
 is basically ./configure && make && make install ]

>>System requirements

1) A supported platform
2) A C compiler (preferebly gcc)
3) Make (GNU make tested)
4) Tcl/Tk >= 8.0 for the GUI

>>Platforms lexstats will *probably* compile under:

Linux (tested and supported)
UNIX
Irix
VMS
Windows (using Cygwin)

>>Installation instructions

1. Configure makefiles for your system.

   First of all, it is recommended to set the C compiler flags for
   optimal code generation. For example, when running GNU/Linux on
   an AMD K6 CPU, with pgcc 2.95.2 I would use:
   
    CFLAGS="-O3 -fomit-frame-pointer -march=k6 -mcpu=k6"

   If you have a CPU with MMX (eg Pentium MMX, Pentium II, AMD K6), you
   could use -mmx, but that's not guaranteed to produce correct code.

   If you have gcc 2.95.2 or older, without the Pentium GCC patch, use:

    CFLAGS="-O3 -fomit-frame-pointer -m486"

   And, if you REALLY need speed, you can use (but it might produce incorrect
   code):

    -ffast-math -funroll-loops

   If you have pgcc or a recent gcc, you can fill in the following targets
   instead of k6:
   
    For i686 machines: i686
    For PentiumPro machines: pentiumpro
    For Pentium machines: pentium
    For i486 machines: i486
    For AMD K6 machines: k6
    For AMD Athlon machines: athlon

   If you don't have pgcc or a recent gcc, you can use -m486 instead of the
   -march and -mcpu flags.

   If you don't have gcc, don't set the C compiler flags.
   
   When you have figured out your C compiler flags, you can configure 
   the Makefiles as follows:
   
    CFLAGS = "fill in your cflags" ./configure --prefix=your_prefix

   your_prefix sets the installation root directory. For example,
   when prefix is set to /home/joe/lexstats, you'll get this structure:

    home
      joe
        lexstats
	  bin
	    ad2Carr
	    ad2Sgam
	    ad2Sich
	    ad2YuSi
	    ad2Zipf
	    adjSich
	    adjZipf
	    binomint
	    labhub
	    lexstats
	    lnreCarr
	    lnreChi2
	    lnreSgam
	    lnreSich
	    lnreYuSi
	    lnreZipf
	    mcdisp
	    mcprofil
	    spectfit
	    spectrum
	    wfl2spc
	  share
	    lexstats
	      tclcode
	        lexstats.tcl
	      data
	        alice.spc
		alice27a.txt
		bnc.spc
		cv.spc
		estonian.spc
		filarial.spc
		havelaar.spc
		heid.spc
		hound.spc
		in.spc
		in1.spc
		in8.spc
		iteit.spc
		nesscg.spc
		nessd.spc
		nessw.spc
		noun.spc
		pairs.spc
		plur.spc
		sing.spc
		ster.spc
		through.spc
		turkish.spc
		war.spc
	      lexstatsrc

   [ The default is /usr/local ]

2. Building the Lexstats suite

   Type 'make'.

3. Installing the Lexstats suite

   Type 'make install'. This will install the Lexstats suite as described
   in section one.

4. Using the suite

   First of all, copy the file 'lexstatsrc' in 
   YOUR_INSTALLATION_PREFIX/share/lexstats to .lexstatsrc in your home 
   directory.

   For first time users, it is recommended to type 
   
    YOUR_INSTALLATION_PREFIX/bin/lexstats
    
   This will start the Lexstats GUI.

>>Troubleshooting

When I start lexstats, it bombs out by saying:

 wish: command not found

You haven't installed Tcl and/or Tk or the Tk interpreter 'wish' is not
in your path.

Solutions:
1) Make sure Tcl AND Tk are installed
2) Make sure wish is in your PATH variable
3) Hardcode the wish path into YOUR_INSTALLATION_PREFIX/bin/lexstats,
   by substituting wish by the full path of wish.

