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 .ND
  50 .TL
  51 A TROFF Tutorial
  52 .AU "MH 2C-518" 6021
  53 Brian W. Kernighan
  54 (updated for 4.3BSD by Mark Seiden)
  55 .AI
  56 .\" What's this? .MH
  57 .\" And this? .OK
  58 \"Typesetting
  59 \"Text formatting
  60 \"NROFF
  61 .AB
  62 .PP
  63 .UL troff
  64 is a text-formatting program for
  65 typesetting on the
  66 .UX
  67 operating system.
  68 This device is capable of producing high quality
  69 text;
  70 this paper is an example of
  71 .UL troff
  72 output.
  73 .PP
  74 The phototypesetter itself normally runs with four fonts,
  75 containing roman, italic and bold letters
  76 (as on this page),
  77 a full greek alphabet, and a substantial number of
  78 special characters and mathematical symbols.
  79 Characters can be printed in a range of sizes,
  80 and placed anywhere on the page.
  81 .PP
  82 .UL troff
  83 allows the user full control over fonts,
  84 sizes, and character positions,
  85 as well as the usual features of a formatter _
  86 right-margin justification, automatic hyphenation,
  87 page titling and numbering, and so on.
  88 It also provides macros, arithmetic variables and operations,
  89 and conditional testing, for complicated formatting tasks.
  90 .PP
  91 This document is an introduction to the most basic use of
  92 .UL troff .
  93 It presents just enough information to enable the user
  94 to do simple formatting
  95 tasks like making viewgraphs,
  96 and to make incremental changes to existing packages
  97 of
  98 .UL troff
  99 commands.
 100 In most respects, the
 101 .UC UNIX
 102 formatter
 103 .UL nroff
 104 and a more recent version
 105 .ul
 106 (device-independent
 107 .UL troff)
 108 are identical to
 109 the version described here, so this document also serves as a tutorial for
 110 them as well.
 111 .PP
 112 .vs 12p
 113 \fB\s+1NOTE: This document refers to the historical \f(BItroff\fB program, and
 114 not to \f(BIgroff\fB.  This is a first cut at importing the tutorial from
 115 4.4BSD, now that the code has been released.  It should at some time be modified
 116 to describe \f(BIgroff\fR.\s0
 117 .AE
 118 .nr LL 6.5i
 119 .nr LT 6.5i
 120 .\" Unknown macro .CS 13 1 14 0 0 5
 121 .if t .2C
 122 .nr PS 9
 123 .nr VS 11