vers_string.1   [plain text]

.TH VERS_STRING 1 "5 July 1987"
vers_string \- produce version identification string
.B vers_string
.B \-[c | f | l]
.I Vers_string
outputs a string made up of the SGS version name, the current user's
login identifier, and the current time and date.
.I Vers_string
may only be used within an SGS project.
The output of vers_string has the following format:
\fBPROGRAM:\fIprog\fB  PROJECT:\fIproj&vers \fB DEVELOPER:\fIbob\fB  BUILT:\fIThu Dec 31 ...\fR
.I prog
is the command line argument \fIPROGRAM\fR, \fIproj&vers\fR is the
name of the SGS version root, and \fIbob\fR is the user who built this version.
If the
.I \-c
option is used, the output is formed as a C declaration for the
global character array
If the
.I \-l
option is used, the output is formed like the -c option, but
"PROGRAM" is replaced with "LIBRARY" and the declaration is static.
If the
.I \-f
option is used, the output is simply the program name and suffixed
with the current version number of the SGS version root.
.I Vers_string
is typically used within makefiles with a rule like:
vers.c: ${OBJS}
	vers_string -c ${PROGRAM} >vers.c