getent.1, iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, pldd...

1) Use a single capital font macro for a genuine single argument.
  The output is unchanged.

2) Remove quotation marks (") around a single argument.
  The output is unchanged.

3) Change ".IR ab()" to ".IR ab ()"
  A font is changed in the output.

mtk: I verified that the output is unchanged (other than fonts)
by comparing the output of:

    for a in *.1; do man $a >> out.txt; done

before and after the patch.

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man1/getent.1 b/man1/getent.1
index 0af76e824abcb91913285df94e81e5c7ec1c694d..d750ae9f92966fabf0f558a636067d3e68145ac6 100644 (file)
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -26,7 +26,7 @@
 .SH NAME
 getent \- get entries from Name Service Switch libraries
 .SH SYNOPSIS
-.BR getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
+.B getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
 .SH DESCRIPTION
 The
 .B getent

diff --git a/man1/iconv.1 b/man1/iconv.1
index 2fcb5aa92e74eece7901626aeb8a586a663d80e5..3bd527f5cfacd71dff364733d655cac4562e9fcb 100644 (file)
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -66,14 +66,14 @@ Use
 for output characters.
 .IP
 If the string
-.BR //IGNORE
+.B //IGNORE
 is appended to
 .IR to-encoding ,
 characters that cannot be converted are discarded and an error is
 printed after conversion.
 .IP
 If the string
-.BR //TRANSLIT
+.B //TRANSLIT
 is appended to
 .IR to-encoding ,
 characters being converted are transliterated when needed and possible.
@@ -150,7 +150,7 @@ the system gconv module configuration cache is not used.
 Instead,
 .BR iconv_open (3)
 first tries to load the configuration files by searching the directories in
-.BR GCONV_PATH
+.B GCONV_PATH
 in order,
 followed by the system default gconv module configuration file.
 If a directory does not contain a gconv module configuration file,

diff --git a/man1/ldd.1 b/man1/ldd.1
index 376f04fe138bed86a9d16579289a520bea230f1d..bbb6ecfe6ffc48919806573d2d06c4a788ff10de 100644 (file)
--- a/man1/ldd.1
+++ b/man1/ldd.1
@@ -49,7 +49,7 @@ and find (according to the rules described in
 .BR ld.so (8))
 and load the objects that satisfy those dependencies.
 For each dependency,
-.BR ldd
+.B ldd
 displays the location of the matching object
 and the (hexadecimal) address at which it is loaded.
 (The
@@ -73,7 +73,7 @@ Be aware that in some circumstances
 .\" Much more detail at
 .\" http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
 some versions of
-.BR ldd
+.B ldd
 may attempt to obtain the dependency information
 by attempting to directly execute the program,
 which may lead to the execution of whatever code is defined

diff --git a/man1/locale.1 b/man1/locale.1
index 0efcadbe3cc6ef40aea8d524ff9a386177472208..76f432703bdb11e6d7bdc2d8f282e0410a3bb67d 100644 (file)
--- a/man1/locale.1
+++ b/man1/locale.1
@@ -78,7 +78,7 @@ which are the names of locale keywords (for example,
 or
 .IR decimal_point )
 or locale categories (for example,
-.BR LC_CTYPE
+.B LC_CTYPE
 or
 .BR LC_TIME ).
 For each argument, the following is displayed:
@@ -122,7 +122,7 @@ combinations.
 .BR \-? ", " \-\-help
 Display a summary of command-line options and arguments and exit.
 .TP
-.BR \-\-usage
+.B \-\-usage
 Display a short usage message and exit.
 .TP
 .BR \-V ", " \-\-version

diff --git a/man1/localedef.1 b/man1/localedef.1
index 4f6d36d65533feae3cf53e332da5868e49b7b475..fde87bf165dce935655ab1a5a08791e23d1e5e83 100644 (file)
--- a/man1/localedef.1
+++ b/man1/localedef.1
@@ -50,7 +50,7 @@ localedef \- compile locale definition files
 .br
 .B "localedef \-\-add\-to\-archive"
 .RI [ options ]
-.IR compiledpath
+.I compiledpath
 .br
 .B "localedef \-\-version"
 .br

diff --git a/man1/memusage.1 b/man1/memusage.1
index e87e507c9665b362e96227695809fd1f2d9cf52a..44c676f937cc68f94144c91292ccf7fb4e81ea28 100644 (file)
--- a/man1/memusage.1
+++ b/man1/memusage.1
@@ -61,7 +61,7 @@ to create a PNG file containing graphical representation
 of the collected data.
 .SS Memory usage summary
 The "Memory usage summary" line output by
-.BR memusage
+.B memusage
 contains three fields:
 .RS 4
 .TP
@@ -144,7 +144,7 @@ Generate PNG graphic and store it in
 Generate binary data file and store it in
 .IR file .
 .TP
-.BI \-u\fR,\ \fB\-\-unbuffered
+.B \-u\fR,\ \fB\-\-unbuffered
 Do not buffer output.
 .TP
 .BI \-b\  size \fR,\ \fB\-\-buffer= size
@@ -152,33 +152,33 @@ Collect
 .I size
 entries before writing them out.
 .TP
-.BI \fB\-\-no-timer
+.B \fB\-\-no-timer
 Disable timer-based
 .RB ( SIGPROF )
 sampling of stack pointer value.
 .TP
-.BI \-m\fR,\ \fB\-\-mmap
+.B \-m\fR,\ \fB\-\-mmap
 Also trace
 .BR mmap (2),
 .BR mremap (2),
 and
 .BR munmap (2).
 .TP
-.BI \-?\fR,\ \fB\-\-help
+.B \-?\fR,\ \fB\-\-help
 Print help and exit.
 .TP
-.BI \fB\-\-usage
+.B \-\-usage
 Print a short usage message and exit.
 .TP
-.BI \-V\fR,\ \fB\-\-version
+.B \-V\fR,\ \fB\-\-version
 Print version information and exit.
 .TP
 The following options apply only when generating graphical output:
 .TP
-.BI \-t\fR,\ \fB\-\-time\-based
+.B \-t\fR,\ \fB\-\-time\-based
 Use time (rather than number of function calls) as the scale for the X axis.
 .TP
-.BI \-T\fR,\ \fB\-\-total
+.B \-T\fR,\ \fB\-\-total
 Also draw a graph of total memory use.
 .TP
 .BI \fB\-\-title= name

diff --git a/man1/memusagestat.1 b/man1/memusagestat.1
index 21cd5d4b65d834c0983a65677fe2e661399ea106..87883f062daad23d12fe8a1cfce6b71b244ced7a 100644 (file)
--- a/man1/memusagestat.1
+++ b/man1/memusagestat.1
@@ -54,10 +54,10 @@ Use
 .I string
 as the title inside the output graph.
 .TP
-.BI \-t\fR,\ \fB\-\-time
+.B \-t\fR,\ \fB\-\-time
 Use time (rather than number of function calls) as the scale for the X axis.
 .TP
-.BI \-T\fR,\ \fB\-\-total
+.B \-T\fR,\ \fB\-\-total
 Also draw a graph of total memory consumption.
 .TP
 .BI \-x\  size \fR,\ \fB\-\-x-size= size
@@ -70,13 +70,13 @@ Make the output graph
 .I size
 pixels high.
 .TP
-.BI \-?\fR,\ \fB\-\-help
+.B \-?\fR,\ \fB\-\-help
 Print a help message and exit.
 .TP
-.BI \fB\-\-usage
+.B \-\-usage
 Print a short usage message and exit.
 .TP
-.BI \-V\fR,\ \fB\-\-version
+.B \-V\fR,\ \fB\-\-version
 Print version information and exit.
 .SH BUGS
 To report bugs, see

diff --git a/man1/pldd.1 b/man1/pldd.1
index 4e4501251bd48b30f69ef12832969937f84386b5..6957c8d604ee9575aa74cc49ae91df191ff7ecde 100644 (file)
--- a/man1/pldd.1
+++ b/man1/pldd.1
@@ -42,7 +42,7 @@ The list includes the libraries that have been dynamically loaded using
 .BR \-? ", " \-\-help
 Display program help message.
 .TP
-.BR \-\-usage
+.B \-\-usage
 Display a short usage message.
 .TP
 .BR \-V ", " \-\-version
@@ -85,7 +85,7 @@ The
 .I "info shared"
 command also shows the shared libraries being used by a process,
 so that one can obtain similar output to
-.BR pldd
+.B pldd
 using a command such as the following
 (to monitor the process with the specified
 .IR pid ):

diff --git a/man1/sprof.1 b/man1/sprof.1
index 900190d4ab579c8f7ea99431c5efe08d692367ac..9e40f7d424fd71b95bc3d36a0cd56f27d70b0f45 100644 (file)
--- a/man1/sprof.1
+++ b/man1/sprof.1
@@ -41,7 +41,7 @@ If the profiling data pathname is omitted, then
 .B sprof
 will attempt to deduce it using the soname of the shared object,
 looking for a file with the name
-.IR <soname>.profile
+.I <soname>.profile
 in the current directory.
 .SH OPTIONS
 The following command-line options specify the profile output
@@ -67,7 +67,7 @@ The following additional command-line options are available:
 .BR \-? ", " \-\-help
 Display a summary of command-line options and arguments and exit.
 .TP
-.BR \-\-usage
+.B \-\-usage
 Display a short usage message and exit.
 .TP
 .BR \-V ", " \-\-version
@@ -102,9 +102,9 @@ main(int argc, char *argv[])
 .in
 .PP
 The functions
-.IR x1()
+.IR x1 ()
 and
-.IR x2()
+.IR x2 ()
 are defined in the following source file that is used to
 construct the shared object:
 .PP
@@ -188,7 +188,7 @@ $ \fBldd prog\fP
 .PP
 In order to get profiling information for the shared object,
 we define the environment variable
-.BR LD_PROFILE
+.B LD_PROFILE
 with the soname of the library:
 .PP
 .in +4n
@@ -198,7 +198,7 @@ $ \fBexport LD_PROFILE=libdemo.so.1\fP
 .in
 .PP
 We then define the environment variable
-.BR LD_PROFILE_OUTPUT
+.B LD_PROFILE_OUTPUT
 with the pathname of the directory where profile output should be written,
 and create that directory if it does not exist already:
 .PP
@@ -234,7 +234,7 @@ libdemo.so.1.profile
 .in
 .PP
 We then use the
-.BR "sprof \-p"
+.B sprof \-p
 option to generate a flat profile with counts and ticks:
 .PP
 .in +4n
@@ -253,7 +253,7 @@ Each sample counts as 0.01 seconds.
 .in
 .PP
 The
-.BR "sprof \-q"
+.B sprof \-q
 option generates a call graph:
 .PP
 .in +4n
@@ -284,7 +284,7 @@ are outside of the profiled object (in this example, these are instances of
 .IR main() ).
 .PP
 The
-.BR "sprof \-c"
+.B sprof \-c
 option generates a list of call pairs and the number of their occurrences:
 .PP
 .in +4n

diff --git a/man1/time.1 b/man1/time.1
index a5456581a4a19507b22ef4dcc3836dc68218e930..6e739e03ff4941291e45dfb8eb483fd52530589d 100644 (file)
--- a/man1/time.1
+++ b/man1/time.1
@@ -82,7 +82,7 @@ The variables
 .BR LC_MESSAGES ,
 .BR LC_NUMERIC ,
 and
-.BR NLSPATH
+.B NLSPATH
 are used for the text and formatting of the output.
 .B PATH
 is used to search for