summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorwlemb <wlemb>2001-11-19 14:23:36 +0000
committerwlemb <wlemb>2001-11-19 14:23:36 +0000
commitd924e1dd669583a615d264a17eecad98a4050b74 (patch)
treeb028e0eb603121acb2d0eb511005c3b6d21a9430
parent7c37bccc887cc2ca5f31797e527f007bf129b427 (diff)
downloadgroff-d924e1dd669583a615d264a17eecad98a4050b74.tar.gz
*** empty log message ***
-rw-r--r--man/ditroff.man168
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: