Please find, for review, the debconf templates and packages descriptions for the glide source package.
This review will last from Monday, March 30, 2009 to Thursday, April 09, 2009.
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:
--- glide.old/debian/libglide2.templates 2009-02-14 12:18:12.951869029 +0100
+++ glide/debian/libglide2.templates 2009-03-24 07:26:04.664963077 +0100
@@ -1,43 +1,40 @@
Template: libglide2/no_card
Type: boolean
Default: false
-_Description: No 3Dfx card supported by glide2 found! Manually select driver?
- ERROR: No 3Dfx card supported by glide2 found!
- .
- This package is for cards based on the following 3Dfx chipsets: Voodoo 2,
+_Description: Manually select driver for 3Dfx card?
+ No 3Dfx card that is supported by glide2 was found. This package
+ supports cards based on the following 3Dfx chipsets: Voodoo 2,
Voodoo Banshee, and Voodoo 3.
Avoid two sentences in the synopsis. This very unusual (and too long
for translators).
Avoid exclamative form. This is too non neutral and such texts should
be as factual as possible.
.
- If you do not have a card based on one of the listed chipsets, and you are
- not compiling programs against glide, you should not have this package
- installed.
- .
- If you do have a card based on one of the listed chipsets please file a
- bug on this package, including the output from the command 'lspci -vm' in
- the bug report.
+ If the graphical card in this computer does not use one of these
+ chipsets, and you are not compiling programs against glide,
+ this package will be useless.
+ .
+ If the graphical card is based on one of these chipsets, you
+ should report a bug against this package, including the output from the
+ "lspci -vm" command.
.
- Would you like to manually select the driver to use for now? (If not, a
- default sane value for compiling against will be selected.)
+ Please choose whether you want to manually select the driver to use for now.
One does not necessarily "have" a card. That could be someone else's
computer, etc.
Turn "you should not have this package" into "this package becomes
useless". After all, I do what I want and I'm perfectly entitled to
have a package that's useless..:-)
Turn "file a bug" into "report a bug".
Drop extra question (that will save you one lintian warning) and just
summarize the request in the last paragraph.
Template: libglide2/driver
Type: select
Choices: cvg, h3
Default: ${default}
-_Description: Please select a driver.
- Please select the driver you would like to use.
- .
- cvg - Voodoo 2.
- h3 - Voodoo Banshee and Voodoo 3.
+_Description: Driver for 3D acceleration:
+ Please select the driver you would like to use for 3D acceleration:
+ - cvg: Voodoo 2;
+ - h3 : Voodoo Banshee and Voodoo 3.
Use a proper "prompt" for a select template. I added "for 3D
acceleration" to make it clearer this has to do with the glide stuff.
Use recommended itemization style and do not make it a separate paragraph.
Template: libglide2/card
Type: select
Choices: ${choices}
-_Description: Please select a card.
- We have detected more then one video card based on the following 3Dfx
- chipsets: Voodoo 2, Voodoo Banshee, and Voodoo 3.
+_Description: Card to use for 3D acceleration:
+ More than one 3Dfx-based cards were detected that use one of the
+ following 3Dfx chipsets: Voodoo 2, Voodoo Banshee, and Voodoo 3.
.
Please select the card you would like to use for 3D acceleration.
"We" is nobody. Don't personnalize the computer. So, use passive voice.
Template: libglide2/error
Type: note
-_Description: ${e1}
+Description: ${e1}
${e2}
This is not translatable...
--- glide.old/debian/libglide3.templates 2009-02-14 12:18:12.955870218 +0100
+++ glide/debian/libglide3.templates 2009-03-24 07:26:06.068964458 +0100
@@ -1,43 +1,40 @@
Changes are identical for that template. I won't go into the same
rationale details.
--- glide.old/debian/control 2009-02-14 12:18:12.951869029 +0100
+++ glide/debian/control 2009-03-24 07:28:21.448962989 +0100
@@ -16,7 +16,7 @@
Depends: ${shlibs:Depends}
Suggests: device3dfx-module, device3dfx-source
Description: graphics library for 3Dfx Voodoo based cards - support programs
- This is a support package which should be installed if you have a
+ This is a support package which should be installed if you use a
card based on 3dfx Interactive, Inc's Voodoo chipsets.
s/have/use
Package: libglide2
@@ -29,15 +29,15 @@
Description: graphics library for 3Dfx Voodoo based cards - shared libraries
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo 2 chipsets. You should install it if
- you have such a card.
+ you use such a card.
.
- Note, this is NOT the package you want for Voodoo Banshee, Voodoo 3,
- Voodoo 4, or Voodoo 5.
+ This package is not useful with Voodoo Banshee, Voodoo 3,
+ Voodoo 4, or Voodoo 5 cards.
.
- Also note that for the moment the original Voodoo Graphics chipset
+ Additionnally, the original Voodoo Graphics chipset
is no longer supported.
.
- NOTE: You'll need the /dev/3dfx kernel driver to use this library.
+ You'll need the /dev/3dfx kernel driver to use this library.
Do not yell..:-). Instead of "not the package you want", just use "not
useful". Again, I could want a package even if it's useless...
We generally recommend dropping "NOTE:" stuff.
Package: libglide2-dev
Section: libdevel
@@ -61,9 +61,9 @@
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo Banshee, Voodoo 3, Voodoo 4, and
Voodoo 5, chipsets.
- You should install it if you have such a card.
+ You should install it if you use such a card.
.
- NB: This package does NOT need device3dfx, as it is using DRI instead.
+ This package does not need device3dfx, as it is using DRI instead.
Package: libglide3-dev
Section: libdevel
Same changes.
--
Template: libglide2/no_card
Type: boolean
Default: false
_Description: Manually select driver for 3Dfx card?
No 3Dfx card that is supported by glide2 was found. This package
supports cards based on the following 3Dfx chipsets: Voodoo 2,
Voodoo Banshee, and Voodoo 3.
.
If the graphical card in this computer does not use one of these
chipsets, and you are not compiling programs against glide,
this package will be useless.
.
If the graphical card is based on one of these chipsets, you
should report a bug against this package, including the output from the
"lspci -vm" command.
.
Please choose whether you want to manually select the driver to use for now.
Template: libglide2/driver
Type: select
Choices: cvg, h3
Default: ${default}
_Description: Driver for 3D acceleration:
Please select the driver you would like to use for 3D acceleration:
- cvg: Voodoo 2;
- h3 : Voodoo Banshee and Voodoo 3.
Template: libglide2/card
Type: select
Choices: ${choices}
_Description: Card to use for 3D acceleration:
More than one 3Dfx-based cards were detected that use one of the
following 3Dfx chipsets: Voodoo 2, Voodoo Banshee, and Voodoo 3.
.
Please select the card you would like to use for 3D acceleration.
Template: libglide2/error
Type: note
Description: ${e1}
${e2}
Template: libglide3/no_card
Type: boolean
Default: false
_Description: Manually select driver for 3Dfx card?
No 3Dfx card that is supported by glide3 was found. This package
supports cards based on the following 3Dfx chipsets: Voodoo
Banshee, Voodoo 3, Voodoo 4, and Voodoo 5.
.
If the graphical card in this computer does not use one of these
chipsets, and you are not compiling programs against glide,
this package will be useless.
.
If the graphical card is based on one of these chipsets, you
should report a bug against this package, including the output from the
"lspci -vm" command.
.
Please choose whether you want to manually select the driver to use for now.
Template: libglide3/driver
Type: select
Choices: h3, h5
Default: ${default}
_Description: Driver for 3D acceleration:
Please select the driver you would like to use for 3D acceleration:
- h3: Voodoo Banshee and Voodoo 3;
- h5: Voodoo 4 and Voodoo 5.
Template: libglide3/card
Type: select
Choices: ${choices}
_Description: Card to use for 3D acceleration:
More than one 3Dfx-based cards were detected that use one of the
following 3Dfx chipsets: Voodoo 2, Voodoo Banshee, Voodoo 3, Voodoo 4, and Voodoo 5.
.
Please select the card you would like to use for 3D acceleration.
Template: libglide3/error
Type: note
Description: ${e1}
${e2}
--- glide.old/debian/libglide2.templates 2009-02-14 12:18:12.951869029 +0100
+++ glide/debian/libglide2.templates 2009-03-30 07:13:21.192152966 +0200
@@ -1,43 +1,40 @@
Template: libglide2/no_card
Type: boolean
Default: false
-_Description: No 3Dfx card supported by glide2 found! Manually select driver?
- ERROR: No 3Dfx card supported by glide2 found!
- .
- This package is for cards based on the following 3Dfx chipsets: Voodoo 2,
+_Description: Manually select driver for 3Dfx card?
+ No 3Dfx card that is supported by glide2 was found. This package
+ supports cards based on the following 3Dfx chipsets: Voodoo 2,
Voodoo Banshee, and Voodoo 3.
.
- If you do not have a card based on one of the listed chipsets, and you are
- not compiling programs against glide, you should not have this package
- installed.
- .
- If you do have a card based on one of the listed chipsets please file a
- bug on this package, including the output from the command 'lspci -vm' in
- the bug report.
+ If the graphical card in this computer does not use one of these
+ chipsets, and you are not compiling programs against glide,
+ this package will be useless.
+ .
+ If the graphical card is based on one of these chipsets, you
+ should report a bug against this package, including the output from the
+ "lspci -vm" command.
.
- Would you like to manually select the driver to use for now? (If not, a
- default sane value for compiling against will be selected.)
+ Please choose whether you want to manually select the driver to use for now.
Template: libglide2/driver
Type: select
Choices: cvg, h3
Default: ${default}
-_Description: Please select a driver.
- Please select the driver you would like to use.
- .
- cvg - Voodoo 2.
- h3 - Voodoo Banshee and Voodoo 3.
+_Description: Driver for 3D acceleration:
+ Please select the driver you would like to use for 3D acceleration:
+ - cvg: Voodoo 2;
+ - h3 : Voodoo Banshee and Voodoo 3.
Template: libglide2/card
Type: select
Choices: ${choices}
-_Description: Please select a card.
- We have detected more then one video card based on the following 3Dfx
- chipsets: Voodoo 2, Voodoo Banshee, and Voodoo 3.
+_Description: Card to use for 3D acceleration:
+ More than one 3Dfx-based cards were detected that use one of the
+ following 3Dfx chipsets: Voodoo 2, Voodoo Banshee, and Voodoo 3.
.
Please select the card you would like to use for 3D acceleration.
Template: libglide2/error
Type: note
-_Description: ${e1}
+Description: ${e1}
${e2}
--- glide.old/debian/libglide3.templates 2009-02-14 12:18:12.955870218 +0100
+++ glide/debian/libglide3.templates 2009-03-30 07:13:20.224153095 +0200
@@ -1,43 +1,40 @@
Template: libglide3/no_card
Type: boolean
Default: false
-_Description: No 3Dfx card supported by glide3 found! Manually select driver?
- ERROR: No 3Dfx card supported by glide3 found!
- .
- This package is for cards based on the following 3Dfx chipsets: Voodoo
+_Description: Manually select driver for 3Dfx card?
+ No 3Dfx card that is supported by glide3 was found. This package
+ supports cards based on the following 3Dfx chipsets: Voodoo
Banshee, Voodoo 3, Voodoo 4, and Voodoo 5.
.
- If you do not have a card based on one of the listed chipsets, and you are
- not compiling programs against glide, you should not have this package
- installed.
- .
- If you do have a card based on one of the listed chipsets please file a
- bug on this package, including the output from the command 'lspci -vm' in
- the bug report.
+ If the graphical card in this computer does not use one of these
+ chipsets, and you are not compiling programs against glide,
+ this package will be useless.
+ .
+ If the graphical card is based on one of these chipsets, you
+ should report a bug against this package, including the output from the
+ "lspci -vm" command.
.
- Would you like to manually select the driver to use for now? (If not, a
- default sane value for compiling against will be selected.)
+ Please choose whether you want to manually select the driver to use for now.
Template: libglide3/driver
Type: select
Choices: h3, h5
Default: ${default}
-_Description: Please select a driver.
- Please select the driver you would like to use.
- .
- h3 - Voodoo Banshee and Voodoo 3.
- h5 - Voodoo 4 and Voodoo 5.
+_Description: Driver for 3D acceleration:
+ Please select the driver you would like to use for 3D acceleration:
+ - h3: Voodoo Banshee and Voodoo 3;
+ - h5: Voodoo 4 and Voodoo 5.
Template: libglide3/card
Type: select
Choices: ${choices}
-_Description: Please select a card.
- We have detected more then one video card based on the following 3Dfx
- chipsets: Voodoo 2, Voodoo Banshee, Voodoo 3, Voodoo 4, and Voodoo 5.
+_Description: Card to use for 3D acceleration:
+ More than one 3Dfx-based cards were detected that use one of the
+ following 3Dfx chipsets: Voodoo 2, Voodoo Banshee, Voodoo 3, Voodoo 4, and Voodoo 5.
.
Please select the card you would like to use for 3D acceleration.
Template: libglide3/error
Type: note
-_Description: ${e1}
+Description: ${e1}
${e2}
--- glide.old/debian/control 2009-02-14 12:18:12.951869029 +0100
+++ glide/debian/control 2009-03-24 07:28:21.448962989 +0100
@@ -16,7 +16,7 @@
Depends: ${shlibs:Depends}
Suggests: device3dfx-module, device3dfx-source
Description: graphics library for 3Dfx Voodoo based cards - support programs
- This is a support package which should be installed if you have a
+ This is a support package which should be installed if you use a
card based on 3dfx Interactive, Inc's Voodoo chipsets.
Package: libglide2
@@ -29,15 +29,15 @@
Description: graphics library for 3Dfx Voodoo based cards - shared libraries
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo 2 chipsets. You should install it if
- you have such a card.
+ you use such a card.
.
- Note, this is NOT the package you want for Voodoo Banshee, Voodoo 3,
- Voodoo 4, or Voodoo 5.
+ This package is not useful with Voodoo Banshee, Voodoo 3,
+ Voodoo 4, or Voodoo 5 cards.
.
- Also note that for the moment the original Voodoo Graphics chipset
+ Additionnally, the original Voodoo Graphics chipset
is no longer supported.
.
- NOTE: You'll need the /dev/3dfx kernel driver to use this library.
+ You'll need the /dev/3dfx kernel driver to use this library.
Package: libglide2-dev
Section: libdevel
@@ -61,9 +61,9 @@
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo Banshee, Voodoo 3, Voodoo 4, and
Voodoo 5, chipsets.
- You should install it if you have such a card.
+ You should install it if you use such a card.
.
- NB: This package does NOT need device3dfx, as it is using DRI instead.
+ This package does not need device3dfx, as it is using DRI instead.
Package: libglide3-dev
Section: libdevel
Source: glide
Section: libs
Priority: optional
Build-Depends: dbs (>= 0.25), debhelper (>= 5), autoconf, automake,
libtool (>= 1.5), libx11-dev, libxext-dev, libxxf86dga-dev, libxxf86vm-dev
Build-Conflicts: automake1.4
Maintainer: Guillem Jover <guillem@debian.org>
Homepage: http://glide.sf.net/
Vcs-Browser: http://git.hadrons.org/?p=debian/pkgs/glide.git
Vcs-Git: git://git.hadrons.org/git/debian/pkgs/glide.git
Standards-Version: 3.7.3
Package: glide2-bin
Section: graphics
Architecture: i386
Depends: ${shlibs:Depends}
Suggests: device3dfx-module, device3dfx-source
Description: graphics library for 3Dfx Voodoo based cards - support programs
This is a support package which should be installed if you use a
card based on 3dfx Interactive, Inc's Voodoo chipsets.
Package: libglide2
Section: libs
Architecture: i386
Depends: ${shlibs:Depends}, ${misc:Depends}, pciutils
Recommends: glide2-bin
Suggests: device3dfx-module, device3dfx-source
Conflicts: libglide2
Description: graphics library for 3Dfx Voodoo based cards - shared libraries
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo 2 chipsets. You should install it if
you use such a card.
.
This package is not useful with Voodoo Banshee, Voodoo 3,
Voodoo 4, or Voodoo 5 cards.
.
Additionnally, the original Voodoo Graphics chipset
is no longer supported.
.
You'll need the /dev/3dfx kernel driver to use this library.
Package: libglide2-dev
Section: libdevel
Architecture: i386
Depends: libglide2
Provides: libglide-dev
Conflicts: llibglide-dev
Description: graphics library for 3Dfx Voodoo based cards - development files
This package contains the necessary header files, example programs,
and documentation necessary to develop software for cards based on
3dfx Interactive, Inc's Voodoo chipsets.
Package: libglide3
Section: libs
Architecture: i386 alpha ia64 amd64
Depends: ${shlibs:Depends}, ${misc:Depends}, pciutils
Provides: libglide3-alpha
Replaces: libglide3-alpha, libglide3-dev
Conflicts: libglide3, libglide3-alpha
Description: graphics library for 3Dfx Voodoo based cards - shared libraries
This package allows you to use the 3D functions of cards based on
3dfx Interactive, Inc's Voodoo Banshee, Voodoo 3, Voodoo 4, and
Voodoo 5, chipsets.
You should install it if you use such a card.
.
This package does not need device3dfx, as it is using DRI instead.
Package: libglide3-dev
Section: libdevel
Architecture: i386 alpha ia64 amd64
Depends: libglide3
Provides: libglide-dev, libglide3-alpha-dev
Replaces: libglide2-dev, libglide3-alpha-dev
Conflicts: libglide3-alpha-dev
Description: graphics library for 3Dfx Voodoo based cards - development files
This package contains the necessary header files, example programs,
and documentation necessary to develop software for cards based on
3dfx Interactive, Inc's Voodoo chipsets.
Attachment:
signature.asc
Description: Digital signature