next up previous contents
Next: For the Developer Up: For the User/Administrator Previous: Obtaining   Contents

Subsections


Installing

You'll need to install Phil before installing or developing software that uses Phil.

Step-by-Step Instructions

  1. Unpack the distribution.

    If the distribution came in a file with a name of the form phil-m.n.tar.gz, you can unpack it like this: zcat phil-m.n.tar.gz |tar xf -.

    If the distribution came in a file with a name of the form phil-m.n.cpio.bz2, you can unpack it like this: bzcat phil-m.n.cpio.bz2 |cpio -i.6.1

    Either way, you'll end up with a directory called phil-m.n in the current directory.

  2. cd phil

  3. ./configure

    Running ./configure with no options will setup Phil to install with default options. It's possible to override many of those options. For example, it's possible to change the directory into which Phil installs. To use those options, read the ``Options to ./configure'' section, below.

    You might notice a program called make-makefile. It's a wrapper around ./configure, & it's for Phil's developers to use. While running make-makefile as a user will probably work just fine, it's not guarranteed. Still, users who need to supply lots of options to ./configure because of their operating system or compiler system might fine some useful templates, hints, or starting points in make-makefile.

    Remember: make-makefile is intended for Phil's developers. Users should endeavour to ignore it.

  4. make

    This builds the Phil library, programs, & test programs.

  5. make check

    This runs the Phil test programs. In general, a test program prints nothing if it works. Let me restate that: If a test program succeeds, it doesn't print anything. If all the tests work, you'll see a list of the tests that ran; the list was printed by make. You won't see any other output. If a test fails, it will print a diagnostic message, & the make will fail.

    I do this (make test programs print nothing if they succeed) so that you can glance at the list of tests as make runs them & easily determine whether they succeeded. After all, that's what you care about. You don't want or need to read through a long, ugly, stream of output from a bunch of test programs to determine whether the tests succeeded. Success or failure should be binary, & should be easy to determine at a glance.

    There are some exceptions to this rule. Some tests will print warnings even if they succeed. I consider these bugs & intend to fix them. Seeing a ``warning'' message from a test program does not mean that all the tests failed, though it is ugly.

  6. make install

    This will install Phil. See a section below for a discussion of what gets installed where.

  7. homeof

    Sort of an interactive final test. It should print your home directory, just like echo   would.

    If you see a ``program not found'' or ``no such file or directory'' message, it's possible that the directory into which Phil was installed is not in your path.

Directories & Files

Suggested base directories for installing Phil are

/usr/local
the default

philhome
where philhome is the home directory of the Phil administrator; I recomment ``phil'' or ``philadmin'' as the user name

$HOME
where $HOME is your home directory.

Within the base directory, Phil will make use of

lib
to hold libphil.a

include/phil
to hold the header files that software which uses Phil will #include

bin/phil
to hold the handful of programs Phil creates, including homeof, printsizes, printhostbyname, & the others.

etc
to hold some support files for make


next up previous contents
Next: For the Developer Up: For the User/Administrator Previous: Obtaining   Contents
Gene Michael Stover 2002-02-14