DEROFF(1,C)                 AIX Commands Reference                  DEROFF(1,C)



-------------------------------------------------------------------------------
deroff



PURPOSE

Removes nroff, troff, tbl, and eqn constructs from files.

SYNTAX


          +---------+   +--------+   +--------+   +------------+
deroff ---| one of  |---| one of |---| +----+ |---|            |---|
          | +-----+ |   | +----+ |   +-| -k |-+   +--- file ---+
          +-| -ma |-+   +-| -i |-+     | -p |       ^        |
            | -me |       | -l |       | -u |       +--------+
            | -ml |       +----+       | -w |
            | -mm |                    +----+
            | -ms |
            +-----+


Note:  This command does not have MBCS support.

DESCRIPTION

The deroff command reads the specified files (standard input, by default);
removes all troff requests, macro calls, backslash constructs, eqn constructs
(between .EQ and .EN lines and between delimiters), and tbl descriptions; and
writes the remainder of the file to standard output.

The deroff command normally follows chains of included files (.so and .nx troff
commands).  If a file has already been included, a .so command naming the file
is ignored and a .nx command naming the file ends execution.  Note that the
deroff command is not a complete troff interpreter and can be confused by
subtle constructs.  Most errors result in too much rather than too little
output.

FLAGS

-i    Suppresses processing of included files.

-k    Keeps (that is, does not remove) a block of text.  The default is to
      remove blocks of text (for example, .ne constructs).

-l    Suppresses processing of included files whose names begin with /usr/lib,
      such as macro files in the directory /usr/lib/tmac.

-ma   Remove ma (man) macros from text so that only running text is output.





Processed November 8, 1990        DEROFF(1,C)                                 1

DEROFF(1,C)                 AIX Commands Reference                  DEROFF(1,C)



-me   Removes me macros from text so that only running text is output (default
      macro).

-ml   Removes mm macros from text and also deletes mm list structures.  The -ml
      flag does not handle nested lists.

-mm   Removes mm and ms macros from text so that only running text is output
      (no text from macro lines is included).

-ms   Removes ms macros in text so that only running text is output.

-p    Processes special paragraphs.

-u    Removes ASCII underline and boldface control sequences (_\b and \b).  The
      -u flag automatically sets the -w flag.

-w    Makes the output a word list, with one word per line and all other
      characters deleted.  In text, a word is defined as any string containing
      at least two letters, composed of letters, digits, ampersands ("&"), and
      apostrophes (').  In a macro call, a word is defined as a string
      beginning with at least two letters and containing at least three
      letters.  Delimiters are any characters other than letters, digits,
      apostrophes, and ampersands.  Trailing apostrophes and ampersands are
      removed from words.

RELATED INFORMATION

See the following commands:  "eqn, neqn, checkeq,"  "nroff, troff," and  "tbl."



























Processed November 8, 1990        DEROFF(1,C)                                 2