diff options
author | wlemb <wlemb> | 2001-11-19 14:23:36 +0000 |
---|---|---|
committer | wlemb <wlemb> | 2001-11-19 14:23:36 +0000 |
commit | d924e1dd669583a615d264a17eecad98a4050b74 (patch) | |
tree | b028e0eb603121acb2d0eb511005c3b6d21a9430 | |
parent | 7c37bccc887cc2ca5f31797e527f007bf129b427 (diff) | |
download | groff-d924e1dd669583a615d264a17eecad98a4050b74.tar.gz |
*** empty log message ***
-rw-r--r-- | man/ditroff.man | 168 |
1 files changed, 168 insertions, 0 deletions
diff --git a/man/ditroff.man b/man/ditroff.man new file mode 100644 index 00000000..0d58b89e --- /dev/null +++ b/man/ditroff.man @@ -0,0 +1,168 @@ +.ig +ditroff.man + +This file is part of groff, the GNU roff type-setting system. + +Copyright (C) 2001 Free Software Foundation, Inc. +written by Bernd Warken <bwarken@mayn.de> + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with the +Invariant Sections being this .ig-section and AUTHORS, with no +Front-Cover Texts, and with no Back-Cover Texts. + +A copy of the Free Documentation License is included as a file called +FDL in the main directory of the groff source package. +.. +. +.\" -------------------------------------------------------------------- +.\" Setup +.\" -------------------------------------------------------------------- +. +.mso www.tmac +. +.\" -------------------------------------------------------------------- +.\" Title +.\" -------------------------------------------------------------------- +. +.TH DITROFF @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@" +.SH NAME +ditroff \- classical device independent roff +. +.\" -------------------------------------------------------------------- +.SH DESCRIPTION +.\" -------------------------------------------------------------------- +. +The name +.I ditroff +once marked a development level of the +.I troff +text processing system. +In actual +.BR roff (@MAN7EXT@) +systems, the name +.I troff +is used as a synonym for +.IR ditroff . +. +.P +The first roff system was written by Joe Osanna around 1973. +It supported only two output devices, the +.B nroff +program produced text oriented tty output, while the +.B troff +program generated graphical output for exactly one output device, the +.I Graphic Systems CAT +typesetter. +. +.P +In 1979, Brian Kernighan rewrote troff to support more devices by +creating an intermediate output format for troff that can be fed into +postprocessor programs which actually do the printout on the device. +Kernighan's version marks what is known as +.I classical troff +today. +In order to distinguish it from Osanna's original mono-device version, +it was called +.I ditroff +.RI ( d\/ evice\ i\/ ndependent\ troff ) +on some systems, though this naming isn't mentioned in the classical +documentation. +. +.P +Today, any existing roff system is based on Kernighan's multi-device +troff. +The distinction between +.I troff +and +.I ditroff +isn't necessary any longer, for each modern +.I troff +provides already the complete functionality of +.IR ditroff . +On most systems, the name +.I troff +is used to denote +.IR ditroff . +. +.P +The easiest way to use ditroff is the GNU roff system, +.IR groff . +The +.BR groff (@MAN1EXT@) +program is a wrapper around +.I (di)troff +that automatically handles postprocessing. +. +.\" -------------------------------------------------------------------- +.SH "SEE ALSO" +.\" -------------------------------------------------------------------- +. +.TP +.BR roff (@MAN7EXT@) +This document gives details on the history and concepts of roff and the +groff extensions. +. +.TP +.BR troff (@MAN1EXT@) +The actual implementation of +.IR ditroff . +. +.TP +.BR groff (@MAN1EXT@) +The GNU roff program. +. +.TP +.BR groff_out (@MAN5EXT@) +The groff version of the intermediate output language, the basis for +multi-devicing. +. +.TP +.I [CSTR #97] +.IR "A Typesetter-independent TROFF\/" , +written by +.IR "Brian Kernighan" . +This is the original documentation of the first multi-device troff +.IR (ditroff) . +See +.URL "Bell Labs CSTR #97" \ +http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz . +. +.TP +.I [CSTR #54] +The 1992 revision of the +.I Nroff/Troff User's Manual +by +.I J. F. Osanna +and +.IR "Brian Kernighan" ; +see +.URL "Bell Labs CSTR #54" \ +http://\:cm.bell-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz . +. +.\" -------------------------------------------------------------------- +.SH "AUTHORS" +.\" -------------------------------------------------------------------- +. +Copyright (C) 2001 Free Software Foundation, Inc. +. +.P +This document is distributed under the terms of the FDL (GNU Free +Documentation License) version 1.1 or later. +You should have received a copy of the FDL on your system, it is also +available on-line at the +.URL "GNU copyleft site" http://\:www.gnu.org/\:copyleft/\:fdl.html . +. +.P +This document is part of +.IR groff , +the GNU roff distribution. +. +..\" -------------------------------------------------------------------- +.\" Emacs settings +.\" -------------------------------------------------------------------- +.\" +.\" Local Variables: +.\" mode: nroff +.\" End: |