git: 2d69f02c5745 - main - stats.3: Fix "skipping end of block" syntax errors
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 03 Oct 2024 17:50:10 UTC
The branch main has been updated by mhorne:
URL: https://cgit.FreeBSD.org/src/commit/?id=2d69f02c5745a89c01bcd76389d53fd2a4189f02
commit 2d69f02c5745a89c01bcd76389d53fd2a4189f02
Author: Graham Percival <gperciva@tarsnap.com>
AuthorDate: 2024-09-24 18:11:03 +0000
Commit: Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2024-10-03 17:49:09 +0000
stats.3: Fix "skipping end of block" syntax errors
These were reported by `mandoc -T lint ...` as errors.
The rendered output (in ascii and html) is not affected by this commit.
There was a small misunderstanding about the mdoc format: a 1-line
enclosure does not need a closing tag. For example, Pc is for closing
an Po; if a line uses Pq (enclose the remainder of this line), there's
no need for Pc.
Signed-off-by: Graham Percival <gperciva@tarsnap.com>
Reviewed by: mhorne
MFC after: 3 days
Sponsored by: Tarsnap Backup Inc.
Pull Request: https://github.com/freebsd/freebsd-src/pull/1434
---
share/man/man3/stats.3 | 28 ++++++++++++++--------------
1 file changed, 14 insertions(+), 14 deletions(-)
diff --git a/share/man/man3/stats.3 b/share/man/man3/stats.3
index 4dfb1dac63a2..7fe1fa613def 100644
--- a/share/man/man3/stats.3
+++ b/share/man/man3/stats.3
@@ -102,17 +102,17 @@
.Fc
.Ft struct voistatspec
.Fo "STATS_VSS_CRHIST<32|64>_USR"
-.Fa Sy "HBKTS" Ns Pq Sy "CRBKT" Ns ( Em "lb" ) , "..." Pc ,
+.Fa Sy "HBKTS" Ns Pq Sy "CRBKT" Ns ( Em "lb" ) , "..." ,
.Fa "vsdflags"
.Fc
.Ft struct voistatspec
.Fo "STATS_VSS_DRHIST<32|64>_USR"
-.Fa Sy "HBKTS" Ns Pq Sy "DRBKT" Ns ( Em "lb" , "ub" ) , "..." Pc ,
+.Fa Sy "HBKTS" Ns Pq Sy "DRBKT" Ns ( Em "lb" , "ub" ) , "..." ,
.Fa "vsdflags"
.Fc
.Ft struct voistatspec
.Fo "STATS_VSS_DVHIST<32|64>_USR"
-.Fa Sy "HBKTS" Ns Pq Sy "DVBKT" Ns ( Em "val" ) , "..." Pc ,
+.Fa Sy "HBKTS" Ns Pq Sy "DVBKT" Ns ( Em "val" ) , "..." ,
.Fa "vsdflags"
.Fc
.Ft struct voistatspec
@@ -316,16 +316,16 @@ The maximum VOI value.
The minimum VOI value.
.It Dv VS_STYPE_HIST
A static bucket histogram of VOI values, including a count of
-.Dq out-of-band/bucket Dc
+.Dq out-of-band/bucket
values which did not match any bucket.
Histograms can be specified as
-.Dq Em C Ns ontinuous Em R Ns ange Dc
-.Pq CRHIST Pc ,
-.Dq Em D Ns iscrete Em R Ns ange Dc
-.Pq DRHIST Pc
+.Dq Em C Ns ontinuous Em R Ns ange
+.Pq CRHIST ,
+.Dq Em D Ns iscrete Em R Ns ange
+.Pq DRHIST
or
-.Dq Em D Ns iscrete Em V Ns alue Dc
-.Pq DVHIST Pc ,
+.Dq Em D Ns iscrete Em V Ns alue
+.Pq DVHIST ,
with 32 or 64 bit bucket counters, depending on the VOI semantics.
.It Dv VS_STYPE_TDGST
A dynamic bucket histogram of VOI values based on the t-digest method
@@ -433,15 +433,15 @@ Where templates need to be referenced via textual means, for example via a MIB
variable, the following string based template spec formats can be used:
.Bl -enum
.It
-.Qq <tplname> Qc Ns
+.Qq <tplname> Ns
:<tplhash>
.Ns , for example
-.Qq TCP_DEFAULT Qc Ns
+.Qq TCP_DEFAULT Ns
:1731235399
.It
-.Qq <tplname> Qc
+.Qq <tplname>
.Ns , for example
-.Qq TCP_DEFAULT Qc
+.Qq TCP_DEFAULT
.It
:<tplhash>
.Ns , for example