.ig
 Copyright (C) 1993,1994 by the author(s).
 
 This software is published in the hope that it will be useful, but
 WITHOUT ANY WARRANTY for any part of this software to work correctly
 or as described in the manuals. See the ShapeTools Public License
 for details.

 Permission is granted to use, copy, modify, or distribute any part of
 this software but only under the conditions described in the ShapeTools 
 Public License. A copy of this license is supposed to have been given
 to you along with ShapeTools in a file named LICENSE. Among other
 things, this copyright notice and the Public License must be
 preserved on all copies.


Author: Andreas Lampen (Andreas.Lampen@cs.tu-berlin.de)

$Header: shape_stdrul.7[6.0] Fri Jun 25 17:01:51 1993 andy@cs.tu-berlin.de frozen $
..
.TH "SHAPE_STDRUL" 7 "" \n(dy.\n(mo.\n(yr
.SH NAME
shape_stdrul \- shapeTools RMS general version selection rules
.SH DESCRIPTION
The shape release management system requires a set of standard version
selection rules to be accessible project wide. These are defined in
the \fIstdrules\fP 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.
.PP
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
careful, 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.
.PP
The standard version selection rules are:
.IP most_recent 1i
For each component select a busy version if available, the most
recent saved version otherwise.
.IP last_proposed
Use the last proposed version of each component. This rule fails, if
no proposed version is available
.IP last_released
Select versions from the last generated release.
.IP last_prereleased
Select versions from the last generated prerelease.
.IP recent_release
Select versions included in the last release or prerelease, whichever
is newer.
.IP from_release
Select versions from a specific release or prerelease.
When using this rule the value of the macro \fIRELEASENAME\fP has to
be set to the name of the desired (pre)release.
.IP extern
Always select a busy version (a regular UNIX file). This rule should
be applied to all extern components that are not under control of the
shapeTools version control system.
.SH FILES
$(SHAPELIBPATH)/stdrules
.SH SEE ALSO
shape_RMS(1), shape(1)