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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
|
.ig
ditroff.man
Last update: 4 Jan 2002
This file is part of groff, the GNU roff type-setting system.
Copyright (C) 2001, 2002 Free Software Foundation, Inc.
written by Bernd Warken <bwarken@mayn.de>
maintained by Werner Lemberg <wl@gnu.org>
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with the
Invariant Sections being this .ig-section and AUTHORS, with no
Front-Cover Texts, and with no Back-Cover Texts.
A copy of the Free Documentation License is included as a file called
FDL in the main directory of the groff source package.
..
.
.\" --------------------------------------------------------------------
.\" Setup
.\" --------------------------------------------------------------------
.
.mso www.tmac
.
.if n \{\
. mso tty-char.tmac
. ftr CR R
. ftr CI I
. ftr CB B
.\}
.
.if '\*[.T]'dvi' \
. ftr CB CW
.
.
.\" --------------------------------------------------------------------
.\" Title
.\" --------------------------------------------------------------------
.
.TH DITROFF @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
.SH NAME
ditroff \- classical device independent roff
.
.
.\" --------------------------------------------------------------------
.SH DESCRIPTION
.\" --------------------------------------------------------------------
.
The name
.I ditroff
once marked a development level of the
.I troff
text processing system.
.
In actual
.BR roff (@MAN7EXT@)
systems, the name
.I troff
is used as a synonym for
.IR ditroff .
.
.P
The first roff system was written by Joe Osanna around 1973.
.
It supported only two output devices, the
.B nroff
program produced text oriented tty output, while the
.B troff
program generated graphical output for exactly one output device, the Wang
.I Graphic Systems CAT
typesetter.
.
.P
In 1979, Brian Kernighan rewrote troff to support more devices by
creating an intermediate output format for troff that can be fed into
postprocessor programs which actually do the printout on the device.
.
Kernighan's version marks what is known as
.I classical troff
today.
.
In order to distinguish it from Osanna's original mono-device version,
it was called
.I ditroff
.RI ( d\/ evice\~ i\/ ndependent\~ troff\/ )
on some systems, though this naming isn't mentioned in the classical
documentation.
.
.P
Today, any existing roff system is based on Kernighan's multi-device
troff.
.
The distinction between
.I troff
and
.I ditroff
isn't necessary any longer, for each modern
.I troff
provides already the complete functionality of
.IR ditroff .
.
On most systems, the name
.I troff
is used to denote
.IR ditroff .
.
.P
The easiest way to use ditroff is the GNU roff system,
.IR groff .
The
.BR groff (@MAN1EXT@)
program is a wrapper around
.I (di)troff
that automatically handles postprocessing.
.
.
.\" --------------------------------------------------------------------
.SH "SEE ALSO"
.\" --------------------------------------------------------------------
.
.TP
.I [CSTR\~#54]
The 1992 revision of the
.I Nroff/Troff User's Manual
by
.I J. F. Osanna
and
.IR "Brian Kernighan" ,
see
.br
.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \
"Bell Labs CSTR\~#54" .
.
.TP
.I [CSTR\~#97]
.I A Typesetter-independent TROFF
by
.I Brian Kernighan
is the original documentation of the first multi-device troff
.RI ( ditroff\/ ),
see
.br
.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz \
"Bell Labs CSTR\~#97" .
.
.TP
.BR roff (@MAN7EXT@)
This document gives details on the history and concepts of roff.
.
.TP
.BR @g@troff (@MAN1EXT@)
The actual implementation of
.IR ditroff .
.
.TP
.BR groff (@MAN1EXT@)
The GNU roff program and pointers to all documentation around groff.
.
.TP
.BR groff_out (@MAN5EXT@)
The groff version of the intermediate output language, the basis for
multi-devicing.
.
.
.\" --------------------------------------------------------------------
.SH "AUTHORS"
.\" --------------------------------------------------------------------
.
Copyright (C) 2001, 2002 Free Software Foundation, Inc.
.
.P
This document is distributed under the terms of the FDL (GNU Free
Documentation License) version 1.1 or later.
.
You should have received a copy of the FDL on your system, it is also
available on-line at the
.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
.
.P
This document is part of
.IR groff ,
the GNU roff distribution.
.
It was written by
.MTO bwarken@mayn.de "Bernd Warken"
and is maintained by
.MTO wl@gnu.org "Werner Lemberg" .
.
.
.\" --------------------------------------------------------------------
.\" Emacs settings
.\" --------------------------------------------------------------------
.\"
.\" Local Variables:
.\" mode: nroff
.\" End:
|
