Please find, for review, the debconf templates of gpm.
This review will last from Sunday, June 10, 2007 to Wednesday, June 20, 2007.
Please note that I left unchanged the giant template that describes
various mouse types. This template is way way way too big and I think
it's irrealistic to include the description for all mouse protocols in
the template (which is hard to browse with the debconf dialog interface).
Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.
Your review should be sent as an answer to this mail.
When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.
When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.
Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.
Rationale:
--- /home/bubulle/travail/debian/rewrite/INTENT/gpm/gpm.old/debian/gpm.templates 2007-05-24 22:39:54.785422192 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/gpm/gpm/debian/gpm.templates 2007-06-10 09:12:55.609990466 +0200
@@ -1,24 +1,27 @@
Template: gpm/restart
Type: boolean
Default: false
-_Description: Do you want to start or restart GPM while X is running?
+_Description: Do you want to (re)start GPM while X is running?
Make it shorter
Usually, GPM should be started or restarted when it is installed or
- upgraded. But when X is running and trying to use the same mouse
+ upgraded. However, when X is running and trying to use the same mouse
Better English?
device, this can sometimes cause a problem with the X mouse cursor.
Switching to the console and then back to X will usually fix it.
Template: gpm/device
Type: string
-_Description: Which mouse device should gpm use?
- Where is your mouse device? If you have a regular PS/2 mouse, you probably
- want /dev/psaux. If you have a serial mouse, it may be something like
- /dev/ttyS0. If you have a usb mouse (make sure you have the modules
- loaded), it's /dev/input/mice. If you're on a Sun machine, it's probably
- /dev/sunmouse. If you're on an 68k Macintosh, it's probably /dev/mouse.
+_Description: Mouse device for GPM:
No interrogative form. Use consistent capitalization for GPM.
There are many such changes from interrogative form to 'opened prompts'.
+ Please enter the mouse device name.
No question in long descriptions. Avoid possessive form.
+ .
+ Common mouse devices names:
+ - PS/2 mouse: /dev/psaux
+ - Serial mouse: /dev/ttySx
+ - USB mouse: /dev/input/mice
+ - Sun mouse: /dev/sunmouse
+ - M68k Mac mouse: /dev/mouse
Attempt to be clearer and avoid "you have" everywhere.
Template: gpm/type
Type: string
-_Description: What type is your mouse?
+_Description: Mouse type:
No interrogative form.
Available mouse types are:
.
Name Description
@@ -77,15 +80,15 @@
Template: gpm/responsiveness
Type: string
-_Description: How responsive should the mouse be?
- Responsiveness defines the how often the cursor responds to mouse movement, and
- is expressed as a number here. If your mouse seems to move too slowly, try
- setting this to 15.
+_Description: Mouse responsiveness:
No interrogative form.
+ The responsiveness defines how often the cursor responds to mouse
+ movement, and is expressed as a number. If the mouse seems to
+ move too slowly, try setting this to 15.
extra "the" (at least IMHO)
Template: gpm/repeat_type
Type: string
Default: ms3
-_Description: What protocol should be used to repeat mouse events?
+_Description: Protocol to use for repeating mouse events:
No interrogative form.
Template: gpm/sample_rate
Type: string
-_Description: What should the sample rate for the mouse be?
- The sample rate defines how often GPM polls the mouse device for new position
- data. This is often tweaked to make the mouse appear to move more smoothly, but
- it should not be changed unless you really know what you are doing.
+_Description: Mouse sample rate:
+ The sample rate defines how often GPM polls the mouse device for new
+ position data. This is often tweaked to make the mouse appear to move
+ more smoothly, but should only be changed in rare occasions.
No interrogative form.
Avoid "know what you are doing" which is too much spoken language.
Template: gpm/append
Type: string
-_Description: Additional arguments to GPM
- If you need any additional arguments to make GPM work for your
- environment, add them here.
+_Description: Additional arguments for the GPM daemon:
+ Please mention any additional arguments to use with the GPM daemon.
No interrigative form
--- /home/bubulle/travail/debian/rewrite/INTENT/gpm/gpm.old/debian/control 2007-05-24 22:39:54.765422025 +0200
+++ /home/bubulle/travail/debian/rewrite/INTENT/gpm/gpm/debian/control 2007-06-10 09:15:21.602707578 +0200
@@ -12,13 +12,13 @@
Section: misc
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debianutils (>= 1.7), ucf (>= 0.28), lsb-base
-Description: General Purpose Mouse Interface
+Description: General Purpose Mouse interface
I don't like the general capitalization, but it explains the GPM
acronym, so keep it. However 'interface' is not part of the acronym.
This package provides a daemon that captures mouse events when the system
console is active, and delivers events to applications through a library.
.
- The default when no application is running is to emulate "selection", that
- is, to allow cut-and-paste with the mouse on the console the same way as
- it is done under X.
+ By default, the daemon uses a 'selection' mode, to allow
+ cut-and-paste with the mouse on the console the same way as it is
+ done with X.
Avoid "The default is".
I don't really like "the same way as it is done". Can probably be
enhanced.
Template: gpm/restart
Type: boolean
Default: false
_Description: Do you want to (re)start GPM while X is running?
Usually, GPM should be started or restarted when it is installed or
upgraded. However, when X is running and trying to use the same mouse
device, this can sometimes cause a problem with the X mouse cursor.
Switching to the console and then back to X will usually fix it.
Template: gpm/device
Type: string
_Description: Mouse device for GPM:
Please enter the mouse device name.
.
Common mouse devices names:
- PS/2 mouse: /dev/psaux
- Serial mouse: /dev/ttySx
- USB mouse: /dev/input/mice
- Sun mouse: /dev/sunmouse
- M68k Mac mouse: /dev/mouse
Template: gpm/type
Type: string
_Description: Mouse type:
Available mouse types are:
.
Name Description
.
PS/2 mice: round 6-pin connector
autops2 Most PS/2 mice; specific protocol will be auto-detected.
Also use this for USB and ADB mice.
ps2 Standard PS/2 mice, 2 or 3 buttons
imps2 Microsoft IntelliMouse and compatibles; PS/2 mice with
3 buttons and a scroll wheel
exps2 Newer Microsoft IntelliMouse and compatible, may have
more than 3 buttons. Most newer PS/2 mice are this type.
synps2 Synaptics PS/2 TouchPad, found on many laptops
netmouse Genius NetMouse, 2 normal buttons plus an "Up/Down" button
fups2 Same as "ps2" but may be needed for certain broken
mice or KVM switches
fuimps2 Same as "imps2" but may be needed for certain broken
mice or KVM switches
.
Serial mice: 9-pin or 25-pin serial connector
msc The MouseSystems protocol. Most 3-button serial mice.
mman The MouseMan protocol used by newer Logitech serial mice
ms3 Microsoft IntelliMouse, 3 buttons plus scroll wheel
ms Microsoft serial mice, 2 or 3 buttons, no wheel
ms+ Like 'ms', but allows dragging with the middle button
ms+lr 'ms+', but you can reset m by pressing lr (see man page)
pnp Microsoft's "plug and play" serial mouse standard
bare 2-button Microsoft serial mice. Use this one if the 'ms'
protocol seems to produce spurious middle-button events.
mm MM series. Probably an old protocol.
logi Old serial Logitech mice
logim Old Logitech serial mice in MouseSystems mode (3 buttons)
syn Synaptics TouchPad, serial version
brw Fellowes Browser - 4 buttons and a wheel
.
Other mice
bm Some Microsoft and Logitech bus mice: 8-pin round connector
vsxxxaa The DEC VSXXX-AA/GA serial mouse on DEC workstations
sun Sparc mice
.
Non-mice
js Mouse emulation with a joystick
cal Calcomp UltraSlate in absolute mode
calr Calcomp UltraSlate in relative mode
twid Handykey Twiddler keyboard
ncr Ncr3125pen, found on some laptops
wacom Wacom Protocol IV Tablets: Pen+Mouse,
relative+absolute mode
genitizer Genitizer tablet, in relative mode
summa Summa/Genius tablet in absolute mode
(906,1212B,EasyPainter...)
mtouch MicroTouch touch-screens (only button-1 events reported)
gunze Gunze touch-screens (only button-1 events reported)
acecad Acecad tablet in absolute mode (Sumagrapics MM-Series mode)
wp Genius WizardPad tablet
Template: gpm/responsiveness
Type: string
_Description: Mouse responsiveness:
The responsiveness defines how often the cursor responds to mouse
movement, and is expressed as a number. If the mouse seems to
move too slowly, try setting this to 15.
Template: gpm/repeat_type
Type: string
Default: ms3
_Description: Protocol to use for repeating mouse events:
GPM can act as a repeater via /dev/gpmdata, and give both GPM and X access
to the mouse data in configurations where it would otherwise only be available
to only X or GPM.
.
Enter 'none' to turn repeating off.
Template: gpm/sample_rate
Type: string
_Description: Mouse sample rate:
The sample rate defines how often GPM polls the mouse device for new
position data. This is often tweaked to make the mouse appear to move
more smoothly, but should only be changed in rare occasions.
Template: gpm/append
Type: string
_Description: Additional arguments for the GPM daemon:
Please mention any additional arguments to use with the GPM daemon.
--- ../gpm.old/debian/gpm.templates 2007-05-24 22:39:54.785422192 +0200
+++ debian/gpm.templates 2007-06-10 09:12:55.609990466 +0200
@@ -1,24 +1,27 @@
Template: gpm/restart
Type: boolean
Default: false
-_Description: Do you want to start or restart GPM while X is running?
+_Description: Do you want to (re)start GPM while X is running?
Usually, GPM should be started or restarted when it is installed or
- upgraded. But when X is running and trying to use the same mouse
+ upgraded. However, when X is running and trying to use the same mouse
device, this can sometimes cause a problem with the X mouse cursor.
Switching to the console and then back to X will usually fix it.
Template: gpm/device
Type: string
-_Description: Which mouse device should gpm use?
- Where is your mouse device? If you have a regular PS/2 mouse, you probably
- want /dev/psaux. If you have a serial mouse, it may be something like
- /dev/ttyS0. If you have a usb mouse (make sure you have the modules
- loaded), it's /dev/input/mice. If you're on a Sun machine, it's probably
- /dev/sunmouse. If you're on an 68k Macintosh, it's probably /dev/mouse.
+_Description: Mouse device for GPM:
+ Please enter the mouse device name.
+ .
+ Common mouse devices names:
+ - PS/2 mouse: /dev/psaux
+ - Serial mouse: /dev/ttySx
+ - USB mouse: /dev/input/mice
+ - Sun mouse: /dev/sunmouse
+ - M68k Mac mouse: /dev/mouse
Template: gpm/type
Type: string
-_Description: What type is your mouse?
+_Description: Mouse type:
Available mouse types are:
.
Name Description
@@ -77,15 +80,15 @@
Template: gpm/responsiveness
Type: string
-_Description: How responsive should the mouse be?
- Responsiveness defines the how often the cursor responds to mouse movement, and
- is expressed as a number here. If your mouse seems to move too slowly, try
- setting this to 15.
+_Description: Mouse responsiveness:
+ The responsiveness defines how often the cursor responds to mouse
+ movement, and is expressed as a number. If the mouse seems to
+ move too slowly, try setting this to 15.
Template: gpm/repeat_type
Type: string
Default: ms3
-_Description: What protocol should be used to repeat mouse events?
+_Description: Protocol to use for repeating mouse events:
GPM can act as a repeater via /dev/gpmdata, and give both GPM and X access
to the mouse data in configurations where it would otherwise only be available
to only X or GPM.
@@ -94,13 +97,12 @@
Template: gpm/sample_rate
Type: string
-_Description: What should the sample rate for the mouse be?
- The sample rate defines how often GPM polls the mouse device for new position
- data. This is often tweaked to make the mouse appear to move more smoothly, but
- it should not be changed unless you really know what you are doing.
+_Description: Mouse sample rate:
+ The sample rate defines how often GPM polls the mouse device for new
+ position data. This is often tweaked to make the mouse appear to move
+ more smoothly, but should only be changed in rare occasions.
Template: gpm/append
Type: string
-_Description: Additional arguments to GPM
- If you need any additional arguments to make GPM work for your
- environment, add them here.
+_Description: Additional arguments for the GPM daemon:
+ Please mention any additional arguments to use with the GPM daemon.
--- ../gpm.old/debian/control 2007-05-24 22:39:54.765422025 +0200
+++ debian/control 2007-06-10 09:15:21.602707578 +0200
@@ -12,13 +12,13 @@
Section: misc
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debianutils (>= 1.7), ucf (>= 0.28), lsb-base
-Description: General Purpose Mouse Interface
+Description: General Purpose Mouse interface
This package provides a daemon that captures mouse events when the system
console is active, and delivers events to applications through a library.
.
- The default when no application is running is to emulate "selection", that
- is, to allow cut-and-paste with the mouse on the console the same way as
- it is done under X.
+ By default, the daemon uses a 'selection' mode, to allow
+ cut-and-paste with the mouse on the console the same way as it is
+ done with X.
Package: libgpmg1
Priority: standard
Source: gpm
Maintainer: Debian GPM Team <pkg-gpm-devel@lists.alioth.debian.org>
Uploaders: Guillem Jover <guillem@debian.org>, Peter Samuelson <peter@p12n.org>
Section: misc
Priority: optional
Standards-Version: 3.7.2
Build-Depends: autoconf, debhelper (>= 5), dbs, bzip2, mawk | awk, bison,
tetex-bin, texinfo
Package: gpm
Priority: optional
Section: misc
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debianutils (>= 1.7), ucf (>= 0.28), lsb-base
Description: General Purpose Mouse interface
This package provides a daemon that captures mouse events when the system
console is active, and delivers events to applications through a library.
.
By default, the daemon uses a 'selection' mode, to allow
cut-and-paste with the mouse on the console the same way as it is
done with X.
Package: libgpmg1
Priority: standard
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Suggests: gpm
Conflicts: libgpm1 (<< 1.12-3)
Description: General Purpose Mouse - shared library
This package provides a library that handles mouse requests
and delivers them to applications. See the description for the 'gpm'
package for more information.
Package: libgpmg1-dev
Priority: optional
Section: libdevel
Architecture: any
Depends: libgpmg1 (= ${Source-Version}), libc6-dev | libc-dev
Replaces: libgpm1 (<< 1.12-3)
Description: General Purpose Mouse - development files
This package provides a library that handles mouse requests
and delivers them to applications. See the description for the 'gpm'
package for more information.
Attachment:
signature.asc
Description: Digital signature