gno/usr.bin/setvers/setvers.1

130 lines
2.7 KiB
Groff

.TH SETVERS 1 "15 May 1993" GNO "Commands and Applications"
.SH NAME
.LP
.B setvers
\- store version number and strings in rVersion format in the specified
executable file.
.SH SYNOPSIS
.LP
.B setvers
.B file
.RB "'" string1 "~" string2 "'"
.RB "[" country "]"
.RB "v" majrev "." minrev "." bugrev
.SH DESCRIPTION
.LP
.B setvers
is a program which adds an rVersion resource to the specified
.BR file "."
The rVersion format allows for two strings of up to 255 characters, although
it is suggested that for this use you keep each field shorter than 80
characters.
.B string1
is seperated from
.B string2
by a
.B ^
character, and the both strings should be enclosed in single quotes.
.B string1
is required to be the name of the program. Any `_'
character in string2 will be interpreted as a carriage return. When
using GNO, make sure to quote the single quotes with backslashes.
.LP
The optional field
.B country
(no spaces allowed) allows you to set the country field of the rVersion
resource. The last parameter is the current revision number of the
program in the format
.BR majrev "." minrev "." bugrev ","
where
.B majrev
is a single or double digit number from 00 to 99, and
.B minrev
and
.B bugrev
are single digit numbers from zero to nine.
.LP
To print the version information stored by
.B setvers
you can use the companion shell utilities
.BR getvers " or"
.BR gv "."
.SH COUNTRIES
.LP
.nf
Valid Countries/Regions:
(case IS sensitive)
UnitedStates
France
Britian
Germany
Italy
Netherlands
Belgium/Luxembourg
Sweden
Spain
Denmark
Portugal
FrenchCanadian
Norway
Isreal
Japan
Australia
Arabia
Finland
FrenchSwiss
GermanSwiss
Greece
Iceland
Malta
Cyprus
Turkey
Bosnia/Herzegovena
Ireland
Korea
China
Taiwan
Thailand
.SH EXAMPLES
.LP
.nf
o Set the version of program `chmod' to read:
chmod v01.0.0
James Brookes
jamesb@cscihp.ecst.csuchico.edu
Country: United States
in Orca:
# setvers chmod 'chmod^James Brookes_jamesb@cscihp.ecst.csuchico.edu'
v01.0.0
in GNO:
% setvers chmod \\'chmod^James Brookes_jamesb@cscihp.ecst.csuchico.edu\\'
v01.0.0
.fi
.SH CAVEATS
.LP
If an rVersion resource already exists, it will be overwritten and replaced
with the new one. Other resources will be unaffected.
.SH BUGS
.LP
See
.B getvers.1
.SH SEE ALSO
.LP
.BR getvers "(1)"
.BR gv "(1)"
.SH AUTHOR
.LP
.nf
Ian Schmidt, Two Meg Software
internet irsman@iastate.edu
BITNET twbv4@isuvax
AOL IRSMan
.fi