1 konrad.r 1.1 /-----------------------------------------------\
 2              |  Set Configurations of Environment variables  |
 3              \-----------------------------------------------/
 4              
 5              Author: Konrad Rzeszutek <konradr@us.ibm.com>
 6              Jul 28th 2004
 7              
 8              
 9              Description:
10              ------------
11              
12              The SetConfig_EnvVar script is used to solve one of the problems that Pegasus
13              require of users - to set environment variables for compiling components 
14              of Pegasus. This script will allow the user to set those options interactivly
15              or by providing arguments to the script.
16              
17              
18              Usage:
19              ------
20              
21              To set the compilation options, run the script file and provide the answers.
22 konrad.r 1.1 You can always re-run the application to set new options, so don't worry if 
23              you set the wrong option the first time.
24              
25              If you already know what you want and are not interested in interactivly
26              answering questions on components, pass in arguments to the script.
27              For a full list of arguments, run the script with --help parameter, as such:
28              
29               $./SetConfig_EnvVar --help
30              
31              
32              Developer:
33              ----------
34              
35              If you are Pegasus developer, this section will interest you. The details of 
36              the working of this script is described in "PEP #182: Configuration script 
37              enhancement." 
38              
39              If you are adding a new component to Pegasus and require to set a new
40              #ifdef statement, you should consider adding it in ./SetConfig_EnvVar.help file.The file lists the options that would be presented to the user. Syntax of this 
41              file is quite easy:
42              
43 konrad.r 1.1 {<define-component> { [<depends on;depends on; ...>],<define_type>, 
44              	<--config component>, <short description>, <long description> }
45              
46              For example the PEGASUS_HAS_SSL is defined as:
47              
48              PEGASUS_HAS_SSL {
49              # Depends on other components. This is optional.
50              	OPENSSL_HOME
51              # Boolean means you need to define "Yes", "No" (any case).
52              # Path means that the user has to provide a path.
53              	Boolean,
54              # The parameter that can be run with ./ConfigureSetConfig_EnvVar, such as
55              	--enable-ssl,
56              # Short description, used for ./ConfigureSetConfig_EnvVar --help to provide a short 
57              	Build in SSL support,
58              # Long description, used when querying interactively the user.
59              	Enabling SSL compile SSL support in Pegasus. If your SSL include 
60              	files are located in a non-standard location, make sure to define 
61              	OPENSSL_HOME with the right directory.}
62              
63              
64 konrad.r 1.1 Make sure that "{" is ended with "}"
65              
66              Good luck!