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