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