share/doc/usd/22.trofftut/tt00

   1 .\" Hey, Emacs, edit this file in -*- nroff-fill -*- mode!
   2 .\" This module is believed to contain source code proprietary to AT&T.
   3 .\" Use and redistribution is subject to the Berkeley Software License
   4 .\" Agreement and your Software Agreement with AT&T (Western Electric).
   5 .\"
   6 .\"     @(#)tt00        8.1 (Berkeley) 6/8/93
   7 .\" Copyright (C) Caldera International Inc. 2001-2002.  All rights reserved.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions are
  11 .\" met:
  12 .\"
  13 .\" Redistributions of source code and documentation must retain the above
  14 .\" copyright notice, this list of conditions and the following
  15 .\" disclaimer.
  16 .\"
  17 .\" Redistributions in binary form must reproduce the above copyright
  18 .\" notice, this list of conditions and the following disclaimer in the
  19 .\" documentation and/or other materials provided with the distribution.
  20 .\"
  21 .\" All advertising materials mentioning features or use of this software
  22 .\" must display the following acknowledgement:
  23 .\"
  24 .\" This product includes software developed or owned by Caldera
  25 .\" International, Inc.  Neither the name of Caldera International, Inc.
  26 .\" nor the names of other contributors may be used to endorse or promote
  27 .\" products derived from this software without specific prior written
  28 .\" permission.
  29 .\"
  30 .\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA
  31 .\" INTERNATIONAL, INC.  AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
  32 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  33 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  34 .\" DISCLAIMED.  IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE LIABLE
  35 .\" FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR
  36 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  37 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
  38 .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  39 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  40 .\" OR OTHERWISE) RISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  41 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  42 .\"
  43 .\" $FreeBSD$
  44 .\"
  45 .EH 'USD:22-%''A TROFF Tutorial'
  46 .OH 'A TROFF Tutorial''USD:22-%'
  47 .\".RP
  48 .\" .....TM 76-1273-7 39199 39199-11
  49 .TL
  50 A TROFF Tutorial
  51 .AU "MH 2C-518" 6021
  52 Brian W. Kernighan
  53 (updated for 4.3BSD by Mark Seiden)
  54 .AI
  55 .\" What's this? .MH
  56 .\" And this? .OK
  57 \"Typesetting
  58 \"Text formatting
  59 \"NROFF
  60 .AB
  61 .PP
  62 .UL troff
  63 is a text-formatting program for
  64 typesetting on the
  65 .UX
  66 operating system.
  67 This device is capable of producing high quality
  68 text;
  69 this paper is an example of
  70 .UL troff
  71 output.
  72 .PP
  73 The phototypesetter itself normally runs with four fonts,
  74 containing roman, italic and bold letters
  75 (as on this page),
  76 a full greek alphabet, and a substantial number of
  77 special characters and mathematical symbols.
  78 Characters can be printed in a range of sizes,
  79 and placed anywhere on the page.
  80 .PP
  81 .UL troff
  82 allows the user full control over fonts,
  83 sizes, and character positions,
  84 as well as the usual features of a formatter _
  85 right-margin justification, automatic hyphenation,
  86 page titling and numbering, and so on.
  87 It also provides macros, arithmetic variables and operations,
  88 and conditional testing, for complicated formatting tasks.
  89 .PP
  90 This document is an introduction to the most basic use of
  91 .UL troff .
  92 It presents just enough information to enable the user
  93 to do simple formatting
  94 tasks like making viewgraphs,
  95 and to make incremental changes to existing packages
  96 of
  97 .UL troff
  98 commands.
  99 In most respects, the
 100 .UC UNIX
 101 formatter
 102 .UL nroff
 103 and a more recent version
 104 .ul
 105 (device-independent
 106 .UL troff)
 107 are identical to
 108 the version described here, so this document also serves as a tutorial for
 109 them as well.
 110 .PP
 111 .vs 12p
 112 \fB\s+1NOTE: This document refers to the historical \f(BItroff\fB program, and
 113 not to \f(BIgroff\fB.  This is a first cut at importing the tutorial from
 114 4.4BSD, now that the code has been released.  It should at some time be modified
 115 to describe \f(BIgroff\fR.\s0
 116 .AE
 117 .nr LL 6.5i
 118 .nr LT 6.5i
 119 .\" Unknown macro .CS 13 1 14 0 0 5
 120 .if t .2C
 121 .nr PS 9
 122 .nr VS 11