Usage

The procedure gmkpack is used to create a pack.

You can get on-line details about the options and the mechanism of gmkpack from the man pages :

% man gmkpack

If you just type % gmkpack you will get a short description of the arguments of the command :

% gmkpack
Usage: gmkpack -r release [-b branch ] [-n local-pack-version ] [-a -s |
 -u target-pack [-v reference-pack-version ]] [-l compiler-label ]
 [-o compiling-flag ] [-f rootpack-directory ] [-p program ] [-m]

Parameters :
----------
 -r = reference release label
 -a = To create a main pack
 -b = reference branch name (optional, default is "main")
 -u = target pack name
 -v = reference pack version number (optional, default is the latest)
 -n = local pack version number (optional, default is the latest existing one)
 -p = program name for the compilation script
 -s = To create the scripts to compile the system programs
 -f = alternative rootpack directory (optional)
 -l = reference compiler version (optional, default is "PGI616")
 -o = compiler options family, (optional, default is "x")
 -m = quiet mode (optional ; to make the compilation script only)

Meaning of this options :

-r : label of the source code release ; this parameter is mandatory. In case of a non-main pack, it should be the label of the source code release of the reference pack. It is a string starting with two numerics. Metacharacters should not be used.

-a : tells GmkPack to create a main pack

-b : for a non-main pack, label of the source code modification in the reference pack ; the default is main (arbitrary name recommended for a ''main'' pack). It should be an alphanumeric string.

-u : label of the source code modification of the user pack. Options -a and -u are exclusive. This argument is optional ; if not provided, the pack will be given the name of the reference pack. It should be an alphanumeric string. While developping from an external source code manager, it is recommended to adopt the same label of modification than the one used in this source code manager.

-v : version number of the source code modification in the reference pack ; it should be a string of two numerics. If not provided, the highest version found among the existing reference packs on this release and branch is assumed.

-n : version number of the source code modification for an administrator pack. It should be a string of two numerics. If not provided, the value 01 is assumed.

-p : list of the programs to build, with the character ''slash'' (/) as separator. Optional. If not provided a script to compile and make all the object libraries is created anyhow. Note that if this parameter has been omited, a new script can be made later.

-s : tells GmkPack to create a specific compilation script for the precompilers. This option can be used only with main packs. It is used for debugging GmkPack when the compilation of a precompiler fails.

-f : tells GmkPack to adopt the argument as an alternative to ROOTPACK to localize the reference pack.

-l : stamp to identify the compiler version used. This option does not work (its value is defined in the configuration file). Later it might be used to enable the selection of an alternative configuration file and hence, an alternative compiler.

-o : stamp for the compiler options family used. Its default value is ''x''. This option is used to select an alternative configuration file whhere the compilation options would be modified to enable special studies (debugging, profiling, etc).

-m : prevents GmkPack from making a pack : only the compilation script is build. This option has been used for debugging the compilation script made by GmkPack .