Bug#446118: xserver-xorg-input-evdev: manpage fixes

2007-10-10 Thread Peter Samuelson

Package: xserver-xorg-input-evdev
Version: 1:1.2.0~git20070819-3
Severity: minor
Tags: patch

While fixing typos in the evdev manpage (before noticing that these
were already fixed in the latest unstable), I discovered a few other
things that could be cleaned up:

  - 1_ascii.diff: ; use \- (ASCII dash) instead of - (hyphen) where
appropriate; use roff character escapes, not UTF-8.
  - 2_quotes.diff: consistent use of quote marks
  - 3_typefaces.diff: consistent use of bold and italic; avoid
most use of   as substitutes for italic; use in/i instead of
iinteger/i or inumber/i.
-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/
Patch 1 of 3: use \- (ASCII dash) instead of - (hyphen), where
appropriate; use a roff escape instead of a UTF-8 character.

--- man/evdev.man
+++ man/evdev.man
@@ -46,7 +46,7 @@
 .BI   Identifier \*q keyboard \*q
 .BDriver \*qevdev\*q
 .BIOption \*qevBits\*q  \*q +1 \*q
-.BIOption \*qkeyBits\*q \*q ~1-255 ~352-511 \*q
+.BIOption \*qkeyBits\*q \*q ~1\-255 ~352\-511 \*q
 .BIOption \*qPass\*q\*q 3 \*q
 \ \ ...
 .B EndSection
@@ -58,9 +58,9 @@
 .B Section \*qInputDevice\*q
 .BI   Identifier \*q mouse \*q
 .BDriver \*qevdev\*q
-.BIOption \*qevBits\*q  \*q +1-2 \*q
-.BIOption \*qkeyBits\*q \*q ~272-287 \*q
-.BIOption \*qrelBits\*q \*q ~0-2 ~6 ~8 \*q
+.BIOption \*qevBits\*q  \*q +1\-2 \*q
+.BIOption \*qkeyBits\*q \*q ~272\-287 \*q
+.BIOption \*qrelBits\*q \*q ~0\-2 ~6 ~8 \*q
 .BIOption \*qPass\*q\*q 3 \*q
 \ \ ...
 .B EndSection
@@ -126,19 +126,19 @@
 mapBits: Where map is one of ev, key, rel, abs, msc, led, snd, or
 ff.
 .fi
-The bit specifier format is a string consisting of +n, -n, and ~n
+The bit specifier format is a string consisting of +n, \-n, and ~n
 space separated specifiers, where n is a positive integer or integer range.
-(The latter given in the format of 2-6.)
+(The latter given in the format of 2\-6.)
 .fi
 + specifies bits which must be set.
 .fi
-- specifies bits which must not be set.
+\- specifies bits which must not be set.
 .fi
 ~ is a little more complex, it specifies that at least one of the bits given
 with ~ for the field in question must be set, but it doesn't matter how many
 or which of the bits. (It is actually the most useful of the 3 specifiers.)
 .fi
-As an example '+0 +3 -1-2 ~5-10', requires bits 0 and 3 be set,
+As an example '+0 +3 \-1\-2 ~5\-10', requires bits 0 and 3 be set,
 bits 1 and 2 to not be set, and at least one bit in the range of 5 to
 10 be set.
 .fi
@@ -239,8 +239,8 @@
 The relative axis portion of this driver handle all reported relative axes.
 .fi
 The axes are named X, Y, Z, RX, RY, RZ, THROTTLE, RUDDER, WHEEL, GAS, BREAK,
-11-15, HAT0X, HAT0Y, HAT1X, HAT1Y, HAT2X, HAT2Y, HAT3X, HAT3Y, PRESSURE,
-TILT_X, TILT_Y, TOOL_WIDTH, VOLUME, 29-39, MISC, 41-62.
+11\-15, HAT0X, HAT0Y, HAT1X, HAT1Y, HAT2X, HAT2Y, HAT3X, HAT3Y, PRESSURE,
+TILT_X, TILT_Y, TOOL_WIDTH, VOLUME, 29\-39, MISC, 41\-62.
 .fi
 The axes are reported to X as valuators, with the default mapping of axes
 to valuators being the first axes found to the first valuator, the second
@@ -261,9 +261,9 @@
 This binds the device to a specific screen, scaling it to
 the coordinate space of that screen.
 .fi
-The number can either be -1, or a valid screen number.
+The number can either be \-1, or a valid screen number.
 .fi
-If -1 or if in relative mode no scaling or screen fixing is done.
+If \-1 or if in relative mode no scaling or screen fixing is done.
 .fi
 This is of most use for digitizers, where the screen and the input
 device are the same surface.
@@ -277,7 +277,7 @@
 .PP
 .SS BUTTON CONFIGURATION
 At the moment, the button portion of this driver only handles buttons
-reported as mouse buttons, that is from BTN_MOUSE to BTN_JOYSTICK - 1.
+reported as mouse buttons, that is from BTN_MOUSE to BTN_JOYSTICK \- 1.
 .fi
 At this time there are no configuration options for buttons.
 .SS KEYBOARD CONFIGURATION
@@ -317,6 +317,6 @@
 .SH AUTHORS
 Zephaniah E. Hull.
 .fi
-Kristian HÞgsberg.
+Kristian H\(/ogsberg.
 .SH SEE ALSO
 __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__).
Patch 2 of 3: consistent use of quote characters.

--- man/evdev.man
+++ man/evdev.man
@@ -14,7 +14,7 @@
 .fi
 .SH DESCRIPTION
 .B evdev 
-is an __xservername__ input driver for Linux\'s generic event devices.  It
+is an __xservername__ input driver for Linux's generic event devices.  It
 therefore supports all input devices that the kernel knows about, including
 most mice and keyboards.
 .PP
@@ -138,7 +138,7 @@
 with ~ for the field in question must be set, but it doesn't matter how many
 or which of the bits. (It is actually the most useful of the 3 specifiers.)
 .fi
-As an example '+0 +3 \-1\-2 ~5\-10', requires bits 0 and 3 be set,
+As an example, \*q+0 +3 \-1\-2 ~5\-10\*q requires bits 0 and 3 be set,
 bits 1 and 2 to not be set, and 

Bug#446118: xserver-xorg-input-evdev: manpage fixes

2007-10-10 Thread Brice Goglin
tags 446118 +fixed-upstream
thank you



Peter Samuelson wrote:
 While fixing typos in the evdev manpage (before noticing that these
 were already fixed in the latest unstable), I discovered a few other
 things that could be cleaned up:

   - 1_ascii.diff: ; use \- (ASCII dash) instead of - (hyphen) where
 appropriate; use roff character escapes, not UTF-8.
   - 2_quotes.diff: consistent use of quote marks
   - 3_typefaces.diff: consistent use of bold and italic; avoid
 most use of   as substitutes for italic; use in/i instead of
 iinteger/i or inumber/i.
   

Pushed upstream in commit 12a27693b9bb41b9222c5c2256815d225ee75929

Brice




-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#446118: xserver-xorg-input-evdev: manpage fixes

2007-10-10 Thread Peter Samuelson

[Brice Goglin]
  While fixing typos in the evdev manpage (before noticing that these
  were already fixed in the latest unstable), I discovered a few other
  things that could be cleaned up:
 
 Pushed upstream in commit 12a27693b9bb41b9222c5c2256815d225ee75929

Thanks!  Can you do one more?  I verified this one in evdev_axes.c.
-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/


commit ccd66637c0cd9086e258f3a42acf987bfd20b32b
Author: Peter Samuelson [EMAIL PROTECTED]
Date:   Wed Oct 10 22:41:26 2007 -0500

Fix one additional typo in evdev.man (axis named BRAKE, not BREAK).

diff --git a/man/evdev.man b/man/evdev.man
index 3026efe..2a11945 100644
--- a/man/evdev.man
+++ b/man/evdev.man
@@ -253,7 +253,7 @@ and map the Wheel axis to buttons 4 5, you get buttons 1 2 3
 .SS ABSOLUTE AXIS CONFIGURATION
 The relative axis portion of this driver handle all reported relative axes.
 .fi
-The axes are named X, Y, Z, RX, RY, RZ, THROTTLE, RUDDER, WHEEL, GAS, BREAK,
+The axes are named X, Y, Z, RX, RY, RZ, THROTTLE, RUDDER, WHEEL, GAS, BRAKE,
 11\-15, HAT0X, HAT0Y, HAT1X, HAT1Y, HAT2X, HAT2Y, HAT3X, HAT3Y, PRESSURE,
 TILT_X, TILT_Y, TOOL_WIDTH, VOLUME, 29\-39, MISC, 41\-62.
 .fi


signature.asc
Description: Digital signature


Bug#446118: xserver-xorg-input-evdev: manpage fixes

2007-10-10 Thread Brice Goglin
Peter Samuelson wrote:
 [Brice Goglin]
   
 While fixing typos in the evdev manpage (before noticing that these
 were already fixed in the latest unstable), I discovered a few other
 things that could be cleaned up:
   
 Pushed upstream in commit 12a27693b9bb41b9222c5c2256815d225ee75929
 

 Thanks!  Can you do one more?  I verified this one in evdev_axes.c.
   

Done.

Brice




-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]