converted man page

SCCS-vsn: usr.sbin/lpr/lpq/lpq.1 6.7
SCCS-vsn: usr.sbin/lpr/lpr/lpr.1 6.6
SCCS-vsn: usr.bin/du/du.1 6.6
SCCS-vsn: usr.bin/hexdump/hexdump.1 5.9

diff --git a/usr/src/usr.bin/du/du.1 b/usr/src/usr.bin/du/du.1
index bf665ba..d863d37 100644 (file)
--- a/usr/src/usr.bin/du/du.1
+++ b/usr/src/usr.bin/du/du.1
@@ -3,7 +3,7 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"     @(#)du.1       6.5 (Berkeley) %G%
+.\"     @(#)du.1       6.6 (Berkeley) %G%

 .\"
 .Dd 
 .Dt DU 1
 .\"
 .Dd 
 .Dt DU 1


@@ -48,7 +48,6 @@ Files having multiple hard links are counted
 (and displayed) a single time per
 .Nm du
 execution.
 (and displayed) a single time per
 .Nm du
 execution.

-.Dp

 .Sh SEE ALSO
 .Xr df 1 ,
 .Xr quot 8
 .Sh SEE ALSO
 .Xr df 1 ,
 .Xr quot 8

diff --git a/usr/src/usr.bin/hexdump/hexdump.1 b/usr/src/usr.bin/hexdump/hexdump.1
index 5e64fd2..1456fca 100644 (file)
--- a/usr/src/usr.bin/hexdump/hexdump.1
+++ b/usr/src/usr.bin/hexdump/hexdump.1
@@ -3,7 +3,7 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"     @(#)hexdump.1  5.8 (Berkeley) %G%
+.\"     @(#)hexdump.1  5.9 (Berkeley) %G%

 .\"
 .Dd 
 .Dt HEXDUMP 1
 .\"
 .Dd 
 .Dt HEXDUMP 1


@@ -12,63 +12,63 @@
 .Nm hexdump
 .Nd ascii, decimal, hexadecimal, octal dump
 .Sh SYNOPSIS
 .Nm hexdump
 .Nd ascii, decimal, hexadecimal, octal dump
 .Sh SYNOPSIS

-.Ar hexdump
+.Nm hexdump

 .Op Fl bcdovx
 .Op Fl bcdovx

-.Op Fl e format_string
-.Op Fl f format_file
-.Op Fl n length
-.Op Fl s skip
-.Op
-.Ar file  . . .
+.Op Fl e Ar format_string
+.Op Fl f Ar format_file
+.Op Fl n Ar length
+.Op Fl s Ar skip
+.Ar file  ...

 .Sh DESCRIPTION
 .Sh DESCRIPTION

-The hexdump utility is a filter that displays the specified files, or
+The hexdump utility is a filter which displays the specified files, or

 the standard input, if no files are specified, in a user specified
 format.
 .Pp
 The options are as follows:
 the standard input, if no files are specified, in a user specified
 format.
 .Pp
 The options are as follows:

-.Tp
--b
-One-byte octal display.
-.Pp
+.Tw Fl
+.Tp Fl b
+.Em One-byte octal display .

 Display the input offset in hexadecimal, followed by sixteen
 space-separated, three column, zero-filled, bytes of input data,
 in octal, per line.
 Display the input offset in hexadecimal, followed by sixteen
 space-separated, three column, zero-filled, bytes of input data,
 in octal, per line.

-.Tp
--c
-One-byte character display.
-.Pp
+.Tp Fl c
+.Em One-byte character display .

 Display the input offset in hexadecimal, followed by sixteen
 space-separated, three column, space-filled, characters of input
 data per line.
 Display the input offset in hexadecimal, followed by sixteen
 space-separated, three column, space-filled, characters of input
 data per line.

-.Tp
--d
+.Tp Fl d

 Two-byte decimal display.
 Two-byte decimal display.

-.Pp

 Display the input offset in hexadecimal, followed by eight
 space-separated, five column, zero-filled, two-byte units
 of input data, in unsigned decimal, per line.
 Display the input offset in hexadecimal, followed by eight
 space-separated, five column, zero-filled, two-byte units
 of input data, in unsigned decimal, per line.

-.Tp
--e
+.Tc Fl e
+.Ws
+.Ar format_string
+.Cx

 Specify a format string to be used for displaying data.
 Specify a format string to be used for displaying data.

-.Tp
--f
+.Tc Fl f
+.Ws
+.Ar format_file
+.Cx

 Specify a file that contains one or more newline separated format strings.
 Empty lines and lines whose first non-blank character is a hash mark
 (#) are ignored.
 Specify a file that contains one or more newline separated format strings.
 Empty lines and lines whose first non-blank character is a hash mark
 (#) are ignored.

-.Tp
--n
+.Tc Fl n
+.Ws
+.Ar length
+.Cx

 Interpret only
 .Ar length
 bytes of input.
 Interpret only
 .Ar length
 bytes of input.

-.Tp
--o
+.Tp Fl o

 Two-byte octal display.
 Two-byte octal display.

-.Pp

 Display the input offset in hexadecimal, followed by eight
 space-separated, six column, zero-filled, two byte quantities of
 input data, in octal, per line.
 Display the input offset in hexadecimal, followed by eight
 space-separated, six column, zero-filled, two byte quantities of
 input data, in octal, per line.

-.Tp
--s
+.Tc Fl s
+.Ws
+.Ar offset
+.Cx

 Skip
 .Ar offset
 bytes from the beginning of the input.
 Skip
 .Ar offset
 bytes from the beginning of the input.


@@ -85,8 +85,7 @@ Appending the character ``b'', ``k'', or ``m'' to
 .Ar offset
 causes it to be interpreted as a multiple of 512, 1024, or 1048576,
 respectively.
 .Ar offset
 causes it to be interpreted as a multiple of 512, 1024, or 1048576,
 respectively.

-.Tp
--v
+.Tp Fl v

 The
 .Fl v
 option causes hexdump to display all input data.
 The
 .Fl v
 option causes hexdump to display all input data.


@@ -96,13 +95,12 @@ option, any number of groups of output lines, which would be
 identical to the immediately preceding group of output lines (except
 for the input offsets), are replaced with a line comprised of a
 single asterisk.
 identical to the immediately preceding group of output lines (except
 for the input offsets), are replaced with a line comprised of a
 single asterisk.

-.Tp
--x
+.Tp Fl x

 Two-byte hexadecimal display.
 Two-byte hexadecimal display.

-.Pp

 Display the input offset in hexadecimal, followed by eight, space
 separated, four column, zero-filled, two-byte quantities of input
 data, in hexadecimal, per line.
 Display the input offset in hexadecimal, followed by eight, space
 separated, four column, zero-filled, two-byte quantities of input
 data, in hexadecimal, per line.

+.Tp

 .Pp
 For each input file,
 .Nm hexdump
 .Pp
 For each input file,
 .Nm hexdump


@@ -112,7 +110,7 @@ data according to the format strings specified by the
 and
 .Fl f
 options, in the order that they were specified.
 and
 .Fl f
 options, in the order that they were specified.

-.Pp
+.Ss Formats

 A format string contains any number of format units, separated by
 whitespace.
 A format unit contains up to three items: an iteration count, a byte
 A format string contains any number of format units, separated by
 whitespace.
 A format unit contains up to three items: an iteration count, a byte


@@ -135,84 +133,91 @@ The format is required and must be surrounded by double quote
 (" ") marks.
 It is interpreted as a fprintf-style format string, with the
 following exceptions:
 (" ") marks.
 It is interpreted as a fprintf-style format string, with the
 following exceptions:

-.Tp
-.Ar \ (bu
-An asterisk (*) may not be used as a field width or precision.
-.Tp
-.Ar \ (bu
-A byte count or field precision is required for each ``s'' conversion
-character.
-.Tp
-.Ar \ (bu
+.Ds I
+.Tw Ds
+.Tp \&Unsupported \&fprintf \&Conversion \&Characters:

 The conversion characters ``h'', ``n'', and ``p'' are not
 supported.
 The conversion characters ``h'', ``n'', and ``p'' are not
 supported.

+.Tp Supported Escape Sequences:
+The single character escape sequences
+described in the C standard are supported:
+.Ds I
+.Cw <alert_character>
+.Cl NUL        \e0
+.Cl <alert character>  \ea
+.Cl <backspace>        \eb
+.Cl <form-feed>        \ef
+.Cl <newline>  \en
+.Cl <carriage return>  \er
+.Cl <tab>      \et
+.Cl <vertical tab>     \ev
+.Cw
+.De
+.Tp Taboo:
+An asterisk (*) may not be used as a field width or precision.
+.Tp ``\&%s'' Anomaly:
+A byte count or field precision
+.Em is
+required for each ``s'' conversion
+character (unlike the
+.Xr fprintf 3
+default which prints the entire string if the precision is unspecified).

 .Tp
 .Tp

-.Ar \ (bu
-The single character escape sequences (\ea, \eb, \ef, \en, \er,
-\et, and \ev) described in the C standard are supported.
+.De

 .Pp
 Hexdump also supports the the following additional conversion strings:
 .Pp
 Hexdump also supports the the following additional conversion strings:

-.Pp
-.Tp
-_a
+.Tw Fl
+.Tc Cm \&_a

 .Op dox
 .Op dox

+.Cx

 Display the input offset, cumulative across input files, of the
 next byte to be displayed.
 The appended characters ``d'', ``o'', and ``x'' specify the display base
 as decimal, octal or hexadecimal respectively.
 Display the input offset, cumulative across input files, of the
 next byte to be displayed.
 The appended characters ``d'', ``o'', and ``x'' specify the display base
 as decimal, octal or hexadecimal respectively.

-.Tp
-_A
+.Tc Cm \&_A

 .Op dox
 .Op dox

+.Cx

 Identical to the _a conversion string except that it is only performed
 once, when all of the input data has been processed.
 Identical to the _a conversion string except that it is only performed
 once, when all of the input data has been processed.

-.Tp
-_c
+.Tp Cm \&_c

 Output characters in the default character set.
 Nonprinting characters are displayed in three character, zero-padded
 octal, except for those representable by standard escape notation,
 Output characters in the default character set.
 Nonprinting characters are displayed in three character, zero-padded
 octal, except for those representable by standard escape notation,

-which are displayed as the following two character strings:
-.in +5
-.TS
-l l.
-NUL    \e0
-<alert character>      \ea
-<backspace>    \eb
-<form-feed>    \ef
-<newline>      \en
-<carriage return>      \er
-<tab>  \et
-<vertical tab> \ev
-.TE
-.Tp
-_p
+which are displayed as the following two character strings.
+.Tp Cm _p

 Output characters in the default character set.
 Nonprinting characters are displayed as a single ``.''.
 Output characters in the default character set.
 Nonprinting characters are displayed as a single ``.''.

-.Tp
-_u
+.Tp Cm _u

 Output US ASCII characters, with the exception that control characters are
 displayed using the following, lower-case, names.
 Characters greater than 0xff, hexadecimal, are displayed as hexadecimal
 strings.
 Output US ASCII characters, with the exception that control characters are
 displayed using the following, lower-case, names.
 Characters greater than 0xff, hexadecimal, are displayed as hexadecimal
 strings.

-.Pp
+.Cw \&000_nul \&001_soh \&002_stx \&003_etx \&004_eot
+.Cl \&000\ nul\t001\ soh\t002\ stx\t003\ etx\t004\ eot\t005\ enq
+.Cl \&006\ ack\t007\ bel\t008\ bs\t009\ ht\t00A\ lf\t00B\ vt
+.Cl \&00C\ ff\t00D\ cr\t00E\ so\t00F\ si\t010\ dle\t011\ dc1
+.Cl \&012\ dc2\t013\ dc3\t014\ dc4\t015\ nak\t016\ syn\t017\ etb
+.Cl \&018\ can\t019\ em\t01A\ sub\t01B\ esc\t01C\ fs\t01D\ gs
+.Cl \&01E\ rs\t01F\ us\t0FF\ del
+.Cw

 .Tp
 .Tp

-000 nul  001 soh  002 stx  003 etx  004 eot  005 enq
-006 ack  007 bel  008  bs  009  ht  00A  lf  00B  vt
-00C  ff  00D  cr  00E  so  00F  si  010 dle  011 dc1
-012 dc2  013 dc3  014 dc4  015 nak  016 syn  017 etb
-018 can  019  em  01A sub  01B esc  01C  fs  01D  gs
-01E rs   01F  us  0FF del
-.Tp Pp
+.Pp

 The default and supported byte counts for the conversion characters
 are as follows:
 The default and supported byte counts for the conversion characters
 are as follows:

-.Tp
-"%_c, %_p, %_u, %c"
+.Tw Fl
+.Tp Li \&%_c , %_p , %_u , \&%c

 One byte counts only.
 One byte counts only.

-.Tp
-"%d, %i, %o, %u, %X, %x"
+.Tc Li \&%d , \&%i , \&%o ,
+.Ws
+.Li \&%u , \&%X , \&%x
+.Cx

 Four byte default, one and two byte counts supported.
 Four byte default, one and two byte counts supported.

-.Tp
-"%E, %e, %f, %G, %g"
+.Tc Li \&%E , \&%e , \&%f ,
+.Ws
+.Li \&%G , \&%g
+.Cx

 Eight byte default, four byte counts supported.
 Eight byte default, four byte counts supported.

+.Tp

 .Pp
 The amount of data interpreted by each format string is the sum of the
 data required by each format unit, which is the iteration count times the
 .Pp
 The amount of data interpreted by each format string is the sum of the
 data required by each format unit, which is the iteration count times the


@@ -261,27 +266,19 @@ exits 0 on success and >0 if an error occurred.
 .Sh EXAMPLES
 Display the input in perusal format:
 .Pp
 .Sh EXAMPLES
 Display the input in perusal format:
 .Pp

-.Tp
-"%06.6_ao
-.Ar 12/1 "%3_u "
-.br
+.Ds I
+"%06.6_ao "  12/1 "%3_u "

 "\et\et" "%_p "
 "\et\et" "%_p "

-.br

 "\en"
 "\en"

-.Tp Pp
+.De
+.Pp

 Implement the \-x option:
 .Pp
 Implement the \-x option:
 .Pp

-.Tp
+.Ds I

 "%07.7_Ax\en"
 "%07.7_Ax\en"

-.br
-"%07.7_ax
-.Ar 8/2 "%04x
-.Ar "\en"
-.Tp
--PTXX FROM- 4.3
--ENV USAGE-
--MANPAGE HISTORY-
-/usr/src/usr.bin/hexdump/odsyntax.c:   while ((ch = getopt(argc, argv, "aBbcDdeFfHhIiLlOoPpswvXx")) != EOF)
-/usr/src/usr.bin/hexdump/hexsyntax.c:  while ((ch = getopt(argc, argv, "bcde:f:n:os:vx")) != EOF)
-/usr/src/usr.bin/hexdump/odsyntax.c:   while ((ch = getopt(argc, argv, "aBbcDdeFfHhIiLlOoPpswvXx")) != EOF)
-/usr/src/usr.bin/hexdump/hexsyntax.c:  while ((ch = getopt(argc, argv, "bcde:f:n:os:vx")) != EOF)
+"%07.7_ax  " 8/2 "%04x " "\en"
+.De
+.Sh STANDARDS
+The
+.Nm Hexdump
+utility is expected to be POSIX 1003.2 compatible.

diff --git a/usr/src/usr.sbin/lpr/lpq/lpq.1 b/usr/src/usr.sbin/lpr/lpq/lpq.1
index 4fb978b..60ff245 100644 (file)
--- a/usr/src/usr.sbin/lpr/lpq/lpq.1
+++ b/usr/src/usr.sbin/lpr/lpq/lpq.1
@@ -3,75 +3,104 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"     @(#)lpq.1      6.6 (Berkeley) %G%
+.\"     @(#)lpq.1      6.7 (Berkeley) %G%

 .\"
 .\"

-.TH LPQ 1 "%Q"
-.UC 5
-.SH NAME
-lpq \- spool queue examination program
-.SH SYNOPSIS
-.B lpq
-[ -l ] [ \-Pprinter ] [ job # ... ] [ user ... ]
-.SH DESCRIPTION
-.I lpq
+.Dd 
+.Dt LPQ 1
+.Os BSD 4.2
+.Sh NAME
+.Nm lpq
+.Nd spool queue examination program
+.Sh SYNOPSIS
+.Nm lpq
+.Op Fl l
+.Oo
+.Op Fl P Ar printer
+.Oo
+.Op  job # ...
+.Op  user ...
+.Sh DESCRIPTION
+.Nm lpq

 examines the spooling area used by
 examines the spooling area used by

-.IR lpd (8)
+.Xr lpd  8

 for printing files on the line printer, and reports the status of the
 for printing files on the line printer, and reports the status of the

-specified jobs or all jobs associated with a user.  \fIlpq\fP invoked
-without any arguments reports on any jobs currently in the queue.  A
-.B \-P
-flag may be used to specify a particular printer, otherwise the default
-line printer is used (or the value of the PRINTER variable in the
+specified jobs or all jobs associated with a user.
+.Nm lpq
+invoked
+without any arguments reports on any jobs currently in the queue.
+.Pp
+Options:
+.Pp
+.Tp Fl P
+Specify a particular printer, otherwise the default
+line printer is used (or the value of the
+.Ev PRINTER
+variable in the

 environment). All other arguments supplied are interpreted as user
 names or job numbers to filter out only those jobs of interest.
 environment). All other arguments supplied are interpreted as user
 names or job numbers to filter out only those jobs of interest.

-.PP
-For each job submitted (i.e. invocation of 
-.IR lpr (1))
-.I lpq
+.Tp Fl l
+Information about each of the files comprising the job entry
+is printed.
+Normally, only as much information as will fit on one line is displayed.
+.Tp
+.Pp
+For each job submitted (i.e. invocation of
+.Xr lpr  1  )
+.Nm lpq

 reports the user's name, current rank in the queue, the
 names of files comprising the job, the job identifier (a number which
 may be supplied to
 reports the user's name, current rank in the queue, the
 names of files comprising the job, the job identifier (a number which
 may be supplied to

-.IR lprm (1)
+.Xr lprm  1

 for removing a specific job), and the total size in bytes.
 for removing a specific job), and the total size in bytes.

-The
-.B \-l
-option causes information about each of the files comprising the job
-to be printed.
-Normally, only as much information as will fit on one line is displayed.

 Job ordering is dependent on
 the algorithm used to scan the spooling directory and is supposed
 to be FIFO (First in First Out).
 File names comprising a job may be unavailable
 (when
 Job ordering is dependent on
 the algorithm used to scan the spooling directory and is supposed
 to be FIFO (First in First Out).
 File names comprising a job may be unavailable
 (when

-.IR lpr (1)
+.Xr lpr  1

 is used as a sink in a pipeline) in which case the file
 is indicated as ``(standard input)".
 is used as a sink in a pipeline) in which case the file
 is indicated as ``(standard input)".

-.PP
+.Pp

 If
 If

-.I lpq
+.Nm lpq

 warns that there is no daemon present (i.e. due to some malfunction),
 the
 warns that there is no daemon present (i.e. due to some malfunction),
 the

-.IR lpc (8)
+.Xr lpc  8

 command can be used to restart the printer daemon.
 command can be used to restart the printer daemon.

-.SH FILES
-.nf
-.ta \w'/etc/termcap            'u
-/etc/termcap   for manipulating the screen for repeated display
-/etc/printcap  to determine printer characteristics
-/usr/spool/*   the spooling directory, as determined from printcap
-/usr/spool/*/cf*       control files specifying jobs
-/usr/spool/*/lock      the lock file to obtain the currently active job 
-.fi
-.SH "SEE ALSO"
-lpr(1),
-lprm(1),
-lpc(8),
-lpd(8)
-.SH BUGS
+.Sh ENVIRONMENT
+If the following environment variable exists, it is used by
+.Nm lpq :
+.Tw Fl
+.Tp Ev PRINTER
+Specifies an alternate default printer.
+.Tp
+.Sh FILES
+.Dw /usr/share/misc/termcap
+.Di L
+.Dp Pa /usr/share/misc/termcap
+for manipulating the screen for repeated display
+.Dp Pa /etc/printcap
+to determine printer characteristics
+.Dp Pa /var/spool/*
+the spooling directory, as determined from printcap
+.Dp Pa /var/spool/*/cf*
+control files specifying jobs
+.Dp Pa /var/spool/*/lock
+the lock file to obtain the currently active job
+.Dp
+.Sh SEE ALSO
+.Xr lpr 1 ,
+.Xr lprm 1 ,
+.Xr lpc 8 ,
+.Xr lpd 8
+.Sh HISTORY
+.Nm
+appeared in 3 BSD.
+.Sh BUGS

 Due to the dynamic nature of the information in the spooling directory
 lpq may report unreliably.
 Output formatting is sensitive to the line length of the terminal;
 this can results in widely spaced columns.
 Due to the dynamic nature of the information in the spooling directory
 lpq may report unreliably.
 Output formatting is sensitive to the line length of the terminal;
 this can results in widely spaced columns.

-.SH DIAGNOSTICS
+.Sh DIAGNOSTICS

 Unable to open various files.  The lock file being malformed.  Garbage
 files when there is no daemon active, but files in the spooling directory.
 Unable to open various files.  The lock file being malformed.  Garbage
 files when there is no daemon active, but files in the spooling directory.

diff --git a/usr/src/usr.sbin/lpr/lpr/lpr.1 b/usr/src/usr.sbin/lpr/lpr/lpr.1
index a5c9871..34cfe55 100644 (file)
--- a/usr/src/usr.sbin/lpr/lpr/lpr.1
+++ b/usr/src/usr.sbin/lpr/lpr/lpr.1
@@ -3,217 +3,223 @@
 .\"
 .\" %sccs.include.redist.man%
 .\"
 .\"
 .\" %sccs.include.redist.man%
 .\"

-.\"     @(#)lpr.1      6.5 (Berkeley) %G%
+.\"     @(#)lpr.1      6.6 (Berkeley) %G%

 .\"
 .\"

-.TH LPR 1 "%Q"
-.UC 4
-.SH NAME
-lpr \- off line print
-.SH SYNOPSIS
-.B lpr
-[
-.BI \-P printer
-] [
-.BI \-# num
-] [
-.B \-C
-.I class
-] [
-.B \-J
-.I job
-] [
-.B \-T
-.I title
-] [
-.B \-U
-.I user
-] [
-.B \-i
-[
-.I numcols
-]] [
-.B \-1234
-.I font
-] [
-.BI \-w num
-] [
-.B \-pltndgvcfrmhs
-] [
-name ...
-]
-.SH DESCRIPTION
-.B Lpr
+.Dd 
+.Dt LPR 1
+.Os BSD 4
+.Sh NAME
+.Nm lpr
+.Nd off line print
+.Sh SYNOPSIS
+.Nm lpr
+.Oo
+.Op Fl P Ar printer
+.Op Fl \&# Ar num
+.Oo
+.Op Fl C Ar class
+.Op Fl J Ar job
+.Op Fl T Ar title
+.Op Fl U Ar user
+.Op Fl i Op Ar numcols
+.Op Fl 1234 Ar font
+.Oo
+.Op Fl w Ar num
+.Oo
+.Op Fl pltndgvcfrmhs
+.Op Ar name ...
+.Oo
+.Sh DESCRIPTION
+.Nm Lpr

 uses a spooling daemon to print the named files when facilities
 become available.  If no names appear, the standard input is assumed.
 uses a spooling daemon to print the named files when facilities
 become available.  If no names appear, the standard input is assumed.

-The
-.B \-P
+.Fl P

 option may be used to force output to a specific printer.  Normally,
 the default printer is used (site dependent), or the value of the
 option may be used to force output to a specific printer.  Normally,
 the default printer is used (site dependent), or the value of the

-environment variable PRINTER is used.
-.PP
+environment variable
+.Ev PRINTER
+is used.
+.Pp

 The following single letter options are used to notify the line printer
 spooler that the files are not standard text files. The spooling daemon will
 use the appropriate filters to print the data accordingly.
 The following single letter options are used to notify the line printer
 spooler that the files are not standard text files. The spooling daemon will
 use the appropriate filters to print the data accordingly.

-.IP \fB\-p\fP 5
+.Tw Fl
+.Tp Fl p

 Use
 Use

-.IR pr (1)
+.Xr pr  1

 to format the files (equivalent to
 to format the files (equivalent to

-.IR print ).
-.IP \fB\-l\fP 5
+.Em print  ) .
+.Tp Fl l

 Use a filter which allows control characters to be printed and suppresses
 page breaks.
 Use a filter which allows control characters to be printed and suppresses
 page breaks.

-.IP \fB\-t\fP 5
+.Tp Fl t

 The files are assumed to contain data from
 The files are assumed to contain data from

-.IR troff (1)
+.Xr troff  1

 (cat phototypesetter commands).
 (cat phototypesetter commands).

-.IP \fB\-n\fP 5
+.Tp Fl n

 The files are assumed to contain data from
 The files are assumed to contain data from

-.I ditroff
+.Em ditroff

 (device independent troff).
 (device independent troff).

-.IP \fB\-d\fP 5
+.Tp Fl d

 The files are assumed to contain data from
 The files are assumed to contain data from

-.IR tex (l)
+.Em tex

 (DVI format from Stanford).
 (DVI format from Stanford).

-.IP \fB\-g\fP 5
+.Tp Fl g

 The files are assumed to contain standard plot data as produced by the
 The files are assumed to contain standard plot data as produced by the

-.IR plot (3X)
+.Xr plot

 routines (see also
 routines (see also

-.IR plot (1G)
+.Xr plot

 for the filters used by the printer spooler).
 for the filters used by the printer spooler).

-.IP \fB\-v\fP 5
+.Tp Fl v

 The files are assumed to contain a raster image for devices like the
 Benson Varian.
 The files are assumed to contain a raster image for devices like the
 Benson Varian.

-.IP \fB\-c\fP 5
+.Tp Fl c

 The files are assumed to contain data produced by
 The files are assumed to contain data produced by

-.IR cifplot (l).
-.IP \fB\-f\fP 5
+.Xr cifplot 1
+.Tp Fl f

 Use a filter which interprets the first character of each line as a
 standard FORTRAN carriage control character.
 Use a filter which interprets the first character of each line as a
 standard FORTRAN carriage control character.

-.PP
+.Tp
+.Pp

 The remaining single letter options have the following meaning.
 The remaining single letter options have the following meaning.

-.IP \fB\-r\fP 5
+.Tw Fl
+.Tp Fl r

 Remove the file upon completion of spooling or upon completion of
 Remove the file upon completion of spooling or upon completion of

-printing (with the \fB\-s\fP option).
-.IP \fB\-m\fP 5
+printing (with the
+.Fl s
+option).
+The
+.Fl s
+option will use
+.Xr symlink  2
+to link data files rather than trying to copy them so large files can be
+printed.  This means the files should
+not be modified or removed until they have been printed.
+.Tp Fl m

 Send mail upon completion.
 Send mail upon completion.

-.IP \fB\-h\fP 5
+.Tp Fl h

 Suppress the printing of the burst page.
 Suppress the printing of the burst page.

-.IP \fB\-s\fP 5
+.Tp Fl s

 Use symbolic links.  Usually files are copied to the spool directory.
 Use symbolic links.  Usually files are copied to the spool directory.

-.PP 
-The
-.B \-C
-option takes the following argument as a job classification
+.Tp Fl C
+Uses the following argument as a job classification

 for use on the burst page.  For example,
 for use on the burst page.  For example,

-.PP
-.ti +0.5i
-lpr \-C EECS foo.c
-.PP
+.Pp
+.Dl lpr \-C EECS foo.c
+.Pp

 causes the system name (the name returned by
 causes the system name (the name returned by

-.IR hostname (1))
+.Xr hostname  1  )

 to be replaced on the burst page by EECS,
 and the file foo.c to be printed.
 to be replaced on the burst page by EECS,
 and the file foo.c to be printed.

-.PP
-The
-.B \-J
-option takes the following argument as the job name to print on the burst page.
+.Tp Fl J
+Uses the following argument as the job name to print on the burst page.

 Normally, the first file's name is used.
 Normally, the first file's name is used.

-.PP
-The
-.B \-U
-option takes the following argument as the user name to print on the burst page,
-and to use for accounting purposes.
+.Tp Fl U
+Uses the following argument as the user name to print on the burst page,
+and for accounting purposes.

 This option is only honored if the real user-id is daemon
 (or that specified in the printcap file instead of daemon),
 and is intended for those instances where print filters wish to requeue jobs.
 This option is only honored if the real user-id is daemon
 (or that specified in the printcap file instead of daemon),
 and is intended for those instances where print filters wish to requeue jobs.

-.PP
-The
-.B \-T
-option uses the next argument as the title used by
-.IR pr (1)
+.Tp Fl T
+Uses the next argument as the title used by
+.Xr pr  1

 instead of the file name.
 instead of the file name.

-.PP
-To get multiple copies of output, use the
-.BI \-# num
-option,
-where
-.I num
+.Tc Fl \&#
+.Ar num
+.Cx
+The quantity
+.Ar num

 is the number of copies desired of each file named.  For example,
 is the number of copies desired of each file named.  For example,

-.PP
-.ti +0.5i
-lpr \-#3 foo.c bar.c more.c
-.PP
+.Pp
+.Dl lpr \-#3 foo.c bar.c more.c
+.Pp

 would result in 3 copies of the file foo.c, followed by 3 copies
 would result in 3 copies of the file foo.c, followed by 3 copies

-of the file bar.c, etc.  On the other hand, 
-.PP
-.ti +0.5i
-cat foo.c bar.c more.c | lpr \-#3
-.PP
+of the file bar.c, etc.  On the other hand,
+.Pp
+.Dl cat foo.c bar.c more.c \&| lpr \-#3
+.Pp

 will give three copies of the concatenation of the files.
 will give three copies of the concatenation of the files.

-.PP
-The
-.B \-i
-option causes the output to be indented. If the next argument
-is numeric, it is used as the number of blanks to be printed before each
+.Tc Fl i
+.Ws
+.Op numcols
+.Cx
+The output is indented. If the next argument
+is numeric
+.Pf \&( Ar numcols ) ,
+it is used as the number of blanks to be printed before each

 line; otherwise, 8 characters are printed.
 line; otherwise, 8 characters are printed.

-.PP
-The
-.B \-w
-option takes the immediately following number to be
-the page width for
-.IR pr .
-.PP
-The
-.B \-s
-option will use
-.IR symlink (2)
-to link data files rather than trying to copy them so large files can be
-printed.  This means the files should
-not be modified or removed until they have been printed.
-.PP
-The option
-.B \-1234
-Specifies a font to be mounted on font position \fIi\fR.  The daemon
-will construct a \fI.railmag\fR file referencing
-\fI/usr/lib/vfont/name.size\fR.
-.SH FILES
-.nf
-.ta \w'/usr/spool/*/cf*       'u
-/etc/passwd    personal identification
-/etc/printcap  printer capabilities data base
-/usr/lib/lpd*  line printer daemons
-/usr/spool/*   directories used for spooling
-/usr/spool/*/cf*       daemon control files
-/usr/spool/*/df*       data files specified in "cf" files
-/usr/spool/*/tf*       temporary copies of "cf" files
-.fi
-.SH "SEE ALSO"
-lpq(1),
-lprm(1),
-pr(1),
-symlink(2),
-printcap(5),
-lpc(8),
-lpd(8)
-.SH DIAGNOSTICS
+.Tc Fl w
+.Ar num
+.Cx
+Uses
+.Ar num
+as the page width for
+.Xr pr 1 .
+.Tp Fl 1234
+Specifies a font to be mounted on font position
+.Ar i  .
+The daemon
+will construct a
+.Li .railmag
+file referencing
+the font pathname.
+.Tp
+.Sh ENVIRONMENT
+If the following environment variable exists, it is used by
+.Nm lpr :
+.Tw Fl
+.Tp Ev PRINTER
+Specifies an alternate default printer.
+.Tp
+.Sh FILES
+.Dw /var/spool/output/*/tf*
+.Di L
+.Dp Pa /etc/passwd
+personal identification
+.Dp Pa /etc/printcap
+printer capabilities data base
+.Dp Pa /usr/sbin/lpd*
+line printer daemons
+.Dp Pa /var/spool/output/*
+directories used for spooling
+.Dp Pa /var/spool/output/*/cf*
+daemon control files
+.Dp Pa /var/spool/output/*/df*
+data files specified in "cf" files
+.Dp Pa /var/spool/output/*/tf*
+temporary copies of "cf" files
+.Dp
+.Sh SEE ALSO
+.Xr lpq 1 ,
+.Xr lprm 1 ,
+.Xr pr 1 ,
+.Xr symlink 2 ,
+.Xr printcap 5 ,
+.Xr lpc 8 ,
+.Xr lpd 8
+.Sh HISTORY
+.Nm Lpr
+appeared in 3 BSD.
+.Sh BUGS
+.Sh DIAGNOSTICS

 If you try to spool too large a file, it will be truncated.
 If you try to spool too large a file, it will be truncated.

-.I Lpr
+.Nm Lpr

 will object to printing binary files.
 If a user other than root prints a file and spooling is disabled,
 will object to printing binary files.
 If a user other than root prints a file and spooling is disabled,

-.I lpr
+.Nm lpr

 will print a message saying so and will not put jobs in the queue.
 If a connection to
 will print a message saying so and will not put jobs in the queue.
 If a connection to

-.I lpd
+.Xr lpd 1

 on the local machine cannot be made,
 on the local machine cannot be made,

-.I lpr
+.Nm lpr

 will say that the daemon cannot be started.
 Diagnostics may be printed in the daemon's log file
 regarding missing spool files by
 will say that the daemon cannot be started.
 Diagnostics may be printed in the daemon's log file
 regarding missing spool files by

-.IR lpd .
-.SH BUGS
+.Xr lpd 1 .
+.Sh BUGS

 Fonts for
 Fonts for

-.I troff
+.Xr troff 1

 and
 and

-.I tex
+.Xr tex

 reside on the host with the printer. It is currently not possible to
 use local font libraries.
 reside on the host with the printer. It is currently not possible to
 use local font libraries.