Assorted markup fixes and minor wordsmithing.

Approved by:	re

share/man/man4/acpi.4

@@ -237,7 +237,11 @@ Supports system cooling and heat management.
 Implements a timecounter using the ACPI fixed-frequency timer.
 .It Li video
 .Pq Vt device
-Supports acpi_video which may conflict with agp device.
+Supports
+.Xr acpi_video 4
+which may conflict with
+.Xr agp 4
+device.
 .El
 .Pp
 It is also possible to avoid portions of the ACPI namespace which

share/man/man4/cpufreq.4

@@ -62,7 +62,7 @@ interface of all possible levels.
 Users can access this interface directly via
 .Xr sysctl 8
 or by indicating to
-.Pa power_profile
+.Pa /etc/rc.d/power_profile
 that it should switch settings when the AC line state changes via
 .Xr rc.conf 5 .
 .Sh SYSCTLS
@@ -106,7 +106,7 @@ Intel Enhanced SpeedStep
 .It Pa ichss
 Intel SpeedStep for ICH
 .It Pa powernow
-AMD PowerNow! for K7 and K8
+AMD PowerNow!\& for K7 and K8
 .It Pa smist
 Intel SMI-based SpeedStep for PIIX4
 .El

share/man/man4/ed.4

@@ -30,7 +30,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 9, 2005
+.Dd February 23, 2005
 .Dt ED 4
 .Os
 .Sh NAME

share/man/man4/geom.4

@@ -338,28 +338,28 @@ sysctl.
 All of these flags are off by default, and great care should be taken in
 turning them on.
 .Bl -tag -width FAIL
-.It 0x01 (G_T_TOPOLOGY)
+.It 0x01 Pq Dv G_T_TOPOLOGY
 Provide tracing of topology change events.
-.It 0x02 (G_T_BIO)
+.It 0x02 Pq Dv G_T_BIO
 Provide tracing of buffer I/O requests.
-.It 0x04 (G_T_ACCESS)
+.It 0x04 Pq Dv G_T_ACCESS
 Provide tracing of access check controls.
 .It 0x08 (unused)
 .It 0x10 (allow foot shooting)
 Allow writing to Rank 1 providers.
 This would, for example, allow the super-user to overwrite the MBR on the root
-disk or write random sectors elsewhere to a mounted disk.  The implications
+disk or write random sectors elsewhere to a mounted disk.
-are obvious.
+The implications are obvious.
-.It 0x20 (G_T_DETAILS)
+.It 0x20 Pq Dv G_T_DETAILS
 This appears to be unused at this time.
-.It 0x40 (G_F_DISKIOCTL)
+.It 0x40 Pq Dv G_F_DISKIOCTL
 This appears to be unused at this time.
-.It 0x80 (G_F_CTLDUMP)
+.It 0x80 Pq Dv G_F_CTLDUMP
 Dump contents of gctl requests.
 .El
 .Sh HISTORY
 This software was developed for the FreeBSD Project by Poul-Henning Kamp
-and NAI Labs, the Security Research Division of Network Associates, Inc.
+and NAI Labs, the Security Research Division of Network Associates, Inc.\&
 under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
 DARPA CHATS research program.
 .Pp

share/man/man4/icmp6.4

@@ -196,24 +196,32 @@ is modified to allow all message types.
 Ignore all incoming messages.
 .Va filterp
 is modified to ignore all message types.
-.It Fn "void ICMP6_FILTER_SETPASS" "int type" \
+.It Xo
-    "struct icmp6_filter *filterp"
+.Ft void
+.Fn ICMP6_FILTER_SETPASS "int type" "struct icmp6_filter *filterp"
+.Xc
 Allow ICMPv6 messages with the given
 .Fa type .
 .Va filterp
 is modified to allow such messages.
-.It Fn "void ICMP6_FILTER_SETBLOCK" "int type" \
+.It Xo
-    "struct icmp6_filter *filterp"
+.Ft void
+.Fn ICMP6_FILTER_SETBLOCK" "int type" "struct icmp6_filter *filterp"
+.Xc
 Ignore ICMPv6 messages with the given
 .Fa type .
 .Va filterp
 is modified to ignore such messages.
-.It Fn "int ICMP6_FILTER_WILLPASS" "int type" \
+.It Xo
-    "const struct icmp6_filter *filterp"
+.Ft int
+.Fn ICMP6_FILTER_WILLPASS" "int type" "const struct icmp6_filter *filterp"
+.Xc
 Determine if the given filter will allow an ICMPv6 message of the given
 type.
-.It Fn "int ICMP6_FILTER_WILLBLOCK" "int type" \
+.It Xo
-    "const struct icmp6_filter *filterp"
+.Ft int
+.Fn ICMP6_FILTER_WILLBLOCK" "int type" "const struct icmp6_filter *filterp"
+.Xc
 Determine if the given filter will ignore an ICMPv6 message of the given
 type.
 .El

share/man/man4/ng_netflow.4

@@ -243,10 +243,10 @@ we do not use tee, but send packets back to ether node.
 SEQ
 .Ed
 .Sh SEE ALSO
-.Xr flowctl 8 ,
 .Xr netgraph 4 ,
 .Xr ng_ksocket 4 ,
 .Xr ng_tee 4 ,
+.Xr flowctl 8 ,
 .Xr ngctl 8
 .Pp
 .Pa http://www.cisco.com/warp/public/cc/pd/iosw/ioft/neflct/tech/napps_wp.htm

share/man/man4/ng_source.4

@@ -69,27 +69,29 @@ When
 hook is connected,
 .Nm
 node assumes that its neighbour node is of
-.Xr ng_ether
+.Xr ng_ether 4
 node type.
-The neighbor is queried for its interface name.
+The neighbour is queried for its interface name.
+The
 .Nm
 node then uses queue of the interface for its evil purposes.
+The
 .Nm
 node also disables
 .Va autosrc
 option on neighbour
-.Xr ng_ether
+.Xr ng_ether 4
 node.
-If interface name can't be obtained automatically, it should
+If interface name cannot be obtained automatically, it should
-be configured explicitly with help of
+be configured explicitly with the
 .Dv NGM_SOURCE_SETIFACE
 control message, and
 .Va autosrc
 should be turned off on
-.Xr ng_ether
+.Xr ng_ether 4
 node manually.
 .Pp
-Once interface is configured, upon receival of
+Once interface is configured, upon receipt of a
 .Dv NGM_SOURCE_START
 control message the node starts sending
 the previously queued packets out the
@@ -100,8 +102,10 @@ While active, on every clock tick the node checks the available space
 in the interface queue and sends that many packets out its
 .Va output
 hook.
-Once the number of packets indicated in the start message have been
+Once the number of packets indicated in the start message has been
-sent, or upon reception of a stop message, the node stops sending data.
+sent, or upon receipt of a
+.Dv NGM_SOURCE_STOP
+message, the node stops sending data.
 .Sh CONTROL MESSAGES
 This node type supports the generic control messages as well as the following,
 which must be sent with the
@@ -113,19 +117,19 @@ Returns a structure containing the following fields:
 .Bl -tag -width indent
 .It Va outOctets
 The number of octets/bytes sent out the
-.Dv output
+.Va output
 hook.
 .It Va outFrames
 The number of frames/packets sent out the
-.Dv output
+.Va output
 hook.
 .It Va queueOctets
 The number of octets queued from the
-.Dv input
+.Va input
 hook.
 .It Va queueFrames
 The number of frames queued from the
-.Dv input
+.Va input
 hook.
 .It Va startTime
 The time the last start message was received.
@@ -155,23 +159,27 @@ This message requires a single
 .Vt uint64_t
 parameter which is the number of packets to
 send before stopping.
-Node starts sending the queued packets out the output hook.
+Node starts sending the queued packets out the
-The output hook must be connected and node must have
+.Va output
+hook.
+The
+.Va output
+hook must be connected and node must have
 interface configured.
 .It Dv NGM_SOURCE_STOP Pq Ic stop
 Stops the node if it is active.
 .It Dv NGM_SOURCE_CLR_DATA Pq Ic clrdata
 Clears the packets queued from the
-.Dv input
+.Va input
 hook.
 .It Dv NGM_SOURCE_SETIFACE Pq Ic setiface
-This message requires a string argument - name of the interface
+This message requires the name of the interface
-to be configured.
+to be configured as an argument.
 .El
 .Sh SHUTDOWN
 This node shuts down upon receipt of a
 .Dv NGM_SHUTDOWN
-control message, when all hooks has been disconnected, or when the
+control message, when all hooks have been disconnected, or when the
 .Va output
 hook has been disconnected.
 .Sh EXAMPLES
@@ -186,11 +194,11 @@ For example, these commands
 load the
 .Nm ng_ether
 module and attach the
-.Dv output
+.Va output
 hook of a new
 .Nm source
 node to
-.Dv orphans
+.Va orphans
 hook of the
 .Li bge0:
 .Nm ng_ether
@@ -218,7 +226,7 @@ can be used to generate these packets:
 To feed the output of the above TCL script to the
 .Nm source
 node's
-.Dv input
+.Va input
 hook via
 .Xr nghook 8 :
 .Pp
@@ -232,7 +240,7 @@ Args:   { queueOctets=64 queueFrames=1 }
 .Ed
 .Pp
 Send as many packets as required out the
-.Dv output
+.Va output
 hook:
 .Pp
 .Dl "ngctl msg bge0:orphans start 16"

share/man/man4/snd_emu10k1.4

@@ -38,7 +38,7 @@ The
 .Nm
 bridge driver allows the generic audio driver
 .Xr sound 4
-to attach to the SoundBlaster Live! and Audigy audio cards.
+to attach to the SoundBlaster Live!\& and Audigy audio cards.
 .Pp
 Digital output is supported by default.
 .Sh HARDWARE
@@ -48,7 +48,7 @@ driver supports the following sound cards:
 .Pp
 .Bl -bullet -compact
 .It
-Creative SoundBlaster Live! (EMU10K1 Chipset)
+Creative SoundBlaster Live!\& (EMU10K1 Chipset)
 .It
 Creative SoundBlaster Audigy (EMU10K2 Chipset)
 .El

share/man/man4/snd_maestro3.4

@@ -65,7 +65,7 @@ ESS Technology Maestro3
 .El
 .Sh DIAGNOSTICS
 The hardware volume control buttons can be connected to two different pin
-sets(GPIO or GD) on the chip, depending on the manufacturer.
+sets (GPIO or GD) on the chip, depending on the manufacturer.
 The driver has no way of determining this configuration, so a hint may be
 used to override the default guess.
 The default setting for hardware volume control assumes that GD pins

share/man/man4/unix.4

@@ -94,10 +94,14 @@ can be calculated by the macro
 defined in
 .In sys/un.h .
 The
-.Ar sun_path
+.Va sun_path
-field must be terminated by a NUL character to be used with
+field must be terminated by a
+.Dv NUL
+character to be used with
 .Fn SUN_LEN ,
-but the terminating NUL is
+but the terminating
+.Dv NUL
+is
 .Em not
 part of the address.
 .Pp
@@ -195,7 +199,6 @@ or
 .Xr listen 2 )
 under different effective credentials.
 .Pp
-
 .Tn UNIX
 domain sockets support a number of socket options which can be set with
 .Xr setsockopt 2
@@ -207,13 +210,21 @@ This option may be enabled on a
 .Dv SOCK_DGRAM
 or a
 .Dv SOCK_STREAM
-socket.  This option provides a mechanism for the receiver to
+socket.
+This option provides a mechanism for the receiver to
 receive the credentials of the process as a
 .Xr recvmsg 2
-control message.  The msg_control field in the msghdr structure points
+control message.
-to a buffer that contains a cmsghdr structure followed by a variable
+The
-length sockcred structure, defined in
+.Va msg_control
-.Pa \*[Lt]sys/socket.h\*[Gt]
+field in the
+.Vt msghdr
+structure points to a buffer that contains a
+.Vt cmsghdr
+structure followed by a variable length
+.Vt sockcred
+structure, defined in
+.In sys/socket.h
 as follows:
 .Bd -literal
 struct sockcred {
@@ -228,9 +239,13 @@ struct sockcred {
 .Pp
 The
 .Fn SOCKCREDSIZE
-macro computes the size of the sockcred structure for a specified number
+macro computes the size of the
+.Vt sockcred
+structure for a specified number
 of groups.
-The cmsghdr fields have the following values:
+The
+.Vt cmsghdr
+fields have the following values:
 .Bd -literal
 cmsg_len = sizeof(struct cmsghdr) + SOCKCREDSIZE(ngroups)
 cmsg_level = SOL_SOCKET
@@ -244,6 +259,7 @@ sockets, this option causes the
 function to block until
 .Xr accept 2
 has been called on the listening socket.
+.El
 .Sh SEE ALSO
 .Xr socket 2 ,
 .Xr intro 4

share/man/man4/witness.4

@@ -93,9 +93,10 @@ set via the read-only sysctl
 .Pp
 The sysctl
 .Va debug.witness.watch
-specifies the level of witness involvment in the system.  A value of
+specifies the level of witness involvment in the system.
-1 specifies that witness is enabled.  A value of 0 specifies that
+A value of 1 specifies that witness is enabled.
-witness is disabled.  This sysctl can be written to in order to
+A value of 0 specifies that witness is disabled.
+This sysctl can be written to in order to
 disable witness, however it may not be used to enable witness.
 .Va debug.witness.watch
 can be set via

share/man/man5/autofs.5

@@ -40,8 +40,8 @@ The auto file system, or
 provides a method to dynamically graft mountpoints into the file system
 namespace.
 .Sh SEE ALSO
+.Xr libautofs 3 ,
 .Xr mount_autofs 8
-.Xr libautofs 3
 .Sh HISTORY
 The
 .Nm

share/man/man5/elf.5

@@ -832,7 +832,7 @@ fixed-size entries.
 Various sections hold program and control information:
 .Bl -tag -width ".shstrtab" -compact
 .It .bss
-Block Started by Symbol -
+(Block Started by Symbol)
 This section holds uninitialized data that contributes to the program's
 memory image.
 By definition, the system initializes the data with zeros

share/man/man7/release.7

@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 6, 2004
+.Dd May 17, 2005
 .Dt RELEASE 7
 .Os
 .Sh NAME
@@ -166,12 +166,12 @@ staging directory.
 Sets up a suitable area for FTP installations in
 .Pa ${CHROOTDIR}/R/ftp .
 .It Cm cdrom.1
-Create the layout for the live filesystem CD-ROM image in
+Create the layout for the live file system CD-ROM image in
 .Pa ${CHROOTDIR}/R/cdrom .
 .It Cm cdrom.2
 Create the layout for the first and second CD-ROM images.
 .It Cm cdrom.3
-Create the layout for the boot only CD-ROM image and the boot only UFS
+Create the layout for the boot-only CD-ROM image and the boot-only UFS
 miniroot image.
 .It Cm iso.1
 Builds ISO images (installation and
@@ -373,7 +373,7 @@ of the CVS tree
 (a
 .Dq "-CURRENT snapshot" ) .
 .It Va SEPARATE_LIVEFS
-Store the live filesystem on its own CD-ROM image rather than placing it on
+Store the live file system on its own CD-ROM image rather than placing it on
 the first disc.
 .It Va TARGET_ARCH
 The target machine processor architecture.

share/man/man9/MUTEX_PROFILING.9

@@ -186,5 +186,4 @@ due to extra locking that occurs when
 .Dv INVARIANTS
 is present; likewise, using it in combination with
 .Dv WITNESS
-with
 will lead to much higher lock hold times and contention in profiling output.

share/man/man9/VFS_SYNC.9

@@ -71,7 +71,7 @@ The
 .Fn VFS_SYNC
 macro calls the
 .Va vfs_sync
-method of the filesystem, which normally calls
+method of the file system, which normally calls
 .Xr VOP_FSYNC 9
 for all the vnodes in the file system.
 .Sh SEE ALSO

share/man/man9/VFS_VGET.9

@@ -48,20 +48,20 @@ looks up or creates a vnode from a (mount, inode#) tupple.
 Its arguments are:
 .Bl -tag -width ".Fa flags"
 .It Fa mp
-The mountpoint.
+The mount point.
 .It Fa ino
 The inode representing the file.
-This is a unique number assigned by the filesystem when vnodes are first
+This is a unique number assigned by the file system when vnodes are first
 created.
 .It Fa flags
 Additional locking flags to pass through to
-.Xr vget 9
+.Xr vget 9 .
 .It Fa vpp
 Return parameter for the vnode.
 .El
 .Pp
 This is an optional file system entry-point for file systems mainly
-intended for NFS server use, but many filesystems
+intended for NFS server use, but many file systems
 use it internally in
 .Xr VOP_LOOKUP 9
 and similar.
@@ -69,7 +69,11 @@ and similar.
 If the file system does not support this call, then it should return
 .Er EOPNOTSUPP .
 .Pp
-Please see sys/ufs/ffs/ffs_vfsops.c::ffs_vget() for the canonical example.
+Please see
+.Fn ffs_vget
+in
+.Pa sys/ufs/ffs/ffs_vfsops.c
+for the canonical example.
 .Sh SEE ALSO
 .Xr VFS 9 ,
 .Xr vget 9 ,

share/man/man9/VOP_GETPAGES.9

@@ -108,7 +108,7 @@ in addition to calling
 .Xr vm_page_undirty 9 .
 .It Dv VM_PAGER_BAD
 The page was entirely beyond the end of the backing file.
-This condition should not be possible if the vnode's filesystem
+This condition should not be possible if the vnode's file system
 is correctly implemented.
 .It Dv VM_PAGER_ERROR
 The page could not be written because of an error on the underlying storage

share/man/man9/bus_dma.9

@@ -563,8 +563,8 @@ DMA tag.
 .It Fn bus_dmamap_load_mbuf_sg "dmat" "map" "mbuf" "segs" "nsegs" "flags"
 This is just like
 .Fn bus_dmamap_load_mbuf
-except that it returns immediately without calling a callback function.  It is
+except that it returns immediately without calling a callback function.
-provided for efficiency.
+It is provided for efficiency.
 The scatter/gather segment array
 .Va segs
 is provided by the caller and filled in directly by the function.

share/man/man9/device_find_child.9

@@ -48,11 +48,11 @@ and
 .Fa unit .
 If
 .Fa unit
-is -1, it returns the first child of
+is \-1, it returns the first child of
-.Dv dev
+.Fa dev
 with a matching
 .Fa classname
-(that is, the one with the lowest unit.)
+(that is, the one with the lowest unit).
 .Sh RETURN VALUES
 If it exists, the child device is returned, otherwise NULL.
 .Sh SEE ALSO

share/man/man9/ifnet.9

@@ -28,7 +28,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 8, 2004
+.Dd June 10, 2005
 .Os
 .Dt IFNET 9
 .Sh NAME
@@ -1004,8 +1004,8 @@ A reference count of requests for this particular membership.
 .Ss Interface Manipulation Functions
 .Bl -ohang -offset indent
 .It Fn if_alloc
-Allocate and initialize an
+Allocate and initialize
-.Fa ifp .
+.Vt "struct ifnet" .
 Initalization includes the allocation of an interface index and may
 include the allocation of a
 .Fa type

share/man/man9/kthread.9

@@ -263,8 +263,8 @@ flag was specified in the
 parameter.
 .El
 .Sh SEE ALSO
-.Xr exit1 9 ,
 .Xr rfork 2 ,
+.Xr exit1 9 ,
 .Xr SYSINIT 9 ,
 .Xr wakeup 9
 .Sh HISTORY

share/man/man9/ktr.9

@@ -110,7 +110,7 @@ the console in addition to the event buffer.
 This example demonstrates the use of tracepoints at the
 .Dv KTR_PROC
 logging level.
-.Bd -literal -compact
+.Bd -literal
 void
 mi_switch()
 {

share/man/man9/mbuf.9

@@ -627,7 +627,7 @@ bytes into the mbuf.
 The
 .Fa dstoff
 argument aligns the data and leaves room for a link layer header.
-Return the new
+Returns the new
 .Vt mbuf chain
 on success,
 and frees the

share/man/man9/rman.9

@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 12, 2003
+.Dd March 15, 2005
 .Dt RMAN 9
 .Os
 .Sh NAME
@@ -194,8 +194,8 @@ The
 .Fa end
 argument is the highest acceptable ending value of the resource.
 Therefore,
-.Fa start + count - 1
+.Fa start No + Fa count No \- 1
-must be <=
+must be \[<=]
 .Fa end
 for any allocation to happen.
 The default behavior is to allocate an exclusive segment, unless the

share/man/man9/time.9

@@ -88,14 +88,14 @@ variable may be read and written without special precautions.
 .Xr clock_settime 2 ,
 .Xr ntp_adjtime 2 ,
 .Xr settimeofday 2 ,
+.Xr bintime 9 ,
+.Xr binuptime 9 ,
 .Xr getbintime 9 ,
 .Xr getbinuptime 9 ,
 .Xr getmicrotime 9 ,
 .Xr getmicrouptime 9 ,
 .Xr getnanotime 9 ,
 .Xr getnanouptime 9 ,
-.Xr bintime 9 ,
-.Xr binuptime 9 ,
 .Xr microtime 9 ,
 .Xr microuptime 9 ,
 .Xr nanotime 9 ,

share/man/man9/timeout.9

@@ -218,7 +218,7 @@ function returns.
 The following
 .Fa flags
 may be specified:
-.Bl -tag -width CALLOUT_RETURNUNLOCKED
+.Bl -tag -width ".Dv CALLOUT_RETURNUNLOCKED"
 .It Dv CALLOUT_RETURNUNLOCKED
 The callout function will release
 .Fa mtx

share/man/man9/vfs_suser.9

@@ -41,7 +41,7 @@
 The
 .Fn vfs_suser
 function checks if the credentials given include superuser powers
-for the given mountpoint.
+for the given mount point.
 It will check to see if the thread
 passed in has the same credentials as the user that mounted the
 file system.