SHAPE_STDRUL(7) Miscellaneous Information Manual SHAPE_STDRUL(7)
NAME
shape stdrul - shapeTools RMS general version selection rules
DESCRIPTION
The shape release management system requires a set of standard version selection rules to be accessible project wide. These are defined in
the stdrules file, which is to be included into the Shapefiles of any part of the system controlled by the shapeTools release management
system. Version selection rules drive the binding of component names in the Shapefile to specific versions during a build or release
process (or better: any process performed by invocation of shape(1) ). Some functions of shape_RMS allow definition of the version binding
rule being active by defining the VERSIONS macro on the command line. This may be set to any of the rule names listed below.
If you want to introduce new version selection rules for project wide use, you may add them to the stdrules file. You should be very care-
ful, when altering this file. Do not remove any of the rules defined in the original version of stdrules (as it comes from the shapeTools
distribution tape) because these are essential for the release management system. When altering one of the original selection rules, you
should be very concious of what you are doing, as you may affect the operationality of shape RMS. For a description of the syntax of rule
definitions, see the shape(1) manual.
The standard version selection rules are:
most_recent
For each component select a busy version if available, the most recent saved version otherwise.
last_proposed
Use the last proposed version of each component. This rule fails, if no proposed version is available
last_released
Select versions from the last generated release.
last_prereleased
Select versions from the last generated prerelease.
recent_release
Select versions included in the last release or prerelease, whichever is newer.
from_release
Select versions from a specific release or prerelease. When using this rule the value of the macro RELEASENAME has to be set to
the name of the desired (pre)release.
extern Always select a busy version (a regular UNIX file). This rule should be applied to all extern components that are not under con-
trol of the shapeTools version control system.
FILES
$(SHAPELIBPATH)/stdrules
SEE ALSO
shape_RMS(1), shape(1)
7.8.119 SHAPE_STDRUL(7)