mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-11-18 19:09:31 +00:00
130 lines
2.6 KiB
Groff
130 lines
2.6 KiB
Groff
.TH SETVERS 1
|
|
.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
|