deroff —
remove nroff/troff, eqn, pic and tbl constructs
deroff |
[-ikpw] [-m
a | e |
l | m |
s] [file ...] |
deroff reads each file in sequence and removes all roff
command lines, backslash constructions, macro definitions, eqn constructs
(between “.EQ” and “.EN” lines or between
delimiters), pic pictures, and table descriptions and writes the remainder to
the standard output.
deroff follows chains of included
files (“.so” and “.nx” commands); if a file has
already been included, a “.so” is ignored and a
“.nx” terminates execution. If no input file is given,
deroff reads from the standard input.
The options are as follows:
-i- Ignore “.so” and “.nx” commands.
-k- Keep blocks of text intact. This is the default behavior unless the
-m option is given.
-m- Enable support for common macro packages. The
-m
option takes the following arguments:
- a
- recognize man(7) macros.
- e
- recognize me macros.
- l
- remove list constructs.
- m
- recognize mm macros.
- s
- recognize ms macros.
-p- Preserve paragraph macros. This option only has an effect if the
-m option is also specified.
-w- Output a word list, one ‘word’ (string of letters, digits,
and apostrophes, beginning with a letter; apostrophes are removed) per
line, and all other characters ignored. Normally, the output follows the
original, with the deletions mentioned above.
deroff first appeared in
Version 7 AT&T UNIX and has been available
since OpenBSD 3.1.
deroff is not a complete troff interpreter, so it can be
confused by subtle constructs. Most errors result in too much rather than too
little output.
The -ml option does not correctly handle
nested lists.