mirror of https://github.com/mkerrisk/man-pages
getent.1, iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, pldd.1, sprof.1, time.1: tfix, use a one-font macro for a single argument
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>
This commit is contained in:
parent
eadb04edfc
commit
a28b73cda2
|
@ -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
|
||||
|
|
|
@ -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,
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ):
|
||||
|
|
18
man1/sprof.1
18
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
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue