man/l_ditroff.7.in

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