Date: Wed, 9 May 2012 23:53:04 +0900 (JST) From: Nobuyuki Koganemaru <kogane@jp.freebsd.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/167734: gnroff mandoc style, usage mistakes or typos. (man3) Message-ID: <20120509145304.5D92528429@kcesx30.koganemaru.co.jp> Resent-Message-ID: <201205091500.q49F0RVO061802@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 167734
>Category: docs
>Synopsis: gnroff mandoc style, usage mistakes or typos. (man3)
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Wed May 09 15:00:27 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator: Nobuyuki Koganemaru
>Release: FreeBSD 10.0-CURRENT
>Organization:
KOGANEMARU Computer Engineering Service Corporation.
>Environment:
System: FreeBSD kcesx31.koganemaru.co.jp 8.2-RELEASE-p6 FreeBSD 8.2-RELEASE-p6 #0: Tue Apr 24 03:49:22 JST 2012 root@kcesx31.koganemaru.co.jp:/usr/obj/usr/src.82/sys/GENERIC i386
>Description:
man3
>How-To-Repeat:
none.
>Fix:
corrected files:
ATOMIC_VAR_INIT.3:
$FreeBSD: src/share/man/man3/ATOMIC_VAR_INIT.3,v 1.3 2012/01/05 21:36:12 uqs Exp $
acl_delete_entry.3:
$FreeBSD: src/lib/libc/posix1e/acl_delete_entry.3,v 1.9 2009/06/25 12:53:50 trasz Exp $
archive_read_open.3:
$FreeBSD: src/contrib/libarchive/libarchive/archive_read_open.3,v 1.1 2012/02/25 10:58:02 mm Exp $
archive_write_filter.3:
$FreeBSD: src/contrib/libarchive/libarchive/archive_write_filter.3,v 1.1 2012/02/25 10:58:02 mm Exp $
archive_write_open.3:
$FreeBSD: src/contrib/libarchive/libarchive/archive_write_open.3,v 1.1 2012/02/25 10:58:02 mm Exp $
archive_write_set_options.3:
$FreeBSD: src/contrib/libarchive/libarchive/archive_write_set_options.3,v 1.1 2012/02/25 10:58:02 mm Exp $
bluetooth.3:
$Id: bluetooth.3,v 1.5 2003/05/20 23:04:30 max Exp $
$FreeBSD: src/lib/libbluetooth/bluetooth.3,v 1.14 2012/03/29 05:02:12 eadler Exp $
cexp.3:
$FreeBSD: src/lib/msun/man/cexp.3,v 1.1 2011/03/07 03:09:24 das Exp $
complex.3:
$FreeBSD: src/lib/msun/man/complex.3,v 1.3 2011/10/17 05:41:03 das Exp $
duplocale.3:
$FreeBSD: src/lib/libc/locale/duplocale.3,v 1.4 2012/03/26 19:06:59 joel Exp $
elf_getarsym.3:
$FreeBSD: src/lib/libelf/elf_getarsym.3,v 1.3 2010/04/14 19:08:06 uqs Exp $
elf_getdata.3:
$FreeBSD: src/lib/libelf/elf_getdata.3,v 1.7 2012/03/29 05:02:12 eadler Exp $
elf_rand.3:
$FreeBSD: src/lib/libelf/elf_rand.3,v 1.4 2010/04/14 19:08:06 uqs Exp $
elf_strptr.3:
$FreeBSD: src/lib/libelf/elf_strptr.3,v 1.5 2010/08/03 17:40:09 joel Exp $
freelocale.3:
$FreeBSD: src/lib/libc/locale/freelocale.3,v 1.2 2011/12/02 11:55:09 obrien Exp $
gelf_getphdr.3:
$FreeBSD: src/lib/libelf/gelf_getphdr.3,v 1.5 2010/04/14 19:08:06 uqs Exp $
gelf_newehdr.3:
$FreeBSD: src/lib/libelf/gelf_newehdr.3,v 1.5 2010/04/14 19:08:06 uqs Exp $
getenv.3:
$FreeBSD: src/lib/libc/stdlib/getenv.3,v 1.29 2012/03/29 05:02:12 eadler Exp $
getopt_long.3:
$OpenBSD: getopt_long.3,v 1.10 2004/01/06 23:44:28 fgsch Exp $
$NetBSD: getopt_long.3,v 1.14 2003/08/07 16:43:40 agc Exp $
$FreeBSD: src/lib/libc/stdlib/getopt_long.3,v 1.15 2011/12/26 03:14:37 gjb Exp $
gpib.3:
$FreeBSD: src/lib/libgpib/gpib.3,v 1.4 2012/03/25 12:13:24 joel Exp $
kvm_getpcpu.3:
$FreeBSD: src/lib/libkvm/kvm_getpcpu.3,v 1.4 2010/03/12 10:01:06 uqs Exp $
libalias.3:
$FreeBSD: src/sys/netinet/libalias/libalias.3,v 1.62 2011/07/04 23:00:26 gjb Exp $
libarchive_internals.3:
$FreeBSD: src/contrib/libarchive/libarchive/libarchive_internals.3,v 1.3 2012/02/25 10:58:02 mm Exp $
libprocstat.3:
$FreeBSD: src/lib/libprocstat/libprocstat.3,v 1.3 2012/04/01 18:22:48 jhb Exp $
libradius.3:
$FreeBSD: src/lib/libradius/libradius.3,v 1.21 2012/02/12 18:29:56 ed Exp $
libtacplus.3:
$FreeBSD: src/lib/libtacplus/libtacplus.3,v 1.19 2012/03/29 05:02:12 eadler Exp $
libusb.3:
$FreeBSD: src/lib/libusb/libusb.3,v 1.26 2012/05/07 14:07:13 hselasky Exp $
libusb20.3:
$FreeBSD: src/lib/libusb/libusb20.3,v 1.14 2012/03/29 16:07:22 joel Exp $
newlocale.3:
$FreeBSD: src/lib/libc/locale/newlocale.3,v 1.6 2012/04/07 09:26:21 joel Exp $
pthread.3:
$FreeBSD: src/share/man/man3/pthread.3,v 1.34 2010/01/09 12:31:11 delphij Exp $
pthread_condattr.3:
$FreeBSD: src/share/man/man3/pthread_condattr.3,v 1.16 2010/05/09 14:21:34 jilles Exp $
publickey.3:
$FreeBSD: src/lib/libc/rpc/publickey.3,v 1.10 2010/12/28 10:08:50 uqs Exp $
querylocale.3:
$FreeBSD: src/lib/libc/locale/querylocale.3,v 1.2 2011/12/02 11:55:09 obrien Exp $
sctp_connectx.3:
$FreeBSD: src/lib/libc/net/sctp_connectx.3,v 1.8 2012/03/29 05:02:12 eadler Exp $
sctp_recvmsg.3:
$FreeBSD: src/lib/libc/net/sctp_recvmsg.3,v 1.11 2012/03/29 05:02:12 eadler Exp $
snmp_netgraph.3:
$FreeBSD: src/usr.sbin/bsnmpd/modules/snmp_netgraph/snmp_netgraph.3,v 1.14 2012/03/26 15:18:14 joel Exp $
snmp_usm.3:
$FreeBSD: src/contrib/bsnmp/snmp_usm/snmp_usm.3,v 1.3 2011/08/01 22:21:18 uqs Exp $
snmp_vacm.3:
$FreeBSD: src/contrib/bsnmp/snmp_vacm/snmp_vacm.3,v 1.1 2010/12/08 13:51:38 syrinx Exp $
snmp_wlan.3:
$FreeBSD: src/usr.sbin/bsnmpd/modules/snmp_wlan/snmp_wlan.3,v 1.6 2012/03/29 05:02:12 eadler Exp $
sourcefilter.3:
$FreeBSD: src/lib/libc/net/sourcefilter.3,v 1.3 2012/03/29 05:02:12 eadler Exp $
strfmon.3:
$FreeBSD: src/lib/libc/stdlib/strfmon.3,v 1.7 2003/01/06 06:21:25 tjr Exp $
strlcpy.3:
$OpenBSD: strlcpy.3,v 1.19 2007/05/31 19:19:32 jmc Exp $
$FreeBSD: src/lib/libc/string/strlcpy.3,v 1.16 2009/04/07 13:42:53 trasz Exp $
uselocale.3:
$FreeBSD: src/lib/libc/locale/uselocale.3,v 1.2 2011/12/02 11:55:09 obrien Exp $
xlocale.3:
$FreeBSD: src/lib/libc/locale/xlocale.3,v 1.4 2012/03/25 16:00:56 joel Exp $
patch files:
diff -u ATOMIC_VAR_INIT.3.orig ./ATOMIC_VAR_INIT.3
--- ATOMIC_VAR_INIT.3.orig 2012-05-09 04:02:57.000000000 +0900
+++ ./ATOMIC_VAR_INIT.3 2012-05-09 04:04:40.000000000 +0900
@@ -139,7 +139,7 @@
.Fa object
to its desired
.Fa value
-and returs the original contents of the atomic variable.
+and returns the original contents of the atomic variable.
.Pp
The
.Fn atomic_compare_exchange_strong
@@ -203,7 +203,7 @@
.Fn atomic_fetch_sub
macro subtracts the value
.Fa operand
-to atomic variable
+from atomic variable
.Fa object
and returns the original contents of the atomic variable.
.Pp
diff -u acl_delete_entry.3.orig ./acl_delete_entry.3
--- acl_delete_entry.3.orig 2012-05-09 04:06:43.000000000 +0900
+++ ./acl_delete_entry.3 2012-05-09 04:07:08.000000000 +0900
@@ -30,7 +30,7 @@
.Os
.Sh NAME
.Nm acl_delete_entry ,
-.Nm acl_delete_entry_np ,
+.Nm acl_delete_entry_np
.Nd delete an ACL entry from an ACL
.Sh LIBRARY
.Lb libc
diff -u archive_read_open.3.orig ./archive_read_open.3
--- archive_read_open.3.orig 2012-05-09 04:07:21.000000000 +0900
+++ ./archive_read_open.3 2012-05-09 04:08:04.000000000 +0900
@@ -186,7 +186,7 @@
zero.
If the skip callback is not provided (the
function pointer is
-.Dv NULL ),
+.Dv NULL ) ,
the library will invoke the read function
instead and simply discard the result.
A skip callback can provide significant
@@ -203,7 +203,7 @@
.Fn archive_set_error
to register an error code and message and
return
-.Cm ARCHIVE_FATAL.
+.Cm ARCHIVE_FATAL .
.\" .Sh EXAMPLE
.\"
.Sh RETURN VALUES
diff -u archive_write_filter.3.orig ./archive_write_filter.3
--- archive_write_filter.3.orig 2012-05-09 04:08:25.000000000 +0900
+++ ./archive_write_filter.3 2012-05-09 04:13:14.000000000 +0900
@@ -36,6 +36,7 @@
.Nm archive_write_add_filter_none ,
.Nm archive_write_add_filter_program ,
.Nm archive_write_add_filter_xz
+.Nd functions for writing streaming archives
.Sh SYNOPSIS
.In archive.h
.Ft int
diff -u archive_write_open.3.orig ./archive_write_open.3
--- archive_write_open.3.orig 2012-05-09 04:13:24.000000000 +0900
+++ ./archive_write_open.3 2012-05-09 04:13:48.000000000 +0900
@@ -188,7 +188,7 @@
.Fn archive_set_error
to register an error code and message and
return
-.Cm ARCHIVE_FATAL.
+.Cm ARCHIVE_FATAL .
.Pp
Note that if the client-provided write callback function
returns a non-zero value, that error will be propagated back to the caller
diff -u archive_write_set_options.3.orig ./archive_write_set_options.3
--- archive_write_set_options.3.orig 2012-05-09 04:14:02.000000000 +0900
+++ ./archive_write_set_options.3 2012-05-09 04:14:15.000000000 +0900
@@ -265,7 +265,7 @@
the default is
.Cm fd ,
otherwise the default is
-.Cm no-emulation.
+.Cm no-emulation .
.El
.It Format iso9660 - filename and size extensions
Various extensions to the base ISO9660 format.
diff -u bluetooth.3.orig ./bluetooth.3
--- bluetooth.3.orig 2012-05-09 04:14:28.000000000 +0900
+++ ./bluetooth.3 2012-05-09 04:14:40.000000000 +0900
@@ -494,7 +494,8 @@
.Xr bt_devopen 3 .
Filtering can be done on packet types, i.e.
.Dv ACL ,
-.Dv SCO or
+.Dv SCO
+or
.Dv HCI ,
command and event packets, and, in addition, on
.Dv HCI
diff -u cexp.3.orig ./cexp.3
--- cexp.3.orig 2012-05-09 04:14:49.000000000 +0900
+++ ./cexp.3 2012-05-09 04:15:17.000000000 +0900
@@ -48,7 +48,7 @@
.Fa z ,
also known as
.Em cis Ns ( Ns
-.Fa z Ns )
+.Fa z Ns ) .
.Sh RETURN VALUES
For real numbers
.Fa x
diff -u complex.3.orig ./complex.3
--- complex.3.orig 2012-05-09 04:15:59.000000000 +0900
+++ ./complex.3 2012-05-09 04:16:15.000000000 +0900
@@ -111,7 +111,7 @@
functions described here conform to
.St -isoC-99 .
.Sh BUGS
-The inverse trigonmetric and hyperbolic functions
+The inverse trigonometric and hyperbolic functions
.Fn cacos ,
.Fn cacosh ,
.Fn casin ,
diff -u duplocale.3.orig ./duplocale.3
--- duplocale.3.orig 2012-05-09 04:16:26.000000000 +0900
+++ ./duplocale.3 2012-05-09 05:31:39.000000000 +0900
@@ -47,7 +47,7 @@
that refers to the same locale values but has independent internal state.
Various functions, such as
.Xr mblen 3
-require presistent state.
+require persistent state.
These functions formerly used static variables and calls to them from multiple
threads had undefined behavior.
They now use fields in the
diff -u elf_getarsym.3.orig ./elf_getarsym.3
--- elf_getarsym.3.orig 2012-05-09 22:45:28.000000000 +0900
+++ ./elf_getarsym.3 2012-05-09 22:46:38.000000000 +0900
@@ -54,7 +54,7 @@
If the archive
.Ar elf
contains a symbol table with n entries, this function returns a
-pointer to an array of n+1
+pointer to an array of n+1'th
.Vt Elf_Arsym
structures.
An
diff -u elf_getdata.3.orig ./elf_getdata.3
--- elf_getdata.3.orig 2012-05-09 22:46:55.000000000 +0900
+++ ./elf_getdata.3 2012-05-09 22:47:04.000000000 +0900
@@ -144,7 +144,7 @@
.Dv ELF_T_BYTE .
.Ss Special handling of zero-sized and SHT_NOBITS sections
For sections of type
-.Dv SHT_NOBITS,
+.Dv SHT_NOBITS ,
and for zero-sized sections,
the functions
.Fn elf_getdata
diff -u elf_rand.3.orig ./elf_rand.3
--- elf_rand.3.orig 2012-05-09 22:48:42.000000000 +0900
+++ ./elf_rand.3 2012-05-09 22:51:55.000000000 +0900
@@ -28,7 +28,7 @@
.Os
.Sh NAME
.Nm elf_rand
-.Nd provide sequential access to the next archive member
+.Nd provide directly access to the archive member
.Sh LIBRARY
.Lb libelf
.Sh SYNOPSIS
diff -u elf_strptr.3.orig ./elf_strptr.3
--- elf_strptr.3.orig 2012-05-09 22:52:09.000000000 +0900
+++ ./elf_strptr.3 2012-05-09 22:52:35.000000000 +0900
@@ -64,7 +64,7 @@
.It Bq Er ELF_E_ARGUMENT
Argument
.Ar elf
-was NULL
+was NULL.
.It Bq Er ELF_E_ARGUMENT
Argument
.Ar elf
diff -u freelocale.3.orig ./freelocale.3
--- freelocale.3.orig 2012-05-09 22:52:53.000000000 +0900
+++ ./freelocale.3 2012-05-09 22:53:17.000000000 +0900
@@ -34,7 +34,7 @@
.Nd Frees a locale created with
.Xr duplocale 3
or
-.Xr newlocale 3 .
+.Xr newlocale 3
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
diff -u gelf_getphdr.3.orig ./gelf_getphdr.3
--- gelf_getphdr.3.orig 2012-05-09 22:53:29.000000000 +0900
+++ ./gelf_getphdr.3 2012-05-09 22:54:33.000000000 +0900
@@ -66,7 +66,7 @@
will retrieve the program header table entry at index
.Ar index
from ELF descriptor
-.Ar elf.
+.Ar elf .
The translated program header table entry will be written to the
address pointed to be argument
.Ar dst .
diff -u gelf_newehdr.3.orig ./gelf_newehdr.3
--- gelf_newehdr.3.orig 2012-05-09 22:54:44.000000000 +0900
+++ ./gelf_newehdr.3 2012-05-09 22:54:56.000000000 +0900
@@ -58,7 +58,8 @@
Function
.Fn elf64_newehdr
returns a pointer to a 64 bit
-.Vt Elf64_Ehdr structure.
+.Vt Elf64_Ehdr
+structure.
.Pp
When argument
.Ar elfclass
diff -u getenv.3.orig ./getenv.3
--- getenv.3.orig 2012-05-09 22:55:11.000000000 +0900
+++ ./getenv.3 2012-05-09 22:55:22.000000000 +0900
@@ -152,7 +152,8 @@
is a
.Dv NULL
pointer,
-.Fa string is without an
+.Fa string
+is without an
.Dq Li \&=
character or
.Dq Li \&=
diff -u getopt_long.3.orig ./getopt_long.3
--- getopt_long.3.orig 2012-05-09 22:55:44.000000000 +0900
+++ ./getopt_long.3 2012-05-09 22:56:50.000000000 +0900
@@ -472,7 +472,7 @@
.Fn getopt_long_only
functions first appeared in the
.Tn GNU
-libiberty library.
+library.
The first
.Bx
implementation of
diff -u gpib.3.orig ./gpib.3
--- gpib.3.orig 2012-05-09 22:57:45.000000000 +0900
+++ ./gpib.3 2012-05-09 22:58:26.000000000 +0900
@@ -666,7 +666,7 @@
.Pp
The function
.Fn ibwrtkey
-is obsolete, and not implemented
+is obsolete, and not implemented.
.Pp
The function
.Fn ibxtrc
diff -u kvm_getpcpu.3.orig ./kvm_getpcpu.3
--- kvm_getpcpu.3.orig 2012-05-09 22:59:37.000000000 +0900
+++ ./kvm_getpcpu.3 2012-05-09 22:59:56.000000000 +0900
@@ -114,7 +114,7 @@
On success, the
.Fn kvm_getpcpu
function returns a pointer to an allocated buffer or
-.Dv NULL.
+.Dv NULL .
If an error occurs,
it returns -1 instead.
.Pp
@@ -124,7 +124,7 @@
.Pp
If any function encounters an error,
then an error message may be retrieved via
-.Xr kvm_geterr 3.
+.Xr kvm_geterr 3 .
.Sh SEE ALSO
.Xr free 3 ,
.Xr kvm 3
diff -u libalias.3.orig ./libalias.3
--- libalias.3.orig 2012-05-09 23:00:09.000000000 +0900
+++ ./libalias.3 2012-05-09 23:01:14.000000000 +0900
@@ -919,7 +919,7 @@
.An Paolo Pisati Aq piso@FreeBSD.org
made the library modular, moving support for all
protocols (except for IP, TCP and UDP) to external modules.
-.Sh ACKNOWLEDGMENTS
+.Sh ACKNOWLEDGEMENTS
Listed below, in approximate chronological order, are individuals who
have provided valuable comments and/or debugging assistance.
.Bd -ragged -offset indent
@@ -1277,10 +1277,10 @@
.Ed
.Bl -inset
.It Va name
-is the name of the module
+is the name of the module.
.It Va handle
is a pointer to the module obtained through
-.Xr dlopen 3
+.Xr dlopen 3 .
.El
Whenever a module is loaded in userland, an entry is added to
.Va dll_chain ,
diff -u libarchive_internals.3.orig ./libarchive_internals.3
--- libarchive_internals.3.orig 2012-05-09 23:01:30.000000000 +0900
+++ ./libarchive_internals.3 2012-05-09 23:01:44.000000000 +0900
@@ -126,7 +126,7 @@
entire file to libarchive as a single block;
other clients may begin asynchronous I/O operations for the
next block on each request.
-.Ss Decompresssion Layer
+.Ss Decompression Layer
The decompression layer not only handles decompression,
it also buffers data so that the format handlers see a
much nicer I/O model.
diff -u libprocstat.3.orig ./libprocstat.3
--- libprocstat.3.orig 2012-05-09 23:06:26.000000000 +0900
+++ ./libprocstat.3 2012-05-09 23:06:37.000000000 +0900
@@ -203,7 +203,7 @@
.Fn procstat_get_socket_info
and
.Fn procstat_get_vnode_info
-functions are used to retrive information about pipes, pseudo-terminals,
+functions are used to retrieve information about pipes, pseudo-terminals,
shared memory objects,
sockets, and vnodes, respectively.
Each of them have a similar interface API.
diff -u libradius.3.orig ./libradius.3
--- libradius.3.orig 2012-05-09 23:06:45.000000000 +0900
+++ ./libradius.3 2012-05-09 23:07:22.000000000 +0900
@@ -108,8 +108,7 @@
network requests to remote servers.
.Ss Initialization
To use the library, an application must first call
-.Fn rad_auth_open
-,
+.Fn rad_auth_open ,
.Fn rad_acct_open
or
.Fn rad_server_open
@@ -119,8 +118,7 @@
The former function is used for RADIUS authentication and the
latter is used for RADIUS accounting.
Calls to
-.Fn rad_auth_open
-,
+.Fn rad_auth_open ,
.Fn rad_acct_open
and
.Fn rad_server_open
@@ -487,7 +485,7 @@
.Fn rad_create_response
and fill response content with same packet writing functions as for client.
When packet is ready, it should be sent with
-.Fn rad_send_response
+.Fn rad_send_response .
.Sh RETURN VALUES
The following functions return a non-negative value on success.
If
diff -u libtacplus.3.orig ./libtacplus.3
--- libtacplus.3.orig 2012-05-09 23:07:33.000000000 +0900
+++ ./libtacplus.3 2012-05-09 23:13:50.000000000 +0900
@@ -380,7 +380,7 @@
On failure,
.Fn tac_send_acct
returns \-1.
-Otherwise, it returns the TACACS+ status code
+Otherwise, it returns the TACACS+ status code.
Possible status codes, defined in
.In taclib.h ,
include:
diff -u libusb.3.orig ./libusb.3
--- libusb.3.orig 2012-05-09 23:15:07.000000000 +0900
+++ ./libusb.3 2012-05-09 23:16:59.000000000 +0900
@@ -100,12 +100,12 @@
.Ft uint8_t
.Fn libusb_get_bus_number "libusb_device *dev"
Returns the number of the bus contained by the device
-.Fa dev.
+.Fa dev .
.Pp
.Ft uint8_t
.Fn libusb_get_device_address "libusb_device *dev"
Returns the device_address contained by the device
-.Fa dev.
+.Fa dev .
.Pp
.Ft enum libusb_speed
.Fn libusb_get_device_speed "libusb_device *dev"
@@ -127,12 +127,12 @@
.Ft libusb_device *
.Fn libusb_ref_device "libusb_device *dev"
Increment the reference counter of the device
-.Fa dev.
+.Fa dev .
.Pp
.Ft void
.Fn libusb_unref_device "libusb_device *dev"
Decrement the reference counter of the device
-.Fa dev.
+.Fa dev .
.Pp
.Ft int
.Fn libusb_open "libusb_device *dev" "libusb_device_handle **devh"
@@ -147,7 +147,7 @@
A convenience function to open a device by vendor and product IDs
.Fa vid
and
-.Fa pid.
+.Fa pid .
Returns NULL on error.
.Pp
.Ft void
@@ -161,7 +161,7 @@
.Pp
.Ft int
.Fn libusb_get_configuration "libusb_device_handle *devh" "int *config"
-Returns the bConfiguration value of the current configuration.
+Returns the Configuration value of the current configuration.
Returns 0
on success, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected
and a LIBUSB_ERROR code on error.
@@ -171,7 +171,7 @@
Set the active configuration to
.Fa config
for the device contained by
-.Fa devh.
+.Fa devh .
This function returns 0 on success, LIBUSB_ERROR_NOT_FOUND if the requested
configuration does not exist, LIBUSB_ERROR_BUSY if the interfaces are currently
claimed, LIBUSB_ERROR_NO_DEVICE if the device has been disconnected and a
@@ -180,7 +180,7 @@
.Ft int
.Fn libusb_claim_interface "libusb_device_handle *devh" "int interface_number"
Claim an interface in a given libusb_handle
-.Fa devh.
+.Fa devh .
This is a non-blocking function.
It returns 0 on success, LIBUSB_ERROR_NOT_FOUND
if the requested interface does not exist, LIBUSB_ERROR_BUSY if a program or
@@ -279,7 +279,7 @@
.Ft int
.Fn libusb_get_device_descriptor "libusb_device *dev" "libusb_device_descriptor *desc"
Get the USB device descriptor for the device
-.Fa dev.
+.Fa dev .
This is a non-blocking function.
Returns 0 on success and a LIBUSB_ERROR code on
failure.
@@ -330,11 +330,11 @@
This function parses the USB 3.0 endpoint companion descriptor in host endian format pointed to by
.Fa buf
and having a length of
-.Fa len.
+.Fa len .
Typically these arguments are the extra and extra_length fields of the
endpoint descriptor.
On success the pointer to resulting descriptor is stored at the location given by
-.Fa ep_comp.
+.Fa ep_comp .
Returns zero on success and a LIBUSB_ERROR code on failure.
On success the parsed USB 3.0 endpoint companion descriptor must be
freed using the libusb_free_ss_endpoint_comp function.
@@ -348,9 +348,9 @@
This function parses a Binary Object Store, BOS, descriptor into host endian format pointed to by
.Fa buf
and having a length of
-.Fa len.
+.Fa len .
On success the pointer to resulting descriptor is stored at the location given by
-.Fa bos.
+.Fa bos .
Returns zero on success and a LIBUSB_ERROR code on failure.
On success the parsed BOS descriptor must be freed using the
libusb_free_bos_descriptor function.
diff -u libusb20.3.orig ./libusb20.3
--- libusb20.3.orig 2012-05-09 23:17:19.000000000 +0900
+++ ./libusb20.3 2012-05-09 23:19:45.000000000 +0900
@@ -331,7 +331,7 @@
.Pp
.
.Fn libusb20_tr_get_max_total_length
-function will return the maximum value for the data length sum of all USB
+will return the maximum value for the data length sum of all USB
frames associated with an USB transfer.
In case of control transfers the value returned does not include the
length of the SETUP packet, 8 bytes, which is part of frame zero.
@@ -815,7 +815,7 @@
.Pp
.
.Fn libusb20_dev_get_config_index
-This function returns the currently select config index for the given
+returns the currently select config index for the given
USB device.
.
.Pp
@@ -832,7 +832,7 @@
.Pp
.
.Fn libusb20_dev_wait_process
-function will wait until a pending USB transfer has completed on
+will wait until a pending USB transfer has completed on
the given USB device.
.
A timeout value can be specified which is passed on to the
@@ -866,7 +866,7 @@
.Pp
.
.Fn libusb20_be_get_dev_quirk
-This function will return the device quirk according to
+will return the device quirk according to
.Fa index
into the libusb20_quirk structure pointed to by
.Fa pq .
@@ -948,7 +948,7 @@
.Pp
.
.Fn libusb20_be_enqueue_device
-This function will enqueue the given USB device pointer in the backend USB device list.
+will enqueue the given USB device pointer in the backend USB device list.
.
Enqueued USB devices will get freed when the backend is freed.
.
diff -u newlocale.3.orig ./newlocale.3
--- newlocale.3.orig 2012-05-09 23:28:45.000000000 +0900
+++ ./newlocale.3 2012-05-09 23:32:10.000000000 +0900
@@ -51,7 +51,7 @@
The
.Fa mask
is either
-.Fa LC_ALL_MASK,
+.Fa LC_ALL_MASK ,
indicating all possible locale components,
or the logical OR of some combination of the following:
.Bl -tag -width "LC_MESSAGES_MASK" -offset indent
@@ -59,7 +59,7 @@
The locale for string collation routines.
This controls alphabetic ordering in
.Xr strcoll 3
- and
+and
.Xr strxfrm 3 .
.It LC_CTYPE_MASK
The locale for the
diff -u pthread.3.orig ./pthread.3
--- pthread.3.orig 2012-05-09 23:32:42.000000000 +0900
+++ ./pthread.3 2012-05-09 23:33:26.000000000 +0900
@@ -452,7 +452,7 @@
.Fa "void \*[lp]*child\*[rp]\*[lp]void\*[rp]"
.Fc
.Xc
-Register fork handlers
+Register fork handlers.
.It Xo
.Ft void
.Fn pthread_cleanup_pop "int execute"
diff -u pthread_condattr.3.orig ./pthread_condattr.3
--- pthread_condattr.3.orig 2012-05-09 23:33:38.000000000 +0900
+++ ./pthread_condattr.3 2012-05-09 23:33:58.000000000 +0900
@@ -35,7 +35,7 @@
.Nm pthread_condattr_getclock ,
.Nm pthread_condattr_setclock ,
.Nm pthread_condattr_getpshared ,
-.Nm pthread_condattr_setpshared ,
+.Nm pthread_condattr_setpshared
.Nd condition attribute operations
.Sh LIBRARY
.Lb libpthread
diff -u publickey.3.orig ./publickey.3
--- publickey.3.orig 2012-05-09 23:34:26.000000000 +0900
+++ ./publickey.3 2012-05-09 23:34:48.000000000 +0900
@@ -35,14 +35,14 @@
which is used to decrypt the encrypted secret key stored in the database.
Both routines return 1 if they are successful in finding the key, 0 otherwise.
The keys are returned as
-.Dv NULL Ns \-terminated ,
+.Dv NUL Ns \-terminated ,
hexadecimal strings.
If the password supplied to
.Fn getsecretkey
fails to decrypt the secret key, the routine will return 1 but the
.Fa secretkey
argument will be a
-.Dv NULL
+.Dv NUL
string
.Pq Dq .
.Sh SEE ALSO
diff -u querylocale.3.orig ./querylocale.3
--- querylocale.3.orig 2012-05-09 23:34:56.000000000 +0900
+++ ./querylocale.3 2012-05-09 23:37:09.000000000 +0900
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm querylocale
-.Nd Look up the locale name for a specified category.
+.Nd Look up the locale name for a specified category
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
@@ -41,7 +41,7 @@
.Fn querylocale "int mask" "locale_t locale"
.Sh DESCRIPTION
Returns the name of the locale for the category specified by
-.Fa mask.
+.Fa mask .
This possible values for the mask are the same as those in
.Xr newlocale 3 .
If more than one bit in the mask is set, the returned value is undefined.
diff -u sctp_connectx.3.orig ./sctp_connectx.3
--- sctp_connectx.3.orig 2012-05-09 23:38:47.000000000 +0900
+++ ./sctp_connectx.3 2012-05-09 23:39:10.000000000 +0900
@@ -36,7 +36,7 @@
.Os
.Sh NAME
.Nm sctp_connectx
-.Nd connect an SCTP socket with multiple destination addresses.
+.Nd connect an SCTP socket with multiple destination addresses
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
diff -u sctp_recvmsg.3.orig ./sctp_recvmsg.3
--- sctp_recvmsg.3.orig 2012-05-09 23:39:24.000000000 +0900
+++ ./sctp_recvmsg.3 2012-05-09 23:40:33.000000000 +0900
@@ -66,7 +66,7 @@
.Fn sctp_recvmsg
after having implicitly started an association via one
of the send calls including
-.Fn sctp_sendmsg
+.Fn sctp_sendmsg ,
.Fn sendto
and
.Fn sendmsg .
diff -u snmp_netgraph.3.orig ./snmp_netgraph.3
--- snmp_netgraph.3.orig 2012-05-09 23:43:38.000000000 +0900
+++ ./snmp_netgraph.3 2012-05-09 23:44:12.000000000 +0900
@@ -305,7 +305,7 @@
.Li NG_NODESIZ
bytes long.
The function returns the node id or 0 if the
-node is not found
+node is not found.
.Pp
The function
.Fn ng_node_type
@@ -396,7 +396,8 @@
.Fa peer .
The functions return 0 on success or -1 otherwise.
The function
-.Fn ng_connect2_tee_id does the same as
+.Fn ng_connect2_tee_id
+does the same as
.Fn ng_connect2_id
except, that it puts an unnamed tee node between the two nodes.
.Pp
diff -u snmp_usm.3.orig ./snmp_usm.3
--- snmp_usm.3.orig 2012-05-09 23:44:25.000000000 +0900
+++ ./snmp_usm.3 2012-05-09 23:45:10.000000000 +0900
@@ -57,7 +57,7 @@
altering the SNMP USM users.
.It Va usmUserTable
The table contains all SNMP USM users configured in
-.Nm bsnmpd.
+.Nm bsnmpd .
The table contains the following objects
.Bl -tag -width ".It Va usmUserEngineID"
.It Va usmUserEngineID
@@ -102,7 +102,7 @@
These columns may be used to change the user's privacy key.
.It Va usmUserPublic
An arbitrary octet string that may be modified to confirm a SET operation on any
-of the columns was successfull.
+of the columns was successful.
.It Va usmUserStorageType
This column always has either of two values. Entries created via
.Nm bsnmpd's
diff -u snmp_vacm.3.orig ./snmp_vacm.3
--- snmp_vacm.3.orig 2012-05-09 23:45:20.000000000 +0900
+++ ./snmp_vacm.3 2012-05-09 23:45:31.000000000 +0900
@@ -76,7 +76,7 @@
.It Va vacmViewTreeFamilyTable
The table contains a list of SNMP views, i.e. entries specifying the OID of a
MIB subtree and whether access to the objects under this subtree is to be
-allowed or forbiden.
+allowed or forbidden.
.El
.Sh FILES
.Bl -tag -width "XXXXXXXXX"
diff -u snmp_wlan.3.orig ./snmp_wlan.3
--- snmp_wlan.3.orig 2012-05-09 23:45:48.000000000 +0900
+++ ./snmp_wlan.3 2012-05-09 23:46:03.000000000 +0900
@@ -61,8 +61,8 @@
.Va wlanParentIfName
column. Any optional parameters may be set
via the
-.Va wlanIfaceOperatingMode,
-.Va wlanIfaceFlags,
+.Va wlanIfaceOperatingMode ,
+.Va wlanIfaceFlags ,
.Va wlanIfaceBssid
and
.Va wlanIfaceLocalAddress
diff -u sourcefilter.3.orig ./sourcefilter.3
--- sourcefilter.3.orig 2012-05-09 23:46:20.000000000 +0900
+++ ./sourcefilter.3 2012-05-09 23:47:25.000000000 +0900
@@ -158,7 +158,7 @@
.Fn getsourcefilter
and
.Fn setsourcefilter ,
-the argument
+the
.Fa grouplen
argument specifies the size of the structure pointed to by
.Fa group .
@@ -220,7 +220,7 @@
.Sh SEE ALSO
.Xr ip 4 ,
.Xr ip6 4 ,
-.Xr multicast 4,
+.Xr multicast 4 ,
.Xr ifmcstat 8
.Rs
.%A D. Thaler
diff -u strfmon.3.orig ./strfmon.3
--- strfmon.3.orig 2012-05-09 23:47:52.000000000 +0900
+++ ./strfmon.3 2012-05-09 23:48:04.000000000 +0900
@@ -115,14 +115,14 @@
.El
.Sh RETURN VALUES
If the total number of resulting bytes including the terminating
-.Dv NULL
+.Dv NUL
byte is not more than
.Fa maxsize ,
.Fn strfmon
returns the number of bytes placed into the array pointed to by
.Fa s ,
not including the terminating
-.Dv NULL
+.Dv NUL
byte.
Otherwise, \-1 is returned,
the contents of the array are indeterminate,
diff -u strlcpy.3.orig ./strlcpy.3
--- strlcpy.3.orig 2012-05-09 23:48:17.000000000 +0900
+++ ./strlcpy.3 2012-05-09 23:48:59.000000000 +0900
@@ -169,7 +169,7 @@
.Ed
.Pp
Since it is known how many characters were copied the first time, things
-can be sped up a bit by using a copy instead of an append
+can be sped up a bit by using a copy instead of an append.
.Bd -literal -offset indent
char *dir, *file, pname[MAXPATHLEN];
size_t n;
diff -u uselocale.3.orig ./uselocale.3
--- uselocale.3.orig 2012-05-09 23:49:06.000000000 +0900
+++ ./uselocale.3 2012-05-09 23:49:23.000000000 +0900
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm uselocale
-.Nd Sets a thread-local locale.
+.Nd Sets a thread-local locale
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
diff -u xlocale.3.orig ./xlocale.3
--- xlocale.3.orig 2012-05-09 23:49:30.000000000 +0900
+++ ./xlocale.3 2012-05-09 23:49:38.000000000 +0900
@@ -32,7 +32,7 @@
.Os
.Sh NAME
.Nm xlocale
-.Nd Thread-safe extended locale support.
+.Nd Thread-safe extended locale support
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120509145304.5D92528429>