Package: xserver-xorg-input-evdev
Version: 1:2.10.6-2+b1
Severity: minor
Tags: patch
Dear Maintainer,
here are some comments and editorial fixes for the man page.
-.-
The difference between the formatted outputs can be seen with:
nroff -man <file1> > <out1>
nroff -man <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "
instead of "nroff -man"
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual, 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 -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint evdev.4":
mandoc: evdev.4:19:10: STYLE: whitespace at end of input line
mandoc: evdev.4:26:4: STYLE: whitespace at end of input line
mandoc: evdev.4:40:2: WARNING: skipping paragraph macro: PP empty
mandoc: evdev.4:43:12: STYLE: whitespace at end of input line
mandoc: evdev.4:46:2: WARNING: skipping paragraph macro: PP empty
mandoc: evdev.4:52:21: STYLE: whitespace at end of input line
mandoc: evdev.4:67:74: STYLE: whitespace at end of input line
mandoc: evdev.4:84:2: WARNING: line scope broken: TP breaks TP
-.-.
Input file is evdev.4
Remove space characters at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
19:.B evdev
26:The
43:through the
52:The following driver
67:Specifies the device through which the device can be accessed. This will
-.-.
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.
125:.BR EmulateWheel
149:.BR EmulateWheelButton
151:.BR EmulateWheelButton
242:.BI "Option \*qTypeName\*q \*q"type"\*q
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"
-.-.
Wrong distance between sentences.
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.
N.B
The number of lines affected is too large to be in the patch.
28:driver can serve as both a pointer and a keyboard input device. Multiple
38:per-device configuration. Devices configured in the
57:Sets the button mapping for this device. The mapping is a space-separated
list
59:device (i.e. the first number is the mapping for button 1, etc.). The default
60:mapping is "1 2 3 ... 32". A mapping of 0 deactivates the button. Multiple
63:mapping of "3 2 1 0 0". Invalid mappings are ignored and the default mapping
64:is used. Buttons not specified in the user's mapping use the default mapping.
69:The mapping from device node to hardware is system-dependent. Property:
75:same time they move a mouse cursor. Button numbers occur in pairs,
77:number that is the target of the lock button. Property: "Evdev
83:\*qdrag locked\*q. Property: "Evdev Drag Lock Buttons".
89:pressing both buttons simultaneously. Default: off. Property: "Evdev Middle
95:enabled. Default: 50. Property: "Evdev Middle Button Timeout".
115:options. Default: off. Property "Evdev Wheel Emulation".
124:settings. If the button is 0 and
126:is on, any motion of the device is converted into wheel events. Default: 4.
131:press/release events in wheel emulation mode. Default: 10. Property: "Evdev
139:the name \*qinertia\*q is a misnomer. This option defines the distance
144:options. It does not enable inertia in the
150:must be pressed before wheel emulation is started. If the
153:is sent. Default: 200. Property: "Evdev Wheel Emulation Timeout".
156:Enable third button emulation. Third button emulation emits a right button
157:event (by default) by pressing and holding the first button. The first
159:than the configured threshold for the emulation to activate. Otherwise, the
160:first button event is posted as normal. Default: off. Property: "Evdev
166:Default: 1000. Property: "Evdev Third Button Emulation Timeout".
175:emulation. If the device moves by more than this threshold before the third
178:Default: 20. Property: "Evdev Third Button Emulation Threshold".
181:Force a grab on the event device. Doing so will ensure that no other driver
183:events to /dev/kbd or /dev/input/mice. Events from this device will not be
184:sent to virtual devices (e.g. rfkill or the Macintosh mouse button
emulation).
190:Invert the given axis. Default: off. Property: "Evdev Axis Inversion".
195:Ignore the specified type of axis. Default: unset. The X server cannot deal
196:with devices that have both relative and absolute axes. Evdev tries to guess
198:mice and relative axes for tablets, touchscreens and touchpad. These options
199:allow to forcibly disable an axis type. Mouse wheel axes are exempt and will
200:work even if relative axes are ignored. No property, this configuration must
204:axes regardless of the presence of other axes. This may trigger buggy
205:behavior and events from this axis are always forwarded. Users are
210:coordinate system than reported to the X server. This feature is required
212:originally reported by the kernel (e.g. touchscreens). The scaling to the
214:the transformation. Property: "Evdev Axis Calibration".
222:Swap x/y axes. Default: off. Property: "Evdev Axes Swap".
230:is mapped to the positive X axis motion. Default: no mapping. Property:
239:is mapped to the positive Y axis motion. Default: "4 5". Property:
245:based on the device's capabilities. This option is provided for devices that
261:Sets the resolution of the device in dots per inch. The resolution is used
262:to scale relative motion events from mouse devices to 1000 DPI resolution.
This
264:acceleration. If set to 0 no scaling will be performed. Default: "0".
276:2 boolean values (8 bit, 0 or 1), order X, Y. 1 inverts the axis.
279:1 boolean value (8 bit, 0 or 1). 1 swaps x/y axes.
282:8-bit. Either 1 value or pairs of values. Value range 0-32, 0 disables a
298:4 8-bit values, order X up, X down, Y up, Y down. 0 disables a value.
-.-.
Rephrase the beginning of a sentence, if it starts with a digit (see
a style manual).
272:4 32-bit values, order min-x, max-x, min-y, max-y or 0 values to disable
276:2 boolean values (8 bit, 0 or 1), order X, Y. 1 inverts the axis.
279:1 boolean value (8 bit, 0 or 1). 1 swaps x/y axes.
282:8-bit. Either 1 value or pairs of values. Value range 0-32, 0 disables a
286:1 boolean value (8 bit, 0 or 1).
289:1 16-bit positive value.
292:1 8-bit value, allowed range 0-32, 0 disables the button.
295:1 boolean value (8 bit, 0 or 1).
298:4 8-bit values, order X up, X down, Y up, Y down. 0 disables a value.
301:1 8-bit value, allowed range 0-32, 0 disables the button.
304:1 16-bit positive value.
307:1 16-bit positive value.
310:3 32-bit values: vertical, horizontal and dial.
-.-.
The name of a man page is set in bold type 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)
-.-.
[ "test-groff" is a developmental version of "groff" ]
Input file is ./evdev.4
Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z
-rCHECKSTYLE=0":
troff: backtrace: file '<stdin>':26
troff:<stdin>:26: warning: trailing space in the line
troff: backtrace: file '<stdin>':43
troff:<stdin>:43: warning: trailing space in the line
troff: backtrace: file '<stdin>':52
troff:<stdin>:52: warning: trailing space in the line
troff: backtrace: file '<stdin>':67
troff:<stdin>:67: warning: trailing space in the line
-.-.
Additional changes:
Add information about the encoding of the file for "man" (from preconv(1)):
'\" -*- coding: utf-8 -*-
>From "codespell":
evdev.4:197: wich ==> which
-.-
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (990, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.4.11-1 (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.37-7
ii libevdev2 1.13.1+dfsg-1
ii libmtdev1 1.1.6-1
ii libudev1 254.1-2
ii xserver-xorg-core [xorg-input-abi-24] 2:21.1.8-1
xserver-xorg-input-evdev recommends no packages.
xserver-xorg-input-evdev suggests no packages.
-- no debconf information
