summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/deroff/deroff.1
blob: f6f7aa2170fa69a39aac3044068713f875ed6387 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
.\" $OpenBSD: deroff.1,v 1.3 1998/11/14 00:14:19 espie Exp $ -*- nroff -*-
.\" $DebianId: deroff.1,v 1.1 1996/12/27 23:21:22 david Rel david $
.TH DEROFF 1 "December 23, 1996"
.SH NAME
deroff \- remove troff and preprocessor constructs
.SH SYNOPSIS
.B deroff 
[-w] 
.RI { file(s) }
.PP
.SH DESCRIPTION
.B deroff
reads in the named files (or stdin if none are given) and strips out 
.B troff 
constructs and macros. The preprocessor
.RB ( eqn ", " tbl ", " pic ", " grap ", and "vgrind )
sections are removed entirely.
The resulting output, suitable for spelling, is sent to stdout.
.PP
.SH OPTIONS
.TP
.I \-w
output a word-by-word list, delimited by newlines.
.PP
.SH SEE ALSO
.BR troff (1),
.BR eqn (1),
.BR pic (1),
.BR grap (1) ,
.BR vgrind (1) .
.PP
.SH BUGS
.B deroff
is not a full 
.BR troff (1)
interpreter; in particular it doesn't know how to expand macros and how to
treat 
.IR m[mse] "'s"
registers.
.br
Macros are assumed to end with 
.I .. 
and are simply skipped.
.br
.B deroff
can be fooled with circular 
.IR ".nx " requests.
The
.IR ".so " request
deepness is limited.
.PP
.SH AUTHOR
David Frey <david@eos.lugs.ch>