HOME Generic Build Support (GBS) - User Manual
GBS Release Notes - Release 2

Release Notes for GBS 2.00 (Deprecated - not complete)

GBS 2.00 is not backwards compatible!

Release Notes for GBS 2.05

Interface changes since 2.04

The following must be implemented before switching to this version.

Upgraded to the last build of GBS 2.04 (2011-09-01)
Performed an 'Upgrade from previous release' (gbsmaint 7 9)

The following major changes were implemented:

None

Build 2.05: 2012-06-20

New/Changed Functionality

gbsxref: GUI Theme changed due to use of Tkx
gbsxref: Minimum window now smaller
GBS is now distributed a version per customer
The version contains the customer's company name
This name is shown during startup, logfiles and generated html-files.
GBS startup: Now shows the GBS banner.
gbswhich: Checks and shows existence of GBSEXT_*_DIR directories.
gbsshow (gbs): New option: '--brief'
New layout
gbssws (sws): Now call gbsshow with --brief
gbsswc (swc): Now call gbsshow with --brief
gbsswt (swt): Now call gbsshow with --brief
Improved layout of generated HTML files (Audit & Silo)
gbsaudit: QAC & QAC++: Improved 'missing license' handling
Support for QAC 8.00 and QAC++ 2.5
gbssysgen, gbssysmake and gbssysaudit: At completion a Notify window is always displayed, even if Perl Tkx is not available (if not disabled)

Problems solved

GBS does not depend anymore on the separate Perl package Tk (PerlTk).
It now uses Tkx, which is standard since Perl 5.10.
Hence it is not necessary anymore to install the PerlTk package separately.
Warning: "Use of qw(...) as parentheses is deprecated " in Perl 5.14 solved.
Use of Subversion 1.7 caused 'Use of uninitialized value $repos_root in regexp compilation..' warning.
Caused by change in output layout of svn. Solved.
system.gbs: Platform sensitive SCMS added.

Release Notes for GBS 2.04

Interface changes since 2.03

The following must be implemented before switching to this version.

Upgraded to the last build of GBS 2.03 (2010-10-14)
Performed an 'Upgrade from previous release' (gbsmaint 7 9)

The following major changes were implemented:

Perl version must be at least V5.10.01

Build 2.04: 2011-08-29

New/Changed Functionality

None

Problems solved

gbshelp: Perl Install Documentation updated
(@INC bug with directories starting with '5')
gbssysgen: Solved 'Cannot delete logfile' problem
gbssetup: Properly implement GBS_BASE_PATH

Release Notes for GBS 2.03

Interface changes since 2.02

The following must be implemented before switching to this version.
The following changes were implemented:

Audit output directories must exist and be in Version Control.
Starting 2.03, gbsaudit will skip a Component if .../aud/audit/target does not exist.
You can already use gbsmaint to add these directories
gbsmakemake: Files in the sysgen/makemake_stubs directory must have been moved to the sysgen/makemake_stubs/ALL directory.
sysgen.gbs: 'RECUR' was already obsolete. Will become an error.
New mandatory directories have been introduced (e.g.: systools and silo). You should run gbsmaint 8: Check/Fix Directory structure.
audit.gbs The MAINT entry has become obsolete for QAC and QAC++, you should remove it (them)
export.gbs: to-base RES: replaced by RESSUB:
EnvVar format for SCM-tools has changed from 'GBS_scm_BIN' to 'GBSEXT_scm_DIR'
Startup mechanism change.
gbs (gbsinit) is now started via [.gbs]gbsinit
gbsstart is now started via [.gbs]gbsstart
You will have to change any reference to $GBS_SCRIPTS/gbsstartup in our IDE and/or scripts
Win32: Registry is not used anymore for saving GBS EnvVars. You can (should) remove all present GBS_ settings

QAC and QAC++: audit.gbs now must be defined as follows:

    .plugin qac
    .include <audit.gbs>
    or
    .plugin qacpp
    .include <audit.gbs>

switch.gbs (QAC): Now needs GBSEXT_QAC_REL and GBSEXT_QAC_DIR
switch.gbs (QAC++): Now needs GBSEXT_QACPP_REL and GBSEXT_QACPP_DIR

Note that this release requires at least Perl 5.8.8. Preferably 5.8.8.817.

Build 2.03: 2010-10-14

New/Changed Functionality

wordrep: multiple replace commands can now be specified in commands-file

Problems solved

None

Build 2.03: 2010-06-10

New/Changed Functionality

None

Problems solved

The whole gbshelp was revised.
Many thanks to Martin Smits who spent may hours (days) meticulously revising the document, checking for inconsistencies, unclearities and typos.

Build 2.03: 2010-03-15

New/Changed Functionality

gbsexport: Added support for (msi) installer create programs
export.gbs: New from_base: INSTALL. Specifies execution of installer create program
Pruning is now performed before replicate
gbsexport:
Exported directories are now created with mode: u=rwx,go=rx,o=x
Exported files are now created with mode: ugo:r
export.gbs: Directory/File permissions can now be altered (chmods)

Problems solved

export.gbs: Target_Line_Selector did not work properly (deleted all non-targets)
gbsgen: The $1 was not expanded properly in the MAP YES => options on Unix.

Build 2.03: 2009-09-02

New/Changed Functionality

gbsmaint 8: (Fix/Check directory structure) will now give a message when there is no SCMS
Added system.gbs help page
system.gbs: Implemented stricter checking of values
Added owners.gbs help page
MinGW: Now needs envvar GBSEXT_MINGW_GNU_REL in switch.gbs to specify internal GNU-release
File templates for C++ improved (gbsedit)
The Install(.bat/.sh) script now accepts a -q (quiet) flag. It will run the script without human interaction, assuming all defaults to be correct

Problems solved

Problems with user-modified system.gbs file. See above
gbsedit: When creating a .cpp file in the src directory any.c was taken as template-file instead of any.cpp
Fixed and added URL-links in the GBS help files

Build 2.03: 2009-04-20

New/Changed Functionality

export.gbs Now support file/directory specifications with spaces (yech!).
All occurrences of %_ (Unix), $_ (Win32) and %20 (all) are replaced by spaces.

Problems solved

File-states not detected properly when using Subversion. This occurs from Subversion release 1.6 where the layout of the status has been changed GBS updated to work with both 1.6 and pre-1.6
gbssilo: Could crash if there were empty lines in file(s)
swr: Did not cleanup EnvVars (GBS_SUBSYS_ROOT) properly when switching to a Root without a current SubSys
gbsexport: Spaces in names did not function properly.

Build 2.03: 2009-03-17

New/Changed Functionality

gbsscm/scm: New functionality: import
swr: Now gives a warning when there is a GBS-VERSION and GBS-ROOT-VERSION mismatch.
gbsmaint: 6 7 (Upgrade) will now check the dir-structure and set the GBS-ROOT-VERSION to GBS-VERSION.
export.gbs files can now have a Target Line Selector in the destination_line.
gbsstart: Implemented !abs_file/dir
gbsedit now allows for an additional positional parameter for the editor. This enables you to optionally specify a line-nr to jump to (according to the editor syntax).
Prompts for single character input e.g.: Sure? (y/n)[y]: are now in lowercase
gbshelp: Added 'Plugins'
gbshelp: Added 'Integration with other Tools'
gbshelp: Split Customisations in User part and Admin part

Problems solved

Unix: '\atq' sometimes returns rc=1 without known reason. This will now give a warning instead of a GBS Internal Error.
Plugin 'copy_export' now locks the input and output directories.
This caused the 'INTERNAL-ERROR: No such file or directory'

Build 2.03: 2009-01-22

New/Changed Functionality

New version
Corrective creation of mandatory directories removed
Audit output directories must exist and be in Version Control.
gbsaudit will skip a Component if .../aud/audit/target does not exist.
You can use gbsmaint 7 to add these directories
gbsmakemake: sysgen/makemake_stubs has been removed from search path
sysgen.gbs: 'RECUR' not supported anymore.
export.gbs: 'RES:' replaced by 'RESSUB:'
GBS startup on Win32: the obsolete setup.bat file has been removed. If your DeskTop shortcut cannot find this file then run gbssetup 6 on release 2.02 or re-install GBS

Problems solved

None

Release Notes for GBS 2.02

Interface changes since 2.01

Must be implemented before switching to this version.

Unix scripts must end with '.sh'
The syntax of the GBS_BG_NOTIFIER parameters has changed.
qacrun does not include the PRL substitute system header files anymore.
If you need them you will have to add the -I in your .via file.
All .gbs* files in the HOME directory are moved to new HOME/.gbs directory
New implementation of Non-GBS SubSystem handling

Planned interface changes for 2.03

Must be implemented before switching to that version (in the future).
Following changes can already be implemented. You are urgently advised to do so as soon as possible.

Audit output directories must exist and be in Version Control.
Starting 2.03, gbsaudit will skip a Component if .../aud/audit/target does not exist.
You can already use gbsmaint to add these directories
gbsmakemake: Files in the sysgen/makemake_stubs directory must have been moved to the sysgen/makemake_stubs/ALL directory.
sysgen.gbs: 'RECUR' was already obsolete. Will become an error.
New mandatory directories have been introduced (e.g.: systools and silo). You should run gbsmaint 8: Check/Fix Directory structure.
audit.gbs The MAINT entry has become obsolete for QAC and QAC++, you should remove it (them)
export.gbs: to-base RES: replaced by RESSUB:
EnvVar format for SCM-tools has changed from 'GBS_scm_BIN' to 'GBSEXT_scm_DIR'
Startup mechanism change.
gbs (gbsinit) is now started via [.gbs]gbsinit
gbsstart is now started via [.gbs]gbsstart
You will have to change any reference to $GBS_SCRIPTS/gbsstartup in our IDE and/or scripts
Win32: Registry is not used anymore for saving GBS EnvVars. You can (should) remove all present GBS_ settings

QAC and QAC++: audit.gbs now must be defined as follows:

    .plugin qac
    .include <audit.gbs>
    or
    .plugin qacpp
    .include <audit.gbs>

switch.gbs (QAC): Now needs GBSEXT_QAC_REL and GBSEXT_QAC_DIR
switch.gbs (QAC++): Now needs GBSEXT_QACPP_REL and GBSEXT_QACPP_DIR

Above changes can already be implemented. You are urgently advised to do so as soon as possible.

Build 2.02: 2009-01-14

New/Changed Functionality

gbsmaint 8: On Unix/Linux you will be prompted for the possibility to set the execute-bit of all .sh files in the GBS WorkArea

Problems solved

gbsmake failed with a FATAL INTERNAL ERROR when 'make' retuned non-zero. It will now exit with an ERROR.

Build 2.02: 2009-01-12

New/Changed Functionality

audit.gbs (QAC/QAC++): GBS_QAC_FORMAT and GBS_QACPP_FORMAT now supported.
switch.gbs (QAC): Now needs GBSEXT_QAC_REL and GBSEXT_QAC_DIR
switch.gbs (QAC++): Now needs GBSEXT_QACPP_REL and GBSEXT_QACPP_DIR
gbsaudit (QAC/QAC++): Annotated source format standardised and improved.
GBSEXT_pluginname_DIR may now have the value 'PATH', indicating that the PATH mechanism should be used.
A warning is given if the EnvVar is not defined at all.
gbsaudit 'via' files (.via and .lnt) are now searched in the order 'target' / 'target_plugin_name' first in $GBS_ROOT/sysgen/$GBS_AUDIT and then in GBS_SCRIPTS/plugins/$GBS_AIUDIT directories.
gbsstats: New option: --lines (bool) to count the lines in the files in specific directories (src, inc, loc, ect)
gbssysaudit, gbssysgen and gbssysmake: .sum information is now also appended to a file in the silo directory
gbssilo: Now also generates an overview of gbssys... runs
The Install script will not delete obsolete files that have the HIDDEN attribute set (Win32 only).
gbsmaint: Check/Fix Directory Structure: Much faster due to new state pre-fetch functionality in SVN plugin. Other CM plugins may follow

Problems solved

GBS_HOME was gone
Repair multiple files status checking for SVN (and make it faster - no network access)
gbssetup: Created invalid DeskTop shortcut.

Build 2.02: 2008-11-28

New/Changed Functionality

flags.gbs: Options containing spaces and quotes will not be placed between quotes on the command-line anymore
target.gbs and audit.gbs: No arguments check if command is 'echo'
gbssysaudit: html files are now created in silo/audits.
gbsaudit still writes html files to GBS_LOG_DIR
audit.gbs: New possible values for GBS_pluginname_FORMAT: NONE, DEFAULT, PRQA and ECLIPSE

Problems solved

gbsaudit did not pick up SYSINCS correctly
Subsystem, Component and Target names may only consist of the characters 'A-Z, a-z, 0-9 and _'
(Was temporarily disabled)
gbsmakemake: Invalid Argument problem

Build 2.02: 2008-11-21

New/Changed Functionality

Password-prompt is now directly via the commandline. (no X-window anymore)
gbssilo: New options: 'create_index' and 'view_index'

Problems solved

Concurrent creation of various files in silo is now guarded by a lock mechanism.

Build 2.02: 2008-10-17

New/Changed Functionality

On Unix/Linux Mozilla will open in New-Tab instead of New-Window
Internal updates, better error-messages, less messages
Long resulting command lines: The mechanism in Win32 to automatically use the '@' via-file notation to cope with long command lines has been removed.
target.gbs and audit.gbs: New option env_var for INC_FORMAT and SYSINC_FORMAT to implement the via-file option for any builder or auditor that supports this functionality

Problems solved

gbsedit of scope.gbs crashed
Lock and sleep added when staring up the browser. This solves browser-startup problems in Linux

Build 2.02: 2008-10-07

New/Changed Functionality

gbssysaudit, gbssysgen and gbssysmake: steps 'ALL' will now FORCE all steps.
gbssysgen and gbsgen: gbsexport now is executed AFTER gbsmakemake.
gbsmaint Set Version Limits: Improved User Interface

Problems solved

gbsmaint Cleanup deleted .svn (and CVS) directories in tmp and silo directories.
Unix/Linux: problem with 'at' jobs

Build 2.02: 2008-10-03

New/Changed Functionality

gbssetup: Preparations for GBS 2.03.
Startup mechanism has been changed.
gbs (gbsinit) is now started via [.gbs]gbsinit
gbsstart is now started via [.gbs]gbsstart
Win32: Registry not used anymore for saving GBS EnvVars. Mechanism is now same as for unix: [.gbs].gbs_profile
The 'old' way of startup will keep functioning until you run gbssetup 6.
Unix/Linux: Implemented detection of not-sourcing .sh files that need to be 'sourced'
gbsstart: Now allows --exec=none

Problems solved

gbswhich did not expand Target EnvVars when searching for a file. (e.g.: gbswhich windows.h .c)
gbssetup: Could not specify a file_spec surrounded with quotes and some more minor problems concerning user-interface

Build 2.02: 2008-09-25

New/Changed Functionality

gbsedit: If a file does not exist you will always be prompted for permission to create.
gbsaudit, gbssysaudit, gbsgen, gbssysgen, gbsmake, gbssysmake: now accept the --job option. This option specifies the maximum number of parallel jobs within a submit. Default and 0 will result in 2 parallel jobs.
gbsaudit: In the Annotated Source error messages are shown in red and message-navigation has been extended with 'top', 'previous' and 'bottom'.

Problems solved

None

Build 2.02: 2008-09-22

New/Changed Functionality

No support anymore for Microsoft Visual Studio .dsp files
Wild-cards are now supported in the target-line-selection mechanism in scope.gbs and glkbt files
gbsedit: You can now specify an edit from a different SubSystem and/or Component. There are now more SubDir possibilities.
Added Include Guards in templates for .h and .hpp files

Problems solved

The scope mechanism did not check wether a Component actually exists

Build 2.02: 2008-09-04

New/Changed Functionality

gbsmaint: Improved handling of plugins
gbsfiles: New: '.plugin' directive'
A possible plugin-path has been included in the search paths of target.gbs, audit.gbs and tool.gbs and as such reduces the number of files that have to be copied to the sysgen/systools directories
Introduced the tool.gbs file
gbswhich: Now also shows GBSEXT_* directories
swr --remove: Now always checks for obsolete Roots

Problems solved

Creation of new Component or SubSystem failed (root in SubSys/Component name)
gbsmaint Problem slowing down gbsmaint 8 (Check/Fix GBS Directory Structure) solved
Repaired problem in gbsaudit causing audit-mixup when there was more than 1 audit installed for 1 src-type
sws --new did not add 'export.gbs' to SCM in non-GBS SubSystems

Build 2.02: 2008-08-19

New/Changed Functionality

export.gbs:
to-base RES: replaced by RESSUB: (You may have to change your export.gbs)
New from-base: SILO: SUB: and GBSEXT_name_DIR:
Default from-base for GEN is now GBS_SUBSYS_ROOT (Was GBS_GEN_ROOT)
New Help document: .gbs files: General information
Documentation on gbs files updated
EnvVar format for SCM-tools has changed from 'GBS_scm_BIN' to 'GBSEXT_scm_DIR'
gbsaudit: In the HTML Summary File the file legend has been moved to the left, after the source-file-name.
GBS Files - General: added directives .plugin and .exit

Problems solved

gbsexport did not remove obsolete files
gbsexport deleted files with no 'to_dir'
Endless recurse loop in copy_export when output-root did not exist
GBS Files - General: Recursive include of a file is now properly detected

Build 2.02: 2008-08-05

New/Changed Functionality

Plugin 'copy_export' implemented
Improved gbshelp layout
Improved gbssilo layout

Problems solved

None

Build 2.02: 2008-08-01

New/Changed Functionality

gbsmaint now has a separate menu-entry for Integrator Tools.
The 'Set version limits' entry has been moved to the Integrator Tools menu.
New entry in Integrator Tools menu: Consolidate (base) Audits.
This functionality was dedicated to qac/qac++
audit.gbs The MAINT entry has become obsolete for QAC and QAC++, you should remove it (them)

Problems solved

gbswhich would crash if no Audits were present
gbsaudit: HTML link problem fixed.
gbsaudit: HTML '< >' problem fixed.

Build 2.02: 2008-07-28

New/Changed Functionality

Implemented PC-Lint Audit plugin

Problems solved

QAC/QAC++ Incorrect constants-count

Build 2.02: 2008-07-16

New/Changed Functionality

New mandatory directories introduced: systools, silo and tools.
You should run gbsmaint 8: Check/Fix Directory structure.
New gbs command: gbssilo
Doxygen support implemented as plugin
New glkb type: glt for test-files
Specify a test-executable in a .glt file and it will run with STDOUT and STDERR redirected to the output_file.
When exiting a Root (System) with swr all Environment Variables starting with GBSEXT_ are unset.
(No need to do that anymore in the 'exit' part of switch.gbs)

Problems solved

None

Build 2.02: 2008-07-09

New/Changed Functionality

Template of 'any.glk' extended with 'Control' section
gbsedit of a new steps.gbs now creates a file containing proper references to the available SubSystems
Added Tools Plugin-type
Added doxygen plugin under Tools
Improved STEPS handling
e.g.: you can now specify AUDITS in STEPS and value of STEPS / AUDITS by be '-' Indicating 'none' or 'non-specific'
the gbssys commands now allow --targets and/or --audits to have the value '-'
The job-completion notification window now displays a red icon when the job terminated with an error

Problems solved

QACAUDIT: Nr of lines per Source and Total were switched!
_gbssetup.bat now prompts for Windows closure

Build 2.02: 2008-xx-xx

New/Changed Functionality

Max size of GBS_SITE increased from 8 to 20
gbsmaint: Audit handling improved
gbswhich: New functionality: gbswhich Component

Problems solved

When gbssetup is called via _gbssetup then gbssetup will wait to close the window.
New SubSystem, Component and Target were nor remembered across sessions

Build 2.02: 2008-06-27

New/Changed Functionality

audit.gbs: GBS_OPTS changed into GBS_FLAGS

Problems solved

File replication command in Win32 (xcopy) is language sensitive and expects f for file in English, but b in Dutch.
XCOPY replaced by Win32::CopyFile
gbsaudit always placed a space between -D and value.
This is now done in qacaudit

Build 2.02: 2008-06-18

New/Changed Functionality

Audit 'base' handling has been formalized and the 'base' files are not extracted/saved anymore
This is an internal change and has no consequences for the way of working.
Audit output directories (aud/audit/target)will now be added to Version Control.
Audit output directories will now be created and Added to Version Control when a new Component is created.
gbsmaint Now offers functionality to add Audit output directories.
The job-completion notification window now displays text in red when the job terminated with an error
Implemented parallel execution of gbsgen build-steps.
Note that logging of compilations, etc, may not be the same as the order of startup as steps complete asynchronously
With subversion a check is now made between the information in the .svn directory and the settings in the system.gbs file. You will be warned is there is a mismatch.
gbsedit: The editor is now started as a detached process. This will allow you to keep the editor running. The drawback is that there will be no logging if the starting of the editor fails. To get this logging, define an Environment Variable GBS_DEBUG_PROC=1 and the logfile will be written in the TMP directory and named nohup.out
GLK/B: Improved handling of '=' lines. /def:file_name.def is now handled properly.
This may mean an update of the mvs_glk.bat file.

Problems solved

gbsexport did not expand EnvVars ($GBS_TARGET) in EXT:

Build 2.02: 2008-04-02

New/Changed Functionality

Command-line options: '--' will stop assuming '--' to be a GBS-option prefix and all following options prefixed with '--' will be passed to underlying application(s) '---' will ignore the rest of the command-line.
swr --new: When selecting Subversion, the Repository-URL will be taken from the .svn directory (it was previously prompted for)

Problems solved

swr --new: Fix Extend to other platform functionality
(Allow SCM REPOSITORY selection/update)
There was no '####' fail message when non-gbs SubSystems failed
svn: svn:ignore properties were not set correctly (\n)

Build 2.02: 2008-03-21

New/Changed Functionality

vim is now the default GBS_EDITOR on Linux/Unix (was nedit)
Reduced number of logging messages
Improved layout of logfile (FAIL now recognisable by '#####' block)
gbsmake: Added --r (reverse type)
gbswhich: Added 'PATH'
Added _gbssetup.bat and _gbssetup.sh for initial setup convenience.
They will appear at the top of the list! :-)
Added --rel=gbs_version to gbsinit ('gbs' at startup) and gbsstart. This allows you to temporary startup a different version of GBS than the default.
Settings set by gbssetup are not affected.
bgpids: New option '-a'
The obsolete Linux/unix script 'gbs' has been removed from $GBS_SCRIPTS. (use 'gbs.sh')

Problems solved

Solved problem with GBS_FLAGS_* being issued double
gbssetup: Solved problem with escape of strings
gbsmake: if --export is specified gbsexport will be executed even if no files were generated.
Proper execution of bgpids on Linux
gbsaudit could crash if CWD not in current src directory

Build 2.02: 2008-03-03

New/Changed Functionality

Large change considering Non-GBS SubSystems.
- 'app' directory now mandatory in $GBS_SYSGEN_ROOT. New command: cdapp to chdir to app
- gbssub... commands do not take any parameters anymore. Only EnvVars.
- EnvVars for gbssub... commands now properly set:
  GBS_IGNORE_ERRORS, GBS_MAKE, GBS_FLAGS_type, GBS_BLD_type,
  GBS_MODE, GBS_OPT, GBS_DEBUGGER and GBS_MAP.
- New template scripts for gbssub... commands. Lots of documentation in scripts.
  You may want to replace your current scripts by the new ones. (use gbsedit)
gbsedit: New: template-files for .sh, .bat and .mk files
target.gbs may now be empty (for pure non-gbs systems)

Problems solved

Not all GBS_..._ROOT EnvVars were set properly for Win32 ('/' instead of '\') after an sws or swc

Build 2.02: 2008-02-21

New/Changed Functionality

Non-gbs SubSystem generation files are renamed from 'gbs...' to 'gbssub...'
'app' is now a mandatory directory in non-gbs SubSystems.
gbswhich and gbsedit now have the same syntax for specifying files in SubDirs.
gbsmakemake now also includes:
- .include target.gbs files
- command-files referred to in target.gbs (1 level deep only)
New fixed directory in makemake_stubs: ALL.
To be used instead of makemake_subs for generic stubs.
You are urgently requested to move non-target directories and files from makemake_stubs to makemake_stubs/ALL.
Default GBS_VIEWER on Unix/Linux is now 'less' in xterm window
Unix/Linux: GBS now takes care of proper DISPLAY settings of 'at' and other types of detached jobs.
'Thumbs.db' added to SkipTypes
Optimised execution of gbssys... jobs (Sub-process depth reduced)

Problems solved

On Linux/Unix: Formatting in columns like in swr did nog get the screen width right and causing it to be set to 100 which gave strange layout.
On Win32: If a path-like EnvVar like %PATH% was used, Perl would crash with an Access-Violation without a issuing a proper message. (Bug in Win32 API long/short name conversion)
target.gbs: Proper handling of GLKB = UNIXLIB
gbsmakemake was not always called correctly in gbssysmake
gbssetup: Did not handle %1% correctly
gbsgenDid not get currencies right when CWD was in different src directory than current scr directory (various types of problems here)
gbsswr on Linux/unix left GBSSWR_RESULT_*.tmp file in $HOME
Solved problem with gbsexport having a $GBS_TARGET in file NAME
Reviewed (part of) documentation removing obsolete items

Build 2.02: 2008-01-23

New/Changed Functionality

gbsmaint: Check/Fix Dir Struct: Generally improved. Non_GBS SubSystems are now also checked
gbsexport now takes an export.gbs file on SubSys level for Non_GBS SubSystems
sws --new and gbsedit adjusted accordingly.
swc --new now gives a formatted list of existing Components
The Install script will now set permissions of directories to rwxr-xr-x, .sh files to r-xr-xr-x and all others to r--r--r--
When a new Target is created a directory with the target-name will be created in tmp.
gbsmaint: Check/Fix Dir Struct: will now check validity of Target directories
swr: Will now fail if switch.gbs or switch.usr set GBS_RC != 0
gbsstart: --exec is now mandatory
gbsmakemake: Files with Excluded file-types not longer displayed.
The html directory in tmp has been renamed to .html

Problems solved

swr --add root will now convert (Win32) root to proper path.
Solved various problems concerning usage of swr --new in a totally new environment
swr: switch.gbs and switch.usr were executed in wrong order
Problems with gbsstart solved
Special characters were not escaped when defining an Environment Variable (Win32, SKIPTYPES)
gbsmaint: Solved problem with SCM in Audit Handling→qac/qacpp→Commit Metrics
gbsmaint: Solved problem with cleanup AUD System and SubSystem
Temporary files are now made unique by including hostname in the name instead of userid.

Build 2.02: 2007-11-12

New/Changed Functionality

gbssysgen, gbssysmake and gbssysaudit: added --wait functionality
Improved gbsscm layout
Improved gbsstart performance
gbsmaint: New function: Fix 'ignore property' for Subversion directories
When creating SVN directories the 'ignore' property is set properly
Install: Install-directory is now remembered in .gbs
gbsmaint: Fix: Optionally delete illegal files/directories
gbsscm: Added: Select. Removed: Create, GetWa and Mkroot
swr --new: New System-root must exist and be under SCM control
Support VisualSourceSafe version 8

Problems solved

Solved dump in gbsmakemake while trying to read non-existent generated include file
If 'steps.gbs' did not exist, the generation was not started.
wordrep did not handle i option correctly
gbssetup: Win32 Startup icon was not set properly
Very long internal command-lines could crash without notice
gbsedit: header-files were not created using template.
GBS_LOG_DIR did not accept spaces when defined outside gbssetup
'Install' did not copy Command Prompt Icon
incs_*.gbs Files: Environment-variable replacement was not handled properly
swr --new: Allow spaces in SVN repository URL
swr --new: $GBS_ROOT/sysgen/makemake_stubs was not created
sws --new: Possible Current Component caused gbsnew to malfunction with ERROR

Build 2.02: 2007-08-13

New/Changed Functionality

All .gbs* files in the HOME directory are moved to new HOME/.gbs directory
New: Install functionality
On Win32 the 'beep' is now a sound (.wav) file, so the volume can be adjusted
swr: --remove / --add: prompt for deletion of obsolete Roots in Roots-List
swt: --remove changed to swt --delete
gbsmaint: cleanup functions extended with 'cleanup ALL', cleanup EXPORT and cleanup RES
Cleanup-functions streamlined to give same look-and-feel
target.gbs: GBS_SYSGEN_ROOT added to COMMAND search-path
gbsmaint: Administrator functions now in separate menu
gbsmaint: Added 'Set GBS Version Limits'
glkb files now accept lines starting with '^', specifying: as-is, without leading '^'

Problems solved

Internal switch of Target displayed the old instead of the new Target
Unresolved EnvVars caused 'use of undefined variable' in error-display of inc_*.gbs files
gbsexport: export.gbs files of non-generating Components (no bld/$GBS_TARGET) were not taken into account, causing files to be deleted wrongly from the destination directories.

Build 2.02: 2007-07-03

New/Changed Functionality

GBS_SITE now properly implemented in template of switch.gbs
audit.gbs now supports INIT entry with SET to setup envvars
'audit' en 'gen' scripts now moved to 'plugins' directory

Problems solved

Changing the current Target inside as script did not work well with Target search-path
Notify and HTML-browser (gbsaudit) are now run as truly detached processes on Win32

Build 2.02: 2007-06-28

New/Changed Functionality

css and image files for HTML output (gbsaudit) are now copied to the GBS_TMP_ROOT directory and are used from there.
This facilitates having relative urls and thus solve the security restrictions imposed my Internet Explorer which do not allow file-inclusion from a different drive.
Note that logfiles must still be on same drive!
QAC/QAC++ Summary: Metrics: Data of functions with no lines is now skipped.
This results in the removal of lower bound warning messages like CYC < 1.
gbsexport: You can now also export from the EXT to the EXPORT directory

Problems solved

Changing the current Target inside a command could make certain commands like gbsbldaudit crash
On Unix display of the Notify message was delayed in gbssysaudit because the startup of the HTML display was not created as a proper detached job.
This meant that a slot was kept occupied in the batch queue as long as the job had an open window.

Build 2.02: 2007-06-07

New/Changed Functionality

target.gbs: @-COMMANDs are now searched via .include path.
bld_incs_*.gbs and bld_flags_*.gbs are now also searched via the .include path of the target.gbs
target.gbs: Secondary out-types and opt-out-types had to start with a '.' (dot) now must contain a '.'.

Problems solved

Allow commandline on WinXP to be 8190 chars (was 2000 chars).
On other versions of Win32 the max commandline size is 2046 characters.

Build 2.02: 2007-04-06

New/Changed Functionality

gbssys... commands now create a $GBS_LOGFILE.err file containing info on all the files that generated with an error.
The contents of the file is also appended in the .log file.
gbsmaint: Creation of Generate/Bld/Audit directories implemented

Problems solved

Repaired swr --remove for Win32
Repaired error in gbsstart with twice --targets= or targets-comma-list

Build 2.02: 2007-03-27

New/Changed Functionality

target.gbs: Implemented P_COMMAND
Implemented gbscmd.bat file for MSwin
.gbs files: All error/warning messages also give line number.
.gbs files: Continuation ( \) works for all files.
.gbs files: You will now receive a warning when using a .usr file.
steps.gbs now gives a warning if not all SubSystems are named in STEPS.
UserInterface: Added 'more'-type of functionality when displaying long lists on screen

Problems solved

.gbs files: .usr file without a .gbs file is now also valid
gbsmakemake did not specify .usr file in make-file (only .gbs)
qac/qacpp audit left a temp file in the tmp-directory
gbssetup did not redefine GBS_SCRIPTS envvar when changing GBS_REL

Build 2.02: 2007-03-14

New/Changed Functionality

New internal design UserInterface
UserInterface: You can now always enter '?' to get help.
(But help not always provided...)

Problems solved

Repaired Registry problems in gbssetup
.h files were not recognised as valid files for non-src directory
Some minor problems

Build 2.02: 2007-02-28

New/Changed Functionality

New command: gbssetup

Problems solved

gbsedit: Error in 'unknown src type' repaired
'swr --add' did not recognise added roots (invalid index)
Repaired mistake that sometimes caused commands to exit with rc=0 after an error occurred.

Build 2.02: 2007-02-20

New/Changed Functionality

You will now get a warning if an src-file contains white-space and the file will be skipped for generation/make/audit
Component-names may not contain '.' and ALL, RES and EXPORT are now reserved.
The GBS_BG_NOTIFIER will now also be executed after submit of all jobs.
Note different layout!
qacsummary: Warning Message Summary: level9 are now red.

Problems solved

None

Build 2.02: 2007-02-13

New/Changed Functionality

target.gbs: New 'INIT' section that allows you to set EnvVars
target.gbs: New allowed value for 'MODE': PROFILING
sysgen.gbs: 'RECUR' entry is now obsolete
sysgen.gbs: 'VALUE' that enables assigning of values to names

Problems solved

None

Build 2.02: 2007-02-09

New/Changed Functionality

More efficient execution of gbsstart, new defaults, mandatory --exec
Implemented 'GBS_BEEPS' to disable beeps
Allow spaces in some root directory specifications
Allow *.sln and *.vcproj in Component directory (gbsmaint→CheckDir)
swt --new now guarded for Administrator privilege
Allow 'dat' SubDir to have subdirectories

Problems solved

Bug preventing opt/target/flags_*.gbs to be seen
qacaudit did not pass flags_*.gbs properly
gbsmaint→CheckDir marked audit directories 'not under scms'

Build 2.02: 2007-01-25

New/Changed Functionality

All error-messages from reading .gbs files have the same format now.
Added flags_*.gbs and incs_*.gbs documentation
Number of 'beeps' reduced to once per command.
Streamlined format of error/warning messages (not entirely complete).
gbssysaudit now allows multiple --files options
--files now also possible for gbssysgen and gbssysmake
'Root-version' removed from gbsshow
--new removed from gbsstart
--exec implemented in gbsswr (swr)

Problems solved

gbsscm: 'remove' with svn gives error-message:
svn: Local, non-commit operations do not take a log message
Running QAC/QAC++ on different platform caused error:
AUDIT_ID-file not found

Build 2.02: 2007-01-11

New/Changed Functionality

None. Equal to 2.01 [2007-01-11]

Problems solved

None

Important Notice. UNIX Only

In the next release all Unix scripts must end with '.sh'.
This is already supported in releases 2.00 (last version) - 2.02. So you can already start renaming.
Files affected are:

Code tree:
- switch.gbs (rename to switch.gbs.sh)
- Generation scripts for non-Full-GBS SubSystems (rename to *.sh)
Commands:
- gbs (in .kshrc or .bashrc: change alias gbs to: alias gbs=". $GBS_SCRIPTS/gbs.sh")
- gbsstart (In any startup-script, macro or button-definition: change to gbsstart.sh)
Central Installation of GBS:
- gbsall (if present: copy to gbsall.sh)

Release Notes for GBS 2.01

Build 2.01: 2007-01-11

New/Changed Functionality

This release requires at least Perl 5.8.8. Preferably 5.8.8.817.

Problems solved

None

Release Notes for GBS 2.00

Build 2.00: 2007-01-11

New/Changed Functionality

Documentation: New Release-Notes layout (yes, that is what you are reading now)
Unix command 'which' now available in MSWindows
Implement GBS_PERL_PATH to allow selection of a specific version of Perl
Unix scripts now have extension .sh

Problems solved

SCM for Synergy did not find the password script when called from qac/qac++
swr --new: snv always assumed 'trunk' before the workarea

Build 2.00: 2006-12-22

New/Changed Functionality

Documentation: Enhanced TOC Layout

Problems solved

PR VDO: Use of uninitialized variable when giving error message in target.gbs for last SRC
swr --remove removed all entries with same name.

Build 2.00: 2006-11-17

New/Changed Functionality

New command: gbsstats

Problems solved

PR VDO: Wrong task was selected with Synergy functionality

Build 2.00: 2006-11-13

New/Changed Functionality

CR VDO: command --h and --help now return status OK
CR PDSL: Do not require SVN-root to be 'trunk'
CR Various: Force full switch functionality in swr, even if root is not changed
CR PDSL: Invert selected line in gbsxref
GBS_APP_* and OPTIONS are now displayed in gbswhich
Obsolete command gbsdosbox removed. Replaced by gbsstart
Various internal cleanup

Problems solved

Repair bug in swr --remove (perl-error)
PR VDO: Solve crash in mm.pm (gbsmakemake) ('cannot open file').
(not reproducible, but I hope this helps)
PR VDO: gbsmaint: Check/Fix GBS Directory Structure: Allow incs_*.gbs files in opt and opt/target
PR VDO: Repair 'uninitialized value' in cleanup of Component bld
PR GBS: Repair 'no default root' in swr
PR PDSL: skiptypes was not properly set at initial swr
PR VDO: gbsedit did not recognize .usr files
PR GBS: 'notify' did not run as a truly detached job under Unix (kept queue slot occupied until removed)
PR PDSL: Fix gbsxref for new gbsmakemake

Build 2.00: 2006-10-11

New/Changed Functionality

--l (logfilename) removed from gbssys* commands
Internal update to prevent unnecessary reads of target.gbs
Env-vars GBS_BUILD, GBS_IS_ADMINISTRATOR and GBS_IS_INTEGRATOR implemented
Non-GBS SubSystems: set cd to subsys directory before executing commands

Problems solved

PR VDO: Cleanup BLD for multiple targets does not work properly
PR VDO: Problems with multisession startup of Synergy (again)

Build 2.00: 2006-10-08

New/Changed Functionality

Subsystems switch.gbs now obsolete and not called anymore
target.gbs: INCLUDE_INC implemented
PR VDO: gbsmakemake must check existence of source files when object-files are included.
gbsmakemake must fail in case of not-existing source-files.
Implement sysgen/makemake_stubs directory to facilitate this
target.gbs: added include-re and comment_re to TYPE

Problems solved

PR VDO: Problems with multisession startup of Synergy
PR VDO: case should be checked when specifying args to sws and swc

Build 2.00: 2005-03-11

New/Changed Functionality

GBS_BASE (gbs_base.ini) now fixed name and location: $HOME/.gbsdb
Env-var GBS_BASE now obsolete.
Selective use of Environment Variables in gbs commands
Documentation now show which Environment Variables are enabled.
qacaudit modified. GBS_QAC_COMMAND and GBS_QACPP_COMMAND now needed.
gbssubgen, gbssubmake and gbssubaudit removed.
Use gbssysgen, gbssysmake or gbssysaudit with single SubSystem name.
fillexport and fillres commands replaced by gbsexport
Copy now dependent on presence of export and/or res/SubSystem directory
log-file names now contain date/time
UNIX scripts are now executed in Bourne-Again-shell enabling easy execution under Linux
SYSGEN.GBS:
The 'steps' part has been moved to a separate file: steps.gbs
The 'target' parts have been moved to target.gbs in the sysgen Target directories
The 'audit' parts have been moved to audit.gbs in the sysgen Audit directories
Format completely changed
Implement GBS_XTITLE tot be able to set the window-text to reflect the GBS currencies
Redesign of the syntax of all .gbs files.
Target-selective scope.
Target-selective glkb.
ALIAS added to STEPS.
In glkb: #include replaced by .include
GBS_PLATFORM
GBS_BG_NOTIFIER
New command gbsedit
gbsexport only executed if bld directory contains current Target directory

Release Notes for GBS 1.00

Build 1.00: 2003-11-07

New/Changed Functionality

New submit mechanism creates .sum file besides the .log file.
Implemented Component-specification in generate, make and audit commands: gbsgen/gbsmake/gbsaudit *:*.*
gbsmakemake now possible for single Component(s)
You can now specify options beginning with '/' in a Windows environment
New command: gbslocate.
Can be used in scripts to locate a file in a set of specified directories
In Unix it must be 'sourced' with dot.
syntax: . gbslocate env_name file prefix prefixdir [ prefixdir ]...
The found file-spec will be placed in the env. variable env_name
Added the opt sub-directory in Component.
To be used to contain flags_type.gbs, ext_includes.gbs and ext_libaries.gbs files local to a Component.
This means that flags_type.gbs files in the Component directories must be moved to Component/opt or Component/opt/target directories!!!
New Manual Page: Generating Code
Here an explanation is given about file-specifications and how compilation-flags and include-paths are handled.
Added standard option --inc file-name to all command-line interfaces.
This 'includes' a file as if the contents was specified on the command-line.
gbsmake has been changed as to generate a list of files to be re-generated and then call gbsgen once.
This gives a significant improvement on the generation performance.
In a ClearCase environment the clearmake option -T ( or -F) must be used in order to let clearmake behave properly.
Removed ClearCase dedication (GBS_CC NEW_VIEW functionality does not work with LSF) and was a pain anyway (implementation-wise)
New Manual Page Customization shows settings for using ClearCase and LSF
LSF and ClearCase functionality must now be combined in GBS_SUBMIT Any SCMS dependency can now only be found in the 'scms.pm' module.
New functionality 'upgrade' in gbsmaint.
Allows upgrade from 0.9 to 1.00 by fixing 'opt' directories, moving flags files from Component directory to 'opt' and removing wildcards from export.gbs files.
Multiple output-file-types can now be specified in sysgen.gbs.
This is done by binding them with '&'.
gbsmakemake will now also cater for multiple targets.
Refer to Sysgen Manual Page for more information.
New command gbsbldaudit
Checks if all src-files were built
New command gbswhich
Shows GBS search-paths and GBS flags and/or
Searches a file using the GBS search-path.
Components in glb/glk files are now checked against scope.
In prompts: Long lists are now split into multiple columns
Added creation of standard target scripts in swr --new and gbsmaint
Replaced qac/qacpp commands by generic gbsaudit/gbssubaudit/gbssysaudit commands.
Added creation of standard audit scripts in gbsmaint: qac and qacpp
Added Audit specific tasks execution in gbsmaint
gbsmaint: Added upgrade for qac and qacpp directories to audit/qac and audit/qacpp
gbsmaint can now be invoked with a single argument denoting the main-menu entry to be executed.
New format and maintenance of owners file.
New owners function: Synchronise file
Standard Target-scripts can now be selected from a 'scripts-repository' when a new Target is created. (and with gbsmaint)
Unix: gnu and standard unix
Win32: DJGPP, Winn32 and Microsoft Visual Studio
Files to be ignored in the src directory can now be specified in sysgen.gbs
The layout of sysgen.gbs: ptype has been changed:
There is now the possibility to specify that absolute paths must be generated for Include paths and Library paths
glk will now interpret a Microsoft .dsp file if it is included with #include
Diff implemented in qac and qacpp.
This allows comparing the current analysis with a previous accepted one.
gbssubaudit and gbssysaudit now accept --files=*.c for selective auditing
Documentation partly converted to HTML
New command: gbshelp
Manual Pages converted to HTML and now accessible via gbshelp
gbsaudit Audit and Summary files are now HTML
qacaudit and qacsum now output HTML
Batch commands now notify the user when ready with a pop-up window also allowing immediate view of logfile.
New non-GBS command fixeol
Changes the line-endings of a file to that of the current Operating System
Allow --i for fillexport, fillres and gbsmakemake
Complete redesign of gbs, swr, sws, swc and swt commands, new commands gbsstart and gbsshow
gbsgen and gbsmake now accept options --fe, --fr and --mm allowing immediate execution of fillexport, fillres and/or makemake
fillexport does not accept wildcards anymore. Allowing wildcards can compromise the consistency of the build. (Not complaining about missing files).
fillexport now also replaces $GBS_BLD_intype in export.gbs files with the proper Target-dependent extension
gbsxref Cross-Reference Utility Implemented

Release Notes for GBS 0.9

Build 0.90: 2003-01-17

New/Changed Functionality

GBS will now stop generation when an error is found.
This is valid for all gbsgen/make commands ('plain', sub and sys)
To prevent stopping the generation the --i (ignore errors) switch must be used.
GBS_SUBMIT Environment Variable introduced to enable LSF functionality.
QAC/QAC++ commands now follow standard GBS-naming convention and functionality.
The following commands were renamed:
qacrun → gbsqac gbsqacpp
qacsub → gbssubqac gbssubqacpp
qacsys → gbssysqac gbssysqacpp
QAC/QAC++ now delivers statistics per File, Component, SubSystem and System.
QAC/QAC++ handling redesigned to run on both Unix and WinNT/2000, separate from 'cadenv' environment.
New Environment Variables:
- GBS_QAC_ROOT location of project personality files
- GBS_QAC_DIR location of qac1 and qac2 commands (default = QAC_HOME)
- GBS_QACPP_ROOT location of project personality files
- GBS_QACPP_DIR location of qac++1 and qac++2 (default = QACPP_HOME)
gmaint renamed to gbsmaint
New functionality in gbsmaint:
a. Cleanup BLD-directories per Target
b. Cleanup QAC directories
c. Cleanup QAC++ directories d. Cleanup TMP directories
ccclean functions now properly implemented in gbscleanup
In sysgen.gbs and in GBS_BLD_src environment-specifiers the '.' must be included in the file-type.
e.g. GBS_BLD_GLK=.lku (instead of GBS_BLD_GLK=lku)
GBS now requires QAC 4.5.1 and QAC++ 1.3.2
Must now specify '-new' instead of 'new' when you want to create a new root, subsys, Component or target.
-remove and -add added to swr command.
'in' and 'out' types in sysgen.gbs must now specify the full type, including the '.'
Argument 4 in the called generation-function in sysgen.gbs now specifies the output- directory (was: output-base name)
Continuus and Visual Source Safe are now supported
New command gbsscm allows generic execution of simple scms commands like mkdir, ci, co.
makemake now counts all errors/warnings and gives only one beep at the end.

Problems solved

GBS_TARGET=... in a GBS-command now works properly
'ALWAYS' rules not generated in makemake for missing files

Generic Build Support (GBS) - User Manual - GBS Release Notes - Release 2

release_notes_2.html