[src/trunk]: src/share/man/man8/man8.x86 Formatting fixes for PostScript output.

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9c24e8d1e3e2
branches:  trunk
changeset: 974752:9c24e8d1e3e2
user:      uwe <uwe%NetBSD.org@localhost>
date:      Mon Aug 10 01:10:26 2020 +0000

description:
Formatting fixes for PostScript output.

Mostly use .Ar instead of .Va and use -literal, .Ql, etc where
appropriate.

diffstat:

 share/man/man8/man8.x86/boot.8 |  254 +++++++++++++++++++++++-----------------
 1 files changed, 144 insertions(+), 110 deletions(-)

diffs (truncated from 592 to 300 lines):

diff -r 58bb37145b92 -r 9c24e8d1e3e2 share/man/man8/man8.x86/boot.8
--- a/share/man/man8/man8.x86/boot.8    Sun Aug 09 23:43:58 2020 +0000
+++ b/share/man/man8/man8.x86/boot.8    Mon Aug 10 01:10:26 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: boot.8,v 1.22 2020/08/09 18:54:59 kim Exp $
+.\"    $NetBSD: boot.8,v 1.23 2020/08/10 01:10:26 uwe Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -99,7 +99,7 @@
 .Xr x86/mbr 8 ) .
 .Ss Normal Operation
 Once running, a banner similar to the following will appear:
-.Bd -unfilled -offset indent
+.Bd -literal -offset indent
 >> NetBSD BIOS Boot, revision 3.0
 >> (user@buildhost, builddate)
 >> Memory: 637/15360 k
@@ -113,7 +113,7 @@
 which is the file
 .Pa /netbsd
 on partition
-.Dq a
+.Dq Li a
 of the
 .Nx
 .Tn MBR
@@ -122,7 +122,7 @@
 .Po
 which is an
 .Tn IDE
-or similar device - see the
+or similar device \(em see the
 .Sx BUGS
 section
 .Pc .
@@ -173,9 +173,9 @@
 .\" also duplicated in the x86-specific x86/dosboot.8 and x86/pxeboot.8;
 .\" please try to keep all relevant files synchronized.
 .Bl -tag -width 04n -offset 04n
-.It Ic boot Oo Va device : Oc Ns Oo Va filename Oc Oo Fl 1234abcdmqsvxz Oc
+.It Ic boot Oo Ar device Ns Ic \&: Oc Ns Oo Ar filename Oc Oo Fl 1234abcdmqsvxz Oc
 The default
-.Va device
+.Ar device
 will be set to the disk from which the boot loader was loaded.
 The partition is set to the first match in this list:
 .Bl -enum
@@ -196,22 +196,22 @@
 .Pp
 To boot from an alternate disk, the full name of the device should
 be given at the prompt.
-.Va device
+.Ar device
 is of the form
-.Va NAME=partition_label
+.Li NAME= Ns Ar partition_label
 when booting from a
 .Xr gpt 8
 partitioned disk.
 Otherwise, the syntax is
-.Xo Va xd
-.Op Va N Ns Op Va x
+.Xo Ar xd\^ Ns
+.Op Ar N\^ Ns Op Ar x
 .Xc
 where
-.Va xd
+.Ar xd
 is the device from which to boot,
-.Va N
+.Ar N
 is the unit number, and
-.Va x
+.Ar x
 is the partition letter.
 .Pp
 In the latter case, the following list of supported devices may
@@ -238,7 +238,7 @@
 Inner RAIDframe partitions can also be given to the
 .Ic dev
 command using he
-.Va NAME=partition_label
+.Li NAME= Ns Ar partition_label
 syntax.
 .El
 .Pp
@@ -261,7 +261,7 @@
 .Bl -tag -width xxx
 .It Fl 1
 Sets the machine-dependent flag
-.Sy RB_MD1
+.Dv RB_MD1
 in
 .Va boothowto .
 In
@@ -270,7 +270,7 @@
 the kernel will boot in uniprocessor mode.
 .It Fl 2
 Sets the machine-dependent flag
-.Sy RB_MD2
+.Dv RB_MD2
 in
 .Va boothowto .
 In
@@ -278,7 +278,7 @@
 this disables ACPI.
 .It Fl 3
 Sets the machine-dependent flag
-.Sy RB_MD3
+.Dv RB_MD3
 in
 .Va boothowto .
 In
@@ -286,7 +286,7 @@
 this disables SVS.
 .It Fl 4
 Sets the machine-dependent flag
-.Sy RB_MD4
+.Dv RB_MD4
 in
 .Va boothowto .
 In
@@ -294,7 +294,7 @@
 this has no effect.
 .It Fl a
 Sets the
-.Sy RB_ASKNAME
+.Dv RB_ASKNAME
 flag in
 .Va boothowto .
 This causes the kernel to prompt for the root file system device,
@@ -302,13 +302,13 @@
 .Xr init 8 .
 .It Fl b
 Sets the
-.Sy RB_HALT
+.Dv RB_HALT
 flag in
 .Va boothowto .
 This causes subsequent reboot attempts to halt instead of rebooting.
 .It Fl c
 Sets the
-.Sy RB_USERCONF
+.Dv RB_USERCONF
 flag in
 .Va boothowto .
 This causes the kernel to enter the
@@ -320,7 +320,7 @@
 to be modified before the kernel attempts to attach the devices.
 .It Fl d
 Sets the
-.Sy RB_KDB
+.Dv RB_KDB
 flag in
 .Va boothowto .
 Requests the kernel to enter debug mode, in which it
@@ -328,76 +328,76 @@
 .Xr ddb 4 .
 .It Fl m
 Sets the
-.Sy RB_MINIROOT
+.Dv RB_MINIROOT
 flag in
 .Va boothowto .
 Informs the kernel that a mini-root file system is present in memory.
 .It Fl q
 Sets the
-.Sy AB_QUIET
+.Dv AB_QUIET
 flag in
 .Va boothowto .
 Boot the system in quiet mode.
 .It Fl s
 Sets the
-.Sy RB_SINGLE
+.Dv RB_SINGLE
 flag in
 .Va boothowto .
 Boot the system in single-user mode.
 .It Fl v
 Sets the
-.Sy AB_VERBOSE
+.Dv AB_VERBOSE
 flag in
 .Va boothowto .
 Boot the system in verbose mode.
 .It Fl x
 Sets the
-.Sy AB_DEBUG
+.Dv AB_DEBUG
 flag in
 .Va boothowto .
 Boot the system with debug messages enabled.
 .It Fl z
 Sets the
-.Sy AB_SILENT
+.Dv AB_SILENT
 flag in
 .Va boothowto .
 Boot the system in silent mode.
 .El
-.It Ic consdev Va dev Ns Oo Ns , Ns Va speed Oc
+.It Ic consdev Ar dev\| Ns Oo Ns Ic \&, Ns Ar speed Oc
 Immediately switch the console to the specified device
-.Va dev
+.Ar dev
 and reprint the banner.
-.Va dev
+.Ar dev
 must be one of
 .\" .Bl -item -width com[0123]kbd -offset indent -compact
-.Ar pc , com0 , com1 , com2 ,
-.Ar com3 , com0kbd , com1kbd , com2kbd ,
-.Ar com3kbd ,
+.Li pc , com0 , com1 , com2 ,
+.Li com3 , com0kbd , com1kbd , com2kbd ,
+.Li com3kbd ,
 or
-.Ar auto .
+.Li auto .
 See
 .Sx Console Selection Policy
 in
 .Xr x86/boot_console 8 .
 .Pp
 A
-.Va speed
+.Ar speed
 for the serial port is optional and defaults to 9600.
 If a value of zero is specified, then the current baud rate (set by the
 BIOS) will be used.
 Setting the
-.Va speed
+.Ar speed
 with the
-.Ar pc
+.Li pc
 device is not possible.
-.It Ic dev Op Va device
+.It Ic dev Op Ar device
 Set the default drive and partition for subsequent file system
 operations.
 Without an argument, print the current setting.
-.Va device
+.Ar device
 is of the form specified in
-.Cm boot .
-.It Ic fs Va file
+.Ic boot .
+.It Ic fs Ar file
 Load a file system image from the specified
 .Ar file ,
 and request the kernel to use it as the root file system.
@@ -406,22 +406,24 @@
 utility may be used to create suitable file system images.
 .It Ic help
 Print an overview about commands and arguments.
-.It Ic load Va module Op Ar arguments
+.It Ic load Ar module Op Ar arguments
 Load the specified kernel
-.Va module ,
+.Ar module ,
 and pass it the specified
 .Ar arguments .
 If the module name is not an absolute path,
-.Pa /stand/ Xo Ns
-.Aq Sy arch Ns
+.Bd -ragged -offset indent -compact
+.Pa /stand/ Ns Xo Ns
+.Aq Ar arch Ns
 .Pa / Ns
-.Aq Sy osversion Ns
+.Aq Ar osversion Ns
 .Pa /modules/ Ns
-.Aq Sy module Ns
+.Aq Ar module Ns
 .Pa / Ns
-.Aq Sy module Ns
+.Aq Ar module Ns
 .Pa .kmod
 .Xc
+.Ed
 is used.
 Possible uses of the
 .Ic load
@@ -448,16 +450,15 @@
 Override the default boot device.
 .Ar dev
 is of the form
-.Va NAME=partition_label
+.Li NAME= Ns Ar partition_label
 for
 .Xr gpt 8
 partitioned disks.
 It can also be a unit name
-.Po Dq wd0
-.Pc ,
+.Pq Ql wd0 ,
 or an interface name