From: Sascha Wildner <saw@online.de>
Date: Sun, 29 Aug 2010 00:41:12 +0000 (+0200)
Subject: Fix various mdoc issues in various manual pages.
X-Git-Tag: v2.9.0~366
X-Git-Url: https://gitweb.dragonflybsd.org/dragonfly.git/commitdiff_plain/4041d91945fc1e4ba1bb1065fd5f9915983f8605

Fix various mdoc issues in various manual pages.
---

diff --git a/games/piano/piano.6 b/games/piano/piano.6
index 48a5139bb3..6ab0c0dc6d 100644
--- a/games/piano/piano.6
+++ b/games/piano/piano.6
@@ -2,7 +2,7 @@
 .\" $DragonFly: src/games/piano/piano.6,v 1.2 2003/06/17 04:25:24 dillon Exp $
 .\"
 .Dd February 3, 1995
-.Dt "PIANO" 6
+.Dt PIANO 6
 .Os
 .Sh NAME
 .Nm piano
diff --git a/lib/libc/gen/posix_spawn.3 b/lib/libc/gen/posix_spawn.3
index 670f55522f..74a610f706 100644
--- a/lib/libc/gen/posix_spawn.3
+++ b/lib/libc/gen/posix_spawn.3
@@ -300,7 +300,9 @@ had been called to create a child process and then
 .Fn execve
 had been called by the child process to execute the new process image.
 .Pp
-The implementation uses vfork(), thus the fork handlers are not run when
+The implementation uses
+.Fn vfork ,
+thus the fork handlers are not run when
 .Fn posix_spawn
 or
 .Fn posix_spawnp
diff --git a/lib/libc/sys/jail.2 b/lib/libc/sys/jail.2
index a74ca60756..a42834f1e6 100644
--- a/lib/libc/sys/jail.2
+++ b/lib/libc/sys/jail.2
@@ -86,8 +86,10 @@ The program
 .Xr jls 8
 ca be used to identify all active jails.
 .Sh RETURN VALUES
-If successful, jail() returns a non-negative integer, termed the jail
-identifier (JID). It returns -1 on failure, and sets
+If successful,
+.Fn jail
+returns a non-negative integer, termed the jail identifier (JID).
+It returns -1 on failure, and sets
 .Va errno
 to indicate the error.
 .Sh ERRORS
diff --git a/lib/libc/sys/lwp_kill.2 b/lib/libc/sys/lwp_kill.2
index 6394ea2b1a..57f5027741 100644
--- a/lib/libc/sys/lwp_kill.2
+++ b/lib/libc/sys/lwp_kill.2
@@ -81,7 +81,7 @@ user id does not match the effective user-id of the receiving process.
 .Sh SEE ALSO
 .Xr kill 2 ,
 .Xr lwp_create 2 ,
-.Xr raise 3 ,
+.Xr raise 3
 .Sh HISTORY
 The
 .Fn lwp_kill
diff --git a/lib/libc/sys/mmap.2 b/lib/libc/sys/mmap.2
index 366026044f..9c3b250652 100644
--- a/lib/libc/sys/mmap.2
+++ b/lib/libc/sys/mmap.2
@@ -229,7 +229,8 @@ The bottom of the stack at maximum growth is the starting
 address returned by the call.
 .Pp
 The entire area is reserved from the point of view of other
-mmap() calls, even if not faulted in yet.
+.Fn mmap
+calls, even if not faulted in yet.
 .Pp
 WARNING.  We currently allow
 .Dv MAP_STACK
diff --git a/lib/libc/sys/tls.2 b/lib/libc/sys/tls.2
index 1f6f2656e6..59c893cd30 100644
--- a/lib/libc/sys/tls.2
+++ b/lib/libc/sys/tls.2
@@ -38,7 +38,7 @@
 .Sh NAME
 .Nm set_tls_area ,
 .Nm get_tls_area
-.Nd kernel TLS (thread local storage) support.
+.Nd kernel TLS (thread local storage) support
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
diff --git a/sbin/dhclient/dhcp-options.5 b/sbin/dhclient/dhcp-options.5
index bfa7c04a88..cd8c5af3ae 100644
--- a/sbin/dhclient/dhcp-options.5
+++ b/sbin/dhclient/dhcp-options.5
@@ -37,7 +37,7 @@
 .\" see ``http://www.isc.org/isc''.  To learn more about Vixie
 .\" Enterprises, see ``http://www.vix.com''.
 .\"
-.Dd $Mdocdate$
+.Dd August 30, 2008
 .Dt DHCP-OPTIONS 5
 .Os
 .Sh NAME
diff --git a/sbin/getdevpath/getdevpath.8 b/sbin/getdevpath/getdevpath.8
index e0bb1d6736..c7159e1150 100644
--- a/sbin/getdevpath/getdevpath.8
+++ b/sbin/getdevpath/getdevpath.8
@@ -33,7 +33,7 @@
 .\"
 .Dd July 10, 2009
 .Os
-.Dt getdevpath 8
+.Dt GETDEVPATH 8
 .Sh NAME
 .Nm getdevpath
 .Nd "translate device partial or label to device path"
diff --git a/sbin/jscan/jscan.8 b/sbin/jscan/jscan.8
index d5d0e76280..0568e2bea0 100644
--- a/sbin/jscan/jscan.8
+++ b/sbin/jscan/jscan.8
@@ -231,10 +231,14 @@ no longer need the data.
 .It Fl F
 Forces
 .Nm
-to fsync() after updating a journaling file prior to acknowledging the
+to
+.Fn fsync
+after updating a journaling file prior to acknowledging the
 data or updating a transaction-id-tracking file.  If specified twice,
 .Nm
-will also fsync() after updating the transaction-id-tracking file.
+will also
+.Fn fsync
+after updating the transaction-id-tracking file.
 .It Ar journal_prefix/file
 Specify the input to
 .Nm .
@@ -286,8 +290,9 @@ these conditions, if the input is a stream rather than a file
 .Nm
 will be forced to buffer meta-transactions (for mirroring) entirely in
 memory, which could present a serious problem since a single meta-transaction
-can exceed a gigabyte (e.g. if someone were to do a single write() system
-call writing a gigabyte all in one go).
+can exceed a gigabyte (e.g. if someone were to do a single
+.Fn write
+system call writing a gigabyte all in one go).
 .Sh SEE ALSO
 .Xr mountctl 8
 .Sh CAVEATS
diff --git a/sbin/slattach/slattach.8 b/sbin/slattach/slattach.8
index a5346d30a5..3ca94d1157 100644
--- a/sbin/slattach/slattach.8
+++ b/sbin/slattach/slattach.8
@@ -80,7 +80,9 @@ before
 .Nm
 exits.
 .It Fl f
-Disable the invocation of daemon() to run
+Disable the invocation of
+.Fn daemon
+to run
 .Nm
 in the background.
 .It Fl h
diff --git a/share/man/man4/atapicam.4 b/share/man/man4/atapicam.4
index 4f4f2e070d..22f1f01ede 100644
--- a/share/man/man4/atapicam.4
+++ b/share/man/man4/atapicam.4
@@ -103,7 +103,7 @@ Mount a CD-ROM from an ATAPI CD-ROM drive
 .Xr scsi 4 ,
 .Xr atacontrol 8 ,
 .Xr camcontrol 8
-.Xr natacontrol 8 ,
+.Xr natacontrol 8
 .Sh HISTORY
 The ATAPI/CAM driver first appeared in
 .Fx 4.8
diff --git a/share/man/man4/joy.4 b/share/man/man4/joy.4
index aa51f7e0b3..b8ce9d70ce 100644
--- a/share/man/man4/joy.4
+++ b/share/man/man4/joy.4
@@ -22,7 +22,8 @@ the PC joystick.
 .Pp
 This device may be opened by only one process at a time.
 .Pp
-The joystick status is read from a structure via a read()
+The joystick status is read from a structure via a
+.Fn read
 call.
 The structure is defined in the header file as follows:
 .Bd -literal -offset indent
@@ -41,7 +42,9 @@ perl -e 'open(JOY,"/dev/joy0")||die;while(1)
 {sysread(JOY,$x,16);@j=unpack("iiii",$x);print "@j\\n";sleep(1);}'
 .Ed
 .Ss ioctl calls
-Several ioctl() calls are also available.
+Several
+.Fn ioctl
+calls are also available.
 They take an argument of
 type int *
 .Bl -tag -width ".Dv JOY_SET_X_OFFSET"
diff --git a/share/man/man4/lpt.4 b/share/man/man4/lpt.4
index 1fba998985..0a73691f89 100644
--- a/share/man/man4/lpt.4
+++ b/share/man/man4/lpt.4
@@ -60,8 +60,9 @@ system.
 .Pp
 One purpose of this port was to allow parallel port sharing with other
 parallel devices.
-Secondly, inb()/outb() calls have been replaced by ppbus
-function calls.
+Secondly,
+.Fn inb / outb
+calls have been replaced by ppbus function calls.
 lpt is now arch-independent thanks to the ppbus interface.
 See
 .Xr ppbus 4
diff --git a/share/man/man4/mmcsd.4 b/share/man/man4/mmcsd.4
index 603326c703..4531dd3985 100644
--- a/share/man/man4/mmcsd.4
+++ b/share/man/man4/mmcsd.4
@@ -29,7 +29,7 @@
 .Os
 .Sh NAME
 .Nm mmcsd
-.Nd MMC and SD memory card driver.
+.Nd MMC and SD memory card driver
 .Sh SYNOPSIS
 .Cd device mmcsd
 .Sh DESCRIPTION
diff --git a/share/man/man4/pccard.4 b/share/man/man4/pccard.4
index cb7ea6ebd4..7039921614 100644
--- a/share/man/man4/pccard.4
+++ b/share/man/man4/pccard.4
@@ -52,7 +52,7 @@ more verbose.
 .Sh SEE ALSO
 .Xr cardbus 4 ,
 .\" .Xr mecia 4 ,
-.Xr pccbb 4 ,
+.Xr pccbb 4
 .\" .Xr tcic 4
 .Sh BUGS
 There is no way cause a program to run when a card is inserted.
diff --git a/share/man/man4/ppbus.4 b/share/man/man4/ppbus.4
index ef36a1aca5..37b09b55eb 100644
--- a/share/man/man4/ppbus.4
+++ b/share/man/man4/ppbus.4
@@ -98,8 +98,11 @@ functions to initialize the ppbus system.
 The logical parallel port model chosen for the ppbus system is the PC's
 parallel port model.
 Consequently, for the i386 implementation of ppbus,
-most of the services provided by ppc are macros for inb()
-and outb() calls.
+most of the services provided by ppc are macros for
+.Fn inb
+and
+.Fn outb
+calls.
 But, for an other architecture, accesses to one of our logical
 registers (data, status, control...) may require more than one I/O access.
 .Ss Description
diff --git a/share/man/man5/kernel.conf.5 b/share/man/man5/kernel.conf.5
index 78ecba3f59..01284557f2 100644
--- a/share/man/man5/kernel.conf.5
+++ b/share/man/man5/kernel.conf.5
@@ -89,7 +89,7 @@ End the configuration file.
 .Xr loader.conf 5
 .Xr boot 8 ,
 .Xr kget 8 ,
-.Xr loader 8 ,
+.Xr loader 8
 .Sh HISTORY
 The
 .Nm
diff --git a/share/man/man5/tmpfs.5 b/share/man/man5/tmpfs.5
index f0e2ecce37..338f1a0cbd 100644
--- a/share/man/man5/tmpfs.5
+++ b/share/man/man5/tmpfs.5
@@ -72,8 +72,9 @@ implementation,
 .Nm
 filesystems are backed by swap space.
 Only memory pressure will cause data to be backed to swap.
-Normal filesystem operations such as fsync(), buffer cache flushing,
-and vnode recycling have no effect.
+Normal filesystem operations such as
+.Fn fsync ,
+buffer cache flushing, and vnode recycling have no effect.
 .Pp
 .Nm
 stores meta-data in wired kernel memory.
diff --git a/share/man/man7/tuning.7 b/share/man/man7/tuning.7
index 9f8a7c90ec..c36eabc48e 100644
--- a/share/man/man7/tuning.7
+++ b/share/man/man7/tuning.7
@@ -557,8 +557,10 @@ The
 .Va net.inet.ip.portrange.*
 sysctls control the port number ranges automatically bound to TCP and UDP
 sockets.  There are three ranges:  A low range, a default range, and a
-high range, selectable via an IP_PORTRANGE setsockopt() call.  Most
-network programs use the default range which is controlled by
+high range, selectable via an IP_PORTRANGE
+.Fn setsockopt
+call.
+Most network programs use the default range which is controlled by
 .Va net.inet.ip.portrange.first
 and
 .Va net.inet.ip.portrange.last ,
diff --git a/share/man/man9/devstat.9 b/share/man/man9/devstat.9
index 777ad3a912..b7df34e5f2 100644
--- a/share/man/man9/devstat.9
+++ b/share/man/man9/devstat.9
@@ -156,7 +156,8 @@ is a wrapper for
 .Fn devstat_end_transaction
 which pulls all the information from a
 .Va "struct buf"
-which is ready for biodone().
+which is ready for
+.Fn biodone .
 .Pp
 The
 .Va devstat
diff --git a/share/man/man9/lwbuf.9 b/share/man/man9/lwbuf.9
index 10136eee96..a6c92d4817 100644
--- a/share/man/man9/lwbuf.9
+++ b/share/man/man9/lwbuf.9
@@ -33,7 +33,7 @@
 .\"
 .Dd March 17, 2010
 .Os
-.Dt lwbuf 9
+.Dt LWBUF 9
 .Sh NAME
 .Nm lwbuf_alloc ,
 .Nm lwbuf_free ,
diff --git a/share/man/man9/rman.9 b/share/man/man9/rman.9
index ef83537c08..3cdcb7ca2a 100644
--- a/share/man/man9/rman.9
+++ b/share/man/man9/rman.9
@@ -342,8 +342,8 @@ function returns a pointer to the device which reserved the resource
 .Fa r .
 .Sh SEE ALSO
 .\".Xr bus_activate_resource 9 ,
-.Xr bus_alloc_resource 9
-.Xr bus_release_resource 9 ,
+.Xr bus_alloc_resource 9 ,
+.Xr bus_release_resource 9
 .\".Xr bus_set_resource 9 ,
 .Sh AUTHORS
 .An -nosplit
diff --git a/usr.bin/ipcs/ipcs.1 b/usr.bin/ipcs/ipcs.1
index 196f5d1aaa..807d9206e2 100644
--- a/usr.bin/ipcs/ipcs.1
+++ b/usr.bin/ipcs/ipcs.1
@@ -31,7 +31,7 @@
 .\" $DragonFly: src/usr.bin/ipcs/ipcs.1,v 1.7 2008/09/02 11:50:45 matthias Exp $
 .\"
 .Dd September 2, 2008
-.Dt "IPCS" 1
+.Dt IPCS 1
 .Os
 .Sh NAME
 .Nm ipcs
diff --git a/usr.bin/vknet/vknet.1 b/usr.bin/vknet/vknet.1
index 302c043a3b..e701d8910f 100644
--- a/usr.bin/vknet/vknet.1
+++ b/usr.bin/vknet/vknet.1
@@ -34,7 +34,7 @@
 .\" $DragonFly: src/usr.bin/vknet/vknet.1,v 1.4 2008/07/21 23:42:23 swildner Exp $
 .\"
 .Dd May 27, 2008
-.Dt vknet 1
+.Dt VKNET 1
 .Os
 .Sh NAME
 .Nm vknet
diff --git a/usr.sbin/resident/resident.8 b/usr.sbin/resident/resident.8
index 696e4896f4..d0e85e1965 100644
--- a/usr.sbin/resident/resident.8
+++ b/usr.sbin/resident/resident.8
@@ -5,7 +5,7 @@
 .Os
 .Sh NAME
 .Nm resident
-.Nd Make a dynamic binary resident.
+.Nd Make a dynamic binary resident
 .Sh SYNOPSIS
 .Nm
 .Op Fl l
diff --git a/usr.sbin/vknetd/vknetd.8 b/usr.sbin/vknetd/vknetd.8
index 11323ead0e..19453913f0 100644
--- a/usr.sbin/vknetd/vknetd.8
+++ b/usr.sbin/vknetd/vknetd.8
@@ -34,7 +34,7 @@
 .\" $DragonFly: src/usr.sbin/vknetd/vknetd.8,v 1.3 2008/05/31 12:04:15 swildner Exp $
 .\"
 .Dd May 21, 2009
-.Dt vknetd 8
+.Dt VKNETD 8
 .Os
 .Sh NAME
 .Nm vknetd