Merge branch 'main' of https://github.com/performancecopilot/pcp

Author: kmcdonell

man/man1/dkvis.1

@@ -41,7 +41,7 @@ The height of the bars is proportional to the activity.
 The user can specify a list of disks as \f2diskid\f1 arguments
 using the disk naming scheme reported by
 .sp 0.5v
-.ft CW
+.ft CR
 .ti 1i
 $ pminfo -f disk.dev.total
 .sp 0.5v

man/man1/mpvis.1

@@ -70,7 +70,7 @@ than one row of CPUs).
 The user can specify a list of CPUs as \f2cpuid\f1 arguments
 using the naming scheme reported by
 .sp 0.5v
-.ft CW
+.ft CR
 .ti 1i
 $ pminfo -f kernel.percpu.cpu.user
 .sp 0.5v

man/man1/pcpintro.1

@@ -152,6 +152,7 @@ There is a set of common command line arguments that are used consistently
 by most PCP tools.
 .TP
 \fB\-a\fR \fIarchive\fR, \fB\-\-archive\fR=\fIarchive\fR
+.RS
 Performance metric information is retrospectively retrieved
 from the set of Performance Co-Pilot (PCP) archives identified by
 .IR archive
@@ -162,7 +163,6 @@ See
 and
 .BR LOGARCHIVE (5)
 for archive creation interfaces and format documentation.
-.RS
 .PP
 .I archive
 is a comma-separated list of names, each
@@ -205,6 +205,7 @@ etc.
 .RE
 .TP
 \fB\-h\fR \fIhost\fR, \fB\-\-host\fR=\fIhost\fR
+.RS
 Unless directed to another host by the
 .B \-h
 (or
@@ -247,8 +248,10 @@ is 0 or
 is not specified, the application
 will sample and report continuously (in real time mode) or until the end
 of the set of PCP archives (in archive mode).
+.RE
 .TP
 \fB\-z\fR, \fB\-\-hostzone\fR
+.RS
 Change the reporting timezone to the local timezone at the
 host that is the source of the performance metrics, as identified via
 either the
@@ -260,8 +263,10 @@ or
 (or
 .BR \-\-archive )
 options.
+.RE
 .TP
 \fB\-Z\fR \fItimezone\fR, \fB\-\-timezone\fR=\fItimezone\fR
+.RS
 By default, applications
 report the time of day according to the local timezone on the
 system where
@@ -276,8 +281,10 @@ in the format of the environment variable
 .B TZ
 as described in
 .BR environ (7).
+.RE
 .TP
 \fB\-D\fR \fIdebugspec\fR, \fB\-\-debug\fR=\fIdebugspec\fR
+.RS
 Sets the PCP debugging options to
 .I debugspec
 to enable diagnostics and tracing that is most helpful for developers or
@@ -304,6 +311,7 @@ option, but a typical invocation in this mode would be
 .B "\-O today"
 or
 .BR "\-\-origin yesterday" .
+.RE
 .SH INTERVAL SPECIFICATION AND ALIGNMENT
 Most PCP tools operate with periodic sampling or
 reporting, and the
@@ -1181,8 +1189,7 @@ is a directory then recursive descent is used to enumerate all
 files below that directory and these are added to the list.
 .RS
 .PP
-Each file in the resulting list is assumed to
-contain
+Each file in the resulting list is assumed to contain
 definitions of derived metrics as per the syntax described in
 .BR pmLoadDerivedConfig (3),
 and these are loaded in order.
@@ -1276,7 +1283,6 @@ If
 .B PCP_STDERR
 is set to any other value, the value is assumed to
 be a filename, and all messages will be written there.
-.RE
 .TP
 .B PMCD_CONNECT_TIMEOUT
 When attempting to connect to a remote

man/man1/pmdapipe.1

@@ -333,20 +333,15 @@ lf(B) | lxf(R) .
 Option	Description
 _
 appl0	T{
-.ad l
 event processing and generation, interactions with \fBpmcd\fP(1),
 client context handling, command execution
 T}
 _
-appl1	T{
-.ad l
-access controls, user and group diagnostics
-T}
+appl1	access controls, user and group diagnostics
 _
 appl2	T{
-.ad l
-.I configfile
-handling, bad command argument diagnostics, \fBselect\fP(2) handling
+\fIconfigfile\fP handling, bad command argument diagnostics,
+\fBselect\fP(2) handling
 T}
 .TE
 .SH SEE ALSO

man/man1/pmdashping.1

@@ -233,21 +233,12 @@ lf(B) | lf(B)
 lf(B) | lxf(R) .
 Option	Description
 _
-appl0	T{
-.ad l
-exit handling
-T}
+appl0	exit handling
 _
-appl1	T{
-.ad l
-\fIconfigfile\fP parsing, timeouts, refresh cycle
-T}
+appl1	\fIconfigfile\fP parsing, timeouts, refresh cycle
 _
 appl2	T{
-.ad l
-append commands and arguments to
-.I shping.out
-as they are executed
+append commands and arguments to \fIshping.out\fP as they are executed
 T}
 .TE
 .SH SEE ALSO

man/man1/pmdaweblog.1

@@ -592,22 +592,11 @@ lf(B) | lf(B)
 lf(B) | lxf(R) .
 Option	Description
 _
-appl0	T{
-.ad l
-initialization,
-.I configfile
-parsing and log file processing
-T}
+appl0	initialization, \fIconfigfile\fP parsing and log file processing
 _
-appl1	T{
-.ad l
-timer operations, log file probing
-T}
+appl1	timer operations, log file probing
 _
-appl2	T{
-.ad l
-IPC with worker processes, log lines processed
-T}
+appl2	IPC with worker processes, log lines processed
 .TE
 .SH SEE ALSO
 .BR pmcd (1),

man/man1/pmhostname.1

@@ -90,9 +90,7 @@ lf(B) | lxf(R) .
 Option	Description
 _
 appl0	T{
-.ad l
-detailed diagnostics, e.g. result from calling
-.BR gethostname (2)
+detailed diagnostics, e.g. result from calling \fBgethostname\fP(2)
 and PMAPI routines
 T}
 .TE

man/man1/pmie.1

@@ -733,38 +733,26 @@ lf(CB) | l | l.
 Operators	Type	Explanation
 _
 T{
-.ad l
 some_inst
-.br
 some_host
-.br
 some_sample
 T}	Existential	T{
-.ad l
 True if at least one set member is true in the associated dimension
 T}
 _
 T{
-.ad l
 all_inst
-.br
 all_host
-.br
 all_sample
 T}	Universal	T{
-.ad l
 True if all set members are true in the associated dimension
 T}
 _
 T{
-.ad l
 \f(CIN\f(CB%_inst
-.br
 \f(CIN\f(CB%_host
-.br
 \f(CIN\f(CB%_sample\fR
 T}	Percentile	T{
-.ad l
 True if at least \fIN\fP percent of set members are true in the associated dimension
 T}
 .TE
@@ -787,19 +775,11 @@ lf(CB) | l.
 Operators	Explanation
 _
 match_inst	T{
-.ad l
-For each value of the logical expression that is ``true'', the
-result is ``true'' if the associated instance name matches the
-regular expression.
-Otherwise the result is ``false''.
+For each value of the logical expression that is ``true'', the result is ``true'' if the associated instance name matches the regular expression.  Otherwise the result is ``false''.
 T}
 _
 nomatch_inst	T{
-.ad l
-For each value of the logical expression that is ``true'', the
-result is ``true'' if the associated instance name does
-\fBnot\fP match the
-regular expression.  Otherwise the result is ``false''.
+For each value of the logical expression that is ``true'', the result is ``true'' if the associated instance name does \fBnot\fP match the regular expression.  Otherwise the result is ``false''.
 T}
 .TE
 .PP
@@ -824,50 +804,34 @@ lf(CB) | l | l.
 Operators	Type	Explanation
 _
 T{
-.ad l
 min_inst
-.br
 min_host
-.br
 min_sample
 T}	Extrema	T{
-.ad l
 Minimum value across all set members in the associated dimension
 T}
 _
 T{
-.ad l
 max_inst
-.br
 max_host
-.br
 max_sample
 T}	Extrema	T{
-.ad l
 Maximum value across all set members in the associated dimension
 T}
 _
 T{
-.ad l
 sum_inst
-.br
 sum_host
-.br
 sum_sample
 T}	Aggregate	T{
-.ad l
 Sum of values across all set members in the associated dimension
 T}
 _
 T{
-.ad l
 avg_inst
-.br
 avg_host
-.br
 avg_sample
 T}	Aggregate	T{
-.ad l
 Average value across all set members in the associated dimension
 T}
 .TE
@@ -1544,24 +1508,16 @@ lf(B) | lxf(R) .
 Option	Description
 _
 appl0	T{
-.ad l
 lexical scanning during parsing of the configuration file
 T}
 _
 appl1	T{
-.ad l
 configuration file parsing and expression tree construction
 T}
 _
-appl2	T{
-.ad l
-expression evaluation
-T}
+appl2	expression evaluation
 _
-appl3	T{
-.ad l
-status file operations
-T}
+appl3	status file operations
 .TE
 .SH SEE ALSO
 .BR PCPIntro (1),

man/man1/pminfo.1

@@ -336,16 +336,10 @@ lf(B) | lxf(R) .
 Option	Description
 _
 appl4	T{
-.ad l
-report batch downsizing if
-.I batchsize
-would exceed maximum PDU size
+report batch downsizing if \fIbatchsize\fP would exceed maximum PDU size
 T}
 _
-appl5	T{
-.ad l
-dump PDU stats at end if context is a host
-T}
+appl5	dump PDU stats at end if context is a host
 .TE
 .SH SEE ALSO
 .BR PCPIntro (1),

man/man1/pmlogbasename.1

@@ -103,18 +103,12 @@ lf(B) | lxf(R) .
 Option	Description
 _
 appl0	T{
-.ad l
-report the name of each file that exists and potentially matches
-.I name
+report the name of each file that exists and potentially matches \fIname\fP
 T}
 _
 appl1	T{
-.ad l
-report the name of each file that does
-.B not
-exist but was probed looking
-for matches with
-.I name
+report the name of each file that does \fBnot\fP exist but was probed
+looking for matches with \fIname\fP
 T}
 .TE
 .SH SEE ALSO