new copyright; att/bsd/shared

[unix-history] / usr / src / usr.bin / deroff / deroff.1

.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.proprietary.roff%
.\"
.\"	@(#)deroff.1	6.5 (Berkeley) %G%
.\"
.Dd 
.Dt DEROFF 1
.Os ATT 7th
.Sh NAME
.Nm deroff
.Nd remove nroff, troff, tbl and eqn constructs
.Sh SYNOPSIS
.Nm deroff
.Op Fl w
.Ar file \&...
.Sh DESCRIPTION
.Nm Deroff
reads each file in sequence and removes all
.Xr nroff 1
and
.Xr troff 1
command lines, backslash constructions, macro definitions,
.Xr eqn 1
constructs (between `.EQ' and `.EN' lines or between delimiters),
and table descriptions and writes the remainder on the standard output.
.Nm Deroff
follows chains of included files (`.so' and `.nx' commands);
if a file has already been included, a `.so' is ignored and a `.nx'
terminates execution.  If no input file is given,
.Nm deroff
reads from the standard input.
.Pp
If the
.Fl w
flag is given, the output is a word list, one `word' (string of letters,
digits, and apostrophes, beginning with a letter; apostrophes are removed)
per line, and all other characters ignored.
Otherwise, the output follows the original, with the deletions mentioned above.
.Sh SEE ALSO
.Xr troff 1 ,
.Xr eqn 1 ,
.Xr tbl 1
.Sh HISTORY
.Nm Deroff
appeared in Version 7 AT&T Unix.
.Sh BUGS
.Nm Deroff
is not a complete
.Xr troff 1
interpreter, so it can be confused by subtle constructs.
Most errors result in too much rather than too little output.