man/ditroff.7.in

   1 .ig
   2 @ ditroff.7
   3
   4 Copyright (c) 2014 - 2015 Steffen (Daode) Nurpmeso <sdaoden@users.sf.net>.
   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 DITROFF @MAN7EXT@ "@MDATE@" "@T_ROFF@ v@VERSION@"
  21 .
  22 .SH NAME
  23 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 roff (@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 (\c
  67 .IR d\/ "evice " i\/ "ndependent " troff\/\c
  68 )
  69 on some systems, though this naming isn't mentioned in the classical
  70 documentation.
  71 .
  72 .P
  73 Today, any existing roff system is based on Kernighan's multi-device
  74 troff.
  75 .
  76 The distinction between
  77 .I troff
  78 and
  79 .I ditroff
  80 isn't necessary any longer, for each modern
  81 .I troff
  82 provides already the complete functionality of
  83 .IR ditroff .
  84 .
  85 On most systems, the name
  86 .I troff
  87 is used to denote
  88 .IR ditroff .
  89 .
  90 .P
  91 The easiest way to use ditroff is
  92 .BR @L_ROFF@ (@MAN1EXT@),
  93 a wrapper around
  94 .I (di)troff
  95 that automatically handles postprocessing.
  96 .
  97 .
  98 .\"
  99 .SH "SEE ALSO"
 100 .\"
 101 .
 102 .TP
 103 .I [CSTR\~#54]
 104 The 1992 revision of the
 105 .I Nroff/Troff User's Manual
 106 by
 107 .I J.\& F.\& Ossanna
 108 and
 109 .IR "Brian Kernighan" ,
 110 see
 111 .UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
 112 Bell Labs CSTR\~#54
 113 .UE .
 114 .
 115 .TP
 116 .I [CSTR\~#97]
 117 .I A Typesetter-independent TROFF
 118 by
 119 .I Brian Kernighan
 120 is the original documentation of the first multi-device troff
 121 .RI ( ditroff\/ ),
 122 see
 123 .UR http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz
 124 Bell Labs CSTR\~#97
 125 .UE .
 126 .
 127 .TP
 128 .BR roff (@MAN7EXT@)
 129 This document gives details on the history and concepts of roff.
 130 .
 131 .TP
 132 .BR @L_TROFF@ (@MAN1EXT@)
 133 The actual implementation of
 134 .IR ditroff .
 135 .
 136 .TP
 137 .BR @L_ROFF@ (@MAN1EXT@)
 138 The @L_ROFF@ program and pointers to all documentation around @T_ROFF@.
 139 .
 140 .TP
 141 .BR @L_ROFF@_out (@MAN5EXT@)
 142 The @T_ROFF@ version of the intermediate output language, the basis for
 143 multi-devicing.
 144 .
 145 .
 146 .\"
 147 .SH "AUTHORS"
 148 .\"
 149 .
 150 Copyright (c) 2014 - 2015 Steffen (Daode) Nurpmeso <sdaoden@users.sf.net>.
 151
 152 Copyright (C) 2001, 2002, 2004, 2007, 2008 Free Software Foundation, Inc.
 153 .
 154 .P
 155 This document is distributed under the terms of the FDL (GNU Free
 156 Documentation License) version 1.1 or later.
 157 .
 158 You should have received a copy of the FDL on your system, it is also
 159 available on-line at the
 160 .UR http://\:www.gnu.org/\:copyleft/\:fdl.html
 161 GNU copyleft site
 162 .UE .
 163 .
 164 .P
 165 This document was written by
 166 .MT bwarken@\:mayn.de
 167 Bernd Warken
 168 .ME .
 169 .\" s-ts-mode