mirror of
https://github.com/GnoConsortium/gno.git
synced 2025-08-09 13:25:21 +00:00
Initial checkin. Unfortunately, the getvers/setvers sources are still
missing; only the manual pages and README files are here.
This commit is contained in:
gdr-ftp
55
usr.bin/getvers/README.getvers
Normal file
55
usr.bin/getvers/README.getvers
Normal file
@@ -0,0 +1,55 @@
|
|||||||
|
=============
|
||||||
|
GetVers v1.20
|
||||||
|
=============
|
||||||
|
|
||||||
|
Another quality Two Meg Software shell utility by Ian Schmidt.
|
||||||
|
Copyright (c) 1993 Two Meg Software.
|
||||||
|
All Rights Reserved.
|
||||||
|
|
||||||
|
Like most Two Meg shell utilities, this one's in 100% assembly for minimum size
|
||||||
|
and maximum speed.
|
||||||
|
|
||||||
|
GetVers is the companion for the 'SetVers' utility. Given a filename or
|
||||||
|
list of filenames, it prints out the version information for each one.
|
||||||
|
|
||||||
|
*New and Improved!*
|
||||||
|
|
||||||
|
GetVers 1.20 now uses System 6.0's VersionString call so it can correctly
|
||||||
|
report versions for all valid rVersion resources.
|
||||||
|
|
||||||
|
GetVers 1.20 also now includes a stack/DP segment of 384 bytes; quite a step
|
||||||
|
down from the default 4k.
|
||||||
|
|
||||||
|
GetVers v1.10 now can accept a list of filenames or pathnames to print version
|
||||||
|
information for. This means GNO and TMSH users can use the * and other regexp
|
||||||
|
operators to create version reports for a whole list of files (sorry, wildcards
|
||||||
|
the Orca way is too much of a pain in the butt :)
|
||||||
|
|
||||||
|
Usage
|
||||||
|
-----
|
||||||
|
|
||||||
|
getvers file1 [file2 file3...filen]
|
||||||
|
|
||||||
|
GetVers will print a usage message if called with no arguments. Otherwise it
|
||||||
|
processes all the arguments and generates a version printout for each one.
|
||||||
|
|
||||||
|
No flags are defined in GetVers 1.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 "Missed Manners" Deatherage, and
|
||||||
|
David "Mr Tangent" Lyons. Also Jawaid `zaB' Bazyar and James `Abe' Brookes.
|
||||||
|
|
||||||
|
Author
|
||||||
|
------
|
||||||
|
|
||||||
|
Ian Schmidt, Two Meg Software
|
||||||
|
|
||||||
|
irsman@iastate.edu
|
||||||
|
irsman@aol.com
|
||||||
|
twbv4@isuvax.bitnet
|
||||||
45
usr.bin/getvers/README.gv
Normal file
45
usr.bin/getvers/README.gv
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
========
|
||||||
|
GV v1.00
|
||||||
|
========
|
||||||
|
|
||||||
|
Another quality Two Meg Software shell utility by Ian Schmidt.
|
||||||
|
Copyright (c) 1993 Two Meg Software.
|
||||||
|
All Rights Reserved.
|
||||||
|
|
||||||
|
GV is written in Orca/C, which means the Byte Works gets this plug:
|
||||||
|
"This software contains material from the Orca/C Run-Time Libraries, copyright
|
||||||
|
1987-1989 by Byte Works, Inc. Used with permission."
|
||||||
|
|
||||||
|
GV is the micro companion for the 'SetVers' utility. Given a filename or
|
||||||
|
list of filenames, it prints out just the version information for each one.
|
||||||
|
This is especially handy for checking versions of your entire GNO /bin/
|
||||||
|
directory.
|
||||||
|
|
||||||
|
Usage
|
||||||
|
-----
|
||||||
|
|
||||||
|
gv file1 [file2 file3...filen]
|
||||||
|
|
||||||
|
GV will print a usage message if called with no arguments. Otherwise it
|
||||||
|
processes all the arguments and generates a version printout for each one.
|
||||||
|
|
||||||
|
No flags are defined in GV 1.0.
|
||||||
|
|
||||||
|
Bugs
|
||||||
|
----
|
||||||
|
If a file's rVersion or resource fork is damaged, unpredictable results may
|
||||||
|
occur.
|
||||||
|
|
||||||
|
Big Thanks To
|
||||||
|
-------------
|
||||||
|
The Apple Brigade: Jim "Huh?" Murphy, Matt "Missed Manners" Deatherage, and
|
||||||
|
David "Mr Tangent" Lyons. Also Jawaid `zaB' Bazyar and James `Abe' Brookes.
|
||||||
|
|
||||||
|
Author
|
||||||
|
------
|
||||||
|
|
||||||
|
Ian Schmidt, Two Meg Software
|
||||||
|
|
||||||
|
irsman@iastate.edu
|
||||||
|
irsman@aol.com
|
||||||
|
twbv4@isuvax.bitnet
|
||||||
52
usr.bin/getvers/README.setvers
Normal file
52
usr.bin/getvers/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
|
||||||
40
usr.bin/getvers/getvers.1
Normal file
40
usr.bin/getvers/getvers.1
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
.TH VERSION 1
|
||||||
|
.SH NAME
|
||||||
|
.LP
|
||||||
|
.B getvers
|
||||||
|
\- get version number and information stored in rVersion format from
|
||||||
|
specified executable file
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.LP
|
||||||
|
.BR getvers " < file1 file2 ...filen >"
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B getvers
|
||||||
|
is a program which accepts as input the name(s) of file(s)
|
||||||
|
and print the version information stored in the rVersion resource of
|
||||||
|
the file(s). If no rVersion resource is present it will print with the error
|
||||||
|
`This file has no version resource' and continue processing other filenames
|
||||||
|
provided as input.
|
||||||
|
.LP
|
||||||
|
To add information to the rVersion resource, you can use the companion
|
||||||
|
shell utility
|
||||||
|
.BR setvers "."
|
||||||
|
.LP
|
||||||
|
You can use the companion shell utility
|
||||||
|
.BR gv " to list versions in a more compact form."
|
||||||
|
.SH BUGS
|
||||||
|
.LP
|
||||||
|
Little crawly things, also known as insects.
|
||||||
|
.SH SEE ALSO
|
||||||
|
.LP
|
||||||
|
.BR setvers "(1)"
|
||||||
|
.BR gv "(1)"
|
||||||
|
.SH AUTHOR
|
||||||
|
.LP
|
||||||
|
.nf
|
||||||
|
Ian Schmidt, Two Meg Software
|
||||||
|
|
||||||
|
internet irsman@iastate.edu
|
||||||
|
BITNET twbv4@isuvax
|
||||||
|
AOL IRSMan
|
||||||
|
.fi
|
||||||
40
usr.bin/getvers/gv.1
Normal file
40
usr.bin/getvers/gv.1
Normal file
@@ -0,0 +1,40 @@
|
|||||||
|
.TH VERSION 1
|
||||||
|
.SH NAME
|
||||||
|
.LP
|
||||||
|
.B gv
|
||||||
|
\- get version number and information stored in rVersion format from
|
||||||
|
specified executable file and print in shorter format.
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.LP
|
||||||
|
.BR gv " < file1 file2 ...filen >"
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.LP
|
||||||
|
.B gv
|
||||||
|
is a program which accepts as input the name(s) of any number of file(s)
|
||||||
|
and print only the version number stored in the rVersion resource of
|
||||||
|
the file(s). If no rVersion resource is present it will print the error
|
||||||
|
`The file <filename> has no version resource' and process any remaining files.
|
||||||
|
.LP
|
||||||
|
To add information to the rVersion resource, you can use the companion
|
||||||
|
shell utility
|
||||||
|
.BR setvers "."
|
||||||
|
.LP
|
||||||
|
You can use the companion shell utility
|
||||||
|
.BR getvers " to list versions in a more complete form."
|
||||||
|
.SH BUGS
|
||||||
|
.LP
|
||||||
|
Unpredictable results may occur if a file's rVersion resource is damaged.
|
||||||
|
Other exception cases should be correctly handled.
|
||||||
|
.SH SEE ALSO
|
||||||
|
.LP
|
||||||
|
.BR setvers "(1)"
|
||||||
|
.BR getvers "(1)"
|
||||||
|
.SH AUTHOR
|
||||||
|
.LP
|
||||||
|
.nf
|
||||||
|
Ian Schmidt, Two Meg Software
|
||||||
|
|
||||||
|
internet irsman@iastate.edu
|
||||||
|
BITNET twbv4@isuvax
|
||||||
|
AOL IRSMan
|
||||||
|
.fi
|
||||||
129
usr.bin/getvers/setvers.1
Normal file
129
usr.bin/getvers/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
|
||||||
Reference in New Issue
Block a user