NAME

       demandoc — emit only text of UNIX manuals

SYNOPSIS

       demandoc [-w] [file ...]

DESCRIPTION

       The demandoc utility emits only the text portions of well-formed mdoc(7) and man(7) Unix manual files.

       By  default,  demandoc  parses  standard  input  and  outputs only text nodes, preserving line and column
       position.  Escape sequences are omitted from the output.

       Its arguments are as follows:

       -w      Output a word list.  This outputs each word of text on its own line.  A  "word",  in  this  case,
               refers  to  whitespace-delimited  terms beginning with at least two letters and not consisting of
               any escape sequences.  Words have their leading and trailing punctuation (double-quotes, sentence
               punctuation, etc.) stripped.

       file ...
               The input files.

       If a document is not well-formed, it is skipped.

       The -i, -k, -m, and -p flags are silently discarded for calling compatibility with the historical deroff.

EXIT STATUS

       The demandoc utility exits with one of the following values:

       0       No errors occurred.
       6       An operating system error occurred, for example memory exhaustion or  an  error  accessing  input
               files.   Such  errors  cause  demandoc  to  exit  at  once,  possibly in the middle of parsing or
               formatting a file.  The output databases are corrupt and should be removed .

EXAMPLES

       The traditional usage of demandoc is for spell-checking manuals on BSD.  This is accomplished as  follows
       (assuming British spelling):

             $ demandoc -w file.1 | spell -b

SEE ALSO

       mandoc(1), man(7), mdoc(7)

HISTORY

       demandoc replaces the historical deroff utility for handling modern man(7) and mdoc(7) documents.

AUTHORS

       The demandoc utility was written by Kristaps Dzonsons <kristaps@bsd.lv>.

Debian                                         September 12, 2014                                    DEMANDOC(1)