General mdoc(7) and typo fixes.

PR:		167734
Submitted by:	Nobuyuki Koganemaru (kogane!jp.freebsd.org)
MFC after:	3 days
This commit is contained in:
Glen Barber 2012-05-11 20:06:46 +00:00
parent 8a3beec66e
commit a3fb6da9ba
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=235286
36 changed files with 71 additions and 69 deletions

View file

@ -57,7 +57,7 @@ An advisory lock used to coordinate several Command Generator Applications when
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 @@ module
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

View file

@ -76,7 +76,7 @@ objects under the subtree in the relevant view.
.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"

View file

@ -494,7 +494,8 @@ previously obtained with
.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

View file

@ -44,10 +44,10 @@ Duplicates an existing
.Fa locale_t
returning a new
.Fa locale_t
that refers to the same locale values but has independent internal state.
that refers to the same locale values but has an independent internal state.
Various functions, such as
.Xr mblen 3
require presistent state.
require a persistent state.
These functions formerly used static variables and calls to them from multiple
threads had undefined behavior.
They now use fields in the

View file

@ -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

View file

@ -51,7 +51,7 @@ Any other components will be inherited from
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 @@ or the logical OR of some combination of the following:
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

View file

@ -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.

View file

@ -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

View file

@ -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

View file

@ -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

View file

@ -66,7 +66,7 @@ For a one-to-many (SOCK_SEQPACKET) type socket, an endpoint may call
.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 .

View file

@ -158,7 +158,7 @@ For the protocol-independent functions
.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 @@ operation.
.Sh SEE ALSO
.Xr ip 4 ,
.Xr ip6 4 ,
.Xr multicast 4,
.Xr multicast 4 ,
.Xr ifmcstat 8
.Rs
.%A D. Thaler

View file

@ -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

View file

@ -35,14 +35,14 @@ has an extra argument,
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

View file

@ -152,7 +152,8 @@ failed because
is a
.Dv NULL
pointer,
.Fa string is without an
.Fa string
is without an
.Dq Li \&=
character or
.Dq Li \&=

View file

@ -115,14 +115,14 @@ character is written.
.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,

View file

@ -169,7 +169,7 @@ if (strlcat(pname, file, sizeof(pname)) >= sizeof(pname))
.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;

View file

@ -144,7 +144,7 @@ structures of type
.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

View file

@ -64,7 +64,7 @@ encountered.
.It Bq Er ELF_E_ARGUMENT
Argument
.Ar elf
was NULL
was NULL.
.It Bq Er ELF_E_ARGUMENT
Argument
.Ar elf

View file

@ -66,7 +66,7 @@ Function
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 .

View file

@ -58,7 +58,8 @@ structure.
Function
.Fn elf64_newehdr
returns a pointer to a 64 bit
.Vt Elf64_Ehdr structure.
.Vt Elf64_Ehdr
structure.
.Pp
When argument
.Ar elfclass

View file

@ -666,7 +666,7 @@ and sends its contents to the device.
.Pp
The function
.Fn ibwrtkey
is obsolete, and not implemented
is obsolete, and not implemented.
.Pp
The function
.Fn ibxtrc

View file

@ -114,7 +114,7 @@ it returns -1 instead.
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 @@ call returns 0; if an error occurs, it returns -1 instead.
.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

View file

@ -203,7 +203,7 @@ The
.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.

View file

@ -108,8 +108,7 @@ allows clients to perform authentication and accounting by means of
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 @@ which provides the context for subsequent operations.
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 @@ To respond to the request you should call
.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

View file

@ -380,7 +380,7 @@ the request, and waits for a reply.
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:

View file

@ -100,12 +100,12 @@ counter decremented once.
.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 @@ LIBUSB_ERROR_OTHERS on other failure.
.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 @@ disconnected and a LIBUSB_ERROR code on other errors.
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 @@ Returns NULL on error.
.Pp
.Ft int
.Fn libusb_get_configuration "libusb_device_handle *devh" "int *config"
Returns the bConfiguration value of the current configuration.
Returns the 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 @@ and a LIBUSB_ERROR code on error.
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 @@ LIBUSB_ERROR code on failure.
.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 @@ LIBUSB_ERROR code on failure.
.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 @@ on success and a LIBUSB_ERROR code on failure.
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 is NULL safe and frees a parsed USB 3.0 endpoint companion descrip
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.

View file

@ -331,7 +331,7 @@ packets are avoided for proxy buffers.
.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 @@ returns the current speed of the given USB device.
.Pp
.
.Fn libusb20_dev_get_config_index
This function returns the currently select config index for the given
returns the currently selected config index for the given
USB device.
.
.Pp
@ -832,7 +832,7 @@ will set the debug level for the given USB device.
.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 @@ returned.
.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 @@ Dequeued USB devices will not be freed when the backend is freed.
.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.
.

View file

@ -48,7 +48,7 @@ functions compute the complex exponential of
.Fa z ,
also known as
.Em cis Ns ( Ns
.Fa z Ns )
.Fa z Ns ) .
.Sh RETURN VALUES
For real numbers
.Fa x

View file

@ -111,7 +111,7 @@ The
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 ,

View file

@ -139,7 +139,7 @@ It sets the atomic variable
.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 @@ The
.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

View file

@ -452,7 +452,7 @@ Set the thread-specific value for the specified key.
.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"

View file

@ -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

View file

@ -919,7 +919,7 @@ added support for PPTP and LSNAT as well as general hacking.
.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 @@ struct dll {
.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 ,

View file

@ -305,7 +305,7 @@ This buffer should be at least
.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 @@ of the node with id
.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

View file

@ -61,8 +61,8 @@ via
.Va wlanParentIfName
column. Any optional parameters may be set
via the
.Va wlanIfaceOperatingMode,
.Va wlanIfaceFlags,
.Va wlanIfaceOperatingMode ,
.Va wlanIfaceFlags ,
.Va wlanIfaceBssid
and
.Va wlanIfaceLocalAddress