gno/usr.orca.bin/describe/descu.8
gdr-ftp 17aad04201 There used to be a limit of 65k on the size of the describe
database source when using descu.  This limit was imposed
	due to a bug in ORCA/C (it is no longer clear whether
	this was a bug in malloc(3) or in array indexing code).
	As of ORCA/C v2.1.x, this bug appears to be fixed, so
	the limit was lifted.
A couple of calls to lseek(2) didn't have their return values
	checked for errors.  Fixed.
Updated email address for Devin Reade.
1998-02-07 06:40:11 +00:00

82 lines
1.6 KiB
Groff

.\"
.\" $Id: descu.8,v 1.7 1998/02/07 06:40:07 gdr-ftp Exp $
.\"
.TH DESCU 8 "6 February 1998" 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.6.
.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@trenco.gno.org>
.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).