
1. Distribution

pstext depends on two of my libraries: SIO and STR. These libraries are
included in the distribution as separate tar files.  The complete
pstext distribution consists of the following files:

	README.pstext			:		what pstext is about
	INSTALL.pstext			:		this file
	unpack-src				:		shell script to unpack distribution tar files
	compile-src				:		shell script to compile pstext and libraries
	pstext.VERSION.tar	:		program source
	sio.VERSION.tar		:		library source
	str.VERSION.tar		:		library source

The purpose of the scripts is to make installation easier.

----------------------------------------------------------------------

2. Compiling pstext

unpack-src will unpack the tar archives creating the following directory
structure:
   ./pstext
   ./libs
   ./libs/include
   ./libs/man
   ./libs/lib
   ./libs/src/{sio,str}

NOTE: If the archives are compressed, the script will uncompress them.

WARNING: unpack-src will delete the directories "./pstext" and "./libs" if
         they exist already (but it will ask your permission first).

compile-src compiles the libraries and then compiles pstext.  It knows
about some operating systems. When you invoke it, it will ask you if
your OS is among those it knows about. If so, all you need to do is
type the OS name.  If you have a different OS, compile-src will try to
automatically configure pstext appropriately.

The script will also ask you questions when it can't figure out
something.  For every question that it asks, there is a command line
option, so in case you need to run the script more than once, you can
use the command line option to avoid having to answer the question
multiple times.
"compile-src -help" will list all options understood by the script.

At this point, you can try to run the compile-src script. It will
most likely succeed in compiling pstext. You can read the rest
of this file later.

It is recommended that every time you make changes to pstext or to the
libraries it uses, you cd to the top level directory (the one
containing the directories "libs" and "pstext") and run the script
compile-src again. This script invokes "make" with arguments that
override variables defined in the Makefiles.

If at any time you want to start all over again, you can run the script
unpack-src again and then proceed with running compile-src. However, if
you have made any changes to the source, they will be lost since
unpack-src will delete the existing "pstext" and "libs" directories
and create new ones (it will prompt you before deleting anything).

----------------------------------------------------------------------

3. Installing pstext

When the compilation is over, the pstext executable will be in the
"pstext" directory. If you want to install it in one of the system
directories, cd to the "pstext" directory and type:

   make install BINDIR=<install program here>

To install the manpage type:
	
	make install.man MANDIR=<install man page here>

For example:

   make install BINDIR=/usr/local/bin 
	make install.man MANDIR=/usr/local/man/man1

