Fix various mdoc issues in various manual pages.
authorSascha Wildner <saw@online.de>
Sun, 29 Aug 2010 00:41:12 +0000 (02:41 +0200)
committerSascha Wildner <saw@online.de>
Sun, 29 Aug 2010 00:41:32 +0000 (02:41 +0200)
26 files changed:
games/piano/piano.6
lib/libc/gen/posix_spawn.3
lib/libc/sys/jail.2
lib/libc/sys/lwp_kill.2
lib/libc/sys/mmap.2
lib/libc/sys/tls.2
sbin/dhclient/dhcp-options.5
sbin/getdevpath/getdevpath.8
sbin/jscan/jscan.8
sbin/slattach/slattach.8
share/man/man4/atapicam.4
share/man/man4/joy.4
share/man/man4/lpt.4
share/man/man4/mmcsd.4
share/man/man4/pccard.4
share/man/man4/ppbus.4
share/man/man5/kernel.conf.5
share/man/man5/tmpfs.5
share/man/man7/tuning.7
share/man/man9/devstat.9
share/man/man9/lwbuf.9
share/man/man9/rman.9
usr.bin/ipcs/ipcs.1
usr.bin/vknet/vknet.1
usr.sbin/resident/resident.8
usr.sbin/vknetd/vknetd.8

index 48a5139..6ab0c0d 100644 (file)
@@ -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
index 670f555..74a610f 100644 (file)
@@ -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
index a74ca60..a42834f 100644 (file)
@@ -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
index 6394ea2..57f5027 100644 (file)
@@ -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
index 3660260..9c3b250 100644 (file)
@@ -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
index 1f6f265..59c893c 100644 (file)
@@ -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
index bfa7c04..cd8c5af 100644 (file)
@@ -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
index e0bb1d6..c7159e1 100644 (file)
@@ -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"
index d5d0e76..0568e2b 100644 (file)
@@ -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
index a5346d3..3ca94d1 100644 (file)
@@ -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
index 4f4f2e0..22f1f01 100644 (file)
@@ -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
index aa51f7e..b8ce9d7 100644 (file)
@@ -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"
index 1fba998..0a73691 100644 (file)
@@ -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
index 603326c..4531dd3 100644 (file)
@@ -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
index cb7ea6e..7039921 100644 (file)
@@ -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.
index ef36a1a..37b09b5 100644 (file)
@@ -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
index 78ecba3..0128455 100644 (file)
@@ -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
index f0e2ecc..338f1a0 100644 (file)
@@ -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.
index 9f8a7c9..c36eabc 100644 (file)
@@ -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 ,
index 777ad3a..b7df34e 100644 (file)
@@ -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
index 10136ee..a6c92d4 100644 (file)
@@ -33,7 +33,7 @@
 .\"
 .Dd March 17, 2010
 .Os
-.Dt lwbuf 9
+.Dt LWBUF 9
 .Sh NAME
 .Nm lwbuf_alloc ,
 .Nm lwbuf_free ,
index ef83537..3cdcb7c 100644 (file)
@@ -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
index 196f5d1..807d920 100644 (file)
@@ -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
index 302c043..e701d89 100644 (file)
@@ -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
index 696e489..d0e85e1 100644 (file)
@@ -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
index 11323ea..1945391 100644 (file)
@@ -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