mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
977b25a76a
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441.
117 lines
1.8 KiB
Groff
117 lines
1.8 KiB
Groff
.TH DEROFF 1
|
|
.SH NAME
|
|
deroff, delatex \- remove formatting requests
|
|
.SH SYNOPSIS
|
|
.B deroff
|
|
[
|
|
.I option ...
|
|
]
|
|
.I file ...
|
|
.PP
|
|
.B delatex
|
|
.I file
|
|
.SH DESCRIPTION
|
|
.I Deroff
|
|
reads each file in sequence
|
|
and removes all
|
|
.I nroff
|
|
and
|
|
.IM troff (1)
|
|
requests and non-text arguments, backslash constructions,
|
|
and constructs of preprocessors such as
|
|
.IM eqn (1) ,
|
|
.IM pic (1) ,
|
|
and
|
|
.IM tbl (1) .
|
|
Remaining text is written on the standard output.
|
|
.I Deroff
|
|
follows files included by
|
|
.L .so
|
|
and
|
|
.L .nx
|
|
commands;
|
|
if a file has already been included, a
|
|
.L .so
|
|
for that file is ignored and a
|
|
.L .nx
|
|
terminates execution.
|
|
If no input file is given,
|
|
.I deroff
|
|
reads from standard input.
|
|
.PP
|
|
The options are
|
|
.TP
|
|
.B -w
|
|
Output a word list, one `word' (string of letters, digits, and
|
|
properly embedded ampersands and apostrophes,
|
|
beginning with a letter) per line.
|
|
Other characters are skipped.
|
|
Otherwise, the output follows the original, with the deletions mentioned above.
|
|
.TP
|
|
.B -_
|
|
Like
|
|
.BR -w ,
|
|
but consider underscores to be alphanumeric rather than punctuation.
|
|
.TP
|
|
.B -i
|
|
Ignore
|
|
.L .so
|
|
and
|
|
.L .nx
|
|
requests.
|
|
.TP
|
|
.BR -ms
|
|
.PD0
|
|
.TP
|
|
.B -mm
|
|
Remove titles, attachments, etc., as well as ordinary
|
|
.IR troff
|
|
constructs, from
|
|
.IM ms (7)
|
|
or
|
|
.I mm
|
|
documents.
|
|
.PD
|
|
.TP
|
|
.B -ml
|
|
Same as
|
|
.BR -mm ,
|
|
but remove lists as well.
|
|
.PP
|
|
.I Delatex
|
|
does for
|
|
.I tex
|
|
and
|
|
.I latex
|
|
(see
|
|
.IM tex (1) )
|
|
files what
|
|
.B deroff -wi
|
|
does for
|
|
.I troff
|
|
files.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/deroff.c
|
|
.br
|
|
.B \*9/src/cmd/delatex.lx
|
|
.SH "SEE ALSO"
|
|
.IR troff (1),
|
|
.IM tex (1) ,
|
|
.IM spell (1)
|
|
.SH BUGS
|
|
These filters are not complete interpreters of
|
|
.I troff
|
|
or
|
|
.IR tex .
|
|
For example, macro definitions containing
|
|
.L \e$
|
|
cause chaos in
|
|
.IR deroff
|
|
when the popular
|
|
.L $$
|
|
delimiters for
|
|
.I eqn
|
|
are in effect.
|
|
.PP
|
|
Text inside macros is emitted at place of
|
|
definition, not place of call.
|