Apple-2gs-SW/gno
1
0
Fork 0
mirror of https://github.com/GnoConsortium/gno.git synced 2024-12-22 14:30:29 +00:00
Code Issues Projects Releases Wiki Activity
fbcef9625a
gno/usr.orca.bin/describe/descc.8

116 lines
2.9 KiB
Groff
Raw Normal View History

Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.\"
.\" $Id: descc.8,v 1.4 1997/09/24 06:34:57 gdr Exp $
.\"
.TH DESCC 8 "22 September 1997" GNO "System Administration"
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.SH NAME
descc \- the describe(1) source compiler
.SH SYNOPSIS
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.BR descc
[
.BR -hV
]
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.I sourcefile
.SH DESCRIPTION
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
This manual page documents
.BR descc
version 1.0.4.
.LP
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.BR descc
compiles the describe source file
.I sourcefile
and saves the result to the system describe database.
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
If the database doesn't exist, or doesn't have type BIN, then
.BR descc
will set the database file type to BIN and the auxtype to 0x0000 after
it has been updated.
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.SH OPTIONS
.nf
\fB-h\fR Show usage information.
\fB-V\fR Show version information.
.fi
.SH "FILE FORMATS"
The describe source file consists of comments and records. A comment
is any line starting with the
.BR #
describe, descc, descu version 1.0.2. This version was updated by Soenke Behrens. See the readme for change details.
1996-01-22 02:40:50 +00:00
character. Each record consists of eight fields. The first
seven consist of one line of text and begin with the following identifiers:
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.nf
Name: (The name of the program.)
Version: (The current version number.)
describe, descc, descu version 1.0.2. This version was updated by Soenke Behrens. See the readme for change details.
1996-01-22 02:40:50 +00:00
Shell: (The shell(s) the program was written for.)
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
Author: (The author or maintainer of the program.)
Contact: (How to contact the Author, typically an
email address.)
Where: (Where the program should be installed.)
FTP: (An ftp site from which the program may be
obtained.)
.fi
The last field consists of multiple lines of text. It should be
a brief description of the program. The following is an example of
a complete record:
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.RS
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.nf
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
Name: describe
Version: 1.0.4
Shell: GNO, ORCA/Shell
Author: James Brookes
Contact: jamesb@ecst.csuchico.edu
Where: /usr/bin
FTP: apple2.caltech.edu, ground.isca.uiowa.edu
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.fi
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
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.
.RE
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.LP
The describe database file consists of a
.BR Header ,
a set of
.BR "Name Entries" ,
and a set of
.BR Records ,
in the following format:
.nf
Header
2 bytes: Short Int, number of \fBName Entries\fR
Name Entries
34 bytes: NULL-terminated string; name of the utility.
4 bytes: Long Int, offset of the \fBrecord\fR in file.
Records
describe, descc, descu version 1.0.2. This version was updated by Soenke Behrens. See the readme for change details.
1996-01-22 02:40:50 +00:00
8 variable-length NULL-terminated strings.
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.fi
.SH FILES
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.IP \fB/usr/lib/describe\fR
The system
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.B describe
describe, descc, descu version 1.0.2. This version was updated by Soenke Behrens. See the readme for change details.
1996-01-22 02:40:50 +00:00
database. If the environment variable
.B DESCDB
is set, its value will be used instead.
.SH ENVIRONMENT
.IP DESCDB
Full path to the system describe database. If
.B DESCDB
is set, its value is used instead of the default location
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.BR /usr/lib/describe .
.SH AUTHOR
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
James Brookes <jamesb@ecst.csuchico.edu>.
Makefile: - Renamed from makefile.mk to Makefile. - Updated for proper operation as part of GNO build. - Discontinue use of vaend.c, basename.c for GNO v2.0.6. descu: - Document ability to specify an output file vice stdout (this feature was already in, but not documented) - Allow the output file to be the same name as the first input file (it will be overwritten). - Fix buffer overrun bugs that occured when: a) There was no initial input file; or b) There are no headers in the first input file; or c) There are no trailers in the first input file; or - Increased SLOTS_QUANTUM from 20 to 64, hopefully increasing the speed on large files. - fixed stack check code to use the new routines names - put version number in lockstep with descc and describe descc: - descc will now change the database file type to BIN, if it wasn't already so. - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and describe describe: - changed default location of system database - fixed stack check code to use the new routines names - put version number in lockstep with descu and descc *.rez: - added resource source files
1997-09-24 06:34:59 +00:00
.SH HISTORY
.BR descu
was incorporated into the GNO base distribution as of version 1.0.4
Describe (and related utils), version 1.0.1. Like v1.0, this checkin does not include resource forks. See the README for changes. This update by Devin Reade.
1996-01-22 01:38:06 +00:00
.SH "SEE ALSO"
.BR apropos (1),
.BR describe (1),
.BR man (1),
.BR whatis (1),
.BR descu (8).
Reference in New Issue Copy Permalink