man/ditroff.man

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