From 82b264a7a057d8801577f49f9b46e33411f88ae5 Mon Sep 17 00:00:00 2001 From: Jaye Evins Date: Wed, 17 Dec 2025 23:47:05 -0500 Subject: [PATCH] Manpages update for glabels-qt and glabels-batch-qt - Document new verbose version option (-V/--Version) introduced in #257 --- user-docs/_build/man/glabels-batch-qt.1 | 27 ++++++++++++++----------- user-docs/_build/man/glabels-qt.1 | 15 +++++++++----- user-docs/man/glabels-batch-qt.rst | 6 +++++- user-docs/man/glabels-qt.rst | 6 +++++- 4 files changed, 35 insertions(+), 19 deletions(-) diff --git a/user-docs/_build/man/glabels-batch-qt.1 b/user-docs/_build/man/glabels-batch-qt.1 index 693865c..8eca1e4 100644 --- a/user-docs/_build/man/glabels-batch-qt.1 +++ b/user-docs/_build/man/glabels-batch-qt.1 @@ -1,8 +1,5 @@ .\" Man page generated from reStructuredText. . -.TH "GLABELS-BATCH-QT" "1" "Mar 28, 2020" "" "gLabels" -.SH NAME -glabels-batch-qt \- print glabels project from command line . .nr rst2man-indent-level 0 . @@ -30,6 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. +.TH "GLABELS-BATCH-QT" "1" "Dec 17, 2025" "" "gLabels" +.SH NAME +glabels-batch-qt \- print glabels project from command line .SH SYNOPSIS .sp \fBglabels\-batch\-qt\fP [\fIoptions\fP] \fIFILE\fP @@ -37,7 +37,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .sp \fBglabels\-batch\-qt\fP is a utility for printing a glabels project file from the command line. This command takes exactly one project file, FILE. If FILE -is "\-", it expects an XML glabels project to be provided on standard input. +is \(dq\-\(dq, it expects an XML glabels project to be provided on standard input. .SH OPTIONS .INDENT 0.0 .TP @@ -47,7 +47,12 @@ Displays usage information and exits. .INDENT 0.0 .TP .B \-v, \-\-version -Displays version information and exits. +Displays brief version information and exits. +.UNINDENT +.INDENT 0.0 +.TP +.B \-V, \-\-Version +Displays detailed version information and exits. .UNINDENT .INDENT 0.0 .TP @@ -58,9 +63,9 @@ Send output to . .TP .B \-o [], \-\-output [] .TP -.B Set output filename to . If filename is "\-", write to standard output. +.B Set output filename to . If filename is \(dq\-\(dq, write to standard output. .TP -.B (Default="output.pdf") +.B (Default=\(dqoutput.pdf\(dq) .UNINDENT .INDENT 0.0 .TP @@ -131,16 +136,14 @@ On GNU/Linux platforms, \fBglabels\-batch\-qt\fP must be run from within a windo .INDENT 0.0 .INDENT 3.5 .sp -.nf -.ft C +.EX xvfb\-run glabels\-batch\-qt \-o output.pdf myProject.glabels -.ft P -.fi +.EE .UNINDENT .UNINDENT .SH REPORTING BUGS .sp -Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<\fI\%https://github.com/j-evins/glabels\-qt/issues\fP>). You will need a GitHub account to submit new issues or to comment on existing issues. +Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<\fI\%https://github.com/j\-evins/glabels\-qt/issues\fP>). You will need a GitHub account to submit new issues or to comment on existing issues. .SH SEE ALSO .sp \fBglabels\-qt(1)\fP diff --git a/user-docs/_build/man/glabels-qt.1 b/user-docs/_build/man/glabels-qt.1 index 27866cd..4a57098 100644 --- a/user-docs/_build/man/glabels-qt.1 +++ b/user-docs/_build/man/glabels-qt.1 @@ -1,8 +1,5 @@ .\" Man page generated from reStructuredText. . -.TH "GLABELS-QT" "1" "Mar 28, 2020" "" "gLabels" -.SH NAME -glabels-qt \- create labels and business cards . .nr rst2man-indent-level 0 . @@ -30,6 +27,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. +.TH "GLABELS-QT" "1" "Dec 17, 2025" "" "gLabels" +.SH NAME +glabels-qt \- create labels and business cards .SH SYNOPSIS .sp \fBglabels\-qt\fP [\fIoptions\fP] [\fIfilename\fP ...] @@ -47,7 +47,12 @@ Displays usage information and exits. .INDENT 0.0 .TP .B \-v, \-\-version -Displays version information and exits. +Displays brief version information and exits. +.UNINDENT +.INDENT 0.0 +.TP +.B \-V, \-\-Version +Displays detailed version information and exits. .UNINDENT .SH FILES .INDENT 0.0 @@ -69,7 +74,7 @@ Directory for manually created product templates. .UNINDENT .SH REPORTING BUGS .sp -Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<\fI\%https://github.com/j-evins/glabels\-qt/issues\fP>). You will need a GitHub account to submit new issues or to comment on existing issues. +Bugs and feature requests can be reported via the gLabels issue tracking system at GitHub (<\fI\%https://github.com/j\-evins/glabels\-qt/issues\fP>). You will need a GitHub account to submit new issues or to comment on existing issues. .SH SEE ALSO .sp \fBglabels\-batch\-qt(1)\fP diff --git a/user-docs/man/glabels-batch-qt.rst b/user-docs/man/glabels-batch-qt.rst index 339cc8c..db0cc52 100644 --- a/user-docs/man/glabels-batch-qt.rst +++ b/user-docs/man/glabels-batch-qt.rst @@ -25,7 +25,11 @@ OPTIONS .. option:: -v, --version - Displays version information and exits. + Displays brief version information and exits. + +.. option:: -V, --Version + + Displays detailed version information and exits. .. option:: -p , --printer diff --git a/user-docs/man/glabels-qt.rst b/user-docs/man/glabels-qt.rst index 3cfa9b0..08ae859 100644 --- a/user-docs/man/glabels-qt.rst +++ b/user-docs/man/glabels-qt.rst @@ -24,7 +24,11 @@ OPTIONS .. option:: -v, --version - Displays version information and exits. + Displays brief version information and exits. + +.. option:: -V, --Version + + Displays detailed version information and exits. FILES -----