#959405 paperconfig.8: Some tiding in the manual

Package:
libpaper-utils
Source:
libpaper
Description:
library for handling paper characteristics (utilities)
Submitter:
Bjarni Ingi Gislason
Date:
2023-03-18 13:33:09 UTC
Severity:
minor
Tags:
#959405#5
Date:
2020-05-02 02:13:28 UTC
From:
To:
Dear Maintainer,

Input file is paperconfig.8

chk_man: Next line: execute mandoc -T lint paperconfig.8

mandoc: paperconfig.8:68:67: STYLE: whitespace at end of input line

#######

Add a space after a comma.

###

Test nr. 36:

Wrong distance between sentences.

a) Separate the sentences and subordinate clauses; each begins on a new
line.  See man-pages(7) and "info groff".

 The best procedure is always to start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.


45:if possible. If

#####

  Patch:
--- paperconfig.8	2019-08-18 11:08:29.000000000 +0000
+++ paperconfig.8.new	2020-05-01 21:30:25.000000000 +0000
@@ -6,13 +6,14 @@
 .SH SYNOPSIS
 .B paperconfig
 [
-.BR \-v\fP, \fB\-\-version
+.BR \-v ", " \-\-version
 ]
 [
-.BR \-h\fP, \fB\-\-help
+.BR \-h ", " \-\-help
 ]
 [
-.BI "\-p\fP, \fB\-\-paper" " papername"
+.BR \-p ", " \-\-paper
+.I papername
 |
 .B \-\-force
 ]
@@ -31,18 +32,20 @@ notifies other packages of the change by
 directory.
 .SH OPTIONS
 .TP
-.BR \-v\fP, \fB\-\-version
+.BR \-v ", " \-\-version
 Print the version of
 .B paperconfig
 and exit.
 .TP
-.BR \-h\fP, \fB\-\-help
+.BR \-h ", " \-\-help
 Print help about usage and exit.
 .TP
-.BI "\-p\fP, \fB\-\-paper" " papername"
+.BR \-p ", " \-\-paper\c
+.I papername
 Use
 .I papername
-if possible. If
+if possible.
+If
 .I papername
 is not a valid paper, print an error message and exit.
 .TP
@@ -65,7 +68,7 @@ variable is not set.
 Directory of scripts to run after the paper size has been changed.
 This package puts no scripts here, but other packages may.
 .B run-parts
-is used to run the scripts, therefore their names must comply with 
+is used to run the scripts, therefore their names must comply with
 .B run-part's
 naming requirements.
 .SH AUTHOR

#959405#10
Date:
2023-03-18 13:29:36 UTC
From:
To:
Hello Bjarni,
I just uploaded a new libpaper package, including your patches.
Thank you very much for your contribution.

Bye,
Giuseppe