| 1 | .\" @(#)deroff.1 4.1 (Berkeley) %G% |
| 2 | .\" |
| 3 | .TH DEROFF 1 |
| 4 | .AT 3 |
| 5 | .SH NAME |
| 6 | deroff \- remove nroff, troff, tbl and eqn constructs |
| 7 | .SH SYNOPSIS |
| 8 | .B deroff |
| 9 | [ |
| 10 | .B \-w |
| 11 | ] |
| 12 | file ... |
| 13 | .SH DESCRIPTION |
| 14 | .I Deroff |
| 15 | reads each file in sequence |
| 16 | and removes all |
| 17 | .I nroff |
| 18 | and |
| 19 | .I troff |
| 20 | command lines, backslash constructions, macro definitions, |
| 21 | .I eqn |
| 22 | constructs |
| 23 | (between `.EQ' and `.EN' lines or between |
| 24 | delimiters), |
| 25 | and table descriptions |
| 26 | and writes the remainder on the standard output. |
| 27 | .I Deroff |
| 28 | follows chains of included files |
| 29 | (`.so' and `.nx' commands); |
| 30 | if a file has already been included, a `.so' is ignored and a `.nx' terminates execution. |
| 31 | If no input file is given, |
| 32 | .I deroff |
| 33 | reads from the standard input. |
| 34 | .PP |
| 35 | If the |
| 36 | .B \-w |
| 37 | flag is given, the output is a word list, one `word' (string of letters, digits, and apostrophes, |
| 38 | beginning with a letter; apostrophes are removed) per line, and all other characters ignored. |
| 39 | Otherwise, the output follows the original, with the deletions mentioned above. |
| 40 | .SH "SEE ALSO" |
| 41 | troff(1), eqn(1), tbl(1) |
| 42 | .SH BUGS |
| 43 | .I Deroff |
| 44 | is not a complete |
| 45 | .I troff |
| 46 | interpreter, |
| 47 | so it can be confused by subtle constructs. |
| 48 | Most errors result in too much rather than too little output. |