diff --git a/man1/localedef.1 b/man1/localedef.1 index dca01fa61..3b9f8adf1 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -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 diff --git a/man2/access.2 b/man2/access.2 index f24a73161..3957a2ab8 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -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. .\" .\" diff --git a/man2/ioctl_console.2 b/man2/ioctl_console.2 index 8e3ebf0c8..e1f63d8a3 100644 --- a/man2/ioctl_console.2 +++ b/man2/ioctl_console.2 @@ -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 diff --git a/man2/ioctl_fslabel.2 b/man2/ioctl_fslabel.2 index 30435e1e9..df4baecfd 100644 --- a/man2/ioctl_fslabel.2 +++ b/man2/ioctl_fslabel.2 @@ -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 diff --git a/man2/openat2.2 b/man2/openat2.2 index efa840206..376e2ff78 100644 --- a/man2/openat2.2 +++ b/man2/openat2.2 @@ -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 . diff --git a/man2/write.2 b/man2/write.2 index b651a43d9..1a2de2722 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -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. diff --git a/man3/dlsym.3 b/man3/dlsym.3 index e05403bfb..c6ddec332 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -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 () diff --git a/man3/getopt.3 b/man3/getopt.3 index f5970075d..f34625bbd 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -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 diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 index 86a70404c..c0c47aae2 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -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 diff --git a/man3/termios.3 b/man3/termios.3 index c2b353872..256236819 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -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. diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index 9a1419da6..4b425ccb8 100644 --- a/man3/xcrypt.3 +++ b/man3/xcrypt.3 @@ -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 () diff --git a/man5/hosts.equiv.5 b/man5/hosts.equiv.5 index c50110ecf..2aa59be58 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -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 diff --git a/man5/nsswitch.conf.5 b/man5/nsswitch.conf.5 index ae49223b0..f9e253fe5 100644 --- a/man5/nsswitch.conf.5 +++ b/man5/nsswitch.conf.5 @@ -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 diff --git a/man7/cgroups.7 b/man7/cgroups.7 index a5aa4a37d..3f4ed5432 100644 --- a/man7/cgroups.7 +++ b/man7/cgroups.7 @@ -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 diff --git a/man7/man-pages.7 b/man7/man-pages.7 index 3819dfd97..d0da214a8 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -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: diff --git a/man7/netlink.7 b/man7/netlink.7 index 6537e6fab..6b04fead9 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -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 diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 index 6cb6cdde8..d117b1d2b 100644 --- a/man7/system_data_types.7 +++ b/man7/system_data_types.7 @@ -1247,7 +1247,8 @@ Alternatively, or .IR . .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,