pscol README
------------

INTRODUCTION
************

Since the release of procps v1.09, ps and top could be colorized.  The
format they used (a single environment variable with nothing but numbers
and symbols and very hard to understand)  pscol makes this variable with
a color file.  It takes human readable text and converts it to the variable
that ps and top can understand

This program should compile on any linux system.  You need procps 1.09 or
higher to make use of colorization

INSTALLATION
************

* make
* make install

If you currently use procps v1.09+ and you currently have PS_COLORS and
TOP_COLORS set, do 'make config' before you do 'make install'.  This will
create a pscolor file and it will be installed as /etc/pscolor.

CONFIGURATION
*************

There are no configuration options in the Makefile.  But in config.h 3 defines
are set.  They are as follows:

ETC_FILE	This file is the location/name of the system wide color file
		Default: "/etc/pscolor"

PERSONAL_FILE	This file is the location/name of the per use color file
		do not use ~ .  the full name is taken as: $HOME/PERSONAL_FILE
		Default: ".pscolor"

NEW_FILE_HEADER	The header that is put at the beginning of files created by
		pscol
		Default: "#\n# this file was created with pscol\n#\n"

MISC
****

In the Makefile, I have a few items that can be changed.

CC		The C compiler
		Default: gcc

TAR		The tar program
		Default: tar

ROOT		The base directory to install to.  If not specified, use /
		Default: (none)

BINDIR		Where to install the binary to
		Default: $(ROOT)/usr/local/bin

MANDIR		Where to install the man pages to (base man directory)
		Default: $(ROOT)/usr/man

ETCDIR		Where to install the system wide files
		Default: $(ROOT)/etc

Other variables should not be touched, as it will interfere with the operation
of PSCOL