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

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