gno/usr.orca.bin/describe/descu.8
gdr b00e9eb797 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

82 lines
1.6 KiB
Groff

.\"
.\" $Id: descu.8,v 1.4 1997/09/24 06:34:58 gdr Exp $
.\"
.TH DESCU 8 "22 September 1997" GNO "System Administration"
.SH NAME
descu \- the describe(1) source updater
.SH SYNOPSIS
.BR descu
[
.B -hV
] [
.B -o
.I outfile
]
.I sourcefile
.I patchfile1
[
.IR patchfile2 " ..."
]
.SH DESCRIPTION
This manual page documents
.BR descu
version 1.0.4.
.LP
.BR descu
updates the describe source file
.I sourcefile
by applying the new and updated records from the \fIpatchfile\fRs
and prints the result to standard output (or to
.IR outfile ,
if the
.BR -o
flag was specified).
.LP
.IR Patchfile s
are just one or more describe source entries as defined in
.BR descc (8).
(They have nothing to do with
.BR patch (1).)
.LP
.IR Patchfile s
are assumed to contain at most one entry (in all listed
.IR patchfile s)
for a given program, keyed on the
.BR Name:
field. (They may otherwise contain any number of entries.) If an entry in
.IR patchfile
is already in
.IR sourcefile ,
it replaces the original; otherwise the entry is appended. In both
cases, the output is sorted lexicographically (ignoring case), based on
the
.BR Name:
field.
.LP
.BR descu
will create the file
.B descu.rej
in the current directory. This contains all records that were removed
from
.IR sourcefile .
.SH OPTIONS
.IP \fB-h\fR
Show usage information.
.IP "\fB-o\fR \fIoutfile\fR"
Send output to
.IR outfile
rather than stdout.
.IP \fB-v\fR
Show version information.
.SH AUTHOR
Devin Reade <gdr@myrias.ab.ca>
.SH HISTORY
.BR descu
was incorporated into the GNO base distribution as of version 1.0.4
.SH "SEE ALSO"
.BR apropos (1),
.BR describe (1),
.BR man (1),
.BR whatis (1),
.BR descc (8).