From 7ba324e6190a712035af60edc21a9afb1b033342 Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Sat, 7 Apr 2007 19:29:52 +0000 Subject: [PATCH] Fix various forms of .Pa abuse/mistakes. --- lib/libc/gen/arc4random.3 | 8 +++--- lib/libc/net/inet6_option_space.3 | 4 +-- lib/libvgl/vgl.3 | 4 +-- libexec/revnetgroup/revnetgroup.8 | 4 +-- share/man/man4/ccd.4 | 4 +-- share/man/man5/group.5 | 5 ++-- share/man/man9/MD5.9 | 6 ++--- share/man/man9/buf.9 | 5 ++-- share/man/man9/copy.9 | 38 ++++++++++++++-------------- share/man/man9/device_get_children.9 | 4 +-- share/man/man9/fetch.9 | 8 +++--- share/man/man9/store.9 | 8 +++--- share/man/man9/sysctl_add_oid.9 | 6 ++--- usr.sbin/moused/moused.8 | 4 +-- 14 files changed, 55 insertions(+), 53 deletions(-) diff --git a/lib/libc/gen/arc4random.3 b/lib/libc/gen/arc4random.3 index b612fd06fb..d5fbd70e6d 100644 --- a/lib/libc/gen/arc4random.3 +++ b/lib/libc/gen/arc4random.3 @@ -29,7 +29,7 @@ .\" .\" Manual page, using -mandoc macros .\" $FreeBSD: src/lib/libc/gen/arc4random.3,v 1.8.2.5 2003/05/06 21:40:19 trhodes Exp $ -.\" $DragonFly: src/lib/libc/gen/arc4random.3,v 1.4 2007/04/06 06:46:28 swildner Exp $ +.\" $DragonFly: src/lib/libc/gen/arc4random.3,v 1.5 2007/04/07 19:29:51 swildner Exp $ .\" .Dd April 15, 1997 .Dt ARC4RANDOM 3 @@ -94,12 +94,12 @@ functions using .Xr random 3 , .Xr srandomdev 3 .Sh HISTORY -.Pa RC4 +.Tn RC4 has been designed by RSA Data Security, Inc. It was posted anonymously to the USENET and was confirmed to be equivalent by several sources who had access to the original cipher. Since -.Pa RC4 +.Tn RC4 used to be a trade secret, the cipher is now referred to as -.Pa ARC4 . +.Tn ARC4 . diff --git a/lib/libc/net/inet6_option_space.3 b/lib/libc/net/inet6_option_space.3 index 9b5c790efb..4ad669595c 100644 --- a/lib/libc/net/inet6_option_space.3 +++ b/lib/libc/net/inet6_option_space.3 @@ -1,6 +1,6 @@ .\" $KAME: inet6_option_space.3,v 1.11 2005/01/05 03:00:44 itojun Exp $ .\" $FreeBSD: src/lib/libc/net/inet6_option_space.3,v 1.16 2005/01/23 16:02:48 gnn Exp $ -.\" $DragonFly: src/lib/libc/net/inet6_option_space.3,v 1.5 2006/02/17 19:35:06 swildner Exp $ +.\" $DragonFly: src/lib/libc/net/inet6_option_space.3,v 1.6 2007/04/07 19:29:51 swildner Exp $ .\" .\" Copyright (C) 2004 WIDE Project. .\" All rights reserved. @@ -370,7 +370,7 @@ The argument is handled exactly as in the .Fn inet6_option_next function described above. -.Pa +.Pp The .Fn inet6_option_find function starts searching for an option of the specified type diff --git a/lib/libvgl/vgl.3 b/lib/libvgl/vgl.3 index c04e577baf..fa0fb87f78 100644 --- a/lib/libvgl/vgl.3 +++ b/lib/libvgl/vgl.3 @@ -25,7 +25,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD: src/lib/libvgl/vgl.3,v 1.12.2.8 2001/12/17 10:08:35 ru Exp $ -.\" $DragonFly: src/lib/libvgl/vgl.3,v 1.5 2006/10/20 19:11:25 swildner Exp $ +.\" $DragonFly: src/lib/libvgl/vgl.3,v 1.6 2007/04/07 19:29:51 swildner Exp $ .Dd November 7, 1999 .Dt VGL 3 .Os @@ -169,7 +169,7 @@ the system to switch screens. .Pp .Fn VGLTextSetFontFile instruct the char/string functions to use the font in file -.Pa filename +.Fa filename instead of the builtin font. .Pp .Fn VGLKeyboardInit diff --git a/libexec/revnetgroup/revnetgroup.8 b/libexec/revnetgroup/revnetgroup.8 index 667a70b97e..210304fa5a 100644 --- a/libexec/revnetgroup/revnetgroup.8 +++ b/libexec/revnetgroup/revnetgroup.8 @@ -29,7 +29,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/libexec/revnetgroup/revnetgroup.8,v 1.7.2.4 2002/08/15 18:53:16 schweikh Exp $ -.\" $DragonFly: src/libexec/revnetgroup/revnetgroup.8,v 1.2 2003/06/17 04:27:07 dillon Exp $ +.\" $DragonFly: src/libexec/revnetgroup/revnetgroup.8,v 1.3 2007/04/07 19:29:52 swildner Exp $ .\" .Dd October 24, 1995 .Dt REVNETGROUP 8 @@ -49,7 +49,7 @@ processes the contents of a file in .Xr netgroup 5 format into what is called -.Pa reverse netgroup +.Dq reverse netgroup form. That is, where the original file shows netgroup memberships in terms of which members reside in a particular group, the reverse netgroup format specifies what groups are associated diff --git a/share/man/man4/ccd.4 b/share/man/man4/ccd.4 index c8ec1df7c5..bfa3ba045c 100644 --- a/share/man/man4/ccd.4 +++ b/share/man/man4/ccd.4 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/ccd.4,v 1.11.2.8 2001/12/17 11:30:11 ru Exp $ -.\" $DragonFly: src/share/man/man4/ccd.4,v 1.5 2007/02/19 11:10:11 swildner Exp $ +.\" $DragonFly: src/share/man/man4/ccd.4,v 1.6 2007/04/07 19:29:52 swildner Exp $ .\" .Dd August 9, 1995 .Dt CCD 4 @@ -56,7 +56,7 @@ configuration file, and how to partition disks. Note that the .Sq raw partitions of the disks -.Pa should not +.Em should not be combined. The kernel will only allow component partitions of type FS_BSDFFS (type .Dq Bx 4.2 diff --git a/share/man/man5/group.5 b/share/man/man5/group.5 index 128d916adf..fe386b25e9 100644 --- a/share/man/man5/group.5 +++ b/share/man/man5/group.5 @@ -31,7 +31,7 @@ .\" .\" From: @(#)group.5 8.3 (Berkeley) 4/19/94 .\" $FreeBSD: src/share/man/man5/group.5,v 1.15.2.4 2002/02/01 15:51:18 ru Exp $ -.\" $DragonFly: src/share/man/man5/group.5,v 1.5 2006/05/26 19:39:40 swildner Exp $ +.\" $DragonFly: src/share/man/man5/group.5,v 1.6 2007/04/07 19:29:52 swildner Exp $ .\" .Dd September 29, 1994 .Dt GROUP 5 @@ -92,7 +92,8 @@ A user is automatically in a group if that group was specified in their .Pa /etc/passwd entry and does not need to be added to that group in the -.Pa /etc/group file. +.Pa /etc/group +file. .\" .Pp .\" When the system reads the file .\" .Pa /etc/group diff --git a/share/man/man9/MD5.9 b/share/man/man9/MD5.9 index 72355e4b64..20fc97f515 100644 --- a/share/man/man9/MD5.9 +++ b/share/man/man9/MD5.9 @@ -29,7 +29,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/MD5.9,v 1.5.2.3 2001/12/17 11:30:18 ru Exp $ -.\" $DragonFly: src/share/man/man9/MD5.9,v 1.2 2003/06/17 04:37:01 dillon Exp $ +.\" $DragonFly: src/share/man/man9/MD5.9,v 1.3 2007/04/07 19:29:52 swildner Exp $ .\" .Dd April 17, 1996 .Dt MD5 9 @@ -53,7 +53,7 @@ module implements the RSA Data Security, Inc. MD5 Message-Digest Algorithm (MD5). It produces 128-bit MD5 Digest of data. .Pp .Bl -hang -width MD5Transformxxx -.It Pa MD5Init +.It Fn MD5Init must be called just before .Fn MD5Transform will be used to produce a digest. @@ -63,7 +63,7 @@ argument is the storage for the digest being produced on subsequent calls to the .Fn MD5Transform routine. -.It Pa MD5Transform +.It Fn MD5Transform is the core of the MD5 algorithm, this alters an existing MD5 hash kept in .Fa buf diff --git a/share/man/man9/buf.9 b/share/man/man9/buf.9 index b28411ff57..ed28c8c6fd 100644 --- a/share/man/man9/buf.9 +++ b/share/man/man9/buf.9 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/buf.9,v 1.5.2.5 2001/12/17 11:30:18 ru Exp $ -.\" $DragonFly: src/share/man/man9/buf.9,v 1.4 2006/03/26 22:56:57 swildner Exp $ +.\" $DragonFly: src/share/man/man9/buf.9,v 1.5 2007/04/07 19:29:52 swildner Exp $ .\" .Dd December 21, 2004 .Dt BUF 9 @@ -47,7 +47,8 @@ It also supports a relatively primitive byte-granular valid range and dirty range currently hardcoded for use by NFS. .Pp The code implementing the VM Buffer abstraction is mostly concentrated in -.Pa /usr/src/sys/kern/vfs_bio.c and +.Pa /usr/src/sys/kern/vfs_bio.c +and .Pa /usr/src/sys/sys/buf.h . .Pp One of the most important things to remember when dealing with buffer pointers diff --git a/share/man/man9/copy.9 b/share/man/man9/copy.9 index 99bdc858af..51fcb9f0ee 100644 --- a/share/man/man9/copy.9 +++ b/share/man/man9/copy.9 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/copy.9,v 1.6.2.5 2001/12/17 11:30:18 ru Exp $ -.\" $DragonFly: src/share/man/man9/copy.9,v 1.2 2003/06/17 04:37:01 dillon Exp $ +.\" $DragonFly: src/share/man/man9/copy.9,v 1.3 2007/04/07 19:29:52 swildner Exp $ .\" .Dd January 7, 1996 .Dt COPY 9 @@ -72,47 +72,47 @@ routines provide the following functionality: .Bl -tag -width "copyoutstr()" .It Fn copyin Copies -.Pa len +.Fa len bytes of data from the user-space address -.Pa uaddr +.Fa uaddr to the kernel-space address -.Pa kaddr . +.Fa kaddr . .It Fn copyout Copies -.Pa len +.Fa len bytes of data from the kernel-space address -.Pa kaddr +.Fa kaddr to the user-space address -.Pa uaddr . +.Fa uaddr . .It Fn copystr Copies a NUL-terminated string, at most -.Pa len +.Fa len bytes long, from kernel-space address -.Pa kfaddr +.Fa kfaddr to kernel-space address -.Pa kdaddr . +.Fa kdaddr . The number of bytes actually copied, including the terminating NUL, is returned in -.Pa *done . +.Fa *done . .It Fn copyinstr Copies a NUL-terminated string, at most -.Pa len +.Fa len bytes long, from user-space address -.Pa uaddr +.Fa uaddr to kernel-space address -.Pa kaddr . +.Fa kaddr . The number of bytes actually copied, including the terminating NUL, is returned in -.Pa *done . +.Fa *done . .\" .It Fn copyoutstr .\" Copies a NUL-terminated string, at most .\" bytes long, from kernel-space address -.\" .Pa kaddr +.\" .Fa kaddr .\" to user-space address -.\" .Pa uaddr . +.\" .Fa uaddr . .\" The number of bytes actually copied, including the terminating .\" NUL, is returned in -.\" .Pa *done . +.\" .Fa *done . .El .Sh RETURN VALUES The @@ -130,7 +130,7 @@ and functions return .Er ENAMETOOLONG if the string is longer than -.Pa len +.Fa len bytes. .Sh SEE ALSO .Xr fetch 9 , diff --git a/share/man/man9/device_get_children.9 b/share/man/man9/device_get_children.9 index 83aaba9098..08311c610a 100644 --- a/share/man/man9/device_get_children.9 +++ b/share/man/man9/device_get_children.9 @@ -25,7 +25,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/device_get_children.9,v 1.1.2.3 2001/12/17 11:30:18 ru Exp $ -.\" $DragonFly: src/share/man/man9/device_get_children.9,v 1.4 2006/10/19 19:00:47 swildner Exp $ +.\" $DragonFly: src/share/man/man9/device_get_children.9,v 1.5 2007/04/07 19:29:52 swildner Exp $ .\" .Dd December 1, 1999 .Dt DEVICE_GET_CHILDREN 9 @@ -40,7 +40,7 @@ .Fn device_get_children "device_t dev" "device_t **devlistp" "int *devcountp" .Sh DESCRIPTION Retrieve a list of all device instances currently connected to -.Pa dev +.Fa dev and return the list in .Fa *devlistp and the count in diff --git a/share/man/man9/fetch.9 b/share/man/man9/fetch.9 index c21ada7018..bae7959626 100644 --- a/share/man/man9/fetch.9 +++ b/share/man/man9/fetch.9 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/fetch.9,v 1.6.2.4 2001/12/17 11:30:18 ru Exp $ -.\" $DragonFly: src/share/man/man9/fetch.9,v 1.3 2007/02/10 20:46:36 swildner Exp $ +.\" $DragonFly: src/share/man/man9/fetch.9,v 1.4 2007/04/07 19:29:52 swildner Exp $ .\" .Dd January 7, 1996 .Dt FETCH 9 @@ -66,13 +66,13 @@ routines provide the following functionality: .Bl -tag -width ".Fn fusword" .It Fn fubyte Fetches a byte of data from the user-space address -.Pa base . +.Fa base . .It Fn fusword Fetches a short word of data from the user-space address -.Pa base . +.Fa base . .It Fn fuword Fetches a word of data from the user-space address -.Pa base . +.Fa base . .El .Sh RETURN VALUES The diff --git a/share/man/man9/store.9 b/share/man/man9/store.9 index 2563d01eb1..918aa24f74 100644 --- a/share/man/man9/store.9 +++ b/share/man/man9/store.9 @@ -33,7 +33,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/store.9,v 1.7.2.4 2001/12/17 11:30:19 ru Exp $ -.\" $DragonFly: src/share/man/man9/store.9,v 1.3 2007/02/10 20:46:36 swildner Exp $ +.\" $DragonFly: src/share/man/man9/store.9,v 1.4 2007/04/07 19:29:52 swildner Exp $ .\" .Dd January 7, 1996 .Dt STORE 9 @@ -66,13 +66,13 @@ routines provide the following functionality: .Bl -tag -width ".Fn susword" .It Fn subyte Stores a byte of data to the user-space address -.Pa base . +.Fa base . .It Fn susword Stores a short word of data to the user-space address -.Pa base . +.Fa base . .It Fn suword Stores a word of data to the user-space address -.Pa base . +.Fa base . .El .Sh RETURN VALUES The diff --git a/share/man/man9/sysctl_add_oid.9 b/share/man/man9/sysctl_add_oid.9 index e25656be3e..d82029a159 100644 --- a/share/man/man9/sysctl_add_oid.9 +++ b/share/man/man9/sysctl_add_oid.9 @@ -26,7 +26,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man9/sysctl_add_oid.9,v 1.3.2.10 2001/12/17 11:30:19 ru Exp $ -.\" $DragonFly: src/share/man/man9/sysctl_add_oid.9,v 1.6 2007/03/23 15:54:34 swildner Exp $ +.\" $DragonFly: src/share/man/man9/sysctl_add_oid.9,v 1.7 2007/04/07 19:29:52 swildner Exp $ .\" .Dd June 22, 2006 .Dt SYSCTL_ADD_OID 9 @@ -384,7 +384,7 @@ deletion of many oids later. .It Fa recurse If non-zero, attempt to remove the node and all its children. If -.Pa recurse +.Fa recurse is set to 0, any attempt to remove a node that contains any children will result in a @@ -468,7 +468,7 @@ to provide proper hints to the utility. .It Fn SYSCTL_ADD_PROC creates an oid with the specified -.Pa handler +.Fa handler function. The handler is responsible for handling read and write requests to the oid. diff --git a/usr.sbin/moused/moused.8 b/usr.sbin/moused/moused.8 index df0e314056..684b267d17 100644 --- a/usr.sbin/moused/moused.8 +++ b/usr.sbin/moused/moused.8 @@ -29,7 +29,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/usr.sbin/moused/moused.8,v 1.27.2.11 2003/04/28 08:34:04 brueffer Exp $ -.\" $DragonFly: src/usr.sbin/moused/moused.8,v 1.5 2006/04/17 18:01:38 swildner Exp $ +.\" $DragonFly: src/usr.sbin/moused/moused.8,v 1.6 2007/04/07 19:29:52 swildner Exp $ .\" .Dd April 1, 2000 .Dt MOUSED 8 @@ -427,7 +427,7 @@ You can attach multiple USB mice to your system or to your USB hub. They are accessible as .Pa /dev/ums0 , /dev/ums1 , and so on. -.Pa +.Pp You may want to create a symbolic link .Pa /dev/mouse pointing to the real port to which the mouse is connected, so that you -- 2.41.0