From a5e0a0e4274eac427c85afe4aa80104bc5a395c4 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 19 Jul 2005 15:36:19 +0000 Subject: [PATCH] Formatting fixes. --- Changes | 5 +++++ man1/df.1 | 4 ++-- man1/ls.1 | 2 +- man2/cacheflush.2 | 2 +- man2/msync.2 | 2 +- man2/ptrace.2 | 2 +- man2/readdir.2 | 2 +- man2/sched_setparam.2 | 2 +- man2/setsid.2 | 4 ++-- man2/times.2 | 2 +- man2/wait.2 | 8 ++++---- man3/dl_iterate_phdr.3 | 2 +- man3/dlopen.3 | 2 +- man3/getline.3 | 12 ++++++------ man3/inet_pton.3 | 4 ++-- man3/posix_memalign.3 | 6 +++--- man3/scalb.3 | 2 +- man3/sigsetops.3 | 2 +- man3/stdio.3 | 2 +- man3/strptime.3 | 2 +- man4/console_codes.4 | 2 +- man4/sk98lin.4 | 7 ++++--- man5/charmap.5 | 4 ++-- man5/locale.5 | 36 ++++++++++++++++++------------------ man5/nsswitch.conf.5 | 4 ++-- man7/hier.7 | 2 +- man7/netdevice.7 | 2 +- man7/packet.7 | 8 ++++---- man7/pthreads.7 | 2 +- man7/raw.7 | 2 +- man7/tcp.7 | 2 +- 31 files changed, 73 insertions(+), 67 deletions(-) diff --git a/Changes b/Changes index f2cef914d..55b2150ac 100644 --- a/Changes +++ b/Changes @@ -9,6 +9,7 @@ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: ###Andries Brouwer +Mike Frysinger Apologies if I missed anyone! @@ -21,3 +22,7 @@ places. Changes to individual pages --------------------------- + +stat.2 + Mike Frysinger + Improve st_blocks description. diff --git a/man1/df.1 b/man1/df.1 index 3c5a32693..0d51d5883 100644 --- a/man1/df.1 +++ b/man1/df.1 @@ -159,14 +159,14 @@ See also .TP .BI "\-x " "fstype, " "\-\-exclude\-type=" "fstype" Limit the listing to filesystems not of type -.I fstype. +.IR fstype . Multiple filesystem types can be eliminated by giving multiple .B "\-x" options. By default, no filesystem types are omitted. .TP .B "\-v" Ignored; for compatibility with System V versions of -.B df. +.B df . .SH "GNU STANDARD OPTIONS" .TP .B "\-\-help" diff --git a/man1/ls.1 b/man1/ls.1 index b25e5e951..0e10f345a 100644 --- a/man1/ls.1 +++ b/man1/ls.1 @@ -384,7 +384,7 @@ Do not list files whose names match the shell pattern (not regular expression) unless they are given on the command line. As in the shell, an initial `.' in a filename does not match a wildcard at the start of -.I pattern. +.IR pattern . For simple-minded root-kits: add LS_OPTIONS="$LS_OPTIONS \-I mystuff" in /etc/profile or so, to hide your directories. .TP diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index b924029e3..c16d859bc 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -43,7 +43,7 @@ Write back to memory and invalidate the affected valid cache lines. .TP .B BCACHE Same as -.B (ICACHE|DCACHE). +.B (ICACHE|DCACHE) . .PP .SH "RETURN VALUE" .B cacheflush diff --git a/man2/msync.2 b/man2/msync.2 index f3fc2ca3b..6fce5ee05 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -61,7 +61,7 @@ is set appropriately. .I start is not a multiple of PAGESIZE, or any bit other than MS_ASYNC | MS_INVALIDATE | MS_SYNC is set in -.IR flags. +.IR flags . .TP .B ENOMEM The indicated memory (or part of it) was not mapped. diff --git a/man2/ptrace.2 b/man2/ptrace.2 index 59ce44618..e1a616365 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -75,7 +75,7 @@ PTRACE_TRACEME Indicates that this process is to be traced by its parent. Any signal (except SIGKILL) delivered to this process will cause it to stop and its parent to be notified via -.BR wait. +.BR wait . Also, all subsequent calls to .BR exec by this process will cause a SIGTRAP to be sent to it, giving the parent a diff --git a/man2/readdir.2 b/man2/readdir.2 index 6a1c2dd4c..b0a6e616d 100644 --- a/man2/readdir.2 +++ b/man2/readdir.2 @@ -86,7 +86,7 @@ is the distance from the start of the directory to this .IR dirent . .I d_reclen is the size of -.IR d_name, +.IR d_name , not counting the null terminator. .I d_name is a null-terminated file name. diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 8f80f183d..6a9eab2d2 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -57,7 +57,7 @@ following three scheduling policies are supported under Linux: .IR SCHED_FIFO , .IR SCHED_RR , and -.IR SCHED_OTHER. +.IR SCHED_OTHER . .B sched_getparam retrieves the scheduling parameters for the diff --git a/man2/setsid.2 b/man2/setsid.2 index 336360e8d..ce661802d 100644 --- a/man2/setsid.2 +++ b/man2/setsid.2 @@ -36,7 +36,7 @@ setsid \- creates a session and sets the process group ID .br .ad b .SH DESCRIPTION -\fBsetsid()\fP creates a new session if the calling process is not a +\fBsetsid\fP() creates a new session if the calling process is not a process group leader. The calling process is the leader of the new session, the process group leader of the new process group, and has no controlling tty. The process group ID and session ID of the calling @@ -58,7 +58,7 @@ A process group leader is a process with process group ID equal to its PID. In order to be sure that .B setsid will succeed, fork and exit, and have the child do -.BR setsid(). +.BR setsid (). .SH "CONFORMING TO" POSIX, SVr4. .SH "SEE ALSO" diff --git a/man2/times.2 b/man2/times.2 index c2bb451a6..7d86df443 100644 --- a/man2/times.2 +++ b/man2/times.2 @@ -105,7 +105,7 @@ For Linux 2.4 and earlier this point is the moment the system was booted. Since Linux 2.6, this point is \fI(2^32/HZ) \- 300\fP (i.e., about 429 million) seconds before system boot time. The return value may overflow the possible range of type -.I clock_t. +.IR clock_t . On error, \fI(clock_t) \-1\fP is returned, and .I errno is set appropriately. diff --git a/man2/wait.2 b/man2/wait.2 index 112413933..bc7e4728c 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -179,7 +179,7 @@ returns true if the child terminated normally, that is, by calling .BR exit (3) or -.BR _exit(2), +.BR _exit (2), or by returning from main(). .TP .BI WEXITSTATUS( status ) @@ -189,7 +189,7 @@ This consists of the least significant 8 bits of the argument that the child specified in a call to .BR exit () or -.BR _exit() +.BR _exit () or as the argument for a return statement in main(). This macro should only be employed if .B WIFEXITED @@ -339,7 +339,7 @@ after the call returns. on success, returns the process ID of the terminated child; on error, \-1 is returned. -.BR waitpid(): +.BR waitpid (): on success, returns the process ID of the child whose state has changed; on error, \-1 is returned; if @@ -348,7 +348,7 @@ was specified and no child(ren) specified by .I pid has yet changed state, then 0 is returned. -.BR waitid(): +.BR waitid (): returns 0 on success or if .B WNOHANG diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index 30eb1a165..7e4c4c35c 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -63,7 +63,7 @@ which is a copy of whatever value was passed by the calling program as the second argument (also named .IR data ) in the call to -.BR dl_iterate_phdr. +.BR dl_iterate_phdr . The .I info diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 722ee00f9..59b9480bf 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -154,7 +154,7 @@ followed by all shared libraries loaded at program startup, and then all shared libraries loaded by .BR dlopen() with the flag -.B RTLD_GLOBAL. +.BR RTLD_GLOBAL . .PP External references in the library are resolved using the libraries in that library's dependency list and any other libraries previously diff --git a/man3/getline.3 b/man3/getline.3 index 2e5c78eaf..328fd835a 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -36,7 +36,7 @@ getline, getdelim \- delimited string input .B getline() reads an entire line, storing the address of the buffer containing the text into -.IR "*lineptr". +.IR "*lineptr" . The buffer is null-terminated and includes the newline character, if a newline delimiter was found. @@ -45,13 +45,13 @@ newline delimiter was found. If .IR "*lineptr" is -.BR "NULL", +.BR "NULL" , the .BR getline() routine will allocate a buffer for containing the line, which must be freed by the user program. Alternatively, before calling -.BR "getline()", +.BR "getline()" , .IR "*lineptr" can contain a pointer to a .BR "malloc()"\-allocated @@ -60,7 +60,7 @@ buffer bytes in size. If the buffer is not large enough to hold the line read in, .B getline() resizes the buffer to fit with -.BR "realloc()", +.BR "realloc()" , updating .IR "*lineptr" and @@ -73,11 +73,11 @@ will be updated to reflect the buffer address and size respectively. .BR getdelim() works like -.BR "getline()", +.BR "getline()" , except a line delimiter other than newline can be specified as the .IR delimiter argument. As with -.BR "getline()", +.BR "getline()" , a delimiter character is not added if one was not present in the input before end of file was reached. diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index edc07d9db..26868220c 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -58,7 +58,7 @@ The address is converted to a .I struct in_addr and copied to -.IR dst, +.IR dst , which must be .I sizeof(struct in_addr) bytes long. @@ -71,7 +71,7 @@ The address is converted to a .I struct in6_addr and copied to -.IR dst, +.IR dst , which must be .I sizeof(struct in6_addr) bytes long. diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index 85a65db4d..ac20f9cc9 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -45,9 +45,9 @@ The function allocates .I size bytes and places the address of the allocated memory in -.IR "*memptr". +.IR "*memptr" . The address of the allocated memory will be a multiple of -.IR "alignment", +.IR "alignment" , which must be a power of two and a multiple of .IR "sizeof(void *)". @@ -57,7 +57,7 @@ allocates .I size bytes and returns a pointer to the allocated memory. The memory address will be a multiple of -.IR "boundary", +.IR "boundary" , which must be a power of two. The obsolete function diff --git a/man3/scalb.3 b/man3/scalb.3 index 3f75c937b..47cea8154 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -58,7 +58,7 @@ is equivalent to .BR ldexp() . The value of FLT_RADIX is found in -.I . +.IR . .\" not in /usr/include but in a gcc lib .SH "CONFORMING TO" The diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index b6fea3e31..72aa66683 100644 --- a/man3/sigsetops.3 +++ b/man3/sigsetops.3 @@ -68,7 +68,7 @@ from tests whether .I signum is a member of -.I set. +.IR set . .SH "RETURN VALUE" .BR sigemptyset ", " sigfillset ", " sigaddset and diff --git a/man3/stdio.3 b/man3/stdio.3 index 512f8574b..bc533c721 100644 --- a/man3/stdio.3 +++ b/man3/stdio.3 @@ -136,7 +136,7 @@ first removing their current definitions with .BR FOPEN_MAX , .BR L_cuserid , .BR L_ctermid , -.BR L_tmpnam, +.BR L_tmpnam , .BR NULL , .BR SEEK_END , .BR SEEK_SET , diff --git a/man3/strptime.3 b/man3/strptime.3 index 1c3baf869..b9967e914 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -290,7 +290,7 @@ int main() { For reasons of symmetry, glibc tries to support for .B strptime the same format characters as for -.BR strftime. +.BR strftime . (In most cases the corresponding fields are parsed, but no field in \fItm\fP is changed.) This leads to diff --git a/man4/console_codes.4 b/man4/console_codes.4 index 318347346..2f91a0f92 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -367,7 +367,7 @@ The user-defined mapping table can be set using The result of the mapping is that if a symbol c is printed, the symbol s = map[c] is sent to the video memory. The bitmap that corresponds to s is found in the character ROM, and can be changed using -.BR setfont(8). +.BR setfont (8). .SH "MOUSE TRACKING" diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index 484362a57..a6b065c6a 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -179,8 +179,9 @@ or .IR Both whereas .IR Both -is the default. This parameter is only relevant if AutoNeg_A of port A is not set to -.IR Sense. +is the default. +This parameter is only relevant if AutoNeg_A of port A is not set to +.IR Sense . If AutoNeg_A is set to .IR On , all three values of DupCap_A ( @@ -207,7 +208,7 @@ or whereas .IR Both is the default. This parameter is only relevant if AutoNeg_B of port B is not set to -.IR Sense. +.IR Sense . If AutoNeg_B is set to .IR On , all three values of DupCap_B ( diff --git a/man5/charmap.5 b/man5/charmap.5 index 886a1bc9e..11e4b82c7 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -47,9 +47,9 @@ is 1. .I is followed by the min number of bytes for a character. This value must be less or equal than -.B mb_cur_max. +.BR mb_cur_max . If not specified, it defaults to -.B mb_cur_max. +.BR mb_cur_max . .TP .I is followed by a character that should be used as the diff --git a/man5/locale.5 b/man5/locale.5 index 16099e338..f583e9e86 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -269,20 +269,20 @@ The order-definition starts with a line: .I order_start .PP followed by a list of keywords out of -.B forward, -.B backward, +.BR forward , +.BR backward , or -.B position. +.BR position . The order definition consists of lines that describe the order and is terminated with the keyword .TP -.I order_end. +.IR order_end . .PP For more details see the sources in .B /usr/lib/nls/src notably the examples -.B POSIX, +.BR POSIX , .B Example and .B Example2 @@ -291,7 +291,7 @@ and The .B LC_COLLATE definition ends with the string -.I END LC_COLLATE. +.IR END LC_COLLATE . .SS LC_MONETARY The definition starts with the string @@ -333,12 +333,12 @@ monetary quantities. .I int_frac_digits followed by the number of fractional digits that should be used when formatting with the -.B int_curr_symbol. +.BR int_curr_symbol . .TP .I frac_digits followed by the number of fractional digits that should be used when formatting with the -.B currency_symbol. +.BR currency_symbol . .TP .I p_cs_precedes followed by an integer set to @@ -398,31 +398,31 @@ if a space separates the symbol and the sign string, if adjacent. Parentheses enclose the quantity and the .I currency_symbol or -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 1 The sign string precedes the quantity and the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 2 The sign string succeeds the quantity and the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 3 The sign string precedes the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 4 The sign string succeeds the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .RE .TP .I n_sign_posn @@ -432,31 +432,31 @@ or the Parentheses enclose the quantity and the .I currency_symbol or -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 1 The sign string precedes the quantity and the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 2 The sign string succeeds the quantity and the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 3 The sign string precedes the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .TP .B 4 The sign string succeeds the .I currency_symbol or the -.I int_curr_symbol. +.IR int_curr_symbol . .RE .PP The diff --git a/man5/nsswitch.conf.5 b/man5/nsswitch.conf.5 index 4c6c3d40c..24c0414bf 100644 --- a/man5/nsswitch.conf.5 +++ b/man5/nsswitch.conf.5 @@ -219,10 +219,10 @@ and If this is not sufficient, the NSS `compat' service provides full +/\- semantics. By default, the source is `nis', but this may be overridden by specifying `nisplus' as source for the pseudo-databases -.BR passwd_compat, +.BR passwd_compat , .B group_compat and -.BR shadow_compat. +.BR shadow_compat . This pseudo-databases are only available in GNU C Library. .SH FILES A service named SERVICE is implemented by a shared object library named diff --git a/man7/hier.7 b/man7/hier.7 index c3860d8cf..40c1c9538 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -184,7 +184,7 @@ Include files for the C compiler. .I /usr/include/X11 Include files for the C compiler and the X\-Windows system. This is usually a symbolic link to -.I /usr/X11R6/include/X11. +.IR /usr/X11R6/include/X11 . .TP .I /usr/include/asm Include files which declare some assembler functions. This used to be a diff --git a/man7/netdevice.7 b/man7/netdevice.7 index d41445590..b423ca96b 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -199,7 +199,7 @@ structure as argument to the ioctl. It contains a pointer to an array of structures in .B ifc_req and its length in bytes in -.B ifc_len. +.BR ifc_len . The kernel fills the ifreqs with all current L3 interface addresses that are running: .I ifr_name diff --git a/man7/packet.7 b/man7/packet.7 index f79a40043..464d8573b 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -209,8 +209,8 @@ and sets the socket up to receive all multicast packets arriving at the interface. In addition the traditional ioctls -.B SIOCSIFFLAGS, -.B SIOCADDMULTI, +.BR SIOCSIFFLAGS , +.BR SIOCADDMULTI , .B SIOCDELMULTI can be used for the same purpose. @@ -347,11 +347,11 @@ In addition other errors may be generated by the low-level driver. .SH VERSIONS .B PF_PACKET is a new feature in Linux 2.2. Earlier Linux versions supported only -.B SOCK_PACKET. +.BR SOCK_PACKET . .SH BUGS glibc 2.1 does not have a define for -.B SOL_PACKET. +.BR SOL_PACKET . The suggested workaround is to use .RS .nf diff --git a/man7/pthreads.7 b/man7/pthreads.7 index e37afd8e5..68dad7eb8 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -110,7 +110,7 @@ On Linux, programs that use the Pthreads API should be compiled using Over time, two threading implementations have been provided by the GNU C library on Linux: .IP \- 3 -.B LinuxThreads. +.B LinuxThreads This is the original (now obsolete) Pthreads implementation. .IP \- 3 .B NPTL diff --git a/man7/raw.7 b/man7/raw.7 index b1cdcfa8f..a63b06570 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -175,7 +175,7 @@ intended to be portable. Sending on raw sockets should take the IP protocol from .B sin_port; this ability was lost in Linux 2.2. Work around is to use -.B IP_HDRINCL. +.BR IP_HDRINCL . .SH "ERROR HANDLING" Errors originating from the network are only passed to the user when the diff --git a/man7/tcp.7 b/man7/tcp.7 index ce7e3a920..ebbe59b8c 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -573,7 +573,7 @@ To set or get a TCP socket option, call to read or .BR setsockopt (2) to write the option with the option level argument set to -.BR SOL_TCP. +.BR SOL_TCP . In addition, most .B SOL_IP