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