/contrib/groff/man/ditroff.man

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 201 lines · 196 code · 5 blank · 0 comment · 0 complexity · 4bd8c341c80cbfdd9cbeb289e242e560 MD5 · raw file

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