How to install PRCS

1. Things you need

You need gcc version 2.7.0 or later.  It does not compile on version
2.6.x due to serious bugs in that version of g++.

(This may sound silly, but) You need libg++ 2.7.1 or later.  It will
compile with an older version, but will not link.

You need RCS version 5.7 installed.  If 'rcs -V' fails, then you don't
have the version 5.7.  PRCS is known to fail with previous versions of
RCS.  RCS must be properly configured!  If your version of RCS has been
configured to use the manufacturer's diff and diff3 programs, PRCS
and RCS will not be able to handle binary files.

You need the programs tar, gzip, and the GNU versions of diff and diff3.
These can be obtained in the GNU diffutils package, and are the same
that RCS needs to operate properly on binary files, so you might as
well insure that RCS is using them when configuring PRCS.

You need the flex or lex libraries.

2. Configuration and Compilation.

The configure argument --prefix lets you specify where PRCS is to be
installed.  The default installation prefix is /usr/local/lib.  If you
are using g++, you will need to tell `configure' where the libg++
libraries and include files are installed, using the environment
variable LIBGPLUSPLUS.  If it is not set, `configure' will assume that
g++'s default path is correct.  If the compiler's default path does
not include the lex or flex libraries, you should add it to the
LDFLAGS variable.  For example, if your shell is csh:

        setenv LIBGPLUSPLUS /usr/local/gcc-lib
	setenv LDFLAGS $HOME/lib
        setenv CC gcc
        setenv CXX g++
        ./configure --prefix=$HOME

or if your shell is a variant of sh:

        LIBGPLUSPLUS=$HOME/lib LDFLAGS=$HOME/lib CC=gcc CXX=g++ \
	  ./configure --prefix=$HOME

Once `configure' has finished, have a look at the file config.h, which
it produces.  The important variables in that file are named
SYS_*_COMMAND_PATH.  Make sure, as noted above, that diff and diff3
are correct.

Finally, run `make'.

3. Installation

To install the binary, run `make install'.

4. Running the First Time.

Read the documentation.  Set your environment varaible PRCS_REPOSITORY
to the location you would like PRCS to use.  This directory will be
created the first time you run PRCS, if it doesn't already exist.

Run `prcs config' to see that the compiled-in command-paths are
correct.

5. Where PRCS has been Built and Tested.

PRCS has been built on the following platform/compiler releases:

        FreeBSD 2.[12]             gcc-2.7.2
        SunOS 4.1.3                gcc-2.7.2
        HP-UX 9.0[57]              gcc-2.7.2
        Linux 1.2.13-a.out         gcc-2.7.2
        Linux 1.3.x-ELF            gcc-2.7.0
	IRIX 5.[23]                gcc-2.7.2
        Solaris 2.[45]             gcc-2.7.2
        Ultrix 4.4                 gcc-2.7.2
        Digital Unix (OSF/1) 3.2   gcc-2.7.2

HP-UX 10 Note: I have tried PRCS under HP-UX 10, and GNU libstdc++ was
totally broken.  So, I don't recommend it.  It will run the HP-UX 9
binary, so compile on an HP-UX 9 machine.  If you try it and find
different results, let me know.

Non-GNU Compilers Note: Several users complained at not having g++
installed, and wanted to know if PRCS would compile with another
vendor's C++ compiler.  The answer is, "Not until the other vendor's
compilers are close to being compliant with the ISO standard."  I
was able to compile PRCS with SunSoft's C++ version 4.2, getting it to
compile is not terribly difficult, though I have not merged those
changes.  The Sun C++ library is cfront based, and I'm not interested
in making this work.