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