1 a.dunfey 1.1.26.1 //%2006////////////////////////////////////////////////////////////////////////
 2                   //
 3                   // Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development
 4                   // Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.
 5                   // Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;
 6                   // IBM Corp.; EMC Corporation, The Open Group.
 7                   // Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;
 8                   // IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.
 9                   // Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;
10                   // EMC Corporation; VERITAS Software Corporation; The Open Group.
11                   // Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.;
12                   // EMC Corporation; Symantec Corporation; The Open Group.
13                   //
14                   // Permission is hereby granted, free of charge, to any person obtaining a copy
15                   // of this software and associated documentation files (the "Software"), to
16                   // deal in the Software without restriction, including without limitation the
17                   // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
18                   // sell copies of the Software, and to permit persons to whom the Software is
19                   // furnished to do so, subject to the following conditions:
20                   // 
21                   // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
22 a.dunfey 1.1.26.1 // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED
23                   // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
24                   // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
25                   // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
26                   // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
27                   // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
28                   // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29                   //
30                   //==============================================================================

31 konrad.r 1.1      /-----------------------------------------------\
32                   |  Set Configurations of Environment variables  |
33                   \-----------------------------------------------/
34                   
35                   Author: Konrad Rzeszutek <konradr@us.ibm.com>
36                   Jul 28th 2004
37                   
38                   
39                   Description:
40                   ------------
41                   
42                   The SetConfig_EnvVar script is used to solve one of the problems that Pegasus
43                   require of users - to set environment variables for compiling components 
44                   of Pegasus. This script will allow the user to set those options interactivly
45                   or by providing arguments to the script.
46                   
47                   
48                   Usage:
49                   ------
50                   
51                   To set the compilation options, run the script file and provide the answers.
52 konrad.r 1.1      You can always re-run the application to set new options, so don't worry if 
53                   you set the wrong option the first time.
54                   
55                   If you already know what you want and are not interested in interactivly
56                   answering questions on components, pass in arguments to the script.
57                   For a full list of arguments, run the script with --help parameter, as such:
58                   
59                    $./SetConfig_EnvVar --help
60                   
61                   
62                   Developer:
63                   ----------
64                   
65                   If you are Pegasus developer, this section will interest you. The details of 
66                   the working of this script is described in "PEP #182: Configuration script 
67                   enhancement." 
68                   
69                   If you are adding a new component to Pegasus and require to set a new
70                   #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 
71                   file is quite easy:
72                   
73 konrad.r 1.1      {<define-component> { [<depends on;depends on; ...>],<define_type>, 
74                   	<--config component>, <short description>, <long description> }
75                   
76                   For example the PEGASUS_HAS_SSL is defined as:
77                   
78                   PEGASUS_HAS_SSL {
79                   # Depends on other components. This is optional.
80                   	OPENSSL_HOME
81                   # Boolean means you need to define "Yes", "No" (any case).
82                   # Path means that the user has to provide a path.
83                   	Boolean,
84                   # The parameter that can be run with ./ConfigureSetConfig_EnvVar, such as
85                   	--enable-ssl,
86                   # Short description, used for ./ConfigureSetConfig_EnvVar --help to provide a short 
87                   	Build in SSL support,
88                   # Long description, used when querying interactively the user.
89                   	Enabling SSL compile SSL support in Pegasus. If your SSL include 
90                   	files are located in a non-standard location, make sure to define 
91                   	OPENSSL_HOME with the right directory.}
92                   
93                   
94 konrad.r 1.1      Make sure that "{" is ended with "}"
95                   
96                   Good luck!