1997-09-24 06:34:59 +00:00
|
|
|
.\"
|
1998-01-17 07:20:07 +00:00
|
|
|
.\" $Id: descu.8,v 1.6 1998/01/17 07:20:07 gdr Exp $
|
1997-09-24 06:34:59 +00:00
|
|
|
.\"
|
|
|
|
.TH DESCU 8 "22 September 1997" GNO "System Administration"
|
1996-01-22 01:38:06 +00:00
|
|
|
.SH NAME
|
|
|
|
descu \- the describe(1) source updater
|
|
|
|
.SH SYNOPSIS
|
1997-09-24 06:34:59 +00:00
|
|
|
.BR descu
|
|
|
|
[
|
|
|
|
.B -hV
|
|
|
|
] [
|
|
|
|
.B -o
|
|
|
|
.I outfile
|
|
|
|
]
|
1996-01-22 01:38:06 +00:00
|
|
|
.I sourcefile
|
|
|
|
.I patchfile1
|
|
|
|
[
|
|
|
|
.IR patchfile2 " ..."
|
|
|
|
]
|
|
|
|
.SH DESCRIPTION
|
1997-09-24 06:34:59 +00:00
|
|
|
This manual page documents
|
|
|
|
.BR descu
|
1998-01-17 07:20:07 +00:00
|
|
|
version 1.0.5.
|
1997-09-24 06:34:59 +00:00
|
|
|
.LP
|
1996-01-22 01:38:06 +00:00
|
|
|
.BR descu
|
|
|
|
updates the describe source file
|
|
|
|
.I sourcefile
|
|
|
|
by applying the new and updated records from the \fIpatchfile\fRs
|
1997-09-24 06:34:59 +00:00
|
|
|
and prints the result to standard output (or to
|
|
|
|
.IR outfile ,
|
|
|
|
if the
|
|
|
|
.BR -o
|
|
|
|
flag was specified).
|
1996-01-22 01:38:06 +00:00
|
|
|
.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:
|
1997-09-24 06:34:59 +00:00
|
|
|
field. (They may otherwise contain any number of entries.) If an entry in
|
1996-01-22 01:38:06 +00:00
|
|
|
.IR patchfile
|
|
|
|
is already in
|
|
|
|
.IR sourcefile ,
|
|
|
|
it replaces the original; otherwise the entry is appended. In both
|
1996-01-22 02:40:50 +00:00
|
|
|
cases, the output is sorted lexicographically (ignoring case), based on
|
|
|
|
the
|
1996-01-22 01:38:06 +00:00
|
|
|
.BR Name:
|
|
|
|
field.
|
|
|
|
.LP
|
|
|
|
.BR descu
|
|
|
|
will create the file
|
1996-01-22 02:40:50 +00:00
|
|
|
.B descu.rej
|
1996-01-22 01:38:06 +00:00
|
|
|
in the current directory. This contains all records that were removed
|
|
|
|
from
|
|
|
|
.IR sourcefile .
|
|
|
|
.SH OPTIONS
|
1997-09-24 06:34:59 +00:00
|
|
|
.IP \fB-h\fR
|
|
|
|
Show usage information.
|
|
|
|
.IP "\fB-o\fR \fIoutfile\fR"
|
|
|
|
Send output to
|
|
|
|
.IR outfile
|
|
|
|
rather than stdout.
|
1997-12-22 00:34:52 +00:00
|
|
|
.IP \fB-V\fR
|
1997-09-24 06:34:59 +00:00
|
|
|
Show version information.
|
1996-01-22 01:38:06 +00:00
|
|
|
.SH AUTHOR
|
|
|
|
Devin Reade <gdr@myrias.ab.ca>
|
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
|
1996-01-22 01:38:06 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR apropos (1),
|
|
|
|
.BR describe (1),
|
|
|
|
.BR man (1),
|
|
|
|
.BR whatis (1),
|
|
|
|
.BR descc (8).
|