Formatting fixes.

Changes

@@ -9,6 +9,7 @@ The following people contributed notes, ideas, or patches that have
 been incorporated in changes in this release:
 
 ###Andries Brouwer <Andries.Brouwer@cwi.nl>
+Mike Frysinger <vapier@gentoo.org>
 
 Apologies if I missed anyone!
 
@@ -21,3 +22,7 @@ places.
 
 Changes to individual pages
 ---------------------------
+
+stat.2
+    Mike Frysinger
+        Improve st_blocks description.

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"

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

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

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.

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

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.

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 

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"

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.

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

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

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

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.
 

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.

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

man3/scalb.3

@@ -58,7 +58,7 @@ is equivalent to
 .BR ldexp() .
 
 The value of FLT_RADIX is found in
-.I <float.h>.
+.IR <float.h> .
 .\" not in /usr/include but in a gcc lib
 .SH "CONFORMING TO"
 The

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

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 ,

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

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"
 

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 (

man5/charmap.5

@@ -47,9 +47,9 @@ is 1.
 .I <mb_cur_min>
 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 <escape_char>
 is followed by a character that should be used as the

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 

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

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

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 

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

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

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

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