[src/trunk]: src/share/man/man5 use Dq as appropriate

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

details:   https://anonhg.NetBSD.org/src/rev/e58cda68b791
branches:  trunk
changeset: 499333:e58cda68b791
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Nov 17 10:14:16 2000 +0000

description:
use Dq as appropriate

diffstat:

 share/man/man5/ar.5          |  20 +++++++++++++-------
 share/man/man5/core.5        |  22 ++++++++++++++--------
 share/man/man5/daily.conf.5  |  22 ++++++++++++++++------
 share/man/man5/ethers.5      |   6 ++++--
 share/man/man5/group.5       |  12 ++++++++----
 share/man/man5/hosts.5       |  11 +++++++----
 share/man/man5/hosts.equiv.5 |  22 ++++++++++++++--------
 share/man/man5/netgroup.5    |  19 ++++++++++++++-----
 share/man/man5/networks.5    |  11 +++++++----
 share/man/man5/phones.5      |  20 +++++++++++++++-----
 share/man/man5/printcap.5    |  10 ++++------
 share/man/man5/protocols.5   |   6 ++++--
 share/man/man5/ranlib.5      |  10 +++++++---
 share/man/man5/rc.conf.5     |  20 ++++++++++----------
 share/man/man5/remote.5      |  38 +++++++++++++++++++++++++++-----------
 share/man/man5/rpc.5         |   6 ++++--
 share/man/man5/services.5    |  12 ++++++++----
 share/man/man5/shells.5      |   6 ++++--
 share/man/man5/wscons.conf.5 |  10 ++++++----
 19 files changed, 186 insertions(+), 97 deletions(-)

diffs (truncated from 758 to 300 lines):

diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/ar.5
--- a/share/man/man5/ar.5       Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/ar.5       Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ar.5,v 1.1 1998/08/22 05:29:57 tv Exp $
+.\"    $NetBSD: ar.5,v 1.2 2000/11/17 10:14:16 lukem Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -51,7 +51,10 @@
 .Pp
 A file created with
 .Nm
-begins with the ``magic'' string "!<arch>\en".
+begins with the
+.Dq magic
+string
+.Dq Li "!<arch>\en" .
 The rest of the archive is made up of objects, each of which is composed
 of a header for a file, a possible file name, and the file contents.
 The header is portable between machine architectures, and, if the file
@@ -102,7 +105,8 @@
 length, there will be no separation between the fields.
 .Pp
 Objects in the archive are always an even number of bytes long; files
-which are an odd number of bytes long are padded with a newline (``\en'')
+which are an odd number of bytes long are padded with a newline
+.Pq Dq \en
 character, although the size in the header does not reflect this.
 .Sh SEE ALSO
 .Xr ar 1 ,
@@ -111,8 +115,9 @@
 There have been at least four
 .Nm
 formats.
-The first was denoted by the leading ``magic'' number 0177555 (stored as
-type int).
+The first was denoted by the leading
+.Dq magic
+number 0177555 (stored as type int).
 These archives were almost certainly created on a 16-bit machine, and
 contain headers made up of five fields.
 The fields are the object name (8 characters), the file last modification
@@ -120,8 +125,9 @@
 the file size (type unsigned int).
 Files were padded to an even number of bytes.
 .Pp
-The second was denoted by the leading ``magic'' number 0177545 (stored as
-type int).
+The second was denoted by the leading
+.Dq magic
+number 0177545 (stored as type int).
 These archives may have been created on either 16 or 32-bit machines, and
 contain headers made up of six fields.
 The fields are the object name (14 characters), the file last modification
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/core.5
--- a/share/man/man5/core.5     Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/core.5     Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: core.5,v 1.12 2000/10/07 17:45:26 nathanw Exp $
+.\"    $NetBSD: core.5,v 1.13 2000/11/17 10:14:17 lukem Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -47,6 +47,7 @@
 to disk for later examination by one of the available debuggers
 (see
 .Xr signal 7 ).
+.Pp
 This memory image is written to a file named from a per-process template;
 provided the terminated process had write permission, and provided the
 abnormality did not cause a system crash.
@@ -58,15 +59,20 @@
 (where <pid> has to be replaced by the pid in decimal format of the
 process).
 This template is either an absolute or relative path name, in which format
-characters can be used, preceeded by the percent character (``%''). 
-The following characters are recognised as format and subsitued:
-.Bl -column "cAA" "The process's creation date (in seconds)xxx" -offset indent
-.It Li n        The process's name
-.It Li p        The PID of the process (in decimal) 
-.It Li t        The process's creation date (a la
+characters can be used, preceeded by the percent character
+.Pq Dq \&% .
+The following characters are recognised as format and subsituted:
+.Bl -tag -width 4n -offset indent -compact
+.It Sy n
+The process's name
+.It Sy p
+The PID of the process (in decimal) 
+.It Sy t
+The process's creation date (a la
 .Xr time 3 ,
 in decimal)
-.It Li u        The login name, as returned by
+.It Sy u
+The login name, as returned by
 .Xr getlogin 2
 .El
 .Pp
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/daily.conf.5
--- a/share/man/man5/daily.conf.5       Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/daily.conf.5       Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: daily.conf.5,v 1.6 2000/08/25 01:11:43 hubertf Exp $
+.\"    $NetBSD: daily.conf.5,v 1.7 2000/11/17 10:14:17 lukem Exp $
 .\"
 .\" Copyright (c) 1996 Matthew R. Green
 .\" All rights reserved.
@@ -52,7 +52,9 @@
 .It Sy run_msgs
 This runs
 .Xr msgs 1
-with the ``-c'' argument.
+with the
+.Fl c
+argument.
 .It Sy expire_news
 This runs the
 .Pa /etc/expire.news
@@ -63,13 +65,17 @@
 .It Sy run_calendar
 This runs
 .Xr calendar 1
-with the ``-a'' argument.
+with the
+.Fl a
+argument.
 .It Sy check_uucp
 This runs the
 .Pa /etc/uuclean.daily
 script, as the daemon user, and runs
 .Xr uustat 1
-with the ``-a'' argument.
+with the
+.Fl a
+argument.
 .It Sy check_disks
 This uses the
 .Xr df 1
@@ -82,7 +88,9 @@
 .It Sy check_network
 This runs
 .Xr netstat 1
-with the ``-i'' argument, and also checks the
+with the
+.Fl i
+argument, and also checks the
 .Xr rwhod 8
 database, and runs
 .Xr ruptime 1
@@ -91,7 +99,9 @@
 .It Sy run_fsck
 This runs
 .Xr fsck 8
-with the ``-n'' option.
+with the
+.Fl n
+option.
 .It Sy run_rdist
 This runs
 .Xr rdist 1
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/ethers.5
--- a/share/man/man5/ethers.5   Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/ethers.5   Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ethers.5,v 1.6 2000/11/07 07:17:13 lukem Exp $
+.\"    $NetBSD: ethers.5,v 1.7 2000/11/17 10:14:17 lukem Exp $
 .\"
 .\"     Written by Roland McGrath <roland%frob.com@localhost>.  Public domain.
 .\"
@@ -14,7 +14,9 @@
 file maps Ethernet MAC addresses to host names.
 Lines consist of an address and a host name, separated by any number
 of blanks and/or tab characters.
-A ``#'' character indicates the beginning of a comment;
+A
+.Sq \&#
+character indicates the beginning of a comment;
 characters up to the end of
 the line are not interpreted by routines which search the file.
 .Pp
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/group.5
--- a/share/man/man5/group.5    Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/group.5    Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: group.5,v 1.11 2000/11/17 09:43:06 lukem Exp $
+.\"    $NetBSD: group.5,v 1.12 2000/11/17 10:14:17 lukem Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -175,7 +175,9 @@
 .Tn NIS
 map (respectively).
 .Pp
-If no group name is specified, or the ``+'' (plus sign) appears alone
+If no group name is specified, or the plus sign
+.Pq Dq \&+
+appears alone
 on line, all groups are included from the
 Hesiod domain or the
 .Tn NIS
@@ -183,8 +185,10 @@
 .Pp
 Hesiod or
 .Tn NIS
-compat references may appear anywhere in the file, but the single ``+'' form
-should be on the last line, for historical reasons.
+compat references may appear anywhere in the file, but the single
+plus sign
+.Pq Dq \&+
+form should be on the last line, for historical reasons.
 Only the first group with a specific name encountered, whether in the
 .Nm
 file itself, or included via Hesiod or
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/hosts.5
--- a/share/man/man5/hosts.5    Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/hosts.5    Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hosts.5,v 1.10 2000/11/17 09:43:06 lukem Exp $
+.\"    $NetBSD: hosts.5,v 1.11 2000/11/17 10:14:18 lukem Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -67,7 +67,9 @@
 .El
 .Pp
 Items are separated by any number of blanks and/or
-tab characters.  A ``#'' indicates the beginning of
+tab characters.  A hash sign
+.Pq Dq \&#
+indicates the beginning of
 a comment; characters up to the end of the line are
 not interpreted by routines which search the file.
 .Pp
@@ -97,8 +99,9 @@
 Internet.
 .Pp
 As network addresses, both IPv4 and IPv6 addresses are allowed.
-IPv4 addresses are specified in the conventional
-``.'' (dot) notation using the
+IPv4 addresses are specified in the conventional dot
+.Pq Dq \&.
+notation using the
 .Xr inet_pton 3
 routine
 from the Internet address manipulation library,
diff -r 41c7ca4c9093 -r e58cda68b791 share/man/man5/hosts.equiv.5
--- a/share/man/man5/hosts.equiv.5      Fri Nov 17 10:06:27 2000 +0000
+++ b/share/man/man5/hosts.equiv.5      Fri Nov 17 10:14:16 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hosts.equiv.5,v 1.3 1999/04/06 02:52:40 tv Exp $
+.\"    $NetBSD: hosts.equiv.5,v 1.4 2000/11/17 10:14:18 lukem Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -43,8 +43,9 @@
 .Nm hosts.equiv
 and
 .Nm .rhosts
-files list hosts and users which are ``trusted'' by the local host when a
-connection is made via
+files list hosts and users which are
+.Dq trusted
+by the local host when a connection is made via
 .Xr rlogind 8 ,
 .Xr rshd 8 ,
 or any other server that uses
@@ -62,16 +63,20 @@
 .Em hostname
 may be specified as a host name (typically a fully qualified host
 name in a DNS environment) or address,
-.Em +@netgroup
+.Dq Li +@netgroup
 (from which only the host names are checked),
-or a ``+'' wildcard (allow all hosts).
+or a
+.Dq Li \&+
+wildcard (allow all hosts).
 .Pp
 The
 .Em username ,
 if specified, may be given as a user name on the remote host,
-.Em +@netgroup
+.Dq Li +@netgroup
 (from which only the user names are checked),
-or a ``+'' wildcard (allow all remote users).
+or a
+.Dq Li \&+
+wildcard (allow all remote users).
 .Pp
 If a
 .Em username
@@ -173,4 +178,5 @@
 The
 .Xr ruserok 3
 implementation currently skips negative entries (preceded with a
-``-'' sign) and does not treat them as ``short-circuit'' negative entries.
+.Dq Li \&-
+sign) and does not treat them as ``short-circuit'' negative entries.