libc: Fix most issues reported by mandoc
- varios "new sentence, new line" warnings - varios "sections out of conventional order" warnings - varios "unusual Xr order" warnings - varios "missing section argument" warnings - varios "no blank before trailing delimiter" warnings - varios "normalizing date format" warnings MFC after: 1 month
This commit is contained in:
parent
a652079615
commit
f6d234d870
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=368817
@ -157,6 +157,15 @@ if the given combination of
|
||||
and
|
||||
.Fa locale
|
||||
makes no sense.
|
||||
.Sh FILES
|
||||
.Bl -tag -width /usr/share/locale/locale/category -compact
|
||||
.It Pa $PATH_LOCALE/ Ns Em locale/category
|
||||
.It Pa /usr/share/locale/ Ns Em locale/category
|
||||
locale file for the locale
|
||||
.Em locale
|
||||
and the category
|
||||
.Em category .
|
||||
.El
|
||||
.Sh EXAMPLES
|
||||
The following code illustrates how a program can initialize the
|
||||
international environment for one language, while selectively
|
||||
@ -176,15 +185,6 @@ following manner before using any of the locale-specific information:
|
||||
.Bd -literal
|
||||
setlocale(LC_ALL, "");
|
||||
.Ed
|
||||
.Sh FILES
|
||||
.Bl -tag -width /usr/share/locale/locale/category -compact
|
||||
.It Pa $PATH_LOCALE/ Ns Em locale/category
|
||||
.It Pa /usr/share/locale/ Ns Em locale/category
|
||||
locale file for the locale
|
||||
.Em locale
|
||||
and the category
|
||||
.Em category .
|
||||
.El
|
||||
.Sh ERRORS
|
||||
No errors are defined.
|
||||
.Sh SEE ALSO
|
||||
|
@ -303,7 +303,26 @@ for example, a mail-forwarder may be registered for this domain.
|
||||
.Xr hosts 5 ,
|
||||
.Xr hostname 7 ,
|
||||
.Xr named 8
|
||||
.Sh CAVEAT
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn herror
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
The
|
||||
.Fn endhostent ,
|
||||
.Fn gethostbyaddr ,
|
||||
.Fn gethostbyname ,
|
||||
.Fn gethostent ,
|
||||
and
|
||||
.Fn sethostent
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
The
|
||||
.Fn gethostbyname2
|
||||
function first appeared in
|
||||
.Tn BIND
|
||||
version 4.9.4.
|
||||
.Sh CAVEATS
|
||||
The
|
||||
.Fn gethostent
|
||||
function
|
||||
@ -343,25 +362,6 @@ The
|
||||
.Fn endhostent
|
||||
function
|
||||
closes the file.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn herror
|
||||
function appeared in
|
||||
.Bx 4.3 .
|
||||
The
|
||||
.Fn endhostent ,
|
||||
.Fn gethostbyaddr ,
|
||||
.Fn gethostbyname ,
|
||||
.Fn gethostent ,
|
||||
and
|
||||
.Fn sethostent
|
||||
functions appeared in
|
||||
.Bx 4.2 .
|
||||
The
|
||||
.Fn gethostbyname2
|
||||
function first appeared in
|
||||
.Tn BIND
|
||||
version 4.9.4.
|
||||
.Sh BUGS
|
||||
These functions use a thread-specific data storage;
|
||||
if the data is needed for future use, it should be
|
||||
|
@ -117,7 +117,6 @@ with
|
||||
.Dv SEEK_DATA
|
||||
arguments and this system call for the
|
||||
data ranges found.
|
||||
.Pp
|
||||
.Sh RETURN VALUES
|
||||
If it succeeds, the call returns the number of bytes copied, which can be fewer
|
||||
than
|
||||
@ -144,11 +143,9 @@ will fail if:
|
||||
.Bl -tag -width Er
|
||||
.It Bq Er EBADF
|
||||
If
|
||||
.Fa
|
||||
infd
|
||||
.Fa infd
|
||||
is not open for reading or
|
||||
.Fa
|
||||
outfd
|
||||
.Fa outfd
|
||||
is not open for writing, or opened for writing with
|
||||
.Dv O_APPEND ,
|
||||
or if
|
||||
@ -175,8 +172,7 @@ are reset to the initial values for the system call.
|
||||
and
|
||||
.Fa outfd
|
||||
refer to the same file and the byte ranges overlap or
|
||||
.Fa
|
||||
flags
|
||||
.Fa flags
|
||||
is not zero.
|
||||
.It Bq Er EIO
|
||||
An I/O error occurred while reading/writing the files.
|
||||
|
@ -348,7 +348,7 @@ system call conforms to The Open Group Extended API Set 2 specification.
|
||||
The
|
||||
.Fn execve
|
||||
system call appeared in
|
||||
.At V7 .
|
||||
.At v7 .
|
||||
The
|
||||
.Fn fexecve
|
||||
system call appeared in
|
||||
|
@ -272,6 +272,6 @@ is not
|
||||
nor a file descriptor associated with a directory.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr fhstat 2 ,
|
||||
.Xr fhreadlink 2 ,
|
||||
.Xr fhopen 2 ,
|
||||
.Xr fhreadlink 2 ,
|
||||
.Xr fhstat 2
|
||||
|
@ -161,8 +161,8 @@ for
|
||||
.Xr fork 2 ,
|
||||
.Xr fstat 2 ,
|
||||
.Xr kill 2 ,
|
||||
.Xr poll 2 ,
|
||||
.Xr kqueue 2 ,
|
||||
.Xr poll 2 ,
|
||||
.Xr wait4 2 ,
|
||||
.Xr capsicum 4 ,
|
||||
.Xr procdesc 4
|
||||
|
@ -698,7 +698,6 @@ value.
|
||||
If the system call completed in an unusual fashion,
|
||||
.Va sr_error
|
||||
is set to a negative value:
|
||||
.Pp
|
||||
.Bl -tag -width Dv EJUSTRETURN -compact
|
||||
.It Dv ERESTART
|
||||
System call will be restarted.
|
||||
@ -830,7 +829,6 @@ The
|
||||
.Fa data
|
||||
argument is ignored.
|
||||
.El
|
||||
.Pp
|
||||
.Sh x86 MACHINE-SPECIFIC REQUESTS
|
||||
.Bl -tag -width "Dv PT_GETXSTATE_INFO"
|
||||
.It Dv PT_GETXMMREGS
|
||||
|
@ -31,7 +31,7 @@
|
||||
.\" @(#)revoke.2 8.1 (Berkeley) 6/4/93
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd Jan 25, 2016
|
||||
.Dd January 25, 2016
|
||||
.Dt REVOKE 2
|
||||
.Os
|
||||
.Sh NAME
|
||||
|
@ -135,7 +135,10 @@ field ranges between 0 and
|
||||
.Pq usually 31 .
|
||||
0 is the highest possible priority.
|
||||
.Pp
|
||||
Realtime and idle priority is inherited through fork() and exec().
|
||||
Realtime and idle priority is inherited through
|
||||
.Fn fork
|
||||
and
|
||||
.Fn exec .
|
||||
.Pp
|
||||
A realtime thread can only be preempted by a thread of equal or
|
||||
higher priority, or by an interrupt; idle priority threads will run only
|
||||
|
@ -381,14 +381,14 @@ does not support
|
||||
The socket peer has closed the connection.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr loader.conf 5 ,
|
||||
.Xr netstat 1 ,
|
||||
.Xr open 2 ,
|
||||
.Xr send 2 ,
|
||||
.Xr socket 2 ,
|
||||
.Xr writev 2 ,
|
||||
.Xr sysctl 8 ,
|
||||
.Xr tuning 7
|
||||
.Xr loader.conf 5 ,
|
||||
.Xr tuning 7 ,
|
||||
.Xr sysctl 8
|
||||
.Rs
|
||||
.%A K. Elmeleegy
|
||||
.%A A. Chanda
|
||||
|
@ -72,12 +72,12 @@ A return from the function indicates that the calling thread was the
|
||||
last one in the process.
|
||||
.Sh SEE ALSO
|
||||
.Xr _exit 2 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr thr_kill 2 ,
|
||||
.Xr thr_kill2 2 ,
|
||||
.Xr thr_new 2 ,
|
||||
.Xr thr_self 2 ,
|
||||
.Xr thr_set_name 2 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr pthread_exit 3
|
||||
.Sh STANDARDS
|
||||
The
|
||||
|
@ -225,6 +225,7 @@ There was not enough kernel memory to allocate the new thread structures.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr ps 1 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr execve 2 ,
|
||||
.Xr racct 2 ,
|
||||
.Xr thr_exit 2 ,
|
||||
@ -232,7 +233,6 @@ There was not enough kernel memory to allocate the new thread structures.
|
||||
.Xr thr_kill2 2 ,
|
||||
.Xr thr_self 2 ,
|
||||
.Xr thr_set_name 2 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr pthread_create 3
|
||||
.Sh STANDARDS
|
||||
The
|
||||
|
@ -71,12 +71,12 @@ The memory pointed to by the
|
||||
argument is not valid.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr thr_exit 2 ,
|
||||
.Xr thr_kill 2 ,
|
||||
.Xr thr_kill2 2 ,
|
||||
.Xr thr_new 2 ,
|
||||
.Xr thr_set_name 2 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr pthread_getthreadid_np 3 ,
|
||||
.Xr pthread_self 3
|
||||
.Sh STANDARDS
|
||||
|
@ -78,12 +78,12 @@ does not exist in the current process.
|
||||
.El
|
||||
.Sh SEE ALSO
|
||||
.Xr ps 1 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr thr_exit 2 ,
|
||||
.Xr thr_kill 2 ,
|
||||
.Xr thr_kill2 2 ,
|
||||
.Xr thr_new 2 ,
|
||||
.Xr thr_self 2 ,
|
||||
.Xr _umtx_op 2 ,
|
||||
.Xr pthread_set_name_np 3 ,
|
||||
.Xr ddb 4 ,
|
||||
.Xr ktr 9
|
||||
|
@ -98,7 +98,6 @@ As with
|
||||
called from another thread, the next
|
||||
.Nm
|
||||
call does not result in suspension.
|
||||
.Pp
|
||||
.Sh RETURN VALUES
|
||||
.Rv -std thr_suspend
|
||||
.Sh ERRORS
|
||||
|
@ -74,7 +74,7 @@ If
|
||||
.Fa id
|
||||
is not equal to the current thread identifier, the specified thread is
|
||||
woken up if suspended by the
|
||||
.Xr thr_suspend
|
||||
.Xr thr_suspend 2
|
||||
system call.
|
||||
If the thread is not suspended at the time of the
|
||||
.Nm
|
||||
|
Loading…
Reference in New Issue
Block a user