xref: /csrg-svn/usr.bin/deroff/deroff.1 (revision 44280)
1.\" Copyright (c) 1990 Regents of the University of California.
2.\" All rights reserved.  The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
5.\"     @(#)deroff.1	6.3 (Berkeley) 06/26/90
6.\"
7.Dd
8.Dt DEROFF 1
9.Os ATT 7th
10.Sh NAME
11.Nm deroff
12.Nd remove nroff, troff, tbl and eqn constructs
13.Sh SYNOPSIS
14.Nm deroff
15.Op Fl w
16.Ar file \&...
17.Sh DESCRIPTION
18.Nm Deroff
19reads each file in sequence and removes all
20.Xr nroff 1
21and
22.Xr troff 1
23command lines, backslash constructions, macro definitions,
24.Xr eqn 1
25constructs (between `.EQ' and `.EN' lines or between delimiters),
26and table descriptions and writes the remainder on the standard output.
27.Nm Deroff
28follows chains of included files (`.so' and `.nx' commands);
29if a file has already been included, a `.so' is ignored and a `.nx'
30terminates execution.  If no input file is given,
31.Nm deroff
32reads from the standard input.
33.Pp
34If the
35.Fl w
36flag is given, the output is a word list, one `word' (string of letters,
37digits, and apostrophes, beginning with a letter; apostrophes are removed)
38per line, and all other characters ignored.
39Otherwise, the output follows the original, with the deletions mentioned above.
40.Sh SEE ALSO
41.Xr troff 1 ,
42.Xr eqn 1 ,
43.Xr tbl 1
44.Sh HISTORY
45.Nm Deroff
46appeared in Version 7 AT&T Unix.
47.Sh BUGS
48.Nm Deroff
49is not a complete
50.Xr troff 1
51interpreter, so it can be confused by subtle constructs.
52Most errors result in too much rather than too little output.
53