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
|
.SH NAME
|
||||||
getent \- get entries from Name Service Switch libraries
|
getent \- get entries from Name Service Switch libraries
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.BR getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
|
.B getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
The
|
The
|
||||||
.B getent
|
.B getent
|
||||||
|
|
|
@ -66,14 +66,14 @@ Use
|
||||||
for output characters.
|
for output characters.
|
||||||
.IP
|
.IP
|
||||||
If the string
|
If the string
|
||||||
.BR //IGNORE
|
.B //IGNORE
|
||||||
is appended to
|
is appended to
|
||||||
.IR to-encoding ,
|
.IR to-encoding ,
|
||||||
characters that cannot be converted are discarded and an error is
|
characters that cannot be converted are discarded and an error is
|
||||||
printed after conversion.
|
printed after conversion.
|
||||||
.IP
|
.IP
|
||||||
If the string
|
If the string
|
||||||
.BR //TRANSLIT
|
.B //TRANSLIT
|
||||||
is appended to
|
is appended to
|
||||||
.IR to-encoding ,
|
.IR to-encoding ,
|
||||||
characters being converted are transliterated when needed and possible.
|
characters being converted are transliterated when needed and possible.
|
||||||
|
@ -150,7 +150,7 @@ the system gconv module configuration cache is not used.
|
||||||
Instead,
|
Instead,
|
||||||
.BR iconv_open (3)
|
.BR iconv_open (3)
|
||||||
first tries to load the configuration files by searching the directories in
|
first tries to load the configuration files by searching the directories in
|
||||||
.BR GCONV_PATH
|
.B GCONV_PATH
|
||||||
in order,
|
in order,
|
||||||
followed by the system default gconv module configuration file.
|
followed by the system default gconv module configuration file.
|
||||||
If a directory does not contain a 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))
|
.BR ld.so (8))
|
||||||
and load the objects that satisfy those dependencies.
|
and load the objects that satisfy those dependencies.
|
||||||
For each dependency,
|
For each dependency,
|
||||||
.BR ldd
|
.B ldd
|
||||||
displays the location of the matching object
|
displays the location of the matching object
|
||||||
and the (hexadecimal) address at which it is loaded.
|
and the (hexadecimal) address at which it is loaded.
|
||||||
(The
|
(The
|
||||||
|
@ -73,7 +73,7 @@ Be aware that in some circumstances
|
||||||
.\" Much more detail at
|
.\" Much more detail at
|
||||||
.\" http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
|
.\" http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
|
||||||
some versions of
|
some versions of
|
||||||
.BR ldd
|
.B ldd
|
||||||
may attempt to obtain the dependency information
|
may attempt to obtain the dependency information
|
||||||
by attempting to directly execute the program,
|
by attempting to directly execute the program,
|
||||||
which may lead to the execution of whatever code is defined
|
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
|
or
|
||||||
.IR decimal_point )
|
.IR decimal_point )
|
||||||
or locale categories (for example,
|
or locale categories (for example,
|
||||||
.BR LC_CTYPE
|
.B LC_CTYPE
|
||||||
or
|
or
|
||||||
.BR LC_TIME ).
|
.BR LC_TIME ).
|
||||||
For each argument, the following is displayed:
|
For each argument, the following is displayed:
|
||||||
|
@ -122,7 +122,7 @@ combinations.
|
||||||
.BR \-? ", " \-\-help
|
.BR \-? ", " \-\-help
|
||||||
Display a summary of command-line options and arguments and exit.
|
Display a summary of command-line options and arguments and exit.
|
||||||
.TP
|
.TP
|
||||||
.BR \-\-usage
|
.B \-\-usage
|
||||||
Display a short usage message and exit.
|
Display a short usage message and exit.
|
||||||
.TP
|
.TP
|
||||||
.BR \-V ", " \-\-version
|
.BR \-V ", " \-\-version
|
||||||
|
|
|
@ -50,7 +50,7 @@ localedef \- compile locale definition files
|
||||||
.br
|
.br
|
||||||
.B "localedef \-\-add\-to\-archive"
|
.B "localedef \-\-add\-to\-archive"
|
||||||
.RI [ options ]
|
.RI [ options ]
|
||||||
.IR compiledpath
|
.I compiledpath
|
||||||
.br
|
.br
|
||||||
.B "localedef \-\-version"
|
.B "localedef \-\-version"
|
||||||
.br
|
.br
|
||||||
|
|
|
@ -61,7 +61,7 @@ to create a PNG file containing graphical representation
|
||||||
of the collected data.
|
of the collected data.
|
||||||
.SS Memory usage summary
|
.SS Memory usage summary
|
||||||
The "Memory usage summary" line output by
|
The "Memory usage summary" line output by
|
||||||
.BR memusage
|
.B memusage
|
||||||
contains three fields:
|
contains three fields:
|
||||||
.RS 4
|
.RS 4
|
||||||
.TP
|
.TP
|
||||||
|
@ -144,7 +144,7 @@ Generate PNG graphic and store it in
|
||||||
Generate binary data file and store it in
|
Generate binary data file and store it in
|
||||||
.IR file .
|
.IR file .
|
||||||
.TP
|
.TP
|
||||||
.BI \-u\fR,\ \fB\-\-unbuffered
|
.B \-u\fR,\ \fB\-\-unbuffered
|
||||||
Do not buffer output.
|
Do not buffer output.
|
||||||
.TP
|
.TP
|
||||||
.BI \-b\ size \fR,\ \fB\-\-buffer= size
|
.BI \-b\ size \fR,\ \fB\-\-buffer= size
|
||||||
|
@ -152,33 +152,33 @@ Collect
|
||||||
.I size
|
.I size
|
||||||
entries before writing them out.
|
entries before writing them out.
|
||||||
.TP
|
.TP
|
||||||
.BI \fB\-\-no-timer
|
.B \fB\-\-no-timer
|
||||||
Disable timer-based
|
Disable timer-based
|
||||||
.RB ( SIGPROF )
|
.RB ( SIGPROF )
|
||||||
sampling of stack pointer value.
|
sampling of stack pointer value.
|
||||||
.TP
|
.TP
|
||||||
.BI \-m\fR,\ \fB\-\-mmap
|
.B \-m\fR,\ \fB\-\-mmap
|
||||||
Also trace
|
Also trace
|
||||||
.BR mmap (2),
|
.BR mmap (2),
|
||||||
.BR mremap (2),
|
.BR mremap (2),
|
||||||
and
|
and
|
||||||
.BR munmap (2).
|
.BR munmap (2).
|
||||||
.TP
|
.TP
|
||||||
.BI \-?\fR,\ \fB\-\-help
|
.B \-?\fR,\ \fB\-\-help
|
||||||
Print help and exit.
|
Print help and exit.
|
||||||
.TP
|
.TP
|
||||||
.BI \fB\-\-usage
|
.B \-\-usage
|
||||||
Print a short usage message and exit.
|
Print a short usage message and exit.
|
||||||
.TP
|
.TP
|
||||||
.BI \-V\fR,\ \fB\-\-version
|
.B \-V\fR,\ \fB\-\-version
|
||||||
Print version information and exit.
|
Print version information and exit.
|
||||||
.TP
|
.TP
|
||||||
The following options apply only when generating graphical output:
|
The following options apply only when generating graphical output:
|
||||||
.TP
|
.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.
|
Use time (rather than number of function calls) as the scale for the X axis.
|
||||||
.TP
|
.TP
|
||||||
.BI \-T\fR,\ \fB\-\-total
|
.B \-T\fR,\ \fB\-\-total
|
||||||
Also draw a graph of total memory use.
|
Also draw a graph of total memory use.
|
||||||
.TP
|
.TP
|
||||||
.BI \fB\-\-title= name
|
.BI \fB\-\-title= name
|
||||||
|
|
|
@ -54,10 +54,10 @@ Use
|
||||||
.I string
|
.I string
|
||||||
as the title inside the output graph.
|
as the title inside the output graph.
|
||||||
.TP
|
.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.
|
Use time (rather than number of function calls) as the scale for the X axis.
|
||||||
.TP
|
.TP
|
||||||
.BI \-T\fR,\ \fB\-\-total
|
.B \-T\fR,\ \fB\-\-total
|
||||||
Also draw a graph of total memory consumption.
|
Also draw a graph of total memory consumption.
|
||||||
.TP
|
.TP
|
||||||
.BI \-x\ size \fR,\ \fB\-\-x-size= size
|
.BI \-x\ size \fR,\ \fB\-\-x-size= size
|
||||||
|
@ -70,13 +70,13 @@ Make the output graph
|
||||||
.I size
|
.I size
|
||||||
pixels high.
|
pixels high.
|
||||||
.TP
|
.TP
|
||||||
.BI \-?\fR,\ \fB\-\-help
|
.B \-?\fR,\ \fB\-\-help
|
||||||
Print a help message and exit.
|
Print a help message and exit.
|
||||||
.TP
|
.TP
|
||||||
.BI \fB\-\-usage
|
.B \-\-usage
|
||||||
Print a short usage message and exit.
|
Print a short usage message and exit.
|
||||||
.TP
|
.TP
|
||||||
.BI \-V\fR,\ \fB\-\-version
|
.B \-V\fR,\ \fB\-\-version
|
||||||
Print version information and exit.
|
Print version information and exit.
|
||||||
.SH BUGS
|
.SH BUGS
|
||||||
To report bugs, see
|
To report bugs, see
|
||||||
|
|
|
@ -42,7 +42,7 @@ The list includes the libraries that have been dynamically loaded using
|
||||||
.BR \-? ", " \-\-help
|
.BR \-? ", " \-\-help
|
||||||
Display program help message.
|
Display program help message.
|
||||||
.TP
|
.TP
|
||||||
.BR \-\-usage
|
.B \-\-usage
|
||||||
Display a short usage message.
|
Display a short usage message.
|
||||||
.TP
|
.TP
|
||||||
.BR \-V ", " \-\-version
|
.BR \-V ", " \-\-version
|
||||||
|
@ -85,7 +85,7 @@ The
|
||||||
.I "info shared"
|
.I "info shared"
|
||||||
command also shows the shared libraries being used by a process,
|
command also shows the shared libraries being used by a process,
|
||||||
so that one can obtain similar output to
|
so that one can obtain similar output to
|
||||||
.BR pldd
|
.B pldd
|
||||||
using a command such as the following
|
using a command such as the following
|
||||||
(to monitor the process with the specified
|
(to monitor the process with the specified
|
||||||
.IR pid ):
|
.IR pid ):
|
||||||
|
|
14
man1/sprof.1
14
man1/sprof.1
|
@ -41,7 +41,7 @@ If the profiling data pathname is omitted, then
|
||||||
.B sprof
|
.B sprof
|
||||||
will attempt to deduce it using the soname of the shared object,
|
will attempt to deduce it using the soname of the shared object,
|
||||||
looking for a file with the name
|
looking for a file with the name
|
||||||
.IR <soname>.profile
|
.I <soname>.profile
|
||||||
in the current directory.
|
in the current directory.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The following command-line options specify the profile output
|
The following command-line options specify the profile output
|
||||||
|
@ -67,7 +67,7 @@ The following additional command-line options are available:
|
||||||
.BR \-? ", " \-\-help
|
.BR \-? ", " \-\-help
|
||||||
Display a summary of command-line options and arguments and exit.
|
Display a summary of command-line options and arguments and exit.
|
||||||
.TP
|
.TP
|
||||||
.BR \-\-usage
|
.B \-\-usage
|
||||||
Display a short usage message and exit.
|
Display a short usage message and exit.
|
||||||
.TP
|
.TP
|
||||||
.BR \-V ", " \-\-version
|
.BR \-V ", " \-\-version
|
||||||
|
@ -188,7 +188,7 @@ $ \fBldd prog\fP
|
||||||
.PP
|
.PP
|
||||||
In order to get profiling information for the shared object,
|
In order to get profiling information for the shared object,
|
||||||
we define the environment variable
|
we define the environment variable
|
||||||
.BR LD_PROFILE
|
.B LD_PROFILE
|
||||||
with the soname of the library:
|
with the soname of the library:
|
||||||
.PP
|
.PP
|
||||||
.in +4n
|
.in +4n
|
||||||
|
@ -198,7 +198,7 @@ $ \fBexport LD_PROFILE=libdemo.so.1\fP
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
We then define the environment variable
|
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,
|
with the pathname of the directory where profile output should be written,
|
||||||
and create that directory if it does not exist already:
|
and create that directory if it does not exist already:
|
||||||
.PP
|
.PP
|
||||||
|
@ -234,7 +234,7 @@ libdemo.so.1.profile
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
We then use the
|
We then use the
|
||||||
.BR "sprof \-p"
|
.B sprof \-p
|
||||||
option to generate a flat profile with counts and ticks:
|
option to generate a flat profile with counts and ticks:
|
||||||
.PP
|
.PP
|
||||||
.in +4n
|
.in +4n
|
||||||
|
@ -253,7 +253,7 @@ Each sample counts as 0.01 seconds.
|
||||||
.in
|
.in
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR "sprof \-q"
|
.B sprof \-q
|
||||||
option generates a call graph:
|
option generates a call graph:
|
||||||
.PP
|
.PP
|
||||||
.in +4n
|
.in +4n
|
||||||
|
@ -284,7 +284,7 @@ are outside of the profiled object (in this example, these are instances of
|
||||||
.IR main() ).
|
.IR main() ).
|
||||||
.PP
|
.PP
|
||||||
The
|
The
|
||||||
.BR "sprof \-c"
|
.B sprof \-c
|
||||||
option generates a list of call pairs and the number of their occurrences:
|
option generates a list of call pairs and the number of their occurrences:
|
||||||
.PP
|
.PP
|
||||||
.in +4n
|
.in +4n
|
||||||
|
|
|
@ -82,7 +82,7 @@ The variables
|
||||||
.BR LC_MESSAGES ,
|
.BR LC_MESSAGES ,
|
||||||
.BR LC_NUMERIC ,
|
.BR LC_NUMERIC ,
|
||||||
and
|
and
|
||||||
.BR NLSPATH
|
.B NLSPATH
|
||||||
are used for the text and formatting of the output.
|
are used for the text and formatting of the output.
|
||||||
.B PATH
|
.B PATH
|
||||||
is used to search for
|
is used to search for
|
||||||
|
|
Loading…
Reference in New Issue