mdoc(7) police: Deal with self-xrefs.

This commit is contained in:
ru 2002-12-24 13:41:48 +00:00
parent a59d939300
commit 4979ab8d81
47 changed files with 85 additions and 83 deletions

View File

@ -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

View File

@ -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 ,

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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,

View File

@ -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:

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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/<port>/),

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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 .

View File

@ -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 .

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ,

View File

@ -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 ,

View File

@ -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

View File

@ -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.)

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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,

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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*