mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-06-25 14:29:34 +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
parent
63160f6291
commit
e846cb8f9a
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
|
||||
Loading…
Reference in New Issue
Block a user