man/ditroff.man

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