From facc67676f0239e4912f737638710058315d9fc7 Mon Sep 17 00:00:00 2001 From: Ruslan Ermilov Date: Tue, 24 Dec 2002 13:41:48 +0000 Subject: [PATCH] mdoc(7) police: Deal with self-xrefs. --- bin/sh/sh.1 | 2 +- lib/libc/locale/mbrune.3 | 1 - lib/libc/stdio/mktemp.3 | 2 +- lib/libc/stdlib/malloc.3 | 2 +- lib/libc/sys/fcntl.2 | 2 +- lib/libc/sys/vfork.2 | 2 +- lib/libc_r/man/pthread_rwlock_wrlock.3 | 7 ++++--- lib/libc_r/man/pthread_rwlockattr_setpshared.3 | 2 +- lib/libkvm/kvm.3 | 2 +- lib/libpthread/man/pthread_rwlock_wrlock.3 | 6 +++--- lib/libpthread/man/pthread_rwlockattr_setpshared.3 | 2 +- libexec/atrun/atrun.man | 2 +- libexec/mknetid/netid.5 | 2 +- sbin/bsdlabel/bsdlabel.8 | 2 +- sbin/disklabel/disklabel.8 | 2 +- share/man/man3/pthread_rwlock_wrlock.3 | 7 ++++--- share/man/man3/pthread_rwlockattr_setpshared.3 | 2 +- share/man/man4/worm.4 | 2 +- share/man/man7/hier.7 | 2 +- share/man/man7/ports.7 | 2 +- share/man/man9/DEVICE_PROBE.9 | 1 - share/man/man9/VOP_ATTRIB.9 | 10 +++++----- share/man/man9/VOP_INACTIVE.9 | 4 ++-- share/man/man9/VOP_LINK.9 | 2 +- share/man/man9/VOP_OPENCLOSE.9 | 8 ++++---- share/man/man9/accf_data.9 | 5 +++-- share/man/man9/accf_http.9 | 9 +++++---- share/man/man9/device_add_child.9 | 4 ++-- share/man/man9/device_enable.9 | 6 +++--- share/man/man9/device_get_state.9 | 12 ++++++------ share/man/man9/device_quiet.9 | 6 +++--- share/man/man9/device_set_desc.9 | 2 +- share/man/man9/device_set_flags.9 | 4 ++-- share/man/man9/vget.9 | 2 +- share/man/man9/vref.9 | 2 +- share/man/man9/vrele.9 | 2 +- usr.bin/chpass/chpass.1 | 10 +++++----- usr.bin/finger/finger.1 | 2 +- usr.bin/passwd/passwd.1 | 4 ++-- usr.bin/talk/talk.1 | 2 +- usr.bin/tcopy/tcopy.1 | 4 ++-- usr.bin/tip/tip/tip.1 | 2 +- usr.sbin/apm/apm.8 | 4 ++-- usr.sbin/ctm/ctm_rmail/ctm_rmail.1 | 2 +- usr.sbin/ntp/doc/ntpq.8 | 2 +- usr.sbin/rtsold/rtsold.8 | 2 +- usr.sbin/sicontrol/sicontrol.8 | 2 +- 47 files changed, 85 insertions(+), 83 deletions(-) diff --git a/bin/sh/sh.1 b/bin/sh/sh.1 index c575935bf80c..c344df95155e 100644 --- a/bin/sh/sh.1 +++ b/bin/sh/sh.1 @@ -158,7 +158,7 @@ in the descriptions below. The long name for an option may be specified as an argument to the .Fl /+o option of -.Xr sh 1 . +.Nm . Once the shell is running, the long name for an option may be specified as an argument to the .Fl /+o diff --git a/lib/libc/locale/mbrune.3 b/lib/libc/locale/mbrune.3 index 557d92975739..d6f66c1a84ca 100644 --- a/lib/libc/locale/mbrune.3 +++ b/lib/libc/locale/mbrune.3 @@ -157,7 +157,6 @@ if the .Fa pattern does not appear in the string. .Sh "SEE ALSO -.Xr mbrune 3 , .Xr rune 3 , .Xr setlocale 3 , .Xr euc 4 , diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3 index 5c9de2e23cf4..e875a0381e8c 100644 --- a/lib/libc/stdio/mktemp.3 +++ b/lib/libc/stdio/mktemp.3 @@ -102,7 +102,7 @@ is told the length of the suffix string. The .Fn mkdtemp function makes the same replacement to the template as in -.Xr mktemp 3 +.Fn mktemp and creates the template directory, mode 0700. .Sh RETURN VALUES The diff --git a/lib/libc/stdlib/malloc.3 b/lib/libc/stdlib/malloc.3 index b6084d669ecd..d1f081b908de 100644 --- a/lib/libc/stdlib/malloc.3 +++ b/lib/libc/stdlib/malloc.3 @@ -487,7 +487,7 @@ It first appeared in its new shape and ability in .Fx 2.2 . .Pp The -.Xr reallocf 3 +.Fn reallocf function first appeared in .Fx 3.0 . .Sh AUTHORS diff --git a/lib/libc/sys/fcntl.2 b/lib/libc/sys/fcntl.2 index c9dc8e757d4b..c3d0231efb9e 100644 --- a/lib/libc/sys/fcntl.2 +++ b/lib/libc/sys/fcntl.2 @@ -343,7 +343,7 @@ to their children. Note that .Xr flock 2 and -.Xr fcntl 2 +.Fn fcntl locks may be safely used concurrently but .Fn fcntl F_GETLK returns \-1 in diff --git a/lib/libc/sys/vfork.2 b/lib/libc/sys/vfork.2 index 113dff957635..433f42d9e36c 100644 --- a/lib/libc/sys/vfork.2 +++ b/lib/libc/sys/vfork.2 @@ -115,7 +115,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/libc_r/man/pthread_rwlock_wrlock.3 b/lib/libc_r/man/pthread_rwlock_wrlock.3 index 55ab5f933468..c74a46653a79 100644 --- a/lib/libc_r/man/pthread_rwlock_wrlock.3 +++ b/lib/libc_r/man/pthread_rwlock_wrlock.3 @@ -61,9 +61,10 @@ and functions will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_trywrlock 3 , -.Xr pthread_rwlock_unlock 3 , -.Xr pthread_rwlock_wrlock 3 +.Xr pthread_rwlock_init 3 , +.Xr pthread_rwlock_rdlock 3 , +.Xr pthread_rwlock_tryrdlock 3 , +.Xr pthread_rwlock_unlock 3 .Sh STANDARDS The .Fn pthread_rwlock_wrlock diff --git a/lib/libc_r/man/pthread_rwlockattr_setpshared.3 b/lib/libc_r/man/pthread_rwlockattr_setpshared.3 index 48b854d21a6b..e19e66c1c188 100644 --- a/lib/libc_r/man/pthread_rwlockattr_setpshared.3 +++ b/lib/libc_r/man/pthread_rwlockattr_setpshared.3 @@ -60,8 +60,8 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO +.Xr pthread_rwlockattr_getpshared 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 , .Xr pthread_rwlock_init 3 .Sh STANDARDS The diff --git a/lib/libkvm/kvm.3 b/lib/libkvm/kvm.3 index dfa369a70442..35c0dbaabffd 100644 --- a/lib/libkvm/kvm.3 +++ b/lib/libkvm/kvm.3 @@ -46,7 +46,7 @@ .Lb libkvm .Sh DESCRIPTION The -.Xr kvm 3 +.Nm 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/libpthread/man/pthread_rwlock_wrlock.3 b/lib/libpthread/man/pthread_rwlock_wrlock.3 index a73c19407994..c5e9f9980818 100644 --- a/lib/libpthread/man/pthread_rwlock_wrlock.3 +++ b/lib/libpthread/man/pthread_rwlock_wrlock.3 @@ -61,9 +61,9 @@ and functions will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_trywrlock 3 , -.Xr pthread_rwlock_unlock 3 , -.Xr pthread_rwlock_wrlock 3 +.Xr pthread_rwlock_rdlock 3 , +.Xr pthread_rwlock_tryrdlock 3 , +.Xr pthread_rwlock_unlock 3 .Sh STANDARDS The .Fn pthread_rwlock_wrlock diff --git a/lib/libpthread/man/pthread_rwlockattr_setpshared.3 b/lib/libpthread/man/pthread_rwlockattr_setpshared.3 index 2ee7d9ec6c99..a4fba8c94fed 100644 --- a/lib/libpthread/man/pthread_rwlockattr_setpshared.3 +++ b/lib/libpthread/man/pthread_rwlockattr_setpshared.3 @@ -60,8 +60,8 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO +.Xr pthread_rwlockattr_getpshared 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 , .Xr pthread_rwlock_init 3 .Sh STANDARDS The diff --git a/libexec/atrun/atrun.man b/libexec/atrun/atrun.man index 31c81576409d..70c1230dbbc6 100644 --- a/libexec/atrun/atrun.man +++ b/libexec/atrun/atrun.man @@ -24,7 +24,7 @@ has to contain the line .Ed .Pp so that -.Xr atrun 8 +.Nm gets invoked every five minutes. .Pp At every invocation, diff --git a/libexec/mknetid/netid.5 b/libexec/mknetid/netid.5 index d9cc0f962c29..8e60090f898e 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 EXAMPLES A configuration file might look like the following: diff --git a/sbin/bsdlabel/bsdlabel.8 b/sbin/bsdlabel/bsdlabel.8 index 035edec47fff..1e908c29cf46 100644 --- a/sbin/bsdlabel/bsdlabel.8 +++ b/sbin/bsdlabel/bsdlabel.8 @@ -470,7 +470,7 @@ as the partition table in DOS. Here you will define disk slices for your system. .It Use -.Xr disklabel 8 +.Nm to define and write partitions and mount points. You are not required to define the mount points here though, they can be defined later using diff --git a/sbin/disklabel/disklabel.8 b/sbin/disklabel/disklabel.8 index 035edec47fff..1e908c29cf46 100644 --- a/sbin/disklabel/disklabel.8 +++ b/sbin/disklabel/disklabel.8 @@ -470,7 +470,7 @@ as the partition table in DOS. Here you will define disk slices for your system. .It Use -.Xr disklabel 8 +.Nm to define and write partitions and mount points. You are not required to define the mount points here though, they can be defined later using diff --git a/share/man/man3/pthread_rwlock_wrlock.3 b/share/man/man3/pthread_rwlock_wrlock.3 index 55ab5f933468..c74a46653a79 100644 --- a/share/man/man3/pthread_rwlock_wrlock.3 +++ b/share/man/man3/pthread_rwlock_wrlock.3 @@ -61,9 +61,10 @@ and functions will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO -.Xr pthread_rwlock_trywrlock 3 , -.Xr pthread_rwlock_unlock 3 , -.Xr pthread_rwlock_wrlock 3 +.Xr pthread_rwlock_init 3 , +.Xr pthread_rwlock_rdlock 3 , +.Xr pthread_rwlock_tryrdlock 3 , +.Xr pthread_rwlock_unlock 3 .Sh STANDARDS The .Fn pthread_rwlock_wrlock diff --git a/share/man/man3/pthread_rwlockattr_setpshared.3 b/share/man/man3/pthread_rwlockattr_setpshared.3 index 48b854d21a6b..e19e66c1c188 100644 --- a/share/man/man3/pthread_rwlockattr_setpshared.3 +++ b/share/man/man3/pthread_rwlockattr_setpshared.3 @@ -60,8 +60,8 @@ If successful, the function will return zero. Otherwise an error number will be returned to indicate the error. .Sh SEE ALSO +.Xr pthread_rwlockattr_getpshared 3 , .Xr pthread_rwlockattr_init 3 , -.Xr pthread_rwlockattr_setpshared 3 , .Xr pthread_rwlock_init 3 .Sh STANDARDS The diff --git a/share/man/man4/worm.4 b/share/man/man4/worm.4 index b050aa3de794..32111b0a1f91 100644 --- a/share/man/man4/worm.4 +++ b/share/man/man4/worm.4 @@ -60,7 +60,7 @@ by a CAM-compliant layer. The new .Tn SCSI layer doesn't include a -.Xr worm 4 +.Nm driver, and isn't likely to include one in the future. Future in-kernel support for CD-R/CD-RW/DVD drives will likely be implemented through the .Xr cd 4 diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index f07c9f3602dd..8827fb5806fd 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -408,7 +408,7 @@ Also used as the default destination for the .Fx ports framework. Within local/, the general layout sketched out by -.Xr hier 7 +.Nm for /usr should be used. Exceptions are the man directory (directly under local/ rather than under local/share/), ports documentation (in share/doc//), diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index 943c384cd1ab..2b480fbd9b84 100644 --- a/share/man/man7/ports.7 +++ b/share/man/man7/ports.7 @@ -380,6 +380,6 @@ the chapter of .%B "The FreeBSD Handbook" , and -.Xr ports 7 . +this man page. .Pp This man page is too long. diff --git a/share/man/man9/DEVICE_PROBE.9 b/share/man/man9/DEVICE_PROBE.9 index c772e20c8040..36e48e9bdb3f 100644 --- a/share/man/man9/DEVICE_PROBE.9 +++ b/share/man/man9/DEVICE_PROBE.9 @@ -81,7 +81,6 @@ priority, e.g. -100 indicates a lower priority than -50. .Xr device 9 , .Xr DEVICE_DETACH 9 , .Xr DEVICE_IDENTIFY 9 , -.Xr DEVICE_PROBE 9 , .Xr DEVICE_SHUTDOWN 9 .Sh AUTHORS This man page was written by diff --git a/share/man/man9/VOP_ATTRIB.9 b/share/man/man9/VOP_ATTRIB.9 index e75958bcdf29..885edc414716 100644 --- a/share/man/man9/VOP_ATTRIB.9 +++ b/share/man/man9/VOP_ATTRIB.9 @@ -60,7 +60,7 @@ the thread .El .Pp Attributes which are not being modified by -.Xr VOP_SETATTR 9 +.Fn VOP_SETATTR should be set to the value .Dv VNOVAL ; .Fn VATTR_NULL @@ -69,21 +69,21 @@ the contents of .Fa *vap prior to setting specific values. .Sh LOCKS -.Xr VOP_GETATTR 9 +.Fn VOP_GETATTR expects the vnode to be locked on entry and will leave the vnode locked on return. The lock type can be either shared or exclusive. .Pp -.Xr VOP_SETATTR 9 +.Fn VOP_SETATTR expects the vnode to be locked on entry and will leave the vnode locked on return. The lock type must be exclusive. .Sh RETURN VALUES -.Xr VOP_GETATTR 9 +.Fn VOP_GETATTR returns 0 if it was able to retrieve the attribute data via .Fa *vap , otherwise an appropriate error is returned. -.Xr VOP_SETATTR 9 +.Fn VOP_SETATTR returns zero if the attributes were changed successfully, otherwise an appropriate error is returned. .Sh PSEUDOCODE diff --git a/share/man/man9/VOP_INACTIVE.9 b/share/man/man9/VOP_INACTIVE.9 index 9fa38336ebbb..25f8859aa540 100644 --- a/share/man/man9/VOP_INACTIVE.9 +++ b/share/man/man9/VOP_INACTIVE.9 @@ -49,12 +49,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 file system 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 file system. Any file system specific resources associated with the vnode should be freed. diff --git a/share/man/man9/VOP_LINK.9 b/share/man/man9/VOP_LINK.9 index f95c55de2116..9d5bde7b2b13 100644 --- a/share/man/man9/VOP_LINK.9 +++ b/share/man/man9/VOP_LINK.9 @@ -60,7 +60,7 @@ The directory and file vnodes should .Em not be released on exit. .Sh LOCKS -.Xr VOP_LINK 9 +.Fn VOP_LINK expects the directory and file vnodes to be locked on entry and will leave the vnodes locked on return. .Sh RETURN VALUES diff --git a/share/man/man9/VOP_OPENCLOSE.9 b/share/man/man9/VOP_OPENCLOSE.9 index 5c1be6cb6d56..45a046fbdce7 100644 --- a/share/man/man9/VOP_OPENCLOSE.9 +++ b/share/man/man9/VOP_OPENCLOSE.9 @@ -44,9 +44,9 @@ .Fn VOP_CLOSE "struct vnode *vp" "int mode" "struct ucred *cred" "struct thread *td" .Sh DESCRIPTION The -.Xr VOP_OPEN 9 +.Fn VOP_OPEN entry point is called before a file is accessed by a process and the -.Xr VOP_CLOSE 9 +.Fn VOP_CLOSE entry point is called after a file is finished with by the process. .Pp The arguments are: @@ -65,12 +65,12 @@ The access mode is a set of flags, including .Dv O_NONBLOCK , .Dv O_APPEND . .Sh LOCKS -.Xr VOP_OPEN 9 +.Fn VOP_OPEN expects .Fa vp to be locked on entry and will leave it locked on return. .Pp -.Xr VOP_CLOSE 9 +.Fn VOP_CLOSE expects at least a reference to be associated with the vnode and does not care whether the vnode is locked or not. The lock and reference state is left unchanged on return. Note that diff --git a/share/man/man9/accf_data.9 b/share/man/man9/accf_data.9 index a7c78bfdf07d..4b465d3006bb 100644 --- a/share/man/man9/accf_data.9 +++ b/share/man/man9/accf_data.9 @@ -51,8 +51,9 @@ kernel option is also a module that can be enabled at runtime via if the INET option has been compiled into the kernel. .Sh EXAMPLE Assuming ACCEPT_FILTER_DATA has been included in the kernel config -file or the module -.Xr accf_data 9 +file or the +.Nm +module has been loaded, this will enable the data accept filter on the socket .Fa sok . diff --git a/share/man/man9/accf_http.9 b/share/man/man9/accf_http.9 index 1438e0868a63..69e724b0b72c 100644 --- a/share/man/man9/accf_http.9 +++ b/share/man/man9/accf_http.9 @@ -52,7 +52,7 @@ via .Fn accept . .Pp The utility of -.Xr accf_http 9 +.Nm is such that a server will not have to context switch several times before performing the initial parsing of the request. This effectively reduces the amount of required CPU utilization @@ -67,14 +67,15 @@ or based servers. .Pp The -.Xr accf_http 9 +.Nm kernel option is also a module that can be enabled at runtime via .Xr kldload 8 if the INET option has been compiled into the kernel. .Sh EXAMPLE Assuming ACCEPT_FILTER_HTTP has been included in the kernel config -file or the module -.Xr accf_http 9 +file or the +.Nm +module has been loaded, this will enable the http accept filter on the socket .Fa sok . diff --git a/share/man/man9/device_add_child.9 b/share/man/man9/device_add_child.9 index 3c5d2e3c948c..8d0863915121 100644 --- a/share/man/man9/device_add_child.9 +++ b/share/man/man9/device_add_child.9 @@ -82,12 +82,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 a2b4070b8f4f..7e7fdc91be05 100644 --- a/share/man/man9/device_enable.9 +++ b/share/man/man9/device_enable.9 @@ -50,11 +50,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 re-enable 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 e499336974e7..20695bda21fe 100644 --- a/share/man/man9/device_get_state.9 +++ b/share/man/man9/device_get_state.9 @@ -50,7 +50,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 , @@ -60,27 +60,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 c97508581397..502e1a927dca 100644 --- a/share/man/man9/device_quiet.9 +++ b/share/man/man9/device_quiet.9 @@ -50,14 +50,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 re-enable 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_desc.9 b/share/man/man9/device_set_desc.9 index 6ddbeabd0bff..05478059105d 100644 --- a/share/man/man9/device_set_desc.9 +++ b/share/man/man9/device_set_desc.9 @@ -50,7 +50,7 @@ Manipulate the verbose description of a device. This description (if present) is printed as part of the message when it is attached during autoconfiguration. The variation -.Xr device_set_desc_copy 9 +.Fn device_set_desc_copy is used to set the description if the string passed is a temporary buffer which will be overwritten. In this case, the system will copy diff --git a/share/man/man9/device_set_flags.9 b/share/man/man9/device_set_flags.9 index 70bb8508ad2b..b5304cc47932 100644 --- a/share/man/man9/device_set_flags.9 +++ b/share/man/man9/device_set_flags.9 @@ -46,9 +46,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/share/man/man9/vget.9 b/share/man/man9/vget.9 index 97c54f55c6be..a64238970c07 100644 --- a/share/man/man9/vget.9 +++ b/share/man/man9/vget.9 @@ -57,7 +57,7 @@ When a vnode which is on the free list is used again, for instance if the vnode was found in the name cache as a result of a call to .Xr VOP_LOOKUP 9 then the new user must call -.Xr vget 9 +.Fn vget to increment the reference count and remove it from the free list. .Sh SEE ALSO .Xr vnode 9 , diff --git a/share/man/man9/vref.9 b/share/man/man9/vref.9 index 214a05999441..5f7ec1bda43e 100644 --- a/share/man/man9/vref.9 +++ b/share/man/man9/vref.9 @@ -55,7 +55,7 @@ no longer being used and can be safely recycled for a different file. Any code in the system which is using a vnode (e.g. during the operation of some algorithm or to store in a data structure) should call -.Xr vref 9 . +.Fn vref . .Sh SEE ALSO .Xr vget 9 , .Xr vnode 9 , diff --git a/share/man/man9/vrele.9 b/share/man/man9/vrele.9 index adfe769ce60d..28478dbdd88c 100644 --- a/share/man/man9/vrele.9 +++ b/share/man/man9/vrele.9 @@ -49,7 +49,7 @@ the vnode to decrement .El .Pp Any code in the system which is using a vnode should call -.Xr vrele 9 +.Fn vrele when it is finished with the vnode. If the .Dv v_usecount diff --git a/usr.bin/chpass/chpass.1 b/usr.bin/chpass/chpass.1 index 6dbcdd23afd1..324d8a2143c8 100644 --- a/usr.bin/chpass/chpass.1 +++ b/usr.bin/chpass/chpass.1 @@ -70,12 +70,12 @@ with or, by default, the current user. .Pp The -.Xr chfn 1 , -.Xr chsh 1 , -.Xr ypchpass 1 , -.Xr ypchfn 1 +.Nm chfn , +.Nm chsh , +.Nm ypchpass , +.Nm ypchfn and -.Xr ypchsh 1 +.Nm ypchsh utilities behave identically to .Nm . (There is only one program.) diff --git a/usr.bin/finger/finger.1 b/usr.bin/finger/finger.1 index a26b0d4b73da..d517497ec09b 100644 --- a/usr.bin/finger/finger.1 +++ b/usr.bin/finger/finger.1 @@ -205,7 +205,7 @@ The optional .Xr finger.conf 5 configuration file can be used to specify aliases. Since -.Xr finger 1 +.Nm is invoked by .Xr fingerd 8 , aliases will work for both local and network queries. diff --git a/usr.bin/passwd/passwd.1 b/usr.bin/passwd/passwd.1 index 0d148e9c4637..cc61b41d7e96 100644 --- a/usr.bin/passwd/passwd.1 +++ b/usr.bin/passwd/passwd.1 @@ -105,7 +105,7 @@ To change another user's Kerberos password, one must first run .Xr kinit 1 followed by -.Xr passwd 1 . +.Nm . The super-user is not required to provide a user's current password if only the local password is modified. .Sh NIS INTERACTION @@ -240,7 +240,7 @@ configure authentication services .Re .Sh NOTES The -.Xr yppasswd 1 +.Nm yppasswd command is really only a link to .Nm . .Sh HISTORY diff --git a/usr.bin/talk/talk.1 b/usr.bin/talk/talk.1 index debfb7611444..c7dd60b692fa 100644 --- a/usr.bin/talk/talk.1 +++ b/usr.bin/talk/talk.1 @@ -130,7 +130,7 @@ to find the recipient's tty .Xr write 1 .Sh BUGS The version of -.Xr talk 1 +.Nm released with .Bx 4.3 uses a protocol that diff --git a/usr.bin/tcopy/tcopy.1 b/usr.bin/tcopy/tcopy.1 index 8f48d1897be2..bd74e6bb42f6 100644 --- a/usr.bin/tcopy/tcopy.1 +++ b/usr.bin/tcopy/tcopy.1 @@ -101,11 +101,11 @@ otherwise be preserved in a tape-to-tape copy. EOD is determined by two sequential EOF marks with no data between. There are old systems which typically wrote three EOF's between tape files. -.Xr tcopy 1 +.Nm will erroneously stop copying early in this case. .It When using the copy/verify option \-c -.Xr tcopy 1 +.Nm does not rewind the tapes prior to start. A rewind is performed after writing prior to the verification stage. diff --git a/usr.bin/tip/tip/tip.1 b/usr.bin/tip/tip/tip.1 index e11e9b722ff1..1e35a39fec47 100644 --- a/usr.bin/tip/tip/tip.1 +++ b/usr.bin/tip/tip/tip.1 @@ -364,7 +364,7 @@ Racal-Vadic 831 (vadic) units is enabled by default. Support for Bizcomp 1031[fw] (biz31[fw]), Bizcomp 1022[fw] (biz22[fw]), DEC DF0[23]-AC (df0[23]), DEC DN-11 (dn11) and Racal-Vadic 3451 (v3451) units can be added by recompiling -.Xr tip 1 +.Nm with the appropriate defines. .Pp Note that if support for both the Racal-Vadic 831 and 3451 is enabled, diff --git a/usr.sbin/apm/apm.8 b/usr.sbin/apm/apm.8 index 38556d5b0c9d..733589b11fa5 100644 --- a/usr.sbin/apm/apm.8 +++ b/usr.sbin/apm/apm.8 @@ -138,9 +138,9 @@ or .Sh NOTES .Xr apmconf 8 has been merged in -.Xr apm 8 +.Nm and thus -.Xr apm 8 +.Nm replaces all of its functionality. .Sh SEE ALSO .Xr apm 4 diff --git a/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 b/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 index fc29039ce2e4..a364d1b641b6 100644 --- a/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 +++ b/usr.sbin/ctm/ctm_rmail/ctm_rmail.1 @@ -15,7 +15,7 @@ .Nm ctm_dequeue , .Nm ctm_rmail .Nd send and receive -.Nm ctm +.Xr ctm 1 deltas via mail .Sh SYNOPSIS .Nm ctm_smail diff --git a/usr.sbin/ntp/doc/ntpq.8 b/usr.sbin/ntp/doc/ntpq.8 index 28b8262a9087..44f9859bfde3 100644 --- a/usr.sbin/ntp/doc/ntpq.8 +++ b/usr.sbin/ntp/doc/ntpq.8 @@ -323,7 +323,7 @@ returned by the .Ic associations command is cached internally in -.Xr ntpq 8 . +.Nm . The index is then of use when dealing with stupid servers which use association identifiers which are hard for humans to type, in that for any subsequent commands which require an diff --git a/usr.sbin/rtsold/rtsold.8 b/usr.sbin/rtsold/rtsold.8 index abefea5a56c9..e72bb6a24a25 100644 --- a/usr.sbin/rtsold/rtsold.8 +++ b/usr.sbin/rtsold/rtsold.8 @@ -204,7 +204,7 @@ utility, which first appeared in WIDE/KAME IPv6 protocol stack kit. The .Nm rtsol utility is now integrated into -.Xr rtsold 8 . +.Nm . .\" .Sh BUGS In some operating systems, when a PCMCIA network card is removed diff --git a/usr.sbin/sicontrol/sicontrol.8 b/usr.sbin/sicontrol/sicontrol.8 index d2a85c62577a..569392267bbd 100644 --- a/usr.sbin/sicontrol/sicontrol.8 +++ b/usr.sbin/sicontrol/sicontrol.8 @@ -76,7 +76,7 @@ This is not much use outside of debugging the driver. .Bl -tag -width /dev/si_control -compact .It Pa /dev/si_control global driver control file for use by -.Xr sicontrol 8 +.Nm .It Pa /dev/ttyA* terminal control ports .It Pa /dev/ttyiA*