From 51b2bbcf924043b0c13ff4d15a68376af2c5a83d Mon Sep 17 00:00:00 2001 From: gdr Date: Sat, 17 Jan 1998 07:20:07 +0000 Subject: [PATCH] v1.0.5 January 1998 Increased the number of characters in the name field of the nameEntry struct from 34 to 36. This gives an 8-byte alignment to the offset entry, which provides binary compatibility of the precompiled database file between the IIgs and little-endian 32-bit machines such as Linux boxes. *** THIS MEANS THAT THE PRECOMPILED DATABASE IS NO LONGER BINARY COMPATIBLE WITH EARLIER VERSIONS. Updated descu so that the "Last Updated" line in the describe source "header" is updated to reflect the current date and time (GMT, if supported). Fixed a bug in descu that caused the "header" to be slowly eaten, one character at a time. The describe database source file is no longer part of this archive. It is available separately from the url, above. Added a "Known Bugs" section and URLs on where to find the online database to this README. Modified the installation instructions a bit. --- usr.orca.bin/describe/README | 79 +- usr.orca.bin/describe/desc.h | 9 +- usr.orca.bin/describe/descc.8 | 8 +- usr.orca.bin/describe/descc.c | 6 +- usr.orca.bin/describe/descc.rez | 4 +- usr.orca.bin/describe/describe.1 | 4 +- usr.orca.bin/describe/describe.rez | 6 +- usr.orca.bin/describe/describe.source | 1056 ------------------------- usr.orca.bin/describe/descu.8 | 4 +- usr.orca.bin/describe/descu.c | 4 +- usr.orca.bin/describe/descu.rez | 6 +- 11 files changed, 95 insertions(+), 1091 deletions(-) delete mode 100644 usr.orca.bin/describe/describe.source diff --git a/usr.orca.bin/describe/README b/usr.orca.bin/describe/README index 41a3ecb..99ae0e1 100644 --- a/usr.orca.bin/describe/README +++ b/usr.orca.bin/describe/README @@ -1,4 +1,4 @@ -$Id: README,v 1.6 1997/12/22 00:34:51 gdr Exp $ +$Id: README,v 1.7 1998/01/17 07:20:06 gdr Exp $ This is the README file for the describe package. This package is designated as version 1.0.5, and consists of the following utilities: @@ -10,6 +10,11 @@ designated as version 1.0.5, and consists of the following utilities: descu - the describe source updater +** NOTE ** The describe database itself is now shipped as a + separate file. You can find the most recent version + of the database at the URLs mentioned in the installation + section. + ABOUT DESCRIBE AND DESCC ======================== @@ -75,29 +80,79 @@ You can either type "dmake install", or do the following: rm /usr/local/bin/descc rm /usr/local/bin/describe -You will also want to do the following, which is NOT done by dmake's -install target: - +After you have done this, type the command rehash - /usr/sbin/descc ./describe.src +so that gsh will be able to locate the new utilities. -Note that the describe database source file (describe.src) included in -this archive is almost certainly out-of-date. The most recent version -of this file can be obtained online at: +Next, you will need a current copy of the describe database. As of +version 1.0.5, the database is no longer included with the describe +sources. Instead, you can get it from one of the following URLs: + ftp://ftp.gno.org/pub/apple2/gs.specific/gno/doc/desc.src.shk + ftp://ftp.gno.org/pub/apple2/gs.specific/gno/doc/desc.db.shk + http://www.gno/org/~gno/describe http://www.arrowweb.com/sbehrens/describe.htm -If the above url is unreachable, check the GNO FAQ for a new location. +The desc.src.shk file contains the describe database "source" file. +The desc.db.shk file contains a "precompiled" database. + +If you downloaded the precompiled database archive, then you can extract +the contained file, "describe.db", and place it directly in /usr/lib. +If you select another location, you will have to set your DESC_DB +environment variable. See the describe(1) man page. If you did +this step, then you can skip extraction and compilation of the database +source. + +If you downloaded the database source archive (desc.src.shk), it will +extract to a file called "describe.source". You can place this file +anywhere, but the recommended location is in /usr/lib. Next, issue +the following command: + /usr/sbin/descc /usr/lib/describe.source +This will create the file /usr/lib/describe.db. + +You should periodically download a new copy of the database. The +date the database was updated is visible in the first few lines +of the describe.source file. + +If you have submissions for the database, the web pages mentioned above +contain directions on how to do the submission. + +KNOWN BUGS +========== + +The describe.source file must be sorted (keyed on the "Name" field, +case insensitive) when being compiled by descc. Failure to ensure +this will result describe failing to find certain entries, even if +they belong in the database. Using the descu program to update the +database source ensures that the source is properly sorted. CHANGES ======= This details changes to the entire distribution. -v1.0.5 December 1997 +v1.0.5 January 1998 + Increased the number of characters in the name field of the + nameEntry struct from 34 to 36. This gives an 8-byte + alignment to the offset entry, which provides binary + compatibility of the precompiled database file between + the IIgs and little-endian 32-bit machines such as + Linux boxes. + + *** THIS MEANS THAT THE PRECOMPILED DATABASE IS NO LONGER + BINARY COMPATIBLE WITH EARLIER VERSIONS. + Updated descu so that the "Last Updated" line in the describe - source "header" is updated to reflect the current date and - time (GMT, if supported). + source "header" is updated to reflect the current date + and time (GMT, if supported). + Fixed a bug in descu that caused the "header" to be slowly eaten, + one character at a time. + The describe database source file is no longer part of this + archive. It is available separately from the url, + above. + Added a "Known Bugs" section and URLs on where to find the + online database to this README. Modified the installation + instructions a bit. v1.0.4 September 1997 This package is now part of the base GNO distribution. diff --git a/usr.orca.bin/describe/desc.h b/usr.orca.bin/describe/desc.h index d9f7395..12f4f87 100644 --- a/usr.orca.bin/describe/desc.h +++ b/usr.orca.bin/describe/desc.h @@ -2,17 +2,20 @@ * Header file for the describe package. This file is * used by describe(1), descc(8), and descu(8). * - * $Id: desc.h,v 1.5 1997/12/22 00:34:52 gdr Exp $ + * $Id: desc.h,v 1.6 1998/01/17 07:20:06 gdr Exp $ */ -/* Keep these utilities in lockstep. */ +/* + * Keep these utilities in lockstep. Don't forget to change the version + * number in the *.rez files and in the manual pages. + */ #define _VERSION_ "v1.0.5" #define QUOTE_CHAR '#' #define DATABASE "/usr/lib/describe.db" #define FIELD_LEN 9 -#define NAME_LEN 34 +#define NAME_LEN 36 #define MAX_LINE_LENGTH 81 #define FIELD_COUNT 7 /* number of fields below, not including comments */ diff --git a/usr.orca.bin/describe/descc.8 b/usr.orca.bin/describe/descc.8 index 8da2a72..1ab8001 100644 --- a/usr.orca.bin/describe/descc.8 +++ b/usr.orca.bin/describe/descc.8 @@ -1,5 +1,5 @@ .\" -.\" $Id: descc.8,v 1.5 1997/10/30 04:19:10 gdr Exp $ +.\" $Id: descc.8,v 1.6 1998/01/17 07:20:07 gdr Exp $ .\" .TH DESCC 8 "22 September 1997" GNO "System Administration" .SH NAME @@ -13,7 +13,7 @@ descc \- the describe(1) source compiler .SH DESCRIPTION This manual page documents .BR descc -version 1.0.4. +version 1.0.5. .LP .BR descc compiles the describe source file @@ -55,7 +55,7 @@ a complete record: .nf Name: describe -Version: 1.0.4 +Version: 1.0.5 Shell: GNO, ORCA/Shell Author: James Brookes Contact: jamesb@ecst.csuchico.edu @@ -82,7 +82,7 @@ in the following format: 2 bytes: Short Int, number of \fBName Entries\fR Name Entries - 34 bytes: NULL-terminated string; name of the utility. + 36 bytes: NULL-terminated string; name of the utility. 4 bytes: Long Int, offset of the \fBrecord\fR in file. Records diff --git a/usr.orca.bin/describe/descc.c b/usr.orca.bin/describe/descc.c index 9c8d790..7b0d6f0 100644 --- a/usr.orca.bin/describe/descc.c +++ b/usr.orca.bin/describe/descc.c @@ -1,7 +1,9 @@ /* */ /* descc - compile info file into describe database file */ /* */ -/* $Id: descc.c,v 1.5 1997/09/24 06:34:58 gdr Exp $ */ +/* $Id: descc.c,v 1.6 1998/01/17 07:20:07 gdr Exp $ */ +/* */ +/* v1.0.5 and later - see the README file for a list of changes. */ /* */ /* v1.0.4 - Changed location of database. Describe is now */ /* part of the base GNO distribution. Version numbers */ @@ -36,7 +38,7 @@ /* */ /* Name Entries */ /* */ -/* 34 bytes: Null-terminated string; name of utility */ +/* 36 bytes: Null-terminated string; name of utility */ /* 4 bytes: Long Int, offset of record in file. */ /* */ /* Records */ diff --git a/usr.orca.bin/describe/descc.rez b/usr.orca.bin/describe/descc.rez index 8fa6eb0..d9fdd59 100644 --- a/usr.orca.bin/describe/descc.rez +++ b/usr.orca.bin/describe/descc.rez @@ -1,7 +1,7 @@ /* * Resources for version and comment * - * $Id: descc.rez,v 1.1 1997/09/24 06:34:58 gdr Exp $ + * $Id: descc.rez,v 1.2 1998/01/17 07:20:07 gdr Exp $ */ #include "Types.rez" @@ -14,7 +14,7 @@ * Version */ resource rVersion (1, purgeable3) { - { 1, 0, 4, /* Version 1.0.4 */ + { 1, 0, 5, /* Version 1.0.5 */ release, /* development|alpha|beta|final|release */ 0 }, /* non-final release number */ verUS, /* Country */ diff --git a/usr.orca.bin/describe/describe.1 b/usr.orca.bin/describe/describe.1 index 4526ab9..b8e08ff 100644 --- a/usr.orca.bin/describe/describe.1 +++ b/usr.orca.bin/describe/describe.1 @@ -1,5 +1,5 @@ .\" -.\" $Id: describe.1,v 1.5 1997/10/30 04:19:10 gdr Exp $ +.\" $Id: describe.1,v 1.6 1998/01/17 07:20:07 gdr Exp $ .\" .TH DESCRIBE 1 "22 September 1997" GNO "Commands and Applications" .SH NAME @@ -13,7 +13,7 @@ describe \- show information about a program .SH DESCRIPTION This manual page documents .BR describe -version 1.0.4. +version 1.0.5. .LP .BR describe will show current information about diff --git a/usr.orca.bin/describe/describe.rez b/usr.orca.bin/describe/describe.rez index f41f637..3f9b5cd 100644 --- a/usr.orca.bin/describe/describe.rez +++ b/usr.orca.bin/describe/describe.rez @@ -1,7 +1,7 @@ /* * Resources for version and comment * - * $Id: describe.rez,v 1.1 1997/09/24 06:34:58 gdr Exp $ + * $Id: describe.rez,v 1.2 1998/01/17 07:20:07 gdr Exp $ */ #include "Types.rez" @@ -14,7 +14,7 @@ * Version */ resource rVersion (1, purgeable3) { - { 1, 0, 4, /* Version 1.0.4 */ + { 1, 0, 5, /* Version 1.0.5 */ release, /* development|alpha|beta|final|release */ 0 }, /* non-final release number */ verUS, /* Country */ @@ -26,7 +26,7 @@ resource rVersion (1, purgeable3) { * Comment */ resource rComment (1, purgeable3) { - PROG " v1.0.4\n" + PROG " v1.0.5\n" DESC " (GNO) \n" AUTHOR }; diff --git a/usr.orca.bin/describe/describe.source b/usr.orca.bin/describe/describe.source deleted file mode 100644 index c46ddaf..0000000 --- a/usr.orca.bin/describe/describe.source +++ /dev/null @@ -1,1056 +0,0 @@ -#============================================================================= -# List of shell applications for GNO/ME and ORCA/Shell -# Last revision: 28 Jan 96 -#============================================================================= -# -# About this file -# ~~~~~~~~~~~~~~~ -# This file is in human readable form, but is intended to be compiled with -# the program 'descc' into the 'describe' database. Just type 'descc -# ', where is the name you saved this file to, and -# descc will compile the file into the file /usr/local/lib/describe, or -# alternatively into a file named 'describe' in the path given by the -# environment variable DESCDB. Make sure the path that DESCDB points to -# or /usr/local/lib exist first! Information may be later culled from the -# file with the command 'describe '. -# -# While this file may be updated manually, new entries and updates may -# also be merged through the use of 'descu'. -# -# This file is sorted lexicographically, ignoring case, based on the -# Name field. -# -# Online home of describe -# ~~~~~~~~~~~~~~~~~~~~~~~ -# http://webzone1.co.uk/www/thesonkpage/describe.htm -# ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ -# -# Updates and corrections may be submitted through the web page, -# or sent by email to sbehrens@contech.demon.co.uk. -# -# To obtain the version number of a file: -# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -# A) use the shell program `getvers', -# B) any usage or -v/V flag supplied by the utility author -# -# -# NB: "Author" may mean who is maintaing the current port, and may not -# actually mean the original author of the program. -#============================================================================== - -Name: apropos -Version: 3.0 (24 Jul 95) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.com -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Locate commands by keyword. Bundled with catman, makewhatis, man, -and whatis in the manpack30.shk archive. - -Name: argv0 -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Emulates UNIX argv0 (manipulate argv array passed to programs). Runs -shell scripts with #!/... syntax. Runs s16 programs with arguments. - -Name: aw30 -Version: 1.0 -Shell: GNO/ME -Author: Robert Hill -Contact: rhill@eecs.ukans.edu -Where: /usr/local/bin -FTP: ... - - Formats AppleWorks (Classic) Word Processor files for display. Handles -most options--including underline, boldface, margins, centering--on all -terminal types. - -Name: awk -Version: 1.0 -Shell: GNO/ME -Author: Ported by Jawaid Bazyar -Contact: bazyar@netcom.com -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - - A port of AT&T's AWK string processing language. - -Name: bc -Version: 1.01 -Shell: GNO/ME -Author: Frank Petroski -Contact: -Where: /usr/bin -FTP: ftp.cco.caltech.edu - -GNU bc is an arbitrary precision numeric processing language. Syntax is -similar to C, but differs in many substantial areas. It supports -interactive execution of statements. bc is a utility included in the -POSIX P1003.2/D11 draft standard. Copyright Free Software Foundation. - -Name: bed -Version: 1.1.1 -Shell: GNO/ME -Author: Phil Vandry -Contact: vandry@cam.org -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - -A binary editor that can handle "infinitely" long lines and null bytes -in the file. Intended for editing binary files. - -Name: binprint -Version: 1.2 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: - - Prints a hex dump of files or standard in - -Name: bison -Version: 1.19 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/source/ - - A port of the FSF's yacc replacement. bison is part of the GNU project. -yacc is a parser generator (also known as "compiler compiler"). - -Name: booz -Version: 2.01 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils - - Unpacks files that were packed with Zoo 2.1 or earlier. - -Name: cal -Version: x -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: - - Prints a calendar for the current month or any month. - -Name: calls -Version: 2.0 (16 Dec 93) -Shell: GNO/ME -Author: Ported by Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - A call chart generator, to show the sequence and calling dependancies of -functions within a program. It's more flexible than Orca shell version. -Requires cpp. - -Name: catman -Version: 1.0 (24 Jul 95) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.com -Where: /usr/sbin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Preformat manual reference pages. Bundled with apropos, -makewhatis, man, and whatis in the manpack30.shk archive. - -Name: cclean -Version: 1.02 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: Part of occ package - - For use with occ. Remove the lines ccprep put into a source file from that -source file. Part of the occ 1.12 distribution. - -Name: ccprep -Version: 1.1 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: Part of occ package - - For use with occ. Puts a "#line 2" statement into source files to -get around problems with occ 1.12 and ORCA/C 2.03. - -Name: chat -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Sends strings and waits for strings. Used to send modem commands and wait -for replies, etc.. - -Name: chmod -Version: 2.1 -Shell: GNO/ME -Author: Leslie M. Barstow III -Contact: wdphoenix@delphi.com -Where: /bin -FTP: grind.isca.uiowa.edu - - chmod allows you to change the permissions on a file. This is an -enhanced version which allows you to change options ala UNIX or using -the Apple specific flags (UNIX values are translated into Apple -equivalents). - -Name: copycat -Version: 1.4.1 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/bin -FTP: ... - - copycat copies data bidirectionally between the two named ttys. It -can be used as a simple dumb terminal program. - -Name: cron -Version: x -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/sbin -FTP: ... - - Runs certain processes at certain times. cron is started by init. - -Name: cu -Version: 1.0 -Shell: GNO/ME -Author: Dave J. Roberts -Contact: daver@interactive.net -Where: /usr/local/bin -FTP: - -A simple dialup utility. - -Name: cut -Version: 1.0 -Shell: GNO/ME -Author: Jason Perez -Contact: jperez@ee.tamu.edu -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Cuts out selected fields of each line of a file. - -Name: date -Version: 1.2 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Shows the date and time (optionally, continuously). - -Name: descc -Version: 1.0.3 -Shell: ORCA/Shell, GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/sbin -FTP: ftp.cco.caltech.edu - - Compile a source file into a 'describe' database file. - -Name: describe -Version: 1.0.3 -Shell: ORCA/Shell, GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu - - Print a multi-line description obtained from the compiled 'describe' -database; giving utility name, version, intended shell, author, author's -contact, where the utility is, as well as where the utility can be FTPd -from on the InterNet. - -Name: descu -Version: 1.0.3 -Shell: ORCA/Shell, GNO/ME -Author: Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/sbin -FTP: ftp.cco.caltech.edu - - Update a 'describe' source file. - -Name: dial -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Uses your modem to dial telephone numbers stored in a database by name, -or looks up the numbers and reports without dialing. - -Name: dialup -Version: 1.1 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/sbin -FTP: ... - - Run from inittab to handle modems on dialup lines. - -Name: diff -Version: 1.0 (12 Dec 94) -Author: Ported by Devin Reade -Contact: -Where: /usr/bin -FTP: cco.caltech.edu, grind.isca.uiowa.edu. - - Show differences in files. This is a port based on GNU diff v2.6. Some -less-used features have been temporarily disabled for v1.0. - -Name: dmake -Version: 1.0 (4 Jul 94) -Shell: GNO/ME -Author: Ported by Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - A Unix-style make utility for automated compilation. - -Name: DRWM -Version: 2.01 -Shell: GNO/ME -Author: Dave J. Roberts -Contact: dave@mary.iia.org -Where: /usr/X/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - -Davis Rex Window Manager. A window manager for GNO. - -Name: dsort -Version: 1.0 (14 Jun 94) -Shell: GNO/ME -Author: Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu (in file sorts10.shk) - - Sort a text file on disk lexicographically. Archived together -with msort. - -Name: dsplit -Version: 1.0 (19 Dec 93) -Shell: GNO/ME -Author: Ported by Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - A file splitter, with a default output size of 811520 bytes, suitable -for 800k 3.5" floppies. It will work with any type of regular (no -resource fork) file. - -Name: eps -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/bin -FTP: ... - - Display extensive process status information. - -Name: expr -Version: 1.1 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: - - Evaluates matehmatical expressions; prints result in normal and -scientific notation. Uses C like syntax. - -Name: figlet -Version: 2.0 -Shell: GNO/ME -Author: Ported by Jawaid Bazyar -Contact: bazyar@csn.org -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - - Creates styled large characters out of ordinary screen characters. - -Name: finger -Version: 1.1 -Shell: GNO/ME -Author: Leslie M. Barstow III -Contact: wdphoenix@delphi.com -Where: /usr/bin -FTP: ... - -finger is a re-write of the UNIX finger utility. Its purpose is to provide -information about a user or users. It shows their real name, home directory, -default shell, last login time, and two files that they may create to provide -further information. - -Name: flex -Version: 2.38 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://grind.isca.uiowa.edu/2/apple2/nodak/gs/shell.stuff/ - - A port of the FSF's lex replacement. flex is part of the GNU project. -lex is a tokenizer generator, to be used in conjunction with yacc. Note -that due to the way the FSF writes their code (yuck), flex has some problems -with ints being 16-bit instead of 32-bit on the GS.. - -Name: fmake -Version: 1.0 -Shell: ORCA/Shell, GNO/ME -Author: Felix Blank -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ... - - fmake is a Unixish make utility. It only understands a small subset of make -commands, though, barely enough to maintain small projects. Written originally -by Felix Blank. The need for this utility vanished with the advent of dmake. - -Name: fortune -Version: 1 (941115) -Shell: GNO/ME -Author: Douglas E. Mitton -Contact: dmitton@mulberry.com -Where: /usr/bin, /etc -FTP: grind.isca.uiowa.edu, GEnie A2Pro #4402 - - 'fortune.shk' (71k) is a simple shell utility which displays -a random fortune. It contains a text based fortune collection. -The ORCA/C source is included. I ported this from a QNX2 shell -utility. - -Name: ftn -Version: 1.1 (11 Oct 94) -Shell: GNO/ME -Author: Dave J. Roberts. Version 1.1 changes by Devin Reade. -Contact: daver@rush.cc.edu, droberts@chaos.bsu.edu -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - A utility to display Apple's DTS File Type Notes. - -Name: getvers -Version: 1.2 -Shell: GNO/ME -Author: Ian Schmidt -Contact: irsman@iastate.edu -Where: /usr/bin -FTP: pindarus.cs.uiuc.edu - - Gets the rVersion information on a EXE, including name, version, and any -other information the author wishes to include, printing it to standard out. - -Name: gzip -Version: 1.2.4 (Gno) -Shell: GNO/ME -Author: Joseph Lee -Contact: eaiu410@ea.oac.uci.edu -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - -GNU zip -- compress or expand files. Ported from the Free Software -Foundation's gzip. Also has functionality of gunzip and gzcat. - -Name: init -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Sends commands to the init daemon. - -Name: initd -Version: 1.4 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/sbin -FTP: ... - - Starts and kills processes, maintains the system run level, and runs -syslogd (log daemon) - -Name: joinpara -Version: 1.0 (16 Dec 93) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - A filter to strip newlines from the middle of paragraphs, but not -elsewhere. Written to ease the importing of text files into word -processor documents. - -Name: last -Version: 1.1 -Shell: GNO/ME -Author: Steve Reeves -Contact: Internet: reevess@cse.fau.edu, GEnie: S.REEVES2 -Where: /usr/bin -FTP: grind.isca.uiowa.edu - - Displays last logins for specified users or terminals. It searches -through the login accounting file "/var/adm/wtmp" for this information. -It is only useful with GNO's Multi-User package. - -Name: machtype -Version: 1.4 -Shell: GNO/ME -Author: Ian Schmidt -Contact: irsman@iastate.edu -Where: /usr/bin -FTP: pindarus.cs.uiuc.edu - - Gets and prints a wide variety of information on your IIgs system, including -memory, versions of GNO, GS/OS, and the ROM, accelerator type if any, and more. - -Name: makedmake -Version: 1.1.1 (16 Jan 94) -Shell: GNO/ME -Author: Ported by Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - Calculates program dependencies and generates makefiles for dmake. -This is a particularily brain-dead port that will likely be superceded. -(By mkmf?) Suitable for simple dependancies. - -Name: makewhatis -Version: 1.1 (29 May 94) -Shell: GNO/ME -Author: Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /usr/sbin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Generates the whatis database used by apropos(1) and whatis(1). - -Name: man -Version: 3.0 (24 Jul 95) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.com -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Display manual reference pages. Bundled with apropos, catman, -makewhatis, and whatis in the manpack30.shk archive. - -Name: martian -Version: 1.0 -Shell: GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin or /usr/local/games -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Creates martian poetry in nroff format. - -Name: mem -Version: 1.2 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Shows memory usage statistics in different formats. - -Name: mkdir -Version: 1.2 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /bin -FTP: ... - - Make a directory. - -Name: mkfs -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Formats or erases physical devices and creates file systems on them. - -Name: msort -Version: 1.0 (14 Jun 94) -Shell: GNO/ME -Author: Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu (in file sorts10.shk) - - Sort a text file in memory lexicographically. Archived together -with dsort. - -Name: mugs -Version: 3.0 -Shell: GNO/ME -Author: Brian Tao -Contact: taob@io.org -Where: /usr/bin -FTP: ionews.io.org:/pub/apple/16bit/GNO - - MuGS is a full-screen offline Internet e-mail and Usenet news -processor. Utilities for creating message packets on the UNIX system -and delivering replies are included. MicroEMACS 3.11c is required. - -Name: ndp -Version: 1.08 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Merges a FIDO nodediff into a FIDO nodelist - -Name: newuser -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/sbin -FTP: ... - - Create a home directory with basic gshrc for a new user, and add user -into /etc/passwd file for immediate access. - -Name: newuserv -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/sbin -FTP: ... - - Create a home directory with basic gshrc for new user, and add user -to /var/adm/newuser/newusers file for validation by the system operator. - -Name: occ -Version: 1.13 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Unixish front-end for ORCA/C. Particularly useful in combination with -dmake. Requires ORCA/C 2.0.3 (compiler version 2.0.2). - -Name: parent -Version: 1.0 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Shows the current process or a specified process and climbs up to the top -level process. - -Name: patch -Version: 1.0 (12 Nov 95) -Shell: GNO/ME -Author: Ported by Devin Reade. -Contact: gdr@myrias.com -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Apply diffs to an original file. This is based on BSD patch v2.0pl12u8. - -Name: pbmtoiw -Version: 1.0 -Shell: GNO/ME -Author: Thomas Okken -Contact: thomas@animal.hobby.nl, tommasso@hacktic.nl -Where: /usr/bin -FTP: grind.isca.uiowa.edu - - Reads a portable bitmap and converts it to graphics codes for the -Apple Imagewriter printer. - -Name: phone -Version: 1.0.1 -Shell: GNO/ME -Author: Robert Hill -Contact: rhill@eecs.ukans.edu -Where: /usr/bin -FTP: ... - - Based on talk, phone allows two users to interactively chat in a -split-screen format. - -Name: rdial -Version: 1.1 (28 Feb 95) -Shell: GNO/ME -Author: Jeremy Rand. -Contact: -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - -Auto redial a system with a login script. - -Name: rmdir -Version: 1.0 (28 Nov 94) -Shell: GNO/ME -Author: Devin Reade. -Contact: gdr@myrias.ab.ca -Where: /bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Remove empty directories. - -Name: rndname -Version: 4.1 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin or /usr/games -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils - - Creates random names by a set of certain rules. - -Name: rot13 -Version: 1.0 -Shell: ORCA/Shell, GNO/ME -Author: Leslie M. Barstow III -Contact: wdphoenix@delphi.com -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - - rot13 allows you to encrypt and decrypt rot13 text, which is usually -used in Usenet News to hide spoilers and provocative material. - -Name: rsound -Version: 1.1a -Shell: GNO/ME -Author: Douglas E. Mitton -Contact: dmitton@mulberry.com -Where: /usr/bin -FTP: grind.isca.uiowa.edu, GEnie A2Pro #4762 - - 'GNO.rSound.SHK' (76K) is a shell utility which will list and -play any installed rSound in the '*:system:sounds' directory. -ORCA/C source is included as well as 2 home made rSound samples. -This program was written as an example with input from various -A2Pro personalities. "Add sounds to all your scripts, etc." - -Name: rtf2text -Version: 1.0.6 -Shell: GNO/ME -Author: Robert Hill -Contact: rhill@eecs.ukans.edu -Where: /usr/bin -FTP: ... - - Converts RTF (Rich Text Format) files to text. - -Name: scpp -Version: 1.1 (15 Feb 94) -Shell: GNO/ME -Author: Ported by Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - A selective C preprocessor. It will only interpret directives that it -is told to interpret. This makes scpp useful for making source files easier -to read by removing unnecessary code (such as that for other architectures). - -Name: sendmail -Version: 1.1 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/lib/ -FTP: ... - - Sends mail from one local user to another, or spools mail for foreign -destinations. - -Name: setvers -Version: 1.0.2 -Shell: GNO/ME -Author: Ian Schmidt -Contact: irsman@iastate.edu -Where: /usr/bin -FTP: pindarus.cs.uiuc.edu - - Sets the rVersion information on a EXE, including name, version, and any -other information the author wishes to include. - -Name: su -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /bin -FTP: ... - - Launch a new shell as another user. - -Name: sync -Version: x -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Causes GS/OS to commit all pending data to disk. - -Name: tee -Version: 1.1 (23 Nov 93) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.ab.ca -Where: /bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - Pipe fitting: copies stdin to stdout while making copies of the stream -in one or more text files. - -Name: timelimit -Version: 1.1 (16 Dec 93) -Shell: GNO/ME -Author: Ported by Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu. - - Limits the run time of a process; when the time is up, it sends the -specified process a series of SIGINTs. - -Name: tn -Version: 1.1 (11 Oct 94) -Shell: GNO/ME -Author: Dave J. Roberts. Version 1.1 changes by Devin Reade. -Contact: daver@rush.cc.edu, droberts@chaos.bsu.edu -Where: /usr/local/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - A utility to display Apple's DTS Technical Notes. - -Name: udl -Version: 1.14 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens, Devin Reade -Contact: sbehrens@contech.demon.co.uk, gdr@myrias.ab.ca -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Converts text between the CR, LF and CR/LF forms. Also available for Unix -machines, reasonably fast yet secure. - -Name: uname -Version: 2.0.2 -Shell: GNO/ME -Author: Ian Schmidt -Contact: irsman@drift.winternet.com -Where: /bin/ -FTP: grind.isca.uiowa.edu - - Prints the name of the UNIX system (in this case GNO/ME) plus various -other information such as your hostname if you are running the MU package. - -Name: unarj -Version: 2.42 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Unpacks files that were packed with ARJ 2.41 or earlier. - -Name: unpp -Version: 1.1 -Shell: ORCA/Shell, GNO/ME -Author: Soenke Behrens -Contact: sbehrens@contech.demon.co.uk -Where: /usr/local/bin -FTP: ftp://ftp.cco.caltech.edu/pub/apple2/shellutils/ - - Uncompresses PowerPacker(tm) documents, which are created by them Amigoids. - -Name: uptime -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: /usr/bin -FTP: ... - - Reports the time, amount of time the system has been up, number of -users, and system load averages for the last 1, 5, and 15 minutes. - -Name: uptimed -Version: 1.0 -Shell: GNO/ME -Author: Robert Hill -Contact: rhill@eecs.ukans.edu -Where: /usr/sbin -FTP: ... - - Keeps track of system load averages for the uptime utility over the last -1, 5 and 15 minutes. - -Name: wall -Version: 1.0 -Shell: GNO/ME -Author: Phil Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Sends a message to the terminal of every logged on user. - -Name: whatis -Version: 3.0 (24 Jul 95) -Shell: GNO/ME -Author: Devin Reade -Contact: gdr@myrias.com -Where: /usr/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Locate commands by name. Bundled with apropos, catman, makewhatis, -and man in the manpack30.shk archive. - -Name: whereis -Version: v1.1 (2 Jan 93) -Shell: GNO/ME -Author: v1.1 update by Devin Reade -Contact: gdr@myrias.ab.ca -Where: /usr/bin -FTP: ftp.cco.caltech.edu,grind.isca.uiowa.edu. - -whereis searches certain directories (/bin, /usr/bin, /usr/man, et cetera) and -reports the location of source, executables, and man pages. - -Name: wrap -Version: 1.1 -Shell: GNO/ME -Author: Phillip Vandry -Contact: vandry@CAM.ORG -Where: /usr/bin -FTP: ... - - Word wraps text to a certain length (79 default). Also filters binary -data and is very fast. - -Name: write -Version: 2.1 -Shell: GNO/ME -Author: Leslie M. Barstow III -Contact: wdphoenix@delphi.com -Where: /usr/bin -FTP: ... - -write is a simple utility which writes a message to a user, no matter what -terminal he or she is on. The format is: write username [message] -If you do not input a message, you will be prompted for message lines until -you enter a blank line. - -Name: xargs -Version: 0.9 (3 Mar 95) -Shell: GNO/ME -Author: Jeremy Rand. -Contact: -Where: /usr/local/bin -FTP: grind.isca.uiowa.edu - -Pass parameters to a command through standard input. - -Name: xbiff -Version: 1.0 -Shell: GNO/ME -Author: James Brookes -Contact: jamesb@ecst.csuchico.edu -Where: */system/desk.accs/ -FTP: ... - - XBiff is an NDA which gives the user a colorful mailbox announcing both -aurally and visibly when the user has mail. OA-clicking on the window's -content region causes a title bar to appear, allowing the window to be moved. - -Name: xclock -Version: 1.12 -Shell: GNO/ME -Author: Dave J. Roberts -Contact: dave@mary.iia.org -Where: /usr/X/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - -graphical analog time display unit - -Name: xlogin -Version: 2.21 -Shell: GNO/ME -Author: Dave J. Roberts -Contact: dave@mary.iia.org -Where: /usr/X/bin -FTP: ftp.cco.caltech.edu, grind.isca.uiowa.edu - - Graphical login prompt for GNO/ME, X11-style - -Name: zsh -Version: 2.0 -Shell: GNO/ME -Author: Leslie M. Barstow III -Contact: wdphoenix@delphi.com -Where: /bin -FTP: - -zsh is a program used to put a user's account in suspension. -It prints a message and then exits. - - - - - diff --git a/usr.orca.bin/describe/descu.8 b/usr.orca.bin/describe/descu.8 index d12f37e..47cacf4 100644 --- a/usr.orca.bin/describe/descu.8 +++ b/usr.orca.bin/describe/descu.8 @@ -1,5 +1,5 @@ .\" -.\" $Id: descu.8,v 1.5 1997/12/22 00:34:52 gdr Exp $ +.\" $Id: descu.8,v 1.6 1998/01/17 07:20:07 gdr Exp $ .\" .TH DESCU 8 "22 September 1997" GNO "System Administration" .SH NAME @@ -20,7 +20,7 @@ descu \- the describe(1) source updater .SH DESCRIPTION This manual page documents .BR descu -version 1.0.4. +version 1.0.5. .LP .BR descu updates the describe source file diff --git a/usr.orca.bin/describe/descu.c b/usr.orca.bin/describe/descu.c index 92ed649..73aec0c 100644 --- a/usr.orca.bin/describe/descu.c +++ b/usr.orca.bin/describe/descu.c @@ -11,7 +11,7 @@ * Copyright 1995-1997 by Devin Reade for James Brookes' describe(1) utility. * See the included README file and man page for details. * - * $Id: descu.c,v 1.6 1997/12/22 00:34:52 gdr Exp $ + * $Id: descu.c,v 1.7 1998/01/17 07:20:07 gdr Exp $ */ #include @@ -565,7 +565,7 @@ int main(int argc, char **argv) { p++; } time(&t); - fprintf(outfp,"%s%s %s%s", header, revisionMagic, + fprintf(outfp,"%s%s %s%s\n", header, revisionMagic, asctime(gmtime(&t)), p); } else { fprintf(outfp,"%s\n", header); diff --git a/usr.orca.bin/describe/descu.rez b/usr.orca.bin/describe/descu.rez index e44a3d1..9cac8fa 100644 --- a/usr.orca.bin/describe/descu.rez +++ b/usr.orca.bin/describe/descu.rez @@ -1,7 +1,7 @@ /* * Resources for version and comment * - * $Id: descu.rez,v 1.1 1997/09/24 06:34:59 gdr Exp $ + * $Id: descu.rez,v 1.2 1998/01/17 07:20:07 gdr Exp $ */ #include "Types.rez" @@ -14,7 +14,7 @@ * Version */ resource rVersion (1, purgeable3) { - { 1, 0, 4, /* Version 1.0.4 */ + { 1, 0, 5, /* Version 1.0.5 */ release, /* development|alpha|beta|final|release */ 0 }, /* non-final release number */ verUS, /* Country */ @@ -26,7 +26,7 @@ resource rVersion (1, purgeable3) { * Comment */ resource rComment (1, purgeable3) { - PROG " v1.0.4\n" + PROG " v1.0.5\n" DESC " (GNO) \n" AUTHOR };