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

.\"	@(#)deroff.1	4.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
3c21473c KM	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.