Adding the patch for the latest version.
This is a multi-part MIME message sent by reportbug.
--===============2457519859243569888==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Package: xserver-xorg-input-evdev
Version: 1:2.11.0-1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man
page"
[Use
grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>
to find (most) trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
troff:<stdin>:26: warning: trailing space in the line
troff:<stdin>:43: warning: trailing space in the line
troff:<stdin>:52: warning: trailing space in the line
troff:<stdin>:67: warning: trailing space in the line
an.tmac:<stdin>:85: warning: cannot nest .TP or .TQ inside .TP; supply a tag
an.tmac:<stdin>:125: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:149: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:151: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:271: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:275: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:278: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:281: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:285: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:288: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:291: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:294: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:297: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:300: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:303: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:306: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:309: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.12.21-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages xserver-xorg-input-evdev depends on:
ii libc6 2.41-6
ii libevdev2 1.13.4+dfsg-1
ii libmtdev1t64 1.1.7-1
ii libudev1 257.5-2
ii xserver-xorg-core [xorg-input-abi-24] 2:21.1.16-1
xserver-xorg-input-evdev recommends no packages.
xserver-xorg-input-evdev suggests no packages.
-- no debconf information
--===============2457519859243569888==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="chk_man.err.evdev.4"
Input file is evdev.4
Output from "mandoc -T lint evdev.4": (shortened list)
1 line scope broken
2 skipping paragraph macro
5 whitespace at end of input line
Find trailing space with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Output from
test-nroff -mandoc -t -ww -z evdev.4: (shortened list)
16 Use macro '.B' for one argument or split argument.
13 .BI is for at least 2 arguments, got 1
3 .BR is for at least 2 arguments, got 1
1 cannot nest .TP or .TQ inside .TP; supply a tag
4 line(s) with a trailing space
Find trailing space with:
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
Number of lines affected is
5
-.-.
Change '-' (\-) to '\(en' (en-dash) for a (numeric) range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.
evdev.4:282:8 bit. Either 1 value or pairs of values. Value range 0-32, 0
disables a
evdev.4:292:1 8 bit value, allowed range 0-32, 0 disables the button.
evdev.4:301:1 8 bit value, allowed range 0-32, 0 disables the button.
-.-.
Use the correct macro for the font change of a single argument or
split the argument into two.
271:.BI "Evdev Axis Calibration"
275:.BI "Evdev Axis Inversion"
278:.BI "Evdev Axes Swap"
281:.BI "Evdev Drag Lock Buttons"
285:.BI "Evdev Middle Button Emulation"
288:.BI "Evdev Middle Button Timeout"
291:.BI "Evdev Middle Button Button"
294:.BI "Evdev Wheel Emulation"
297:.BI "Evdev Wheel Emulation Axes"
300:.BI "Evdev Wheel Emulation Button"
303:.BI "Evdev Wheel Emulation Inertia"
306:.BI "Evdev Wheel Emulation Timeout"
309:.BI "Evdev Scrolling Distance"
-.-.
Add a "\&" (or a comma (Oxford comma)) after an abbreviation
or use English words
(man-pages(7)).
Abbreviation points should be marked as such and protected against being
interpreted as an end of sentence, if they are not, and that independent
of the current place on the line.
59:device (i.e. the first number is the mapping for button 1, etc.). The default
184:sent to virtual devices (e.g. rfkill or the Macintosh mouse button
emulation).
212:originally reported by the kernel (e.g. touchscreens). The scaling to the
-.-.
Wrong distance (not two spaces) between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always 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.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
Split (sometimes) lines after a punctuation mark; before a conjunction.
Lines with only one (or two) space(s) between sentences could be split,
so latter sentences begin on a new line.
Use
#!/usr/bin/sh
sed -e '/^\./n' \
-e 's/\([[:alpha:]]\)\. */\1.\n/g' $1
to split lines after a sentence period.
Check result with the difference between the formatted outputs.
See also the attachment "general.bugs"
[List of affected lines removed.]
-.-.
The name of a man page is typeset in bold and the section in roman
(see man-pages(7)).
37:directive (refer to xorg.conf(5)) instead of manual
39:xorg.conf(5) are not hot-plug capable.
48:Please refer to xorg.conf(5) for general configuration
243:Specify the X Input 1.x type (see XListInputDevices(3)).
315:Xorg(1), xorg.conf(5), Xserver(1), X(7)
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
[List of affected lines removed.]
-.-.
Only one space character is after a possible end of sentence
(after a punctuation, that can end a sentence).
[List of affected lines removed.]
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
evdev.4:80:.BI "Option \*qDragLockButtons\*q \*q" "M1" \*q
evdev.4:242:.BI "Option \*qTypeName\*q \*q"type"\*q
-.-.
Space character after a macro call.
19:.B evdev
-.-.
Section headings (.SH and .SS) do not need quoting their arguments.
314:.SH "SEE ALSO"
-.-.
Add "\&" after an ellipsis, when it does not end a sentence
60:mapping is "1 2 3 ... 32". A mapping of 0 deactivates the button. Multiple
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:26: warning: trailing space in the line
troff:<stdin>:43: warning: trailing space in the line
troff:<stdin>:52: warning: trailing space in the line
troff:<stdin>:67: warning: trailing space in the line
an.tmac:<stdin>:85: warning: cannot nest .TP or .TQ inside .TP; supply a tag
an.tmac:<stdin>:125: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:149: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:151: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:271: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:275: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:278: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:281: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:285: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:288: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:291: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:294: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:297: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:300: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:303: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:306: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:309: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
Output from "test-nroff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:26: warning: trailing space in the line
troff:<stdin>:43: warning: trailing space in the line
troff:<stdin>:52: warning: trailing space in the line
troff:<stdin>:67: warning: trailing space in the line
an.tmac:<stdin>:85: warning: cannot nest .TP or .TQ inside .TP; supply a tag
an.tmac:<stdin>:125: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:149: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:151: misuse, warning: .BR is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:271: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:275: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:278: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:281: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:285: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:288: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:291: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:294: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:297: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:300: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:303: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:306: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:309: misuse, warning: .BI is for at least 2 arguments, got 1
Use macro '.B' for one argument or split argument.
-.-.
Generally:
--===============2457519859243569888==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="evdev.4.diff"
LS0tIGV2ZGV2LjQJMjAyNS0wNC0xOCAxMzoyODowMi4yNTk4OTQyNTcgKzAwMDAKKysrIGV2ZGV2
LjQubmV3CTIwMjUtMDQtMTggMTQ6MDY6MzMuNDYwODY5Mzg5ICswMDAwCkBAIC0xNiwxNCArMTYs
MTQgQEAgZXZkZXYgXC0gR2VuZXJpYyBMaW51eCBpbnB1dCBkcml2ZXIKIC5CIEVuZFNlY3Rpb24K
IC5maQogLlNIIERFU0NSSVBUSU9OCi0uQiBldmRldiAKKy5CIGV2ZGV2CiBpcyBhbiBYb3JnIGlu
cHV0IGRyaXZlciBmb3IgTGludXhcJ3MgZ2VuZXJpYyBldmVudCBkZXZpY2VzLiAgSXQKIHRoZXJl
Zm9yZSBzdXBwb3J0cyBhbGwgaW5wdXQgZGV2aWNlcyB0aGF0IHRoZSBrZXJuZWwga25vd3MgYWJv
dXQsIGluY2x1ZGluZwogbW9zdCBtaWNlLCBrZXlib2FyZHMsIHRhYmxldHMgYW5kIHRvdWNoc2Ny
ZWVucy4KIC5CIGV2ZGV2CiBpcyB0aGUgZGVmYXVsdCBkcml2ZXIgb24gdGhlIG1ham9yIExpbnV4
IGRpc3RyaWJ1dGlvbnMuCiAuUFAKLVRoZSAKK1RoZQogLkIgZXZkZXYKIGRyaXZlciBjYW4gc2Vy
dmUgYXMgYm90aCBhIHBvaW50ZXIgYW5kIGEga2V5Ym9hcmQgaW5wdXQgZGV2aWNlLiBNdWx0aXBs
ZQogaW5wdXQgZGV2aWNlcyBhcmUgc3VwcG9ydGVkIGJ5IG11bHRpcGxlIGluc3RhbmNlcyBvZiB0
aGlzIGRyaXZlciwgd2l0aCBvbmUKQEAgLTM0LDM3ICszNCw0MiBAQCBJdCBpcyByZWNvbW1lbmRl
ZCB0aGF0CiAuQiBldmRldgogZGV2aWNlcyBhcmUgY29uZmlndXJlZCB0aHJvdWdoIHRoZQogLkIg
SW5wdXRDbGFzcwotZGlyZWN0aXZlIChyZWZlciB0byB4b3JnLmNvbmYoNSkpIGluc3RlYWQgb2Yg
bWFudWFsCitkaXJlY3RpdmUgKHJlZmVyIHRvCisuQlIgeG9yZy5jb25mICg1KSkKK2luc3RlYWQg
b2YgbWFudWFsCiBwZXItZGV2aWNlIGNvbmZpZ3VyYXRpb24uIERldmljZXMgY29uZmlndXJlZCBp
biB0aGUKLXhvcmcuY29uZig1KSBhcmUgbm90IGhvdC1wbHVnIGNhcGFibGUuCisuQlIgeG9yZy5j
b25mICg1KQorYXJlIG5vdCBob3QtcGx1ZyBjYXBhYmxlLgogLlBQCiAuU0ggU1VQUE9SVEVEIEhB
UkRXQVJFCiBJbiBnZW5lcmFsLCBhbnkgaW5wdXQgZGV2aWNlIHRoYXQgdGhlIGtlcm5lbCBoYXMg
YSBkcml2ZXIgZm9yIGNhbiBiZSBhY2Nlc3NlZAotdGhyb3VnaCB0aGUgCit0aHJvdWdoIHRoZQog
LkIgZXZkZXYKIGRyaXZlci4gIFNlZSB0aGUgTGludXgga2VybmVsIGRvY3VtZW50YXRpb24gZm9y
IGEgY29tcGxldGUgbGlzdC4KIC5QUAogLlNIIENPTkZJR1VSQVRJT04gREVUQUlMUwotUGxlYXNl
IHJlZmVyIHRvIHhvcmcuY29uZig1KSBmb3IgZ2VuZXJhbCBjb25maWd1cmF0aW9uCitQbGVhc2Ug
cmVmZXIgdG8KKy5CUiB4b3JnLmNvbmYgKDUpCitmb3IgZ2VuZXJhbCBjb25maWd1cmF0aW9uCiBk
ZXRhaWxzIGFuZCBmb3Igb3B0aW9ucyB0aGF0IGNhbiBiZSB1c2VkIHdpdGggYWxsIGlucHV0IGRy
aXZlcnMuICBUaGlzCiBzZWN0aW9uIG9ubHkgY292ZXJzIGNvbmZpZ3VyYXRpb24gZGV0YWlscyBz
cGVjaWZpYyB0byB0aGlzIGRyaXZlci4KIC5QUAotVGhlIGZvbGxvd2luZyBkcml2ZXIgCitUaGUg
Zm9sbG93aW5nIGRyaXZlcgogLkIgT3B0aW9ucwogYXJlIHN1cHBvcnRlZDoKIC5UUCA3CiAuQkkg
Ik9wdGlvbiBcKnFCdXR0b25NYXBwaW5nXCpxIFwqcSIgc3RyaW5nIFwqcQogU2V0cyB0aGUgYnV0
dG9uIG1hcHBpbmcgZm9yIHRoaXMgZGV2aWNlLiBUaGUgbWFwcGluZyBpcyBhIHNwYWNlLXNlcGFy
YXRlZCBsaXN0CiBvZiBidXR0b24gbWFwcGluZ3MgdGhhdCBjb3JyZXNwb25kIGluIG9yZGVyIHRv
IHRoZSBwaHlzaWNhbCBidXR0b25zIG9uIHRoZQotZGV2aWNlIChpLmUuIHRoZSBmaXJzdCBudW1i
ZXIgaXMgdGhlIG1hcHBpbmcgZm9yIGJ1dHRvbiAxLCBldGMuKS4gVGhlIGRlZmF1bHQKLW1hcHBp
bmcgaXMgIjEgMiAzIC4uLiAzMiIuIEEgbWFwcGluZyBvZiAwIGRlYWN0aXZhdGVzIHRoZSBidXR0
b24uIE11bHRpcGxlCitkZXZpY2UgKGkuZS5cJiB0aGUgZmlyc3QgbnVtYmVyIGlzIHRoZSBtYXBw
aW5nIGZvciBidXR0b24gMSwgZXRjLikuIFRoZSBkZWZhdWx0CittYXBwaW5nIGlzICIxIDIgMyAu
Li5cJiAzMiIuIEEgbWFwcGluZyBvZiAwIGRlYWN0aXZhdGVzIHRoZSBidXR0b24uIE11bHRpcGxl
CiBidXR0b25zIGNhbiBoYXZlIHRoZSBzYW1lIG1hcHBpbmcuCiBGb3IgZXhhbXBsZSwgYSBsZWZ0
LWhhbmRlZCBtb3VzZSB3aXRoIGRlYWN0aXZhdGVkIHNjcm9sbC13aGVlbCB3b3VsZCB1c2UgYQog
bWFwcGluZyBvZiAiMyAyIDEgMCAwIi4gSW52YWxpZCBtYXBwaW5ncyBhcmUgaWdub3JlZCBhbmQg
dGhlIGRlZmF1bHQgbWFwcGluZwogaXMgdXNlZC4gQnV0dG9ucyBub3Qgc3BlY2lmaWVkIGluIHRo
ZSB1c2VyJ3MgbWFwcGluZyB1c2UgdGhlIGRlZmF1bHQgbWFwcGluZy4KIC5UUCA3CiAuQkkgIk9w
dGlvbiBcKnFEZXZpY2VcKnEgXCpxIiBzdHJpbmcgXCpxCi1TcGVjaWZpZXMgdGhlIGRldmljZSB0
aHJvdWdoIHdoaWNoIHRoZSBkZXZpY2UgY2FuIGJlIGFjY2Vzc2VkLiAgVGhpcyB3aWxsIAorU3Bl
Y2lmaWVzIHRoZSBkZXZpY2UgdGhyb3VnaCB3aGljaCB0aGUgZGV2aWNlIGNhbiBiZSBhY2Nlc3Nl
ZC4gIFRoaXMgd2lsbAogZ2VuZXJhbGx5IGJlIG9mIHRoZSBmb3JtIFwqcS9kZXYvaW5wdXQvZXZl
bnRYXCpxLCB3aGVyZSBYIGlzIHNvbWUgaW50ZWdlci4KIFRoZSBtYXBwaW5nIGZyb20gZGV2aWNl
IG5vZGUgdG8gaGFyZHdhcmUgaXMgc3lzdGVtLWRlcGVuZGVudC4gUHJvcGVydHk6CiAiRGV2aWNl
IE5vZGUiIChyZWFkLW9ubHkpLgpAQCAtNzcsMTIgKzgyLDExIEBAIHdpdGggdGhlIGxvY2sgYnV0
dG9uIG51bWJlciBvY2N1cnJpbmcgZmkKIG51bWJlciB0aGF0IGlzIHRoZSB0YXJnZXQgb2YgdGhl
IGxvY2sgYnV0dG9uLiBQcm9wZXJ0eTogIkV2ZGV2CiBEcmFnIExvY2sgQnV0dG9ucyIuCiAuVFAg
NwotLkJJICJPcHRpb24gXCpxRHJhZ0xvY2tCdXR0b25zXCpxIFwqcSIgIk0xIiBcKnEKKy5CSSAi
T3B0aW9uIFwqcURyYWdMb2NrQnV0dG9uc1wqcSBcKnEiIE0xIFwqcQogU2V0cyBhIFwqcW1hc3Rl
ciBkcmFnIGxvY2sgYnV0dG9uXCpxIHRoYXQgYWN0cyBhcyBhIFwqcU1ldGEgS2V5XCpxCiBpbmRp
Y2F0aW5nIHRoYXQgdGhlIG5leHQgYnV0dG9uIHByZXNzZWQgaXMgdG8gYmUKIFwqcWRyYWcgbG9j
a2VkXCpxLiBQcm9wZXJ0eTogIkV2ZGV2IERyYWcgTG9jayBCdXR0b25zIi4KIC5UUCA3Ci0uVFAg
NwogLkJJICJPcHRpb24gXCpxRW11bGF0ZTNCdXR0b25zXCpxIFwqcSIgYm9vbGVhbiBcKnEKIEVu
YWJsZS9kaXNhYmxlIHRoZSBlbXVsYXRpb24gb2YgdGhlIHRoaXJkIChtaWRkbGUpIG1vdXNlIGJ1
dHRvbiBmb3IgbWljZQogd2hpY2ggb25seSBoYXZlIHR3byBwaHlzaWNhbCBidXR0b25zLiAgVGhl
IHRoaXJkIGJ1dHRvbiBpcyBlbXVsYXRlZCBieQpAQCAtMTIyLDcgKzEyNiw3IEBAIHByZXNzL3Jl
bGVhc2UgZXZlbnRzIGFzIHNwZWNpZmllZCBmb3IgdGgKIGFuZAogLkIgWUF4aXNNYXBwaW5nCiBz
ZXR0aW5ncy4gSWYgdGhlIGJ1dHRvbiBpcyAwIGFuZAotLkJSIEVtdWxhdGVXaGVlbAorLkIgRW11
bGF0ZVdoZWVsCiBpcyBvbiwgYW55IG1vdGlvbiBvZiB0aGUgZGV2aWNlIGlzIGNvbnZlcnRlZCBp
bnRvIHdoZWVsIGV2ZW50cy4gRGVmYXVsdDogNC4KIFByb3BlcnR5OiAiRXZkZXYgV2hlZWwgRW11
bGF0aW9uIEJ1dHRvbiIuCiAuVFAgNwpAQCAtMTQ2LDkgKzE1MCw5IEBAIHBoeXNpY2FsIHNlbnNl
LCBzY3JvbGxpbmcgc3RvcHMgaW1tZWRpYXQKIC5UUCA3CiAuQkkgIk9wdGlvbiBcKnFFbXVsYXRl
V2hlZWxUaW1lb3V0XCpxIFwqcSIgaW50ZWdlciBcKnEKIFNwZWNpZmllcyB0aGUgdGltZSBpbiBt
aWxsaXNlY29uZHMgdGhlCi0uQlIgRW11bGF0ZVdoZWVsQnV0dG9uCisuQiBFbXVsYXRlV2hlZWxC
dXR0b24KIG11c3QgYmUgcHJlc3NlZCBiZWZvcmUgd2hlZWwgZW11bGF0aW9uIGlzIHN0YXJ0ZWQu
IElmIHRoZQotLkJSIEVtdWxhdGVXaGVlbEJ1dHRvbgorLkIgRW11bGF0ZVdoZWVsQnV0dG9uCiBp
cyByZWxlYXNlZCBiZWZvcmUgdGhpcyB0aW1lb3V0LCB0aGUgb3JpZ2luYWwgYnV0dG9uIHByZXNz
L3JlbGVhc2UgZXZlbnQKIGlzIHNlbnQuICBEZWZhdWx0OiAyMDAuIFByb3BlcnR5OiAiRXZkZXYg
V2hlZWwgRW11bGF0aW9uIFRpbWVvdXQiLgogLlRQIDcKQEAgLTE4MSw3ICsxODUsNyBAQCBEZWZh
dWx0OiAyMC4gUHJvcGVydHk6ICJFdmRldiBUaGlyZCBCdXR0CiBGb3JjZSBhIGdyYWIgb24gdGhl
IGV2ZW50IGRldmljZS4gRG9pbmcgc28gd2lsbCBlbnN1cmUgdGhhdCBubyBvdGhlciBkcml2ZXIK
IGNhbiBpbml0aWFsaXNlIHRoZSBzYW1lIGRldmljZSBhbmQgaXQgd2lsbCBhbHNvIHN0b3AgdGhl
IGRldmljZSBmcm9tIHNlbmRpbmcKIGV2ZW50cyB0byAvZGV2L2tiZCBvciAvZGV2L2lucHV0L21p
Y2UuIEV2ZW50cyBmcm9tIHRoaXMgZGV2aWNlIHdpbGwgbm90IGJlCi1zZW50IHRvIHZpcnR1YWwg
ZGV2aWNlcyAoZS5nLiByZmtpbGwgb3IgdGhlIE1hY2ludG9zaCBtb3VzZSBidXR0b24gZW11bGF0
aW9uKS4KK3NlbnQgdG8gdmlydHVhbCBkZXZpY2VzIChlLmcuXCYgcmZraWxsIG9yIHRoZSBNYWNp
bnRvc2ggbW91c2UgYnV0dG9uIGVtdWxhdGlvbikuCiBEZWZhdWx0OiBkaXNhYmxlZC4KIC5UUCA3
CiAuQkkgIk9wdGlvbiBcKnFJbnZlcnRYXCpxIFwqcSIgQm9vbCBcKnEKQEAgLTIwOSw3ICsyMTMs
NyBAQCBkaXNjb3VyYWdlZCBmcm9tIHNldHRpbmcgdGhpcyBvcHRpb24uCiBDYWxpYnJhdGVzIHRo
ZSBYIGFuZCBZIGF4ZXMgZm9yIGRldmljZXMgdGhhdCBuZWVkIHRvIHNjYWxlIHRvIGEgZGlmZmVy
ZW50CiBjb29yZGluYXRlIHN5c3RlbSB0aGFuIHJlcG9ydGVkIHRvIHRoZSBYIHNlcnZlci4gVGhp
cyBmZWF0dXJlIGlzIHJlcXVpcmVkCiBmb3IgZGV2aWNlcyB0aGF0IG5lZWQgdG8gc2NhbGUgdG8g
YSBkaWZmZXJlbnQgY29vcmRpbmF0ZSBzeXN0ZW0gdGhhbgotb3JpZ2luYWxseSByZXBvcnRlZCBi
eSB0aGUga2VybmVsIChlLmcuIHRvdWNoc2NyZWVucykuIFRoZSBzY2FsaW5nIHRvIHRoZQorb3Jp
Z2luYWxseSByZXBvcnRlZCBieSB0aGUga2VybmVsIChlLmcuXCYgdG91Y2hzY3JlZW5zKS4gVGhl
IHNjYWxpbmcgdG8gdGhlCiBjdXN0b20gY29vcmRpbmF0ZSBzeXN0ZW0gaXMgZG9uZSBpbi1kcml2
ZXIgYW5kIHRoZSBYIHNlcnZlciBpcyB1bmF3YXJlIG9mCiB0aGUgdHJhbnNmb3JtYXRpb24uIFBy
b3BlcnR5OiAiRXZkZXYgQXhpcyBDYWxpYnJhdGlvbiIuCiAuVFAgNwpAQCAtMjM5LDggKzI0Myw5
IEBAIGlzIG1hcHBlZCB0byB0aGUgbmVnYXRpdmUgWSBheGlzIG1vdGlvbgogaXMgbWFwcGVkIHRv
IHRoZSBwb3NpdGl2ZSBZIGF4aXMgbW90aW9uLiAgRGVmYXVsdDogIjQgNSIuIFByb3BlcnR5Ogog
IkV2ZGV2IFdoZWVsIEVtdWxhdGlvbiBBeGVzIi4KIC5UUCA3Ci0uQkkgIk9wdGlvbiBcKnFUeXBl
TmFtZVwqcSBcKnEidHlwZSJcKnEKLVNwZWNpZnkgdGhlIFggSW5wdXQgMS54IHR5cGUgKHNlZSBY
TGlzdElucHV0RGV2aWNlcygzKSkuCisuQkkgIk9wdGlvbiBcKnFUeXBlTmFtZVwqcSBcKnEiIHR5
cGUiXCpxCitTcGVjaWZ5IHRoZSBYIElucHV0IDEueCB0eXBlIChzZWUKKy5CUiBYTGlzdElucHV0
RGV2aWNlcyAoMykpLgogVGhlcmUgaXMgcmFyZWx5IGEgbmVlZCB0byB1c2UgdGhpcyBvcHRpb24s
IGV2ZGV2IHdpbGwgZ3Vlc3MgdGhlIGRldmljZSB0eXBlCiBiYXNlZCBvbiB0aGUgZGV2aWNlJ3Mg
Y2FwYWJpbGl0aWVzLiBUaGlzIG9wdGlvbiBpcyBwcm92aWRlZCBmb3IgZGV2aWNlcyB0aGF0CiBu
ZWVkIHF1aXJrcy4KQEAgLTI2OCw0OCArMjczLDQ4IEBAIFRoZSBmb2xsb3dpbmcgcHJvcGVydGll
cyBhcmUgcHJvdmlkZWQgYnkKIC5CIGV2ZGV2CiBkcml2ZXIuCiAuVFAgNwotLkJJICJFdmRldiBB
eGlzIENhbGlicmF0aW9uIgorLkIgIkV2ZGV2IEF4aXMgQ2FsaWJyYXRpb24iCiA0IDMyLWJpdCB2
YWx1ZXMsIG9yZGVyIG1pbi14LCBtYXgteCwgbWluLXksIG1heC15IG9yIDAgdmFsdWVzIHRvIGRp
c2FibGUKIGluLWRyaXZlciBheGlzIGNhbGlicmF0aW9uLgogLlRQIDcKLS5CSSAiRXZkZXYgQXhp
cyBJbnZlcnNpb24iCisuQiAiRXZkZXYgQXhpcyBJbnZlcnNpb24iCiAyIGJvb2xlYW4gdmFsdWVz
ICg4IGJpdCwgMCBvciAxKSwgb3JkZXIgWCwgWS4gMSBpbnZlcnRzIHRoZSBheGlzLgogLlRQIDcK
LS5CSSAiRXZkZXYgQXhlcyBTd2FwIgorLkIgIkV2ZGV2IEF4ZXMgU3dhcCIKIDEgYm9vbGVhbiB2
YWx1ZSAoOCBiaXQsIDAgb3IgMSkuIDEgc3dhcHMgeC95IGF4ZXMuCiAuVFAgNwotLkJJICJFdmRl
diBEcmFnIExvY2sgQnV0dG9ucyIKLTgtYml0LiBFaXRoZXIgMSB2YWx1ZSBvciBwYWlycyBvZiB2
YWx1ZXMuIFZhbHVlIHJhbmdlIDAtMzIsIDAgZGlzYWJsZXMgYQorLkIgIkV2ZGV2IERyYWcgTG9j
ayBCdXR0b25zIgorOC1iaXQuIEVpdGhlciAxIHZhbHVlIG9yIHBhaXJzIG9mIHZhbHVlcy4gVmFs
dWUgcmFuZ2UgMFwoZW4zMiwgMCBkaXNhYmxlcyBhCiB2YWx1ZS4KIC5UUCA3Ci0uQkkgIkV2ZGV2
IE1pZGRsZSBCdXR0b24gRW11bGF0aW9uIgorLkIgIkV2ZGV2IE1pZGRsZSBCdXR0b24gRW11bGF0
aW9uIgogMSBib29sZWFuIHZhbHVlICg4IGJpdCwgMCBvciAxKS4KIC5UUCA3Ci0uQkkgIkV2ZGV2
IE1pZGRsZSBCdXR0b24gVGltZW91dCIKKy5CICJFdmRldiBNaWRkbGUgQnV0dG9uIFRpbWVvdXQi
CiAxIDE2LWJpdCBwb3NpdGl2ZSB2YWx1ZS4KIC5UUCA3Ci0uQkkgIkV2ZGV2IE1pZGRsZSBCdXR0
b24gQnV0dG9uIgotMSA4LWJpdCB2YWx1ZSwgYWxsb3dlZCByYW5nZSAwLTMyLCAwIGRpc2FibGVz
IHRoZSBidXR0b24uCisuQiAiRXZkZXYgTWlkZGxlIEJ1dHRvbiBCdXR0b24iCisxIDgtYml0IHZh
bHVlLCBhbGxvd2VkIHJhbmdlIDBcKGVuMzIsIDAgZGlzYWJsZXMgdGhlIGJ1dHRvbi4KIC5UUCA3
Ci0uQkkgIkV2ZGV2IFdoZWVsIEVtdWxhdGlvbiIKKy5CICJFdmRldiBXaGVlbCBFbXVsYXRpb24i
CiAxIGJvb2xlYW4gdmFsdWUgKDggYml0LCAwIG9yIDEpLgogLlRQIDcKLS5CSSAiRXZkZXYgV2hl
ZWwgRW11bGF0aW9uIEF4ZXMiCisuQiAiRXZkZXYgV2hlZWwgRW11bGF0aW9uIEF4ZXMiCiA0IDgt
Yml0IHZhbHVlcywgb3JkZXIgWCB1cCwgWCBkb3duLCBZIHVwLCBZIGRvd24uIDAgZGlzYWJsZXMg
YSB2YWx1ZS4KIC5UUCA3Ci0uQkkgIkV2ZGV2IFdoZWVsIEVtdWxhdGlvbiBCdXR0b24iCi0xIDgt
Yml0IHZhbHVlLCBhbGxvd2VkIHJhbmdlIDAtMzIsIDAgZGlzYWJsZXMgdGhlIGJ1dHRvbi4KKy5C
ICJFdmRldiBXaGVlbCBFbXVsYXRpb24gQnV0dG9uIgorMSA4LWJpdCB2YWx1ZSwgYWxsb3dlZCBy
YW5nZSAwXChlbjMyLCAwIGRpc2FibGVzIHRoZSBidXR0b24uCiAuVFAgNwotLkJJICJFdmRldiBX
aGVlbCBFbXVsYXRpb24gSW5lcnRpYSIKKy5CICJFdmRldiBXaGVlbCBFbXVsYXRpb24gSW5lcnRp
YSIKIDEgMTYtYml0IHBvc2l0aXZlIHZhbHVlLgogLlRQIDcKLS5CSSAiRXZkZXYgV2hlZWwgRW11
bGF0aW9uIFRpbWVvdXQiCisuQiAiRXZkZXYgV2hlZWwgRW11bGF0aW9uIFRpbWVvdXQiCiAxIDE2
LWJpdCBwb3NpdGl2ZSB2YWx1ZS4KIC5UUCA3Ci0uQkkgIkV2ZGV2IFNjcm9sbGluZyBEaXN0YW5j
ZSIKKy5CICJFdmRldiBTY3JvbGxpbmcgRGlzdGFuY2UiCiAzIDMyLWJpdCB2YWx1ZXM6IHZlcnRp
Y2FsLCBob3Jpem9udGFsIGFuZCBkaWFsLgogCiAuU0ggQVVUSE9SUwogS3Jpc3RpYW4gSMODwrhn
c2JlcmcsIFBldGVyIEh1dHRlcmVyCi0uU0ggIlNFRSBBTFNPIgotWG9yZygxKSwgeG9yZy5jb25m
KDUpLCBYc2VydmVyKDEpLCBYKDcpCisuU0ggU0VFIEFMU08KKy5CUiBYb3JnICIoMSksICIgeG9y
Zy5jb25mICIoNSksICIgWHNlcnZlciAiKDEpLCAiIFggKDcpCg==
--===============2457519859243569888==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="general.bugs"
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
To find trailing space use
grep -n -e ' $' -e ' \\f.$' -e ' \\"' <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
"git" has a "tool" to point out whitespace,
see for example "git-apply(1)" and git-config(1)")
Not beginning each input sentence on a new line.
Line length and patch size should thus be reduced.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
--===============2457519859243569888==--
