1104862Sru.ig 2104862Sruditroff.man 3104862Sru 4151497SruLast update: 2 Jul 2004 5104862Sru 6104862SruThis file is part of groff, the GNU roff type-setting system. 7104862Sru 8151497SruCopyright (C) 2001, 2002, 2004 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 88151497Sru(\c 89151497Sru.IR d\/ evice\~ i\/ ndependent\~ troff\/\c 90151497Sru) 91104862Sruon some systems, though this naming isn't mentioned in the classical 92104862Srudocumentation. 93104862Sru. 94104862Sru.P 95104862SruToday, any existing roff system is based on Kernighan's multi-device 96104862Srutroff. 97104862Sru. 98104862SruThe distinction between 99104862Sru.I troff 100104862Sruand 101104862Sru.I ditroff 102104862Sruisn't necessary any longer, for each modern 103104862Sru.I troff 104104862Sruprovides already the complete functionality of 105104862Sru.IR ditroff . 106104862Sru. 107104862SruOn most systems, the name 108104862Sru.I troff 109104862Sruis used to denote 110104862Sru.IR ditroff . 111104862Sru. 112104862Sru.P 113104862SruThe easiest way to use ditroff is the GNU roff system, 114104862Sru.IR groff . 115104862SruThe 116104862Sru.BR groff (@MAN1EXT@) 117104862Sruprogram is a wrapper around 118104862Sru.I (di)troff 119104862Sruthat automatically handles postprocessing. 120104862Sru. 121104862Sru. 122104862Sru.\" -------------------------------------------------------------------- 123104862Sru.SH "SEE ALSO" 124104862Sru.\" -------------------------------------------------------------------- 125104862Sru. 126104862Sru.TP 127104862Sru.I [CSTR\~#54] 128104862SruThe 1992 revision of the 129104862Sru.I Nroff/Troff User's Manual 130104862Sruby 131104862Sru.I J. F. Osanna 132104862Sruand 133104862Sru.IR "Brian Kernighan" , 134104862Srusee 135104862Sru.br 136104862Sru.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \ 137104862Sru "Bell Labs CSTR\~#54" . 138104862Sru. 139104862Sru.TP 140104862Sru.I [CSTR\~#97] 141104862Sru.I A Typesetter-independent TROFF 142104862Sruby 143104862Sru.I Brian Kernighan 144104862Sruis the original documentation of the first multi-device troff 145104862Sru.RI ( ditroff\/ ), 146104862Srusee 147104862Sru.br 148104862Sru.URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz \ 149104862Sru "Bell Labs CSTR\~#97" . 150104862Sru. 151104862Sru.TP 152104862Sru.BR roff (@MAN7EXT@) 153104862SruThis document gives details on the history and concepts of roff. 154104862Sru. 155104862Sru.TP 156104862Sru.BR @g@troff (@MAN1EXT@) 157104862SruThe actual implementation of 158104862Sru.IR ditroff . 159104862Sru. 160104862Sru.TP 161104862Sru.BR groff (@MAN1EXT@) 162104862SruThe GNU roff program and pointers to all documentation around groff. 163104862Sru. 164104862Sru.TP 165104862Sru.BR groff_out (@MAN5EXT@) 166104862SruThe groff version of the intermediate output language, the basis for 167104862Srumulti-devicing. 168104862Sru. 169104862Sru. 170104862Sru.\" -------------------------------------------------------------------- 171104862Sru.SH "AUTHORS" 172104862Sru.\" -------------------------------------------------------------------- 173104862Sru. 174151497SruCopyright (C) 2001, 2002, 2004 Free Software Foundation, Inc. 175104862Sru. 176104862Sru.P 177104862SruThis document is distributed under the terms of the FDL (GNU Free 178104862SruDocumentation License) version 1.1 or later. 179104862Sru. 180104862SruYou should have received a copy of the FDL on your system, it is also 181104862Sruavailable on-line at the 182104862Sru.URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" . 183104862Sru. 184104862Sru.P 185104862SruThis document is part of 186104862Sru.IR groff , 187104862Sruthe GNU roff distribution. 188104862Sru. 189104862SruIt was written by 190104862Sru.MTO bwarken@mayn.de "Bernd Warken" 191104862Sruand is maintained by 192104862Sru.MTO wl@gnu.org "Werner Lemberg" . 193104862Sru. 194104862Sru. 195104862Sru.\" -------------------------------------------------------------------- 196104862Sru.\" Emacs settings 197104862Sru.\" -------------------------------------------------------------------- 198104862Sru.\" 199104862Sru.\" Local Variables: 200104862Sru.\" mode: nroff 201104862Sru.\" End: 202