Blob


1 .TH DEROFF 1
2 .SH NAME
3 deroff, delatex \- remove formatting requests
4 .SH SYNOPSIS
5 .B deroff
6 [
7 .I option ...
8 ]
9 .I file ...
10 .PP
11 .B delatex
12 .I file
13 .SH DESCRIPTION
14 .I Deroff
15 reads each file in sequence
16 and removes all
17 .I nroff
18 and
19 .MR troff (1)
20 requests and non-text arguments, backslash constructions,
21 and constructs of preprocessors such as
22 .MR eqn (1) ,
23 .MR pic (1) ,
24 and
25 .MR tbl (1) .
26 Remaining text is written on the standard output.
27 .I Deroff
28 follows files included by
29 .L .so
30 and
31 .L .nx
32 commands;
33 if a file has already been included, a
34 .L .so
35 for that file is ignored and a
36 .L .nx
37 terminates execution.
38 If no input file is given,
39 .I deroff
40 reads from standard input.
41 .PP
42 The options are
43 .TP
44 .B -w
45 Output a word list, one `word' (string of letters, digits, and
46 properly embedded ampersands and apostrophes,
47 beginning with a letter) per line.
48 Other characters are skipped.
49 Otherwise, the output follows the original, with the deletions mentioned above.
50 .TP
51 .B -_
52 Like
53 .BR -w ,
54 but consider underscores to be alphanumeric rather than punctuation.
55 .TP
56 .B -i
57 Ignore
58 .L .so
59 and
60 .L .nx
61 requests.
62 .TP
63 .BR -ms
64 .PD0
65 .TP
66 .B -mm
67 Remove titles, attachments, etc., as well as ordinary
68 .IR troff
69 constructs, from
70 .MR ms (7)
71 or
72 .I mm
73 documents.
74 .PD
75 .TP
76 .B -ml
77 Same as
78 .BR -mm ,
79 but remove lists as well.
80 .PP
81 .I Delatex
82 does for
83 .I tex
84 and
85 .I latex
86 (see
87 .MR tex (1) )
88 files what
89 .B deroff -wi
90 does for
91 .I troff
92 files.
93 .SH SOURCE
94 .B \*9/src/cmd/deroff.c
95 .br
96 .B \*9/src/cmd/delatex.lx
97 .SH "SEE ALSO"
98 .IR troff (1),
99 .MR tex (1) ,
100 .MR spell (1)
101 .SH BUGS
102 These filters are not complete interpreters of
103 .I troff
104 or
105 .IR tex .
106 For example, macro definitions containing
107 .L \e$
108 cause chaos in
109 .IR deroff
110 when the popular
111 .L $$
112 delimiters for
113 .I eqn
114 are in effect.
115 .PP
116 Text inside macros is emitted at place of
117 definition, not place of call.