deroff(1)                           CLIX                           deroff(1)



  NAME

    deroff - Removes nroff, troff, tbl, and eqn constructs from files

  SYNOPSIS

    deroff [-mx] [-w] [files] Controls the interpretation of the macros.  The
    -m flag may be followed by an m, s, or l.  The -mm flag causes the macros
    to be interpreted so that only running text is output (that is, no text
    from macro lines).  The -ms flag is equivalent to -mm.

    The -ml flag forces the -mm flag and also causes deletion of lists
    associated with the mm macros.  Produces 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

    The deroff command reads each of the files in sequence and removes all
    troff requests, macro calls, backslash constructs, eqn constructs (between
    .EQ and .EN lines, and between delimiters), and tbl descriptions, perhaps
    replacing them with white space (blanks and blank lines), and writes the
    remainder of the file on stdout.  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.  If no input file is given, deroff reads stdin.

  EXAMPLES

    1.  To produce plain text output, enter the following command:

        deroff -mm art.text

        This command will interpret all macros and ``.'' structures in the
        file art.test, producing plain text output.

    2.  To produce a word list, enter the following command:

        deroff -w art.text

        This command will produce a word list for the file art.test, with all
        symbols removed.

  NOTES




  2/94 - Intergraph Corporation                                              1

  deroff(1)                           CLIX                           deroff(1)



    The deroff utility 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 flag does not handle nested lists correctly.  DIAGNOSTICS

    Cannot open file file
           One of the files given as an argument does not have read permission
           or does not exist.

  EXIT VALUES

    The command exits with a value of 0 if successful.  If unsuccessful, the
    command exits with value of 1.

  RELATED INFORMATION

    Commands: eqn(1), nroff(1), tbl(1), troff(1)




































  2                                              Intergraph Corporation - 2/94