From: Sascha Wildner <saw@online.de>
Date: Sun, 10 Mar 2019 08:15:15 +0000 (+0100)
Subject: Fix some self references in our manual pages.
X-Git-Tag: v5.7.0~492
X-Git-Url: https://gitweb.dragonflybsd.org/dragonfly.git/commitdiff_plain/265a14288b8a0c83c58af038128303ea7cd83c94

Fix some self references in our manual pages.
---

diff --git a/games/random/random.6 b/games/random/random.6
index 3e1bcf3d97..aa6f867488 100644
--- a/games/random/random.6
+++ b/games/random/random.6
@@ -95,12 +95,12 @@ The
 option guarantees that the output is unbuffered.
 .It Fl U
 Tells
-.Xr random 6
+.Nm
 that it is okay for it to reuse any given line or word when creating a
 randomized output.
 .It Fl u
 Tells
-.Xr random 6
+.Nm
 not to select the same line or word from a file more than once (the
 default).
 This does not guarantee uniqueness if there are two of the
diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2
index 6e21c81a98..0cae94dd87 100644
--- a/lib/libc/sys/mount.2
+++ b/lib/libc/sys/mount.2
@@ -287,7 +287,7 @@ function may fail with one of the following errors:
 .Bl -tag -width Er
 .It Bq Er EPERM
 The caller is neither the super-user nor the user who issued the corresponding
-.Xr mount 2
+.Fn mount
 call.
 .It Bq Er ENOTDIR
 A component of the path is not a directory.
diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2
index 2561fb9c0a..83900981c4 100644
--- a/lib/libc/sys/vfork.2
+++ b/lib/libc/sys/vfork.2
@@ -108,7 +108,7 @@ This system call will be eliminated when proper system sharing
 mechanisms are implemented.
 Users should not depend on the memory
 sharing semantics of
-.Xr vfork 2
+.Fn vfork
 as it will, in that case, be made synonymous to
 .Xr fork 2 .
 .Pp
diff --git a/lib/libkvm/kvm.3 b/lib/libkvm/kvm.3
index 8336f9e8e5..14404a50a9 100644
--- a/lib/libkvm/kvm.3
+++ b/lib/libkvm/kvm.3
@@ -42,7 +42,7 @@
 .Lb libkvm
 .Sh DESCRIPTION
 The
-.Xr kvm 3
+.Nm kvm
 library provides a uniform interface for accessing kernel virtual memory
 images, including live systems and crash dumps.
 Access to live systems is via
diff --git a/lib/libposix1e/acl.3 b/lib/libposix1e/acl.3
index ef2ffa8f98..5de7bf47eb 100644
--- a/lib/libposix1e/acl.3
+++ b/lib/libposix1e/acl.3
@@ -159,7 +159,6 @@ so as to discourage their
 use in the short term.
 .\" .Sh FILES
 .Sh SEE ALSO
-.Xr acl 3 ,
 .Xr acl_dup 3 ,
 .Xr acl_free 3 ,
 .Xr acl_from_text 3 ,
diff --git a/lib/librt/aio_suspend.3 b/lib/librt/aio_suspend.3
index b001bfbf25..b7ce896f1e 100644
--- a/lib/librt/aio_suspend.3
+++ b/lib/librt/aio_suspend.3
@@ -90,7 +90,6 @@ the suspend was interrupted by a signal.
 .Xr aio_cancel 3 ,
 .Xr aio_error 3 ,
 .Xr aio_read 3 ,
-.Xr aio_suspend 3 ,
 .Xr aio_write 3
 .Sh STANDARDS
 .Fn aio_suspend
diff --git a/libexec/mknetid/netid.5 b/libexec/mknetid/netid.5
index 7890aadde2..fd56138839 100644
--- a/libexec/mknetid/netid.5
+++ b/libexec/mknetid/netid.5
@@ -70,7 +70,7 @@ The second type contains information about hosts:
 .Sm on
 .Pp
 The third type refers to records from a
-.Xr netid 5
+.Nm
 file other than the two types above.
 .Sh FILES
 .Bl -tag -width ".Pa /etc/netid" -compact
diff --git a/sbin/devfsctl/devfsctl.8 b/sbin/devfsctl/devfsctl.8
index 05f8ae6d77..a43c402c26 100644
--- a/sbin/devfsctl/devfsctl.8
+++ b/sbin/devfsctl/devfsctl.8
@@ -179,8 +179,7 @@ rules will create a link node at the specified
 .Ar link_path
 to the given
 .Ar device .
-The path is relative to the mountpoint being operated on (see
-.Xr devfsctl 8 Ap s
+The path is relative to the mountpoint being operated on (see the
 .Fl m
 option), which is usually
 .Pa /dev .
diff --git a/share/man/man4/cxm.4 b/share/man/man4/cxm.4
index cd462093e0..6d7836270b 100644
--- a/share/man/man4/cxm.4
+++ b/share/man/man4/cxm.4
@@ -64,7 +64,7 @@ It uses the
 and Meteor driver ioctls.
 .Pp
 Note that in order for the
-.Xr cxm 4
+.Nm
 driver to work properly, the necessary firmware files have to be extracted
 from the driver CD-ROM prior to compiling the kernel.
 The tool necessary to do this can be found in
diff --git a/share/man/man4/puc.4 b/share/man/man4/puc.4
index 928a7071c9..7f7693529f 100644
--- a/share/man/man4/puc.4
+++ b/share/man/man4/puc.4
@@ -47,7 +47,7 @@ Support for new cards should be added there.
 .Sh HISTORY
 This driver took the idea from the
 .Nx
-.Xr puc 4
+.Nm
 driver and still use the same structure to describe cards to ease exchanging
 card info.
 .Sh BUGS
diff --git a/share/man/man4/random.4 b/share/man/man4/random.4
index 4fcbfa5a15..6182098040 100644
--- a/share/man/man4/random.4
+++ b/share/man/man4/random.4
@@ -65,7 +65,7 @@ generate random numbers.  In a Unix environment, this is best done
 from inside the kernel.
 .Pp
 Previous and contemporary
-.Xr random 4
+.Nm
 implementations typically used
 an "entropy" pool which was processed with a cryptographic hash
 function such as MD5. However, at the time of this writing security
diff --git a/share/man/man4/vge.4 b/share/man/man4/vge.4
index 1e5ef858ed..d2cf0a2074 100644
--- a/share/man/man4/vge.4
+++ b/share/man/man4/vge.4
@@ -217,4 +217,4 @@ driver was written by
 .Sh BUGS
 .Xr polling 4
 may not work with
-.Xr vge 4 .
+.Nm .
diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5
index 81dd0eaef9..8b5244d59c 100644
--- a/share/man/man5/elf.5
+++ b/share/man/man5/elf.5
@@ -1334,5 +1334,5 @@ This manual page was written by
 .An Jeroen Ruigrok van der Werven Aq Mt asmodai@FreeBSD.org
 with inspiration from BSDi's
 .Bsx
-.Xr elf 5
+.Nm
 manpage.
diff --git a/share/man/man5/nsswitch.conf.5 b/share/man/man5/nsswitch.conf.5
index 30b16a09e5..da1890a946 100644
--- a/share/man/man5/nsswitch.conf.5
+++ b/share/man/man5/nsswitch.conf.5
@@ -215,7 +215,7 @@ and continue on anything else (i.e,
 You can enable caching for the particular database by specifying
 .Dq cache
 as the first source in the
-.Xr nsswitch.conf 5
+.Nm
 file.
 You should also enable caching for this database in
 .Xr nscd.conf 5 .
diff --git a/share/man/man9/VOP_INACTIVE.9 b/share/man/man9/VOP_INACTIVE.9
index 954596958b..8909d11cfb 100644
--- a/share/man/man9/VOP_INACTIVE.9
+++ b/share/man/man9/VOP_INACTIVE.9
@@ -47,12 +47,12 @@ The arguments are:
 the vnode being reclaimed
 .El
 .Pp
-.Xr VOP_INACTIVE 9
+.Fn VOP_INACTIVE
 is called when the kernel is no longer using the vnode.  This may be
 because the reference count reaches zero or it may be that the
 filesystem is being forcibly unmounted while there are open files.
 It can be used to reclaim space for 'open but deleted' files.
-.Xr VOP_RECLAIM 9
+.Fn VOP_RECLAIM
 is called when a vnode is being reused for a different filesystem.
 Any filesystem specific resources associated with the vnode should be
 freed.
diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9
index b8124c5b6a..ff11674b78 100644
--- a/share/man/man9/bus_dma.9
+++ b/share/man/man9/bus_dma.9
@@ -835,7 +835,7 @@ the operation.
 "highaddr" "maxsize" "flags" "*dmem"
 This is a convenient function to create one segment of DMA memory.
 It combines following
-.Xr bus_dma 9
+.Nm
 function calls:
 .Bd -literal
 	bus_dma_tag_create(..., dtag);
diff --git a/share/man/man9/device_add_child.9 b/share/man/man9/device_add_child.9
index cfb11bc06e..e61ad0131a 100644
--- a/share/man/man9/device_add_child.9
+++ b/share/man/man9/device_add_child.9
@@ -25,7 +25,6 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/share/man/man9/device_add_child.9,v 1.8.2.5 2001/12/17 11:30:18 ru Exp $
-.\" $DragonFly: src/share/man/man9/device_add_child.9,v 1.3 2004/06/01 11:36:53 hmp Exp $
 .\"
 .Dd June 16, 1998
 .Dt DEVICE_ADD_CHILD 9
@@ -81,12 +80,12 @@ of unrelated drivers and therefore must be probed first),
 the
 .Fa order
 argument of
-.Xr device_add_child_ordered 9
+.Fn device_add_child_ordered
 should be used to specify a partial ordering.
 The new device will be added before any existing device with a greater
 order.
 If
-.Xr device_add_child 9
+.Fn device_add_child
 is used, then the new child will be added as if its order was zero.
 .Sh RETURN VALUES
 The new device if successful, NULL otherwise.
diff --git a/share/man/man9/device_enable.9 b/share/man/man9/device_enable.9
index 294d3439a3..9b76c405fe 100644
--- a/share/man/man9/device_enable.9
+++ b/share/man/man9/device_enable.9
@@ -25,7 +25,6 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/share/man/man9/device_enable.9,v 1.3.2.3 2001/12/17 11:30:18 ru Exp $
-.\" $DragonFly: src/share/man/man9/device_enable.9,v 1.3 2004/06/01 11:36:53 hmp Exp $
 .\"
 .Dd June 16, 1998
 .Dt DEVICE_ENABLE 9
@@ -49,11 +48,11 @@ Each device has an enabled flag associated with it.  A device is
 enabled by default when it is created but may be disabled (for
 instance to prevent a destructive or time consuming probe attempt).
 To disable a device, call
-.Xr device_disable 9 ,
+.Fn device_disable ,
 to reenable it, call
-.Xr device_enable 9
+.Fn device_enable
 and to test to see if a device is enabled, call
-.Xr device_is_enabled 9 .
+.Fn device_is_enabled .
 .Sh SEE ALSO
 .Xr device 9
 .Sh AUTHORS
diff --git a/share/man/man9/device_get_state.9 b/share/man/man9/device_get_state.9
index 3b0af8392f..37d6b56584 100644
--- a/share/man/man9/device_get_state.9
+++ b/share/man/man9/device_get_state.9
@@ -25,7 +25,6 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/share/man/man9/device_get_state.9,v 1.3.2.5 2001/12/17 11:30:18 ru Exp $
-.\" $DragonFly: src/share/man/man9/device_get_state.9,v 1.3 2004/06/01 11:36:53 hmp Exp $
 .\"
 .Dd June 16, 1998
 .Dt DEVICE_GET_STATE 9
@@ -49,7 +48,7 @@
 .Fn device_is_alive "device_t dev"
 .Sh DESCRIPTION
 The current state of a device is accessed by calling
-.Xr device_get_state 9
+.Fn device_get_state
 which returns
 .Dv DS_NOTPRESENT ,
 .Dv DS_ALIVE ,
@@ -59,27 +58,27 @@ or
 (described in
 .Xr device 9 ) .
 To test see if a device was successfully probed, call
-.Xr device_is_alive 9
+.Fn device_is_alive
 which simply returns if the state is greater or equal to
 .Dv DS_ALIVE .
 .Pp
 Each device has a busy count which is incremented when
-.Xr device_busy 9
+.Fn device_busy
 is called and decremented when
-.Xr device_unbusy 9
+.Fn device_unbusy
 is called.  Both routines return an error if the device state is less
 than
 .Dv DS_ATTACHED .
 .Pp
 When
-.Xr device_busy 9
+.Fn device_busy
 is called on a device in the
 .Dv DS_ATTACHED
 state, the device changes to the
 .Dv DS_BUSY
 state.
 When
-.Xr device_unbusy 9
+.Fn device_unbusy
 is called and after decrementing, the busy count for the device is
 zero, the device changes to the
 .Dv DS_ATTACHED
diff --git a/share/man/man9/device_quiet.9 b/share/man/man9/device_quiet.9
index 46c024ab1b..69868efed5 100644
--- a/share/man/man9/device_quiet.9
+++ b/share/man/man9/device_quiet.9
@@ -25,7 +25,6 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/share/man/man9/device_quiet.9,v 1.3.2.4 2001/12/17 11:30:18 ru Exp $
-.\" $DragonFly: src/share/man/man9/device_quiet.9,v 1.3 2004/06/01 11:36:53 hmp Exp $
 .\"
 .Dd June 21, 1999
 .Dt DEVICE_QUIET 9
@@ -49,14 +48,14 @@ Each device has a quiet flag associated with it.  A device is
 verbose by default when it is created but may be quieted to prevent
 the device identification string to be printed during probe.
 To quiet a device, call
-.Xr device_quiet 9 ,
+.Fn device_quiet ,
 to reenable to probe message (to make the message appear again, for
 example after a
 .Xr device_detach 9 )
 call
-.Xr device_verbose 9 .
+.Fn device_verbose .
 To test to see if a device is quieted, call
-.Xr device_is_quiet 9 .
+.Fn device_is_quiet .
 .Sh SEE ALSO
 .Xr device 9
 .Sh AUTHORS
diff --git a/share/man/man9/device_set_flags.9 b/share/man/man9/device_set_flags.9
index 4f2ec524a3..961f6f4769 100644
--- a/share/man/man9/device_set_flags.9
+++ b/share/man/man9/device_set_flags.9
@@ -25,7 +25,6 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/share/man/man9/device_set_flags.9,v 1.1.2.5 2001/12/17 11:30:18 ru Exp $
-.\" $DragonFly: src/share/man/man9/device_set_flags.9,v 1.4 2006/08/06 02:27:56 swildner Exp $
 .\"
 .Dd September 6, 1999
 .Dt DEVICE_SET_FLAGS 9
@@ -45,9 +44,9 @@
 Each device supports a set of driver-dependent flags which are often
 used to control device behaviour.
 These flags are read by calling
-.Xr device_get_flags 9
+.Fn device_get_flags
 and written by calling
-.Xr device_set_flags 9 .
+.Fn device_set_flags .
 .Sh SEE ALSO
 .Xr device 9
 .Sh AUTHORS
diff --git a/usr.bin/soelim/soelim.1 b/usr.bin/soelim/soelim.1
index 2923a12044..6827d3780f 100644
--- a/usr.bin/soelim/soelim.1
+++ b/usr.bin/soelim/soelim.1
@@ -58,15 +58,15 @@ Recognise
 when it is not followed by a space character.
 .It Fl r
 Compatibility with groff's
-.Xr soelim 1
+.Nm
 (does nothing).
 .It Fl t
 Compatibility with groff's
-.Xr soelim 1
+.Nm
 (does nothing).
 .It Fl v
 Compatibility with groff's
-.Xr soelim 1
+.Nm
 (does nothing).
 .It Fl I Ar dir
 This option specifies directories where
diff --git a/usr.bin/su/su.1 b/usr.bin/su/su.1
index 336e4fd6aa..34d8766eed 100644
--- a/usr.bin/su/su.1
+++ b/usr.bin/su/su.1
@@ -49,7 +49,7 @@ and switches to that user ID
 A shell is then executed.
 .Pp
 PAM is used to set the policy
-.Xr su 1
+.Nm
 will use.
 In particular, by default only users in the
 .Dq Li wheel
diff --git a/usr.sbin/chroot/chroot.8 b/usr.sbin/chroot/chroot.8
index 5310c64497..73997d9847 100644
--- a/usr.sbin/chroot/chroot.8
+++ b/usr.sbin/chroot/chroot.8
@@ -27,7 +27,6 @@
 .\"
 .\"     @(#)chroot.8	8.1 (Berkeley) 6/9/93
 .\" $FreeBSD: src/usr.sbin/chroot/chroot.8,v 1.5.2.5 2003/03/12 22:08:13 trhodes Exp $
-.\" $DragonFly: src/usr.sbin/chroot/chroot.8,v 1.3 2003/08/24 16:04:16 drhodus Exp $
 .\"
 .Dd January 24, 2003
 .Dt CHROOT 8
@@ -61,7 +60,7 @@ options are given,
 the user,
 group and group list of the process are set to
 these values after the
-.Xr chroot 8
+.Fn chroot
 has taken place.
 .Sh ENVIRONMENT
 The following environment variable is referenced by