mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-05-29 02:41:28 +00:00
Documentation files for setvers. Not yet modified.
This commit is contained in:
parent
d36d59e158
commit
f00cfed6ba
52
usr.bin/setvers/README.setvers
Normal file
52
usr.bin/setvers/README.setvers
Normal file
|
@ -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
|
129
usr.bin/setvers/setvers.1
Normal file
129
usr.bin/setvers/setvers.1
Normal file
|
@ -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
Block a user