ditroff.man revision 104862
1104862Sru.ig 2104862Sruditroff.man 3104862Sru 4104862SruLast update: 4 Jan 2002 5104862Sru 6104862SruThis file is part of groff, the GNU roff type-setting system. 7104862Sru 8104862SruCopyright (C) 2001, 2002 Free Software Foundation, Inc. 9104862Sruwritten by Bernd Warken <bwarken@mayn.de> 10104862Srumaintained by Werner Lemberg <wl@gnu.org> 11104862Sru 12104862SruPermission is granted to copy, distribute and/or modify this document 13104862Sruunder the terms of the GNU Free Documentation License, Version 1.1 or 14104862Sruany later version published by the Free Software Foundation; with the 15104862SruInvariant Sections being this .ig-section and AUTHORS, with no 16104862SruFront-Cover Texts, and with no Back-Cover Texts. 17104862Sru 18104862SruA copy of the Free Documentation License is included as a file called 19104862SruFDL in the main directory of the groff source package. 20104862Sru.. 21104862Sru. 22104862Sru.\" -------------------------------------------------------------------- 23104862Sru.\" Setup 24104862Sru.\" -------------------------------------------------------------------- 25104862Sru. 26104862Sru.mso www.tmac 27104862Sru. 28104862Sru.if n \{\ 29104862Sru. mso tty-char.tmac 30104862Sru. ftr CR R 31104862Sru. ftr CI I 32104862Sru. ftr CB B 33104862Sru.\} 34104862Sru. 35104862Sru.if '\*[.T]'dvi' \ 36104862Sru. ftr CB CW 37104862Sru. 38104862Sru. 39104862Sru.\" -------------------------------------------------------------------- 40104862Sru.\" Title 41104862Sru.\" -------------------------------------------------------------------- 42104862Sru. 43104862Sru.TH DITROFF @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@" 44104862Sru.SH NAME 45104862Sruditroff \- classical device independent roff 46104862Sru. 47104862Sru. 48104862Sru.\" -------------------------------------------------------------------- 49104862Sru.SH DESCRIPTION 50104862Sru.\" -------------------------------------------------------------------- 51104862Sru. 52104862SruThe name 53104862Sru.I ditroff 54104862Sruonce marked a development level of the 55104862Sru.I troff 56104862Srutext processing system. 57104862Sru. 58104862SruIn actual 59104862Sru.BR roff (@MAN7EXT@) 60104862Srusystems, the name 61104862Sru.I troff 62104862Sruis used as a synonym for 63104862Sru.IR ditroff . 64104862Sru. 65104862Sru.P 66104862SruThe first roff system was written by Joe Osanna around 1973. 67104862Sru. 68104862SruIt supported only two output devices, the 69104862Sru.B nroff 70104862Sruprogram produced text oriented tty output, while the 71104862Sru.B troff 72104862Sruprogram generated graphical output for exactly one output device, the Wang 73104862Sru.I Graphic Systems CAT 74104862Srutypesetter. 75104862Sru. 76104862Sru.P 77104862SruIn 1979, Brian Kernighan rewrote troff to support more devices by 78104862Srucreating an intermediate output format for troff that can be fed into 79104862Srupostprocessor programs which actually do the printout on the device. 80104862Sru. 81104862SruKernighan's version marks what is known as 82104862Sru.I classical troff 83104862Srutoday. 84104862Sru. 85104862SruIn order to distinguish it from Osanna's original mono-device version, 86104862Sruit was called 87104862Sru.I ditroff 88104862Sru.RI ( d\/ evice\~ i\/ ndependent\~ troff\/ ) 89104862Sruon some systems, though this naming isn't mentioned in the classical 90104862Srudocumentation. 91104862Sru. 92104862Sru.P 93104862SruToday, any existing roff system is based on Kernighan's multi-device 94104862Srutroff. 95104862Sru. 96104862SruThe distinction between 97104862Sru.I troff 98104862Sruand 99104862Sru.I ditroff 100104862Sruisn't necessary any longer, for each modern 101104862Sru.I troff 102104862Sruprovides already the complete functionality of 103104862Sru.IR ditroff . 104104862Sru. 105104862SruOn most systems, the name 106104862Sru.I troff 107104862Sruis used to denote 108104862Sru.IR ditroff . 109104862Sru. 110104862Sru.P 111104862SruThe easiest way to use ditroff is the GNU roff system, 112104862Sru.IR groff . 113104862SruThe 114104862Sru.BR groff (@MAN1EXT@) 115104862Sruprogram is a wrapper around 116104862Sru.I (di)troff 117104862Sruthat automatically handles postprocessing. 118104862Sru. 119104862Sru. 120104862Sru.\" -------------------------------------------------------------------- 121104862Sru.SH "SEE ALSO" 122104862Sru.\" -------------------------------------------------------------------- 123104862Sru. 124104862Sru.TP 125104862Sru.I [CSTR\~#54] 126104862SruThe 1992 revision of the 127104862Sru.I Nroff/Troff User's Manual 128104862Sruby 129104862Sru.I J. F. Osanna 130104862Sruand 131104862Sru.IR "Brian Kernighan" , 132104862Srusee 133104862Sru.br 134104862Sru.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \ 135104862Sru "Bell Labs CSTR\~#54" . 136104862Sru. 137104862Sru.TP 138104862Sru.I [CSTR\~#97] 139104862Sru.I A Typesetter-independent TROFF 140104862Sruby 141104862Sru.I Brian Kernighan 142104862Sruis the original documentation of the first multi-device troff 143104862Sru.RI ( ditroff\/ ), 144104862Srusee 145104862Sru.br 146104862Sru.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz \ 147104862Sru "Bell Labs CSTR\~#97" . 148104862Sru. 149104862Sru.TP 150104862Sru.BR roff (@MAN7EXT@) 151104862SruThis document gives details on the history and concepts of roff. 152104862Sru. 153104862Sru.TP 154104862Sru.BR @g@troff (@MAN1EXT@) 155104862SruThe actual implementation of 156104862Sru.IR ditroff . 157104862Sru. 158104862Sru.TP 159104862Sru.BR groff (@MAN1EXT@) 160104862SruThe GNU roff program and pointers to all documentation around groff. 161104862Sru. 162104862Sru.TP 163104862Sru.BR groff_out (@MAN5EXT@) 164104862SruThe groff version of the intermediate output language, the basis for 165104862Srumulti-devicing. 166104862Sru. 167104862Sru. 168104862Sru.\" -------------------------------------------------------------------- 169104862Sru.SH "AUTHORS" 170104862Sru.\" -------------------------------------------------------------------- 171104862Sru. 172104862SruCopyright (C) 2001, 2002 Free Software Foundation, Inc. 173104862Sru. 174104862Sru.P 175104862SruThis document is distributed under the terms of the FDL (GNU Free 176104862SruDocumentation License) version 1.1 or later. 177104862Sru. 178104862SruYou should have received a copy of the FDL on your system, it is also 179104862Sruavailable on-line at the 180104862Sru.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" . 181104862Sru. 182104862Sru.P 183104862SruThis document is part of 184104862Sru.IR groff , 185104862Sruthe GNU roff distribution. 186104862Sru. 187104862SruIt was written by 188104862Sru.MTO bwarken@mayn.de "Bernd Warken" 189104862Sruand is maintained by 190104862Sru.MTO wl@gnu.org "Werner Lemberg" . 191104862Sru. 192104862Sru. 193104862Sru.\" -------------------------------------------------------------------- 194104862Sru.\" Emacs settings 195104862Sru.\" -------------------------------------------------------------------- 196104862Sru.\" 197104862Sru.\" Local Variables: 198104862Sru.\" mode: nroff 199104862Sru.\" End: 200