deroff(1)                                               deroff(1)



NAME
     deroff - removes nroff/troff, tbl, and eqn constructs

SYNOPSIS
     deroff [-mx] [-w] [file]...

ARGUMENTS
     file Specifies the file containing the constructs that are
          to be removed.  If this argument is not given, deroff
          reads the standard input.

     -mx  Specifies the macro package.  Replace x with an m, s,
          or l.  If you select the -mm macro package, the macros
          will be interpreted so that only running text is output
          (that is, no text from macro lines).  If the -ml macro
          package is chosen, the -mm macro package is forced, and
          also causes deletion of lists associated with the mm
          macros.

     -w   Causes the output to be a word list, one word per line,
          with all other characters deleted.  Otherwise, the
          output follows the original, with the deletions
          mentioned above.  In text, a word is any string that
          contains at least two letters and is composed of
          letters, digits, ampersands (&), and apostrophes (');
          in a macro call, however, a word is a string that
          begins with at least two letters and contains a total
          of at least three letters.  Delimiters are any
          characters other than letters, digits, apostrophes, and
          ampersands.  Trailing apostrophes and ampersands are
          removed from words.

DESCRIPTION
     deroff reads each of the files in sequence, removes all
     troff(1) requests, macro calls, backslash constructs, eqn(1)
     constructs (between .EQ and .EN lines, and between
     delimiters), and tbl(1) descriptions, perhaps replacing them
     with white space (blanks and blank lines), and writes the
     remainder of the file on the standard output.  The deroff
     command follows chains of included files (.so and .nx troff
     commands); if a file has already been included, a .so naming
     that file is ignored and a .nx naming that file terminates
     execution.

EXAMPLES
     The command:

        deroff textfile

     removes all nroff, troff, and macro definitions from
     textfile.




January 1992                                                    1

deroff(1)                                               deroff(1)



LIMITATIONS
     The deroff command is not a complete troff interpreter, so
     it can be confused by subtle constructs.  Most such errors
     result in too much rather than too little output.

     The -ml option does not handle nested lists correctly.

FILES
     /usr/bin/deroff
          Executable file

SEE ALSO
     eqn(1), nroff(1), tbl(1), troff(1)










































2                                                    January 1992