summaryrefslogtreecommitdiffstats
path: root/man1
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2023-10-31 01:28:55 +0100
committerAlejandro Colomar <alx@kernel.org>2023-10-31 01:37:57 +0100
commitc6d039a3a6edcffa325c584d9942fc64560c32e1 (patch)
treefe4ac58f924a952635fa4018af95db9d8f64ec62 /man1
parent019aad50584289476a9f206adf074326e106713d (diff)
man*/: srcfix (Use .P instead of .PP or .LP)
We're trying to "standardize" on a paragraphing macro from the three equivalent ones (P, PP, LP). We (somewhat arbitrarily) agreed on P. Scripted change: $ find man* -type f | xargs sed -i '/\.PP/s/PP/P/' $ find man* -type f | xargs sed -i '/\.LP/s/LP/P/' Suggested-by: "G. Branden Robinson" <branden@debian.org> Cc: Ingo Schwarze <schwarze@openbsd.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man1')
-rw-r--r--man1/getent.12
-rw-r--r--man1/iconv.110
-rw-r--r--man1/intro.142
-rw-r--r--man1/ldd.114
-rw-r--r--man1/locale.124
-rw-r--r--man1/localedef.112
-rw-r--r--man1/memusage.18
-rw-r--r--man1/memusagestat.12
-rw-r--r--man1/mtrace.12
-rw-r--r--man1/pldd.18
-rw-r--r--man1/sprof.152
-rw-r--r--man1/time.128
12 files changed, 102 insertions, 102 deletions
diff --git a/man1/getent.1 b/man1/getent.1
index 6a599c676..b4752f534 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -25,7 +25,7 @@ Otherwise, if no
.I key
is provided, all entries will be displayed (unless the database does not
support enumeration).
-.PP
+.P
The
.I database
may be any of those supported by the GNU C Library, listed below:
diff --git a/man1/iconv.1 b/man1/iconv.1
index 14ee488b1..8dcce9262 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -22,7 +22,7 @@ reads from standard input.
If no output file is given,
.B iconv
writes to standard output.
-.PP
+.P
If no
.I from-encoding
is given, the default is derived
@@ -169,7 +169,7 @@ Usual system default gconv module configuration file.
.TP
.I /usr/lib/gconv/gconv\-modules.cache
Usual system gconv module configuration cache.
-.PP
+.P
Depending on the architecture,
the above files may instead be located at directories with the path prefix
.IR /usr/lib64 .
@@ -179,16 +179,16 @@ POSIX.1-2008.
POSIX.1-2001.
.SH EXAMPLES
Convert text from the ISO 8859-15 character encoding to UTF-8:
-.PP
+.P
.in +4n
.EX
$ \fBiconv \-f ISO\-8859\-15 \-t UTF\-8 < input.txt > output.txt\fP
.EE
.in
-.PP
+.P
The next example converts from UTF-8 to ASCII, transliterating when
possible:
-.PP
+.P
.in +4n
.EX
$ \fBecho abc ß α € àḃç | iconv \-f UTF\-8 \-t ASCII//TRANSLIT\fP
diff --git a/man1/intro.1 b/man1/intro.1
index 78cd46610..decaab161 100644
--- a/man1/intro.1
+++ b/man1/intro.1
@@ -13,7 +13,7 @@ web browsers, file and image viewers and editors, and so on.
Linux is a flavor of UNIX, and as a first approximation
all user commands under UNIX work precisely the same under
Linux (and FreeBSD and lots of other UNIX-like systems).
-.PP
+.P
Under Linux, there are GUIs (graphical user interfaces), where you
can point and click and drag, and hopefully get work done without
first reading lots of documentation.
@@ -52,9 +52,9 @@ See also
.BR dash (1),
.BR ksh (1),
.BR zsh (1).
-.PP
+.P
A session might go like:
-.PP
+.P
.in +4n
.EX
.RB "knuth login: " aeb
@@ -98,9 +98,9 @@ maja 0501\-1136285
$
.EE
.in
-.PP
+.P
Here typing Control-D ended the session.
-.PP
+.P
The
.B $
here was the command prompt\[em]it is the shell's way of indicating
@@ -110,13 +110,13 @@ in lots of ways, and one might include stuff like username,
machine name, current directory, time, and so on.
An assignment PS1="What next, master? "
would change the prompt as indicated.
-.PP
+.P
We see that there are commands
.I date
(that gives date and time), and
.I cal
(that gives a calendar).
-.PP
+.P
The command
.I ls
lists the contents of the current directory\[em]it tells you what
@@ -132,7 +132,7 @@ Owner and permissions can be changed by the commands
.I chown
and
.IR chmod .
-.PP
+.P
The command
.I cat
will show the contents of a file.
@@ -142,26 +142,26 @@ parameters are concatenated and sent to "standard output"
.BR stdout (3)),
here
the terminal screen.)
-.PP
+.P
The command
.I cp
(from "copy") will copy a file.
-.PP
+.P
The command
.I mv
(from "move"), on the other hand, only renames it.
-.PP
+.P
The command
.I diff
lists the differences between two files.
Here there was no output because there were no differences.
-.PP
+.P
The command
.I rm
(from "remove") deletes the file, and be careful! it is gone.
No wastepaper basket or anything.
Deleted means lost.
-.PP
+.P
The command
.I grep
(from "g/re/p") finds occurrences of a string in one or more files.
@@ -185,15 +185,15 @@ to
.I tel
when the current directory is
.IR /home/aeb .
-.PP
+.P
The command
.I pwd
prints the current directory.
-.PP
+.P
The command
.I cd
changes the current directory.
-.PP
+.P
Try alternatively
.I cd
and
@@ -205,11 +205,11 @@ usage: "cd", "cd .", "cd ..", "cd /", and "cd \[ti]".
The command
.I mkdir
makes a new directory.
-.PP
+.P
The command
.I rmdir
removes a directory if it is empty, and complains otherwise.
-.PP
+.P
The command
.I find
(with a rather baroque syntax) will find files with given name
@@ -266,7 +266,7 @@ sends the text through some
usually
.IR less .
Hit the space bar to get the next page, hit q to quit.
-.PP
+.P
In documentation it is customary to refer to man pages
by giving the name and section number, as in
.BR man (1).
@@ -274,12 +274,12 @@ Man pages are terse, and allow you to find quickly some forgotten
detail.
For newcomers an introductory text with more examples
and explanations is useful.
-.PP
+.P
A lot of GNU/FSF software is provided with info files.
Type "info info"
for an introduction on the use of the program
.IR info .
-.PP
+.P
Special topics are often treated in HOWTOs.
Look in
.I /usr/share/doc/howto/en
diff --git a/man1/ldd.1 b/man1/ldd.1
index 87a2c9d34..57e9b40eb 100644
--- a/man1/ldd.1
+++ b/man1/ldd.1
@@ -21,7 +21,7 @@ prints the shared objects (shared libraries) required by each program or
shared object specified on the command line.
An example of its use and output
is the following:
-.PP
+.P
.in +4n
.EX
$ \fBldd /bin/ls\fP
@@ -36,7 +36,7 @@ $ \fBldd /bin/ls\fP
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007f87e45fa000)
.EE
.in
-.PP
+.P
In the usual case,
.B ldd
invokes the standard dynamic linker (see
@@ -89,7 +89,7 @@ the upstream
.B ldd
implementation did this for example,
although most distributions provided a modified version that did not.)
-.PP
+.P
Thus, you should
.I never
employ
@@ -97,13 +97,13 @@ employ
on an untrusted executable,
since this may result in the execution of arbitrary code.
A safer alternative when dealing with untrusted executables is:
-.PP
+.P
.in +4n
.EX
$ \fBobjdump \-p /path/to/program | grep NEEDED\fP
.EE
.in
-.PP
+.P
Note, however, that this alternative shows only the direct dependencies
of the executable, while
.B ldd
@@ -150,7 +150,7 @@ Usage information.
.\" .B \-V
.\" and only has the equivalent
.\" .BR \-\-version .
-.\" .LP
+.\" .P
.\" The libc5 version of this program will use the name of a library given
.\" on the command line as-is when it contains a \[aq]/\[aq]; otherwise it
.\" searches for the library in the standard locations.
@@ -159,7 +159,7 @@ Usage information.
.SH BUGS
.B ldd
does not work on a.out shared libraries.
-.PP
+.P
.B ldd
does not work with some extremely old a.out programs which were
built before
diff --git a/man1/locale.1 b/man1/locale.1
index 2579dd19f..8c26f831c 100644
--- a/man1/locale.1
+++ b/man1/locale.1
@@ -17,7 +17,7 @@ The
.B locale
command displays information about the current locale, or all locales,
on standard output.
-.PP
+.P
When invoked without arguments,
.B locale
displays the current locale settings for each locale category (see
@@ -27,7 +27,7 @@ based on the settings of the environment variables that control the locale
.BR locale (7)).
Values for variables set in the environment are printed without double
quotes, implied values are printed with double quotes.
-.PP
+.P
If either the
.B \-a
or the
@@ -51,7 +51,7 @@ metadata about each locale to be included in the output.
Display the available charmaps (character set description files).
To display the current character set for the locale, use
\fBlocale \-c charmap\fR.
-.PP
+.P
The
.B locale
command can also be provided with one or more arguments,
@@ -71,7 +71,7 @@ For a locale keyword, the value of that keyword to be displayed.
.IP \[bu]
For a locale category,
the values of all keywords in that category are displayed.
-.PP
+.P
When arguments are supplied, the following options are meaningful:
.TP
.B \-\-category\-name
@@ -102,7 +102,7 @@ so that the output has the format:
.IR keyword =\[dq] value \[dq]
.EE
.in
-.PP
+.P
The
.B locale
command also knows about the following options:
@@ -153,24 +153,24 @@ LC_TELEPHONE="en_US.UTF\-8"
LC_MEASUREMENT="en_US.UTF\-8"
LC_IDENTIFICATION="en_US.UTF\-8"
LC_ALL=
-.PP
+.P
$ \fBlocale date_fmt\fP
%a %b %e %H:%M:%S %Z %Y
-.PP
+.P
$ \fBlocale \-k date_fmt\fP
date_fmt="%a %b %e %H:%M:%S %Z %Y"
-.PP
+.P
$ \fBlocale \-ck date_fmt\fP
LC_TIME
date_fmt="%a %b %e %H:%M:%S %Z %Y"
-.PP
+.P
$ \fBlocale LC_TELEPHONE\fP
+%c (%a) %l
(%a) %l
11
1
UTF\-8
-.PP
+.P
$ \fBlocale \-k LC_TELEPHONE\fP
tel_int_fmt="+%c (%a) %l"
tel_dom_fmt="(%a) %l"
@@ -178,7 +178,7 @@ int_select="11"
int_prefix="1"
telephone\-codeset="UTF\-8"
.EE
-.PP
+.P
The following example compiles a custom locale from the
.I ./wrk
directory with the
@@ -193,7 +193,7 @@ and
.B LANG
in the shell profile file so that the custom locale will be used in the
subsequent user sessions:
-.PP
+.P
.EX
$ \fBmkdir \-p $HOME/.locale\fP
$ \fBI18NPATH=./wrk/ localedef \-f UTF\-8 \-i fi_SE $HOME/.locale/fi_SE.UTF\-8\fP
diff --git a/man1/localedef.1 b/man1/localedef.1
index 34f04fcff..6a7877089 100644
--- a/man1/localedef.1
+++ b/man1/localedef.1
@@ -58,7 +58,7 @@ locale functions in the C library
etc.),
and places the output in
.IR outputpath .
-.PP
+.P
The
.I outputpath
argument is interpreted as follows:
@@ -92,12 +92,12 @@ system-provided locales;
it is used by all localized programs when the environment variable
.B LOCPATH
is not set.
-.PP
+.P
In any case,
.B localedef
aborts if the directory in which it tries to write locale files has
not already been created.
-.PP
+.P
If no
.I charmapfile
is given,
@@ -386,13 +386,13 @@ POSIX.1-2008.
Compile the locale files for Finnish in the UTF\-8 character set
and add it to the default locale archive with the name
.BR fi_FI.UTF\-8 :
-.PP
+.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI fi_FI.UTF\-8
.EE
.in
-.PP
+.P
The next example does the same thing,
but generates files into the
.I fi_FI.UTF\-8
@@ -401,7 +401,7 @@ variable
.B LOCPATH
is set to the current directory (note that the last argument must
contain a slash):
-.PP
+.P
.in +4n
.EX
localedef \-f UTF\-8 \-i fi_FI ./fi_FI.UTF\-8
diff --git a/man1/memusage.1 b/man1/memusage.1
index aeca54bb0..b6793f6e8 100644
--- a/man1/memusage.1
+++ b/man1/memusage.1
@@ -33,7 +33,7 @@ optionally, calls to
and
.BR munmap (2)
can also be intercepted.
-.PP
+.P
.B memusage
can output the collected data in textual form, or it can use
.BR memusagestat (1)
@@ -86,7 +86,7 @@ After each function call, the actual stack pointer address is read and
the difference from the base stack pointer computed.
The maximum of these differences is then the stack peak.
.RE
-.PP
+.P
Immediately following this summary line, a table shows the number calls,
total memory allocated or deallocated,
and number of failed calls for each intercepted function.
@@ -102,7 +102,7 @@ For
.BR realloc (3),
the additional field "free" shows reallocations that
caused a block to be freed (i.e., the reallocated size was 0).
-.PP
+.P
The "realloc/total memory" of the table output by
.B memusage
does not reflect cases where
@@ -193,7 +193,7 @@ reallocating the memory in smaller blocks that return to zero.
After compiling the program and running the following commands,
a graph of the memory usage of the program can be found in the file
.IR memusage.png :
-.PP
+.P
.in +4n
.EX
$ \fBmemusage \-\-data=memusage.dat ./a.out\fP
diff --git a/man1/memusagestat.1 b/man1/memusagestat.1
index 5559ade69..4825ca67f 100644
--- a/man1/memusagestat.1
+++ b/man1/memusagestat.1
@@ -19,7 +19,7 @@ that file is generated via the
.IR \-\-data )
option of
.BR memusage (1).
-.PP
+.P
The red line in the graph shows the heap usage (allocated memory)
and the green line shows the stack usage.
The x-scale is either the number of memory-handling function calls or
diff --git a/man1/mtrace.1 b/man1/mtrace.1
index 54c13ccf8..7b802837a 100644
--- a/man1/mtrace.1
+++ b/man1/mtrace.1
@@ -24,7 +24,7 @@ for problem locations
(assuming that
.I binary
was compiled with debugging information).
-.PP
+.P
For more information about the
.BR mtrace (3)
function and
diff --git a/man1/pldd.1 b/man1/pldd.1
index eb5e91bb3..e0fa32b6e 100644
--- a/man1/pldd.1
+++ b/man1/pldd.1
@@ -52,16 +52,16 @@ None.
glibc 2.15.
.SH NOTES
The command
-.PP
+.P
.in +4n
.EX
lsof \-p PID
.EE
.in
-.PP
+.P
also shows output that includes the dynamic shared objects
that are linked into a process.
-.PP
+.P
The
.BR gdb (1)
.I "info shared"
@@ -71,7 +71,7 @@ so that one can obtain similar output to
using a command such as the following
(to monitor the process with the specified
.IR pid ):
-.PP
+.P
.in +4n
.EX
$ \fBgdb \-ex "set confirm off" \-ex "set height 0" \-ex "info shared" \e\fP
diff --git a/man1/sprof.1 b/man1/sprof.1
index b86735443..a6eb7ad3c 100644
--- a/man1/sprof.1
+++ b/man1/sprof.1
@@ -44,10 +44,10 @@ with counts and ticks.
.TQ
.B \-q
Generate a call graph.
-.PP
+.P
If none of the above options is specified,
then the default behavior is to display a flat profile and a call graph.
-.PP
+.P
The following additional command-line options are available:
.TP
.B \-\-help
@@ -70,7 +70,7 @@ The following example demonstrates the use of
The example consists of a main program that calls two functions
in a shared object.
First, the code of the main program:
-.PP
+.P
.in +4n
.EX
$ \fBcat prog.c\fP
@@ -88,14 +88,14 @@ main(int argc, char *argv[])
}
.EE
.in
-.PP
+.P
The functions
.IR x1 ()
and
.IR x2 ()
are defined in the following source file that is used to
construct the shared object:
-.PP
+.P
.in +4n
.EX
$ \fBcat libdemo.c\fP
@@ -129,32 +129,32 @@ x2(void)
}
.EE
.in
-.PP
+.P
Now we construct the shared object with the real name
.IR libdemo.so.1.0.1 ,
and the soname
.IR libdemo.so.1 :
-.PP
+.P
.in +4n
.EX
$ \fBcc \-g \-fPIC \-shared \-Wl,\-soname,libdemo.so.1 \e\fP
\fB\-o libdemo.so.1.0.1 libdemo.c\fP
.EE
.in
-.PP
+.P
Then we construct symbolic links for the library soname and
the library linker name:
-.PP
+.P
.in +4n
.EX
$ \fBln \-sf libdemo.so.1.0.1 libdemo.so.1\fP
$ \fBln \-sf libdemo.so.1 libdemo.so\fP
.EE
.in
-.PP
+.P
Next, we compile the main program, linking it against the shared object,
and then list the dynamic dependencies of the program:
-.PP
+.P
.in +4n
.EX
$ \fBcc \-g \-o prog prog.c \-L. \-ldemo\fP
@@ -165,46 +165,46 @@ $ \fBldd prog\fP
/lib64/ld\-linux\-x86\-64.so.2 (0x00007fd4dc51f000)
.EE
.in
-.PP
+.P
In order to get profiling information for the shared object,
we define the environment variable
.B LD_PROFILE
with the soname of the library:
-.PP
+.P
.in +4n
.EX
$ \fBexport LD_PROFILE=libdemo.so.1\fP
.EE
.in
-.PP
+.P
We then define the environment variable
.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
+.P
.in +4n
.EX
$ \fBexport LD_PROFILE_OUTPUT=$(pwd)/prof_data\fP
$ \fBmkdir \-p $LD_PROFILE_OUTPUT\fP
.EE
.in
-.PP
+.P
.B LD_PROFILE
causes profiling output to be
.I appended
to the output file if it already exists,
so we ensure that there is no preexisting profiling data:
-.PP
+.P
.in +4n
.EX
$ \fBrm \-f $LD_PROFILE_OUTPUT/$LD_PROFILE.profile\fP
.EE
.in
-.PP
+.P
We then run the program to produce the profiling output,
which is written to a file in the directory specified in
.BR LD_PROFILE_OUTPUT :
-.PP
+.P
.in +4n
.EX
$ \fBLD_LIBRARY_PATH=. ./prog\fP
@@ -212,11 +212,11 @@ $ \fBls prof_data\fP
libdemo.so.1.profile
.EE
.in
-.PP
+.P
We then use the
.B sprof \-p
option to generate a flat profile with counts and ticks:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-p libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
@@ -231,11 +231,11 @@ Each sample counts as 0.01 seconds.
0.00 0.10 0.00 1 0.00 x2
.EE
.in
-.PP
+.P
The
.B sprof \-q
option generates a call graph:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-q libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
@@ -258,15 +258,15 @@ index % time self children called name
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.EE
.in
-.PP
+.P
Above and below, the "<UNKNOWN>" strings represent identifiers that
are outside of the profiled object (in this example, these are instances of
.IR main() ).
-.PP
+.P
The
.B sprof \-c
option generates a list of call pairs and the number of their occurrences:
-.PP
+.P
.in +4n
.EX
$ \fBsprof \-c libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile\fP
diff --git a/man1/time.1 b/man1/time.1
index 8902b4b96..9b7efcfd4 100644
--- a/man1/time.1
+++ b/man1/time.1
@@ -40,7 +40,7 @@ values in a
.I "struct tms"
as returned by
.BR times (2)).
-.PP
+.P
Note: some shells (e.g.,
.BR bash (1))
have a built-in
@@ -98,20 +98,20 @@ using the
option or the
.B TIME
environment variable.
-.PP
+.P
The default format string is:
-.PP
+.P
.in +4n
.EX
%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
.EE
.in
-.PP
+.P
When the
.I \-p
option is given, the (portable) output format is used:
-.PP
+.P
.in +4n
.EX
real %e
@@ -133,7 +133,7 @@ The conversions follow.
All of those used by
.BR tcsh (1)
are supported.
-.PP
+.P
.B "Time"
.TP
.B %E
@@ -152,7 +152,7 @@ Total number of CPU-seconds that the process spent in user mode.
.TP
.B %P
Percentage of the CPU that this job got, computed as (%U + %S) / %E.
-.PP
+.P
.B "Memory"
.TP
.B %M
@@ -205,7 +205,7 @@ Number of times the process was context-switched involuntarily
.B %w
Number of waits: times that the program was context-switched voluntarily,
for instance while waiting for an I/O operation to complete.
-.PP
+.P
.B "I/O"
.TP
.B %I
@@ -272,10 +272,10 @@ Not all resources are measured by all versions of UNIX,
so some of the values might be reported as zero.
The present selection was mostly inspired by the data
provided by 4.2 or 4.3BSD.
-.PP
+.P
GNU time version 1.7 is not yet localized.
Thus, it does not implement the POSIX requirements.
-.PP
+.P
The environment variable
.B TIME
was badly chosen.
@@ -287,14 +287,14 @@ to use environment variables with the name of a utility to override
the utility to be used.
Uses like MORE or TIME for options to programs
(instead of program pathnames) tend to lead to difficulties.
-.PP
+.P
It seems unfortunate that
.I \-o
overwrites instead of appends.
(That is, the
.I \-a
option should be the default.)
-.PP
+.P
Mail suggestions and bug reports for GNU
.B time
to
@@ -302,13 +302,13 @@ to
Please include the version of
.BR time ,
which you can get by running
-.PP
+.P
.in +4n
.EX
time \-\-version
.EE
.in
-.PP
+.P
and the operating system
and C compiler you used.
.\" .SH AUTHORS