Please find, for review, the debconf templates and packages descriptions for the wacom-tools source package. This review will last from Tuesday, September 11, 2007 to Friday, September 21, 2007. 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: --- ../wacom-tools.old/debian/wacom-kernel-source.templates 2007-09-07 06:08:14.344854999 +0200 +++ debian/wacom-kernel-source.templates 2007-09-11 07:36:34.203746040 +0200 @@ -1,100 +1,77 @@ Template: wacom-kernel-source/module Type: boolean Default: true -_Description: Would you like the wacom modules to be compiled automatically? - In order to make full use of a wacom graphics tablet you need to compile and - install the provided modules to suit your running Linux kernel. - . - If you opt to do this, the wacom modules will be compiled into a Debian binary - package using a local kernel configuration which you will be required to - specify. You must have either a kernel-headers-* package installed to suit - the kernel you wish to use it with, or have a suitably configured kernel - source tree available. If you do not currently have either of these available - you should choose not to do this at present. Once you have suitable headers - installed you can return to this selection with: - . - dpkg-reconfigure wacom-kernel-source - . - Alternatively, you might prefer to build it manually. The source to do this - can be found in /usr/src/modules/wacom. You may use a tool like make-kpkg(1) - or `fakeroot debian/rules kdist [ KSRC=... KVERS=... ]` to create - a Debian package as above, or you can simply `configure && make` and install - it by hand. +_Description: Automatically compile the Wacom modules? + In order to make full use of a Wacom graphics tablet you need to compile and + install the provided modules to suit the running Linux kernel. + . + If you choose this option, the Wacom modules will be compiled into a + binary package using local kernel configuration settings. + . + A kernel-headers-* package fitting the currently running kernel + needs to be installed. Alternatively, a suitably configured kernel + source tree may replace it. Do not choose this option if none of these + are available. + . + Once these requirements are met, you can launch this setup step with + 'dpkg-reconfigure wacom-kernel-source'. Pretty big rewrite with a few rationales in mind: - shorten the short part and make it more direct - attempt to shorten the long part to avoid being displayed on two screens - for this the last paragrpah est simply removed. It more pertains to a README.Debian file, imho - for this, also, the instruction to relaunch dpkg-reconfigure is merged in one paragraph. - avoid personnalization (s/your kernel/the kernel) Template: wacom-kernel-source/recompile Type: boolean Default: true -_Description: Would you like to create a binary wacom-kernel-modules package now? - If you opt to do this, the wacom modules will be compiled into a Debian binary - package using a local kernel configuration which you will be required to - specify. You must have either a kernel-headers-* package installed to suit - the kernel you wish to use it with, or have a suitably configured kernel - source tree available. If you do not currently have either of these available - you should choose not to do this at present. Once you have suitable headers - installed you can return to this selection with: - . - dpkg-reconfigure wacom-kernel-source - . - Note this package may replace some modules that were originally built with - your running kernel. You should ensure the original modules can be replaced - in the event of trouble before installing the resulting package. Also if you - have already built a wacom-kernel-modules package in this way using the same - kernel version then that package may be overwritten. You should rename or - relocate it before continuing if you wish to preserve it. +_Description: Create a binary wacom-kernel-modules package? + If you choose this option, the Wacom modules will be compiled into a + binary package using local kernel configuration settings. + . + A kernel-headers-* package fitting the currently running kernel + needs to be installed. Alternatively, a suitably configured kernel + source tree may replace it. Do not choose this option if none of these + are available. + . + Once these requirements are met, you can launch this setup step with + 'dpkg-reconfigure wacom-kernel-source'. + . + This may replace some modules that were originally built with + the running kernel. About the same rationale Template: wacom-kernel-source/kernel Type: string Default: /usr/src/linux/ -_Description: Linux headers location: - You have choosen to compile the wacom modules, so you must specify the location +_Description: Linux header files location: "header files" is most often used, from what I see + In order to compile the Wacom modules, please enter the location of the Linux kernel headers for them to use. Avoid making reference to a previous action in debconf which is always discouraged. . - When Linux headers are provided by a kernel-headers-* package, they reside in + Headers provided by a kernel-headers-* package are located in /usr/src/kernel-headers-*. More direct style. Template: wacom-kernel-source/wrong_kernel Type: boolean Default: false -_Description: Do you wish to specify a different Linux headers directory? - The directory you have provided is not a valid Linux headers location. +_Description: Specify a different Linux headers directory? + No valid Linux headers were found in the directory you specified. Different style, more direct....and mor ecommon when compared to other packages Template: wacom-kernel-source/module_location Type: note -_Description: What to do after module compilation +_Description: Operations needed ofter modules compilation Frankly, this note is debatable. I'd advise to remove it completely as it is very close to debconf abuse..:-) The rewrite essentially aims at shorten it down. The wacom-kernel-modules package will be built in /usr/src/modules. You will - have to install it yourself after it is created and can do so from that - directory using: - . - dpkg -i wacom-kernel-module-<version>.deb + have to install it yourself after it is created, with 'dpkg -i wacom-kernel-module-<version>.deb'. This operation cannot be done automatically. . - Unfortunately that cannot be done automatically at this stage because dpkg - is not able to be called recursively. + The wacom-kernel-source package becomes useless once the module package is installed, unless kernel upgrades happen later. . - Once the module package is installed, you probably won't need the - wacom-kernel-source package anymore unless you plan to update your kernel - again later. In that case you can safely purge it completely with 'dpkg -P - wacom-kernel-source'. Otherwise, you will be able to rebuild the - wacom-kernel-modules package in this manner at any time with `dpkg-reconfigure - wacom-kernel-source`. You will be prompted once again for the location of the - kernel headers to use. - . - If you update the wacom-kernel-source package at some later time (or remove it - without purging, then reinstall) the answers you have given here will be used - to repeat this process and create a new module package for you to install. + If the wacom-kernel-source package is updated later, th current opeations + will occur again, using your original answers. Template: wacom-kernel-source/verbose Type: boolean Default: false -_Description: Do you want to watch the module compilation progress? +_Description: Follow the module compilation progress? The process of building a binary package may produce quite a lot of output. - Seeing this output may be useful if you have problems with it building, - or annoying if you don't want the extra noise. + It may be useful if problems arise during the build. Shorter and more direct, again. Template: wacom-kernel-source/erase Type: boolean Default: false -_Description: Do you want to delete the wacom-kernel-modules packages? - There are binary wacom-kernel-modules packages left in /usr/src(/modules) that - were generated from this package. Once you have manually installed them you - don't need those packages anymore, though you may like to keep them for backup - or re-installation purposes. +_Description: Delete the wacom-kernel-modules packages? + Some binary wacom-kernel-modules packages were left in /usr/src(/modules). + Once they have been installed, they're not useful anymore and may be removed + unless you want to keep them for backup or re-installation purposes. And ditto again. --- ../wacom-tools.old/debian/wacom.po-templates 2007-09-07 06:08:14.344854999 +0200 +++ debian/wacom.po-templates 2007-09-11 07:21:56.241559676 +0200 @@ -1,15 +1,17 @@ Template: wacom-kernel-modules/moduleorder Type: note -_Description: The wacom module must be loaded before the HID module. - If the wacom driver is not loaded before the normal Linux HID driver then the +Description: Load the wacom module before the HID module Avoid a really complete sentence on a note title. This template is also, imho, very close to debconf abuse. + If the wacom driver is not loaded before the normal Linux HID (Human Interface Driver), the HID will have already claimed the device as a generic mouse and the wacom - driver will be ignored. This package may also replace some modules out of - your running kernel. It is typically not safe for this installer to - automatically unload the HID module and insert the wacom driver beneath it, - nor to automatically remove any of the other affected modules. - If you wish to install the wacom module without rebooting the machine you will + driver will be ignored. + . Split ideas in two paragraphs. + This package may also replace some modules out of + the running kernel. An automated unloading of the HID module, with insertion + of the wacom module beneath it, would be unsafe and therefore not attempted. + . + If you wish to install the wacom module without rebooting the machine, you will need to shut down all processes that use the HID module and its dependents and - unload them manually before installing the wacom module. The simplest thing to + unload them manually before installing the wacom module. The simplest thing to do is reboot the machine at some convenient opportunity after the package install is complete and let the new modules configuration determine the proper loading order. --- ../wacom-tools.old/debian/control 2007-09-07 06:08:14.344854999 +0200 +++ debian/control 2007-09-11 07:38:31.197844678 +0200 @@ -9,33 +9,33 @@ Section: devel Architecture: all Depends: build-essential, debhelper (>= 4.1.16), libx11-dev, ${misc:Depends} -Description: source for the wacom binary modules - This package provides the source code for the wacom kernel and X11 modules. +Description: source for the Wacom binary modules Consistent spelling among the package + This package provides the source code for the Wacom kernel and X11 modules. You will need a kernel headers package or properly configured source for - your running kernel to create the binary module package. + the running kernel to create the binary module package. Unpersonnalize Package: wacom-tools Section: utils Architecture: any Depends: ${shlibs:Depends} -Description: utilities for wacom tablets and other hid devices - This package provides utilities to test and configure wacom graphics tablets. +Description: utilities for Wacom tablets and other HID devices + This package provides utilities to test and configure Wacom graphics tablets. You will need kernel modules built from the wacom-kernel-source package to - use them with such devices. It also provides hotplug and udev scripts which - may be useful without these tools and (later) with the wacom support in the + use them with such devices. It also provides hotplug and udev scripts which + may be useful without these tools and (later) with the Wacom support in the mainline kernel packages as wellperso (2.6.11 or later). Remove double spaces (we try to recommend the use of single spaces after sentence dots).
Template: wacom-kernel-source/module Type: boolean Default: true _Description: Automatically compile the Wacom modules? In order to make full use of a Wacom graphics tablet you need to compile and install the provided modules to suit the running Linux kernel. . If you choose this option, the Wacom modules will be compiled into a binary package using local kernel configuration settings. . A kernel-headers-* package fitting the currently running kernel needs to be installed. Alternatively, a suitably configured kernel source tree may replace it. Do not choose this option if none of these are available. . Once these requirements are met, you can launch this setup step with 'dpkg-reconfigure wacom-kernel-source'. Template: wacom-kernel-source/recompile Type: boolean Default: true _Description: Create a binary wacom-kernel-modules package? If you choose this option, the Wacom modules will be compiled into a binary package using local kernel configuration settings. . A kernel-headers-* package fitting the currently running kernel needs to be installed. Alternatively, a suitably configured kernel source tree may replace it. Do not choose this option if none of these are available. . Once these requirements are met, you can launch this setup step with 'dpkg-reconfigure wacom-kernel-source'. . This may replace some modules that were originally built with the running kernel. Template: wacom-kernel-source/kernel Type: string Default: /usr/src/linux/ _Description: Linux header files location: In order to compile the Wacom modules, please enter the location of the Linux kernel headers for them to use. . Headers provided by a kernel-headers-* package are located in /usr/src/kernel-headers-*. Template: wacom-kernel-source/wrong_kernel Type: boolean Default: false _Description: Specify a different Linux headers directory? No valid Linux headers were found in the directory you specified. Template: wacom-kernel-source/module_location Type: note _Description: Operations needed ofter modules compilation The wacom-kernel-modules package will be built in /usr/src/modules. You will have to install it yourself after it is created, with 'dpkg -i wacom-kernel-module-<version>.deb'. This operation cannot be done automatically. . The wacom-kernel-source package becomes useless once the module package is installed, unless kernel upgrades happen later. . If the wacom-kernel-source package is updated later, th current opeations will occur again, using your original answers. Template: wacom-kernel-source/verbose Type: boolean Default: false _Description: Follow the module compilation progress? The process of building a binary package may produce quite a lot of output. It may be useful if problems arise during the build. Template: wacom-kernel-source/erase Type: boolean Default: false _Description: Delete the wacom-kernel-modules packages? Some binary wacom-kernel-modules packages were left in /usr/src(/modules). Once they have been installed, they're not useful anymore and may be removed unless you want to keep them for backup or re-installation purposes.
Template: wacom-kernel-modules/moduleorder Type: note Description: Load the wacom module before the HID module If the wacom driver is not loaded before the normal Linux HID (Human Interface Driver), the HID will have already claimed the device as a generic mouse and the wacom driver will be ignored. . This package may also replace some modules out of the running kernel. An automated unloading of the HID module, with insertion of the wacom module beneath it, would be unsafe and therefore not attempted. . If you wish to install the wacom module without rebooting the machine, you will need to shut down all processes that use the HID module and its dependents and unload them manually before installing the wacom module. The simplest thing to do is reboot the machine at some convenient opportunity after the package install is complete and let the new modules configuration determine the proper loading order.
--- ../wacom-tools.old/debian/wacom-kernel-source.templates 2007-09-07 06:08:14.344854999 +0200 +++ debian/wacom-kernel-source.templates 2007-09-11 07:36:34.203746040 +0200 @@ -1,100 +1,77 @@ Template: wacom-kernel-source/module Type: boolean Default: true -_Description: Would you like the wacom modules to be compiled automatically? - In order to make full use of a wacom graphics tablet you need to compile and - install the provided modules to suit your running Linux kernel. - . - If you opt to do this, the wacom modules will be compiled into a Debian binary - package using a local kernel configuration which you will be required to - specify. You must have either a kernel-headers-* package installed to suit - the kernel you wish to use it with, or have a suitably configured kernel - source tree available. If you do not currently have either of these available - you should choose not to do this at present. Once you have suitable headers - installed you can return to this selection with: - . - dpkg-reconfigure wacom-kernel-source - . - Alternatively, you might prefer to build it manually. The source to do this - can be found in /usr/src/modules/wacom. You may use a tool like make-kpkg(1) - or `fakeroot debian/rules kdist [ KSRC=... KVERS=... ]` to create - a Debian package as above, or you can simply `configure && make` and install - it by hand. +_Description: Automatically compile the Wacom modules? + In order to make full use of a Wacom graphics tablet you need to compile and + install the provided modules to suit the running Linux kernel. + . + If you choose this option, the Wacom modules will be compiled into a + binary package using local kernel configuration settings. + . + A kernel-headers-* package fitting the currently running kernel + needs to be installed. Alternatively, a suitably configured kernel + source tree may replace it. Do not choose this option if none of these + are available. + . + Once these requirements are met, you can launch this setup step with + 'dpkg-reconfigure wacom-kernel-source'. Template: wacom-kernel-source/recompile Type: boolean Default: true -_Description: Would you like to create a binary wacom-kernel-modules package now? - If you opt to do this, the wacom modules will be compiled into a Debian binary - package using a local kernel configuration which you will be required to - specify. You must have either a kernel-headers-* package installed to suit - the kernel you wish to use it with, or have a suitably configured kernel - source tree available. If you do not currently have either of these available - you should choose not to do this at present. Once you have suitable headers - installed you can return to this selection with: - . - dpkg-reconfigure wacom-kernel-source - . - Note this package may replace some modules that were originally built with - your running kernel. You should ensure the original modules can be replaced - in the event of trouble before installing the resulting package. Also if you - have already built a wacom-kernel-modules package in this way using the same - kernel version then that package may be overwritten. You should rename or - relocate it before continuing if you wish to preserve it. +_Description: Create a binary wacom-kernel-modules package? + If you choose this option, the Wacom modules will be compiled into a + binary package using local kernel configuration settings. + . + A kernel-headers-* package fitting the currently running kernel + needs to be installed. Alternatively, a suitably configured kernel + source tree may replace it. Do not choose this option if none of these + are available. + . + Once these requirements are met, you can launch this setup step with + 'dpkg-reconfigure wacom-kernel-source'. + . + This may replace some modules that were originally built with + the running kernel. Template: wacom-kernel-source/kernel Type: string Default: /usr/src/linux/ -_Description: Linux headers location: - You have choosen to compile the wacom modules, so you must specify the location +_Description: Linux header files location: + In order to compile the Wacom modules, please enter the location of the Linux kernel headers for them to use. . - When Linux headers are provided by a kernel-headers-* package, they reside in + Headers provided by a kernel-headers-* package are located in /usr/src/kernel-headers-*. Template: wacom-kernel-source/wrong_kernel Type: boolean Default: false -_Description: Do you wish to specify a different Linux headers directory? - The directory you have provided is not a valid Linux headers location. +_Description: Specify a different Linux headers directory? + No valid Linux headers were found in the directory you specified. Template: wacom-kernel-source/module_location Type: note -_Description: What to do after module compilation +_Description: Operations needed ofter modules compilation The wacom-kernel-modules package will be built in /usr/src/modules. You will - have to install it yourself after it is created and can do so from that - directory using: - . - dpkg -i wacom-kernel-module-<version>.deb + have to install it yourself after it is created, with 'dpkg -i wacom-kernel-module-<version>.deb'. This operation cannot be done automatically. . - Unfortunately that cannot be done automatically at this stage because dpkg - is not able to be called recursively. + The wacom-kernel-source package becomes useless once the module package is installed, unless kernel upgrades happen later. . - Once the module package is installed, you probably won't need the - wacom-kernel-source package anymore unless you plan to update your kernel - again later. In that case you can safely purge it completely with 'dpkg -P - wacom-kernel-source'. Otherwise, you will be able to rebuild the - wacom-kernel-modules package in this manner at any time with `dpkg-reconfigure - wacom-kernel-source`. You will be prompted once again for the location of the - kernel headers to use. - . - If you update the wacom-kernel-source package at some later time (or remove it - without purging, then reinstall) the answers you have given here will be used - to repeat this process and create a new module package for you to install. + If the wacom-kernel-source package is updated later, th current opeations + will occur again, using your original answers. Template: wacom-kernel-source/verbose Type: boolean Default: false -_Description: Do you want to watch the module compilation progress? +_Description: Follow the module compilation progress? The process of building a binary package may produce quite a lot of output. - Seeing this output may be useful if you have problems with it building, - or annoying if you don't want the extra noise. + It may be useful if problems arise during the build. Template: wacom-kernel-source/erase Type: boolean Default: false -_Description: Do you want to delete the wacom-kernel-modules packages? - There are binary wacom-kernel-modules packages left in /usr/src(/modules) that - were generated from this package. Once you have manually installed them you - don't need those packages anymore, though you may like to keep them for backup - or re-installation purposes. +_Description: Delete the wacom-kernel-modules packages? + Some binary wacom-kernel-modules packages were left in /usr/src(/modules). + Once they have been installed, they're not useful anymore and may be removed + unless you want to keep them for backup or re-installation purposes. --- ../wacom-tools.old/debian/wacom.po-templates 2007-09-07 06:08:14.344854999 +0200 +++ debian/wacom.po-templates 2007-09-11 07:21:56.241559676 +0200 @@ -1,15 +1,17 @@ Template: wacom-kernel-modules/moduleorder Type: note -_Description: The wacom module must be loaded before the HID module. - If the wacom driver is not loaded before the normal Linux HID driver then the +Description: Load the wacom module before the HID module + If the wacom driver is not loaded before the normal Linux HID (Human Interface Driver), the HID will have already claimed the device as a generic mouse and the wacom - driver will be ignored. This package may also replace some modules out of - your running kernel. It is typically not safe for this installer to - automatically unload the HID module and insert the wacom driver beneath it, - nor to automatically remove any of the other affected modules. - If you wish to install the wacom module without rebooting the machine you will + driver will be ignored. + . + This package may also replace some modules out of + the running kernel. An automated unloading of the HID module, with insertion + of the wacom module beneath it, would be unsafe and therefore not attempted. + . + If you wish to install the wacom module without rebooting the machine, you will need to shut down all processes that use the HID module and its dependents and - unload them manually before installing the wacom module. The simplest thing to + unload them manually before installing the wacom module. The simplest thing to do is reboot the machine at some convenient opportunity after the package install is complete and let the new modules configuration determine the proper loading order. --- ../wacom-tools.old/debian/control 2007-09-07 06:08:14.344854999 +0200 +++ debian/control 2007-09-11 07:38:31.197844678 +0200 @@ -9,33 +9,33 @@ Section: devel Architecture: all Depends: build-essential, debhelper (>= 4.1.16), libx11-dev, ${misc:Depends} -Description: source for the wacom binary modules - This package provides the source code for the wacom kernel and X11 modules. +Description: source for the Wacom binary modules + This package provides the source code for the Wacom kernel and X11 modules. You will need a kernel headers package or properly configured source for - your running kernel to create the binary module package. + the running kernel to create the binary module package. Package: wacom-tools Section: utils Architecture: any Depends: ${shlibs:Depends} -Description: utilities for wacom tablets and other hid devices - This package provides utilities to test and configure wacom graphics tablets. +Description: utilities for Wacom tablets and other HID devices + This package provides utilities to test and configure Wacom graphics tablets. You will need kernel modules built from the wacom-kernel-source package to - use them with such devices. It also provides hotplug and udev scripts which - may be useful without these tools and (later) with the wacom support in the + use them with such devices. It also provides hotplug and udev scripts which + may be useful without these tools and (later) with the Wacom support in the mainline kernel packages as well (2.6.11 or later). Package: xserver-xorg-input-wacom Section: x11 Architecture: any Depends: ${shlibs:Depends} -Description: X.Org X server -- wacom input driver - This package provides the driver for wacom tablet devices. +Description: X.Org X server -- Wacom input driver + This package provides the driver for Wacom tablet devices. . - Note that it is not a part of the X.Org distribution since X11R6, this driver - is from the linuxwacom project. See http://linuxwacom.sf.net for details. + Note that it is not a part of the X.Org distribution since X11R6: this driver + is from the linuxwacom project. See http://linuxwacom.sf.net for details. . - You will also require a kernel module which supports your tablet. Many types - are supported by the module supplied with current Linux kernels. If yours is + You will also require a kernel module which supports your tablet. Many types + are supported by the module supplied with current Linux kernels. If yours is not one of them (yet), see the wacom-kernel-source package for the most up to date module available.
Source: wacom-tools Section: graphics Priority: optional Maintainer: Ron Lee <ron@debian.org> Build-Depends: debhelper (>= 5.0.0), po-debconf, xserver-xorg-dev, libxi-dev, libxt-dev, libncurses5-dev Standards-Version: 3.7.2.2 Package: wacom-kernel-source Section: devel Architecture: all Depends: build-essential, debhelper (>= 4.1.16), libx11-dev, ${misc:Depends} Description: source for the Wacom binary modules This package provides the source code for the Wacom kernel and X11 modules. You will need a kernel headers package or properly configured source for the running kernel to create the binary module package. Package: wacom-tools Section: utils Architecture: any Depends: ${shlibs:Depends} Description: utilities for Wacom tablets and other HID devices This package provides utilities to test and configure Wacom graphics tablets. You will need kernel modules built from the wacom-kernel-source package to use them with such devices. It also provides hotplug and udev scripts which may be useful without these tools and (later) with the Wacom support in the mainline kernel packages as well (2.6.11 or later). Package: xserver-xorg-input-wacom Section: x11 Architecture: any Depends: ${shlibs:Depends} Description: X.Org X server -- Wacom input driver This package provides the driver for Wacom tablet devices. . Note that it is not a part of the X.Org distribution since X11R6: this driver is from the linuxwacom project. See http://linuxwacom.sf.net for details. . You will also require a kernel module which supports your tablet. Many types are supported by the module supplied with current Linux kernels. If yours is not one of them (yet), see the wacom-kernel-source package for the most up to date module available.
Attachment:
signature.asc
Description: Digital signature