BSD 4_4 release

[unix-history] / usr / src / old / roff / nroff / nroff.1

diff --git a/usr/src/old/roff/nroff/nroff.1 b/usr/src/old/roff/nroff/nroff.1
index 4188592..002ad41 100644 (file)
--- a/usr/src/old/roff/nroff/nroff.1
+++ b/usr/src/old/roff/nroff/nroff.1
@@ -1,10 +1,13 @@
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.

-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" All rights reserved.

 .\"
 .\"

-.\"     @(#)nroff.1    6.4 (Berkeley) %G%
+.\" This module is believed to contain source code proprietary to AT&T.
+.\" Use and redistribution is subject to the Berkeley Software License
+.\" Agreement and your Software Agreement with AT&T (Western Electric).

 .\"
 .\"

-.Dd 
+.\"    @(#)nroff.1     6.8 (Berkeley) 8/9/91
+.\"
+.Dd August 9, 1991

 .Dt NROFF 1
 .Os BSD 4.2
 .Sh NAME
 .Dt NROFF 1
 .Os BSD 4.2
 .Sh NAME


@@ -12,10 +15,10 @@
 .Nd text formatting
 .Sh SYNOPSIS
 .Nm nroff
 .Nd text formatting
 .Sh SYNOPSIS
 .Nm nroff

-.Op  option
-\&...
-.Op  file
-\&...
+.Op option
+.Ar ...
+.Op file
+.Ar ...

 .Sh DESCRIPTION
 .Nm Nroff
 formats text in the named
 .Sh DESCRIPTION
 .Nm Nroff
 formats text in the named


@@ -25,7 +28,7 @@ for typewriter-like devices.  See also
 The full capabilities of
 .Nm nroff
 are described in the
 The full capabilities of
 .Nm nroff
 are described in the

-.Em Nroff/Troff User's Manual .
+.%T "Nroff/Troff User's Manual" .

 .Pp
 If no
 .Ar file
 .Pp
 If no
 .Ar file


@@ -37,10 +40,8 @@ is taken to be a file name corresponding to the standard input.
 The options, which may appear in any order so long as they appear
 .Ar before
 the files, are:
 The options, which may appear in any order so long as they appear
 .Ar before
 the files, are:

-.Tw Fl
-.Tp Cx Fl o
-.Ar list
-.Cx
+.Bl -tag -width indent
+.It Fl o Ns Ar list 

 Print only pages whose page numbers appear in the comma-separated
 .Ar list
 of numbers and ranges.  A range
 Print only pages whose page numbers appear in the comma-separated
 .Ar list
 of numbers and ranges.  A range


@@ -58,14 +59,10 @@ and a final
 means from
 .Ar N
 to the end.
 means from
 .Ar N
 to the end.

-.Tp Cx Fl n
-.Ar N
-.Cx
+.It Fl n Ns Ar N 

 Number first generated page
 .Ar N  .
 Number first generated page
 .Ar N  .

-.Tp Cx Fl s
-.Ar N
-.Cx
+.It Fl s Ns Ar N 

 Stop every
 .Ar N
 pages.
 Stop every
 .Ar N
 pages.


@@ -73,102 +70,87 @@ pages.
 will halt prior to every
 .Ar N
 pages (default
 will halt prior to every
 .Ar N
 pages (default

-.Cx Ar N
-.Cx =1)
-.Cx
+.Ar N Ns =1) 

 to allow paper loading or changing, and will resume upon receipt of a newline.
 to allow paper loading or changing, and will resume upon receipt of a newline.

-.Tp Cx Fl m
-.Ar name
-.Cx
+.It Fl m Ns Ar name 

 Prepend the macro file
 .Pa /usr/share/tmac/tmac.name
 to the input
 .Ar files  .
 Prepend the macro file
 .Pa /usr/share/tmac/tmac.name
 to the input
 .Ar files  .

-.Tp Cx Fl r
-.Ar aN
-.Cx
+.It Fl r Ns Ar aN 

 Set register
 .Ar a
 (one-character) to
 .Ar N  .
 Set register
 .Ar a
 (one-character) to
 .Ar N  .

-.Tp Fl i
+.It Fl i

 Read standard input after the input files are exhausted.
 Read standard input after the input files are exhausted.

-.Tp Fl q
+.It Fl q

 Invoke the simultaneous input-output mode of the
 .Ar rd
 request.
 Invoke the simultaneous input-output mode of the
 .Ar rd
 request.

-.Tp Cx Fl T
-.Ar name
-.Cx
+.It Fl T Ns Ar name 

 Prepare output for specified terminal.  Known
 .Ar names
 are:
 .Pp
 Prepare output for specified terminal.  Known
 .Ar names
 are:
 .Pp

-.Tw Cm
-.Tp Cm 37
+.Bl -tag -width xeroxxx -compact
+.It Cm 37

 for the Teletype Corporation Model 37 terminal,
 for the Teletype Corporation Model 37 terminal,

-.Tp Cm crt
+.It Cm crt

 the default; linked to lpr and tn300, for the GE TermiNet 300 (or any
 terminal without reverse-line or half-line capability),
 the default; linked to lpr and tn300, for the GE TermiNet 300 (or any
 terminal without reverse-line or half-line capability),

-.Tp Cm 300
+.It Cm 300

 for the DTC 300,
 for the DTC 300,

-.Tp Cm 302
+.It Cm 302

 for the DTC 302S and the DTC 300S,
 for the DTC 302S and the DTC 300S,

-.Tp Cm 382
+.It Cm 382

 for the DTC 382,
 for the DTC 382,

-.Tp Cm 450
+.It Cm 450

 for the DTC 450 and the IPSI 1622,
 for the DTC 450 and the IPSI 1622,

-.Tp Cm 833
+.It Cm 833

 for the AJ 832/833,
 for the AJ 832/833,

-.Tp Cm epson
+.It Cm epson

 for the Epson FX80,
 for the Epson FX80,

-.Tp Cm itoh
+.It Cm itoh

 for the C:ITOH Prowriter
 for the C:ITOH Prowriter

-.Tp Cm nec
+.It Cm nec

 for the NEC-55?0/77?0 Spinwriter, with the Courier-72/Manifold
 thimble,
 for the NEC-55?0/77?0 Spinwriter, with the Courier-72/Manifold
 thimble,

-.Tp Cm nec-t
+.It Cm nec-t

 for the NEC-55?0/77?0 Spinwriter, with the Tech-Math/Times-Roman
 thimble,
 for the NEC-55?0/77?0 Spinwriter, with the Tech-Math/Times-Roman
 thimble,

-.Tp Cm nec25-t
+.It Cm nec25-t

 for the NEC-5525/7725 Spinwriter, with the Tech-Math/Times-Roman
 thimble,
 for the NEC-5525/7725 Spinwriter, with the Tech-Math/Times-Roman
 thimble,

-.Tp Cm qume
+.It Cm qume

 for the Qume Sprint 5 or 9,
 for the Qume Sprint 5 or 9,

-.Tp Cm x-ecs
+.It Cm x-ecs

 for the Xerox/Diablo 1730/630, extended character set,
 for the Xerox/Diablo 1730/630, extended character set,

-.Tp Cm xerox
+.It Cm xerox

 for the Xerox 17?0 or the Diablo 16?0.
 Most of these also have versions for 12 pitch.
 for the Xerox 17?0 or the Diablo 16?0.
 Most of these also have versions for 12 pitch.

-where did this file go? see
+See

 .Pa /usr/libdata/term/README
 for more information.
 .Pa /usr/libdata/term/README
 for more information.

-.Tp Fl e
+.El
+.It Fl e

 Produce equally-spaced words in adjusted lines, using full terminal resolution.
 Produce equally-spaced words in adjusted lines, using full terminal resolution.

-.Tp Fl h
+.It Fl h

 Use output tabs during horizontal spacing
 to speed output and reduce output character count.
 Tab settings are assumed to be every 8 nominal character widths.
 Use output tabs during horizontal spacing
 to speed output and reduce output character count.
 Tab settings are assumed to be every 8 nominal character widths.

-.Tp
+.El

 .Sh FILES
 .Sh FILES

-.Dw /usr/share/tmac/tmac.*
-.Di L
-.Dp Pa /tmp/ta*
-temporary file
-.Dp Pa /usr/share/tmac/tmac.*
-standard macro files
-.Dp Pa /usr/libdata/term/*
-terminal driving tables for
-.Nm nroff
-.br
-.Dp
+.Bl -tag -width /usr/share/tmac/tmac.* -compact
+.It Pa /tmp/ta*
+Temporary file.
+.It Pa /usr/share/tmac/tmac.*
+Standard macro files
+.It Pa /usr/libdata/term/*
+Terminal driving tables for
+.Nm nroff .
+.El

 .Sh SEE ALSO
 .Sh SEE ALSO

-J. F. Ossanna,
-.Em Nroff/ Troff user's manual
-.br
-B. W. Kernighan,
-.Em A TROFF Tutorial
-.br

 .Xr troff 1 ,
 .Xr eqn 1 ,
 .Xr tbl 1 ,
 .Xr troff 1 ,
 .Xr eqn 1 ,
 .Xr tbl 1 ,


@@ -176,9 +158,18 @@ B. W. Kernighan,
 .Xr me 7 ,
 .Xr man 7 ,
 .Xr col 1
 .Xr me 7 ,
 .Xr man 7 ,
 .Xr col 1

+.Rs
+.%A J. F. Ossanna
+.%T "Nroff/Troff user's manual"
+.Re
+.Rs
+.%A B. W. Kernighan
+.%T A TROFF Tutorial
+.Re

 .Sh HISTORY
 .Sh HISTORY

-.Nm Nroff
-appeared in Version 6 AT&T UNIX.
-The version described here is
-Version 7.
-
+An
+.Nm nroff
+command appeared in
+.At v6 .
+The version described here appeared in
+.At v7 .