Apple-2gs-SW/gno
1
0
Fork 0
mirror of https://github.com/GnoConsortium/gno.git synced 2025-02-07 02:30:56 +00:00
Code Issues Projects Releases Wiki Activity

Initial checkin. Unfortunately, the getvers/setvers sources are still

Browse Source 
missing; only the manual pages and README files are here.
This commit is contained in:
gdr-ftp 1998-03-11 02:58:52 +00:00
parent 63160f6291
commit e846cb8f9a
6 changed files with 361 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
usr.bin/getvers/README.getvers Normal file
View 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
View 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
View 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
View 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
View 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
View 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