contrib/groff-1.19/man/ditroff.man

   1 .ig
   2 ditroff.man
   3
   4 Last update: 2 Jul 2004
   5
   6 This file is part of groff, the GNU roff type-setting system.
   7
   8 Copyright (C) 2001, 2002, 2004 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 (\c
  89 .IR d\/ evice\~ i\/ ndependent\~ troff\/\c
  90 )
  91 on some systems, though this naming isn't mentioned in the classical
  92 documentation.
  93 .
  94 .P
  95 Today, any existing roff system is based on Kernighan's multi-device
  96 troff.
  97 .
  98 The distinction between
  99 .I troff
 100 and
 101 .I ditroff
 102 isn't necessary any longer, for each modern
 103 .I troff
 104 provides already the complete functionality of
 105 .IR ditroff .
 106 .
 107 On most systems, the name
 108 .I troff
 109 is used to denote
 110 .IR ditroff .
 111 .
 112 .P
 113 The easiest way to use ditroff is the GNU roff system,
 114 .IR groff .
 115 The
 116 .BR groff (@MAN1EXT@)
 117 program is a wrapper around
 118 .I (di)troff
 119 that automatically handles postprocessing.
 120 .
 121 .
 122 .\" --------------------------------------------------------------------
 123 .SH "SEE ALSO"
 124 .\" --------------------------------------------------------------------
 125 .
 126 .TP
 127 .I [CSTR\~#54]
 128 The 1992 revision of the
 129 .I Nroff/Troff User's Manual
 130 by
 131 .I J. F. Osanna
 132 and
 133 .IR "Brian Kernighan" ,
 134 see
 135 .br
 136 .URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz \
 137      "Bell Labs CSTR\~#54" .
 138 .
 139 .TP
 140 .I [CSTR\~#97]
 141 .I A Typesetter-independent TROFF
 142 by
 143 .I Brian Kernighan
 144 is the original documentation of the first multi-device troff
 145 .RI ( ditroff\/ ),
 146 see
 147 .br
 148 .URL http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz \
 149      "Bell Labs CSTR\~#97" .
 150 .
 151 .TP
 152 .BR roff (@MAN7EXT@)
 153 This document gives details on the history and concepts of roff.
 154 .
 155 .TP
 156 .BR @g@troff (@MAN1EXT@)
 157 The actual implementation of
 158 .IR ditroff .
 159 .
 160 .TP
 161 .BR groff (@MAN1EXT@)
 162 The GNU roff program and pointers to all documentation around groff.
 163 .
 164 .TP
 165 .BR groff_out (@MAN5EXT@)
 166 The groff version of the intermediate output language, the basis for
 167 multi-devicing.
 168 .
 169 .
 170 .\" --------------------------------------------------------------------
 171 .SH "AUTHORS"
 172 .\" --------------------------------------------------------------------
 173 .
 174 Copyright (C) 2001, 2002, 2004 Free Software Foundation, Inc.
 175 .
 176 .P
 177 This document is distributed under the terms of the FDL (GNU Free
 178 Documentation License) version 1.1 or later.
 179 .
 180 You should have received a copy of the FDL on your system, it is also
 181 available on-line at the
 182 .URL http://\:www.gnu.org/\:copyleft/\:fdl.html "GNU copyleft site" .
 183 .
 184 .P
 185 This document is part of
 186 .IR groff ,
 187 the GNU roff distribution.
 188 .
 189 It was written by
 190 .MTO bwarken@mayn.de "Bernd Warken"
 191 and is maintained by
 192 .MTO wl@gnu.org "Werner Lemberg" .
 193 .
 194 .
 195 .\" --------------------------------------------------------------------
 196 .\" Emacs settings
 197 .\" --------------------------------------------------------------------
 198 .\"
 199 .\" Local Variables:
 200 .\" mode: nroff
 201 .\" End: