contrib/groff/man/ditroff.man

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