From f00cfed6bafbb6ff16800a09e7728a8d05c363bf Mon Sep 17 00:00:00 2001 From: tribby Date: Wed, 29 Apr 1998 00:45:05 +0000 Subject: [PATCH] Documentation files for setvers. Not yet modified. --- usr.bin/setvers/README.setvers | 52 +++++++++++++ usr.bin/setvers/setvers.1 | 129 +++++++++++++++++++++++++++++++++ 2 files changed, 181 insertions(+) create mode 100644 usr.bin/setvers/README.setvers create mode 100644 usr.bin/setvers/setvers.1 diff --git a/usr.bin/setvers/README.setvers b/usr.bin/setvers/README.setvers new file mode 100644 index 0000000..5509553 --- /dev/null +++ b/usr.bin/setvers/README.setvers @@ -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 diff --git a/usr.bin/setvers/setvers.1 b/usr.bin/setvers/setvers.1 new file mode 100644 index 0000000..b62651d --- /dev/null +++ b/usr.bin/setvers/setvers.1 @@ -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