1 karl  1.1 This directory is a work-in-progress to develop a standard configure mechanism
 2           that can be used to configure Pegasus for compiling and linking.
 3           
 4           This script is based on the standards for configure options used by the
 5           GNU community as defined in the GNU coding standards. All options to be
 6           used in this script (--enable..., --disable, etc.)  The coding standards can
 7           be found at
 8           
 9               http://www.gnu.org/prep/standards/standards.html
10           

11 karl  1.2 The goal of this script is to replace manually setting of environment
12           variables for Pegaus builds with a configure mechanism that simplifies
13           the choices and also confirms that the choices are correct (ex. confirms
14           that the SSL libraries are where they are defined)
15           
16           Overview
17           
18           This script can be used with existing pegasus source trees on Linux and 
19           Solaris today.  It DOES NOT modify the existing source tree but adds two
20           new files to the pegasus root directory to define the options defined by
21           the configure script and allow them to be incorporated with make. This 
22           depends on a feature of GNUMake that provides a precedence mechanism 
23           for the makefile names (GNUmakefile, Makefile, ...). 
24           
25           
26             options.mak - options to be used with this build
27             GNUmakefile - Makefile that is called by default by make and simply includes
28                           the options.mak and calls Makefile.
29                           It includes one target (distclean) to remove all things
30           	        created by this script. 
31           
32 karl  1.2 The configure script MUST BE executed from the directory that is the top of 
33           the Pegasus source tree (ex. pegasus) since it puts the created files in
34           that directory.
35           
36           Note that in accord with the GNU standards it defines a directory with the
37           platform definition under the source top directory to be used as the output
38           directory (PEGASUS_HOME)
39           
40           This file attempts to automate the selection of platform, compiler, etc. to
41           create the PEGASUS_PLATFORM environment variable.
42           
43           Usage:
44           
45           1. Get configure from pegasus_unsupported.
46           
47           2. Go to the directory that will become PEGASUS_ROOT (the top of the Pegasus
48           source tree).
49           
50           3. Create a softlink to the configure script 
51              ln -s .../pegasus_unsupported/config/configure
52           
53 karl  1.2 4. Execute the script.
54              a. If you execute it with no options, it will install what it feels is the
55                 standard build environment variables into the options.mak and create the
56                 GNUmakefile
57              b. If you execute with the --help option it will list all options
58              c. Execute with the enable/disable options you desire and it will create
59                 the options.mak with these options and the required environment
60                 variables into options.mak and creates the GNUmakefile
61              d. Build pegasus with the standard commands (ex. make, make world,
62                 make new world, etc.)
63           
64