localedef.1, access.2, ioctl_console.2, ioctl_fslabel.2, openat2.2, write.2, dlsym.3, getopt.3, nl_langinfo.3, termios.3, xcrypt.3, hosts.equiv.5, nsswitch.conf.5, cgroups.7, man-pages.7, netlink.7, system_data_types.7: srcfix: semantic newlines

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2021-08-09 00:26:25 +02:00
parent e6b7a7b823
commit 5e833e276d
17 changed files with 44 additions and 26 deletions

View File

@ -245,7 +245,8 @@ and
.IR intcurrsym .
.TP
.B \-\-posix
Conform strictly to POSIX. Implies
Conform strictly to POSIX.
Implies
.BR \-\-verbose .
This option currently has no other effect.
POSIX conformance is assumed if the environment variable

View File

@ -358,8 +358,8 @@ call will still fail.
These calls
may not work correctly on NFSv2 filesystems with UID mapping enabled,
because UID mapping is done on the server and hidden from the client,
which checks permissions. (NFS versions 3 and higher perform the check on
the server.)
which checks permissions.
(NFS versions 3 and higher perform the check on the server.)
Similar problems can occur to FUSE mounts.
.\"
.\"

View File

@ -685,7 +685,8 @@ These are legal only for the superuser or the owner of the current terminal.
.TP
.B "TIOCLINUX, subcode=0"
Dump the screen.
Disappeared in Linux 1.1.92. (With kernel 1.1.92 or later, read from
Disappeared in Linux 1.1.92.
(With kernel 1.1.92 or later, read from
.I /dev/vcsN
or
.I /dev/vcsaN

View File

@ -43,7 +43,8 @@ The
operation requires privilege
.RB ( CAP_SYS_ADMIN ).
.SH RETURN VALUE
On success zero is returned. On error, \-1 is returned, and
On success zero is returned.
On error, \-1 is returned, and
.I errno
is set to indicate the error.
.SH ERRORS
@ -77,7 +78,8 @@ The maximum string length for this interface is
.BR FSLABEL_MAX ,
including the terminating null byte (\(aq\\0\(aq).
Filesystems have differing maximum label lengths, which may or
may not include the terminating null. The string provided to
may not include the terminating null.
The string provided to
.B FS_IOC_SETFSLABEL
must always be null-terminated, and the string returned by
.B FS_IOC_GETFSLABEL

View File

@ -439,7 +439,8 @@ call.
.B EAGAIN
.BR RESOLVE_CACHED
was set, and the open operation cannot be performed using only cached
information. The caller should retry without
information.
The caller should retry without
.B RESOLVE_CACHED
set in
.I how.resolve .

View File

@ -293,7 +293,8 @@ returning the number of bytes actually transferred.
An error return value while performing
.BR write ()
using direct I/O does not mean the
entire write has failed. Partial data may be written
entire write has failed.
Partial data may be written
and the data at the file offset on which the
.BR write ()
was attempted should be considered inconsistent.

View File

@ -153,12 +153,15 @@ There are several scenarios when the address of a global symbol is NULL.
For example, a symbol can be placed at zero address by the linker, via
a linker script or with
.I \-\-defsym
command-line option. Undefined weak symbols also have NULL value.
command-line option.
Undefined weak symbols also have NULL value.
Finally, the symbol value may be the result of
a GNU indirect function (IFUNC) resolver function that returns
NULL as the resolved value. In the latter case,
NULL as the resolved value.
In the latter case,
.BR dlsym ()
also returns NULL without error. However, in the former two cases, the
also returns NULL without error.
However, in the former two cases, the
behavior of GNU dynamic linker is inconsistent: relocation processing
succeeds and the symbol can be observed to have NULL value, but
.BR dlsym ()

View File

@ -176,7 +176,8 @@ behaviour is required in this case
will contain two \(aq+\(aq symbols.
If the first character of \fIoptstring\fP is \(aq\-\(aq, then
each nonoption \fIargv\fP-element is handled as if it were the argument of
an option with character code 1. (This is used by programs that were
an option with character code 1.
(This is used by programs that were
written to expect options and other \fIargv\fP-elements in any order
and that care about the ordering of the two.)
The special argument "\-\-" forces an end of option-scanning regardless

View File

@ -200,7 +200,8 @@ for alternative representation of a time in a locale-specific way
conversion specification).
.TP
.BR DAY_ "{1\(en7} (LC_TIME)"
Return name of the \fIn\fP-th day of the week. [Warning: this follows
Return name of the \fIn\fP-th day of the week.
[Warning: this follows
the US convention DAY_1 = Sunday, not the international convention
(ISO 8601) that Monday is the first day of the week.]
(Used in

View File

@ -331,7 +331,8 @@ Ignore modem control lines.
.TP
.B LOBLK
(not in POSIX) Block output from a noncurrent shell layer.
For use by \fBshl\fP (shell layers). (Not implemented on Linux.)
For use by \fBshl\fP (shell layers).
(Not implemented on Linux.)
.TP
.B CIBAUD
(not in POSIX) Mask for input speeds.

View File

@ -24,8 +24,8 @@ xencrypt, xdecrypt, passwd2des \- RFS password encryption
.fi
.SH DESCRIPTION
.BR WARNING :
Do not use these functions in new code. They do not achieve
any type of acceptable cryptographic security guarantees.
Do not use these functions in new code.
They do not achieve any type of acceptable cryptographic security guarantees.
.PP
The function
.BR passwd2des ()

View File

@ -38,7 +38,8 @@ You can explicitly deny access to a host by preceding the
.I hostname
by a minus (\-) sign.
Users from that host must always supply additional credentials,
including possibly a password. For security reasons you should always
including possibly a password.
For security reasons you should always
use the FQDN of the hostname and not the short hostname.
.PP
The

View File

@ -102,9 +102,10 @@ Shadow user passwords, used by
.BR getspnam (3)
and related functions.
.PP
The GNU C Library ignores databases with unknown names. Some
applications use this to implement special handling for their own
databases. For example,
The GNU C Library ignores databases with unknown names.
Some applications use this to implement special handling for their own
databases.
For example,
.BR sudo (8)
consults the
.B sudoers

View File

@ -92,8 +92,8 @@ was eventually made official with the release of Linux 4.5.
Differences between the two versions are described in the text below.
The file
.IR cgroup.sane_behavior ,
present in cgroups v1, is a relic of this mount option. The file
always reports "0" and is only retained for backward compatibility.
present in cgroups v1, is a relic of this mount option.
The file always reports "0" and is only retained for backward compatibility.
.PP
Although cgroups v2 is intended as a replacement for cgroups v1,
the older system continues to exist

View File

@ -525,7 +525,8 @@ If there is a single such prototype that needs to be continued,
then align the continuation line so that when the page is
rendered on a fixed-width font device (e.g., on an xterm) the
continuation line starts just below the start of the argument
list in the line above. (Exception: the indentation may be
list in the line above.
(Exception: the indentation may be
adjusted if necessary to prevent a very long continuation line
or a further continuation line where the function prototype is
very long.)
@ -541,7 +542,8 @@ As an example:
But, where multiple functions in the SYNOPSIS require
continuation lines, and the function names have different
lengths, then align all continuation lines to start in the
same column. This provides a nicer rendering in PDF output
same column.
This provides a nicer rendering in PDF output
(because the SYNOPSIS uses a variable width font where
spaces render narrower than most characters).
As an example:

View File

@ -189,7 +189,8 @@ message signals an error and the payload contains an
.I nlmsgerr
structure,
.B NLMSG_DONE
message terminates a multipart message. Error messages get the
message terminates a multipart message.
Error messages get the
original request appened, unless the user requests to cap the
error message, and get extra error data if requested.
.PP

View File

@ -1247,7 +1247,8 @@ Alternatively,
or
.IR <wordexp.h> .
.PP
Used for a count of bytes. It is the result of the
Used for a count of bytes.
It is the result of the
.I sizeof
operator.
According to the C language standard,