mirror of https://github.com/GnoConsortium/gno.git
Documentation files for setvers. Not yet modified.
This commit is contained in:
tribby
parent
d36d59e158
commit
f00cfed6ba
|
|
@ -0,0 +1,52 @@
|
|||
==============
|
||||
SetVers v1.0.2
|
||||
==============
|
||||
|
||||
Another quality Two Meg Software shell utility by Ian Schmidt.
|
||||
Copyright (c) 1993 Two Meg Software.
|
||||
All Rights Reserved.
|
||||
|
||||
Like all Two Meg shell utilities, this one's in 100% assembly for minimum size
|
||||
and maximum speed. Just Say GNO to Orca/C code bloat!
|
||||
|
||||
SetVers is the companion for the 'GetVers' utility. Given a filename and some
|
||||
information, it creates and attaches a version resource to the file.
|
||||
|
||||
*New and Improved!*
|
||||
|
||||
SetVers 1.0.2 now correctly sets the stage byte; there's a bug in TN #076 wrt
|
||||
the stage byte, but I was able to figure out the correct value and fix SetVers.
|
||||
This means that SetVers created versions no longer show up as x.y.zf0 in
|
||||
Finder or GetVers 1.2 or later.
|
||||
|
||||
SetVers 1.0.2 also now includes a stack/DP segment of 384 bytes; quite a step
|
||||
down from the default 4k.
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
setvers filename 'ProgName^ProgInfo' [country] vXX.Y.Z
|
||||
|
||||
SetVers will print a usage message if called with no arguments or incorrect
|
||||
arguments.
|
||||
|
||||
No flags are defined in SetVers 1.0.2.
|
||||
|
||||
Bugs
|
||||
----
|
||||
Console output under GNO 1.0 is screwed up. This is a GNO bug; GNO 1.1
|
||||
solves this.
|
||||
|
||||
Big Thanks To
|
||||
-------------
|
||||
The Apple Brigade: Jim "Huh?" Murphy, Matt "DTS" Deatherage, and Dave "A" Lyons
|
||||
Jawaid `zaB' Bazyar and James `Abe' Brookes.
|
||||
|
||||
Author
|
||||
------
|
||||
|
||||
Ian Schmidt, Two Meg Software
|
||||
|
||||
irsman@iastate.edu
|
||||
irsman@aol.com
|
||||
twbv4@isuvax.bitnet
|
||||
|
|
@ -0,0 +1,129 @@
|
|||
.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
|
||||
Loading…
Reference in New Issue