Index: trunk/psconfig/INSTALL
===================================================================
--- trunk/psconfig/INSTALL	(revision 10514)
+++ trunk/psconfig/INSTALL	(revision 11611)
@@ -1,61 +1,50 @@
 
-This is the top-level directory of the IPP software.  here are a few
-notes for installing IPP software in the correct order.  A few things
-to keep in mind:
+The psconfig system allows the user to build and install the IPP
+software suite into a location which is flexibly defined by the user.
+The tools here also set up the user's environment variables (PATH,
+PERL5LIB, LD_LIBRARY_PATH, etc) to make use of the installed
+software.  With the psconfig tools, it is easy to switch between
+different installed versions or to recompile subsets of the IPP tree.
 
-* three directories checked out here from CVS are mirrored from
-external sources.  DO NOT try to commit changes into those branches as
-your commits will be lost when the repository is updated.  The
-directories to watch out for are: Ohana, psLib, psModules
+NOTE: the psconfig.sh script uses the csh / tcsh shell. A bash version
+is not currently available.  
 
-* the current (Jan 2006) tested versions of software depend on
-specific tagged branches for certain components.  if you have checked
-this tree out of CVS, you will have to update those modules to their
-branch tags.  the following commands will bring you up to date with
-those versions:
+---
 
-cvs up -r eam_rel9_p0 psModules
-cvs up -r eam_rel9_b1 psLib
+Install Locations
 
-required sequence:
+To use the psconfig system, place the following line in your ~/.cshrc
+file:
 
- psLib
- psModules
- glueforge
- metadatadb
- ippTools/p2tools
+alias psconfig "source PATH/psconfig.sh"
 
- 
+where PATH is the path to the file psconfig.sh in this directory
+(ipp/psconfig/psconfig.sh).
 
---
+The psconfig system places the installed binary files by default in
+directories below ~/psconfig.  To use a different location, place the
+following line in ~/.psconfigrc (otherwise not needed):
 
-** required PERL modules:
+set PSCONFIG = INSTALL_PATH
 
-Carp
-Template
-Statistics::Descriptive
-Params::Validate
-Parse::RecDescent
-DateTime::Format::ISO8601
-Class::Accessor::Fast
+where INSTALL_PATH is the top-level directory for all binary
+installations. 
 
-perl -MCPAN -e 'install MODULE'
+Using psconfig to set / examine your install system:
 
-http://search.cpan.org/
+psconfig: set or show the current pslib configuration information
+USAGE: psconfig (version) : set configuration to specified version
+       psconfig --bin     : return the current path
+       psconfig --libs    : return the current library path
+       psconfig --list    : list currently availabe configuration versions
+       psconfig --help    : this listing
 
---
+---
 
-user-level installation of perl modules:
+Building
 
-* run cpan:
-cpan
-(answer questions to install in your home dir)
+To build the full IPP tree using the psconfig system, run 'psbuild' in
+this directory, and provide a release version.  (NOTE: if you are
+building from a checked-out tarball, the CVS tags are not used, and
+you will not be able to use the update.
 
-# install packages:
-cpan Carp
-cpan Template
-cpan Statistics::Descriptive
-cpan Params::Validate
-cpan Parse::RecDescent
-cpan DateTime::Format::ISO8601
-cpan Class::Accessor::Fast