Purpose
The tool.gbs files are located in the GBS_SYSTOOLS_PATH/tool directories and are
used to define the particularities of a Tool.
General
Please refer to .gbs files: General information
Additional for this file:
- Lines with no leading white-space (called header-lines) define an item.
- Following lines with leading white-space (called sub-lines) define the parameters for that item.
- Reserved words (keywords) are case sensitive
- The search path for the .include Directive is:
- $GBS_SYSTOOLS_PATH/$GBS_TOOL
- $GBS_SYSTOOLS_PATH
Contents
INIT definition
INIT definition
Purpose:
To define derived Target dependent Environment Variables
Note that all references to the 'outside-world' must be specified in the
switch.gbs.
On Windows it can be used to (re)define an EnvVar with spaces removed.
(Converted to ShortPathName)
Syntax:
- INIT
- SET_W = envvar_name => envvar_value
- ...
- SET_X = envvar_name => envvar_value
- ...
- SET = envvar_name => envvar_value
- ...
- SETPATH = path_envvar_name => envvar_value-list
- ...
Semantics:
- SET_W, SET_X & SET
- Specifies an Environment Variable.
- envvar_name
- Uppercase please
- envvar_value
- If placed between quotes (") it will be canonicalized (/.. solved) and on
Windows converted to a ShortPathName without spaces.
- SET_W is executed for Windows only.
SET_X is executed for Unix and Linux only.
SET is executed for all platforms
and must be specified after SET_W and SET_X
- SETPATH
- Specifies a PATH Environment Variable.
- path_envvar_name
- Case dependent on OS
- envvar_value-list
- If placed between quotes (") items will be canonicalized (/.. solved) and on
Windows converted to a ShortPathName without spaces.
Items will be properly joined (';' on Windows, ':' on Lunix)
- Must be specified after SET_W, SET_X & SET
Notes:
None
Example of a tool.gbs:
#
# TOOL.GBS
# doxygen
#
.plugin doxygen
INIT
SET = DOXY_BIN => %GBSEXT_DOXYGEN_PATH%/bin
##EOF##
Copyright © Randy Marques of Randy Marques Consultancy - All rights reserved