Please find, for review, the debconf templates and packages descriptions for the tvtime source package.
This review will last from Wednesday, June 17, 2009 to Saturday, June 27, 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:
--- tvtime.old/debian/templates 2009-06-11 07:22:28.836198377 +0200
+++ tvtime/debian/templates 2009-06-11 08:19:15.094897561 +0200
@@ -1,52 +1,61 @@
Template: tvtime/norm
Type: select
-_Choices: NTSC, PAL, SECAM, PAL-Nc, PAL-M, PAL-N, NTSC-JP, PAL-60
-_Description: Default television standard for your location:
- North American users should select NTSC. Most areas in the world use PAL.
+Choices: NTSC, PAL, SECAM, PAL-Nc, PAL-M, PAL-N, NTSC-JP, PAL-60
+_Description: TV standard:
+ Please choose the TV standard to use. NTSC is used in North America,
+ much of South America, and Japan; SECAM in France, the former USSR,
+ and parts of Africa and the Middle East; and PAL elsewhere.
Exact same template than freevo, which we just reviewed (simple
coincidence, indeed).
Choices are marked untranslatable. Standard names are not translatable
material.
Shorten the synopsis and avoid "your location" on the rationale that
the location of the machine is not necessarily "mine" ;.:-)
Make the long description less centric to some parts of the world.
Template: tvtime/frequencies-ntsc
Type: select
-_Choices: Cable, Broadcast, Cable including channels 100+
+__Choices: Cable, Broadcast, Cable including channels 100+
_Description: Default frequency table:
- The frequency table specifies which frequencies correspond to the familiar
- channel numbers. Select broadcast if you use an antenna for over-the-air
+ Please choose the frequency table to use. It specifies which frequencies correspond to the familiar
+ channel numbers.
+ .
+ You should select "Broadcast" if you use an antenna for over-the-air
signals.
Split "Choices" into individual strings. This makes translations
individualized and helps in case choices are added. This also makes
them less prone to errors (missing commas).
The former long description was a noun sentence, which we
discourage. The now standardized formula is "Please choose <foo>".
The second part is moved as an independent paragraph and thus becomes
common with the next template.
Template: tvtime/frequencies-jp
Type: select
-_Choices: Cable, Broadcast
+__Choices: Cable, Broadcast
_Description: Default frequency table:
- The frequency table specifies which frequencies correspond to the familiar
- channel numbers. Select broadcast if you use an antenna for over-the-air
+ Please choose the frequency table to use. It specifies which
+ frequencies correspond to the familiar channel numbers.
+ .
+ You should select "Broadcast" if you use an antenna for over-the-air
signals.
Similar changes
Template: tvtime/frequencies-pal
Type: select
-_Choices: Europe, France, Russia, Australia, New Zealand, China Broadcast, Australia Optus, Custom (must run tvtime-scanner first)
+__Choices: Europe, France, Russia, Australia, New-Zealand, China Broadcast, Australia Optus, Custom (must run tvtime-scanner first)
_Description: Default frequency table:
- Users of the Optus cable company in Australia should select Australia
- Optus. If you are a user of a cable company that does not use standard
- frequencies, such as Casema, UPC or Mixtics, please select Custom and run
+ Please choose the frequency table to use. It specifies which
+ frequencies correspond to the familiar channel numbers.
+ .
+ If you are a user of a cable company that does not use standard
+ frequencies, you should select "Custom" and run
the tvtime-scanner application before using tvtime.
Similar changes.
In general, I think that making explicit references to
some cable companies is risky: these things change very
often. Moreover, as a French user, I have no clue about these obscure
cable companies..:-)....why mention a special case for a given
Australian cable company?
Template: tvtime/v4ldevice
Type: string
Default: /dev/video0
_Description: Default television capture device:
- This should be the video4linux device which corresponds to your capture
+ Please choose the video4linux device which corresponds to your capture
card.
Standardize on "please choose"
Template: tvtime/vbidevice
Type: string
Default: /dev/vbi0
_Description: Device to use for VBI decoding:
- This will only be used in NTSC areas for decoding closed captions and XDS
+ Please choose the device that will be used in NTSC areas for decoding closed captions and XDS
channel information.
Ditto.
Template: tvtime/setuid
Type: boolean
Default: false
-_Description: Do you wish to make `/usr/bin/tvtime' setuid root?
+_Description: Allow tvtime to run with root privileges?
+ Please choose whether tvtime should be "setuid root", therefore getting
+ root privileges when running.
+ .
This allows tvtime to run at a high priority to ensure smooth video and
should be used for high quality video output even during high CPU load.
This is the standard formula we recommend in such occasion. "setuid
root" is jargon which we can keep for the long description. As the
consequence is running with root privileges, just say it..:-)
@@ -55,6 +64,8 @@
Default: -10
_Description: Process priority for the tvtime binary:
This setting controls the priority of the tvtime process relative to other
- processes on the system. The allowed range is from -19 to 19. Lower
+ processes on the system.
+ .
+ Allowed values are integers between -19 and 19. Lower
values indicate higher priority, and a value of 0 would give tvtime the
same priority as a normal process.
The allowed values for nice are, IIRC, integers. Mention this.
Split in two paragraph for readability.
--- tvtime.old/debian/control 2009-06-11 07:22:28.824183081 +0200
+++ tvtime/debian/control 2009-06-11 08:21:39.699311597 +0200
@@ -28,23 +28,22 @@
ucf,
Recommends: xmltv-util
Suggests: lirc-x
-Description: A high quality television application
- tvtime is a high quality television application for use with video
- capture cards. tvtime processes the input from a capture card and
- displays it on a computer monitor or projector. Unlike other
- television applications, tvtime focuses on high visual quality making
- it ideal for videophiles.
+Description: television display application
The synopsis should complete "Package <foo> provides a
......". Particularly, it is important to avoid the leading article.
Drop "high quality". This is subjective information and brings no
really useful information. I left it in the long description which is
even debatable..:)
+ This package provides a high quality television application for use with video
+ capture cards. It processes the input from a capture card and
+ displays it on a computer monitor or projector. Tvtime focuses on high
+ visual quality making it ideal for videophiles.
Using "This package provides" avoid the leading lowercase letter in a
sentence. Same for "It".
Drop comparison with other applications: what proves that they don't
also focus on high quality?
.
- tvtime supports:
- * Deinterlaced output at a full interlaced rate of 59.94 frames per
+ Main features:
+ * deinterlaced output at a full interlaced rate of 59.94 frames per
second for NTSC source, or 50 frames per second for PAL sources.
- This gives smoothness of motion and high visual quality.
- * Multiple deinterlacing algoritms for finding the optimal mode for
- your video content and available processor speed.
+ This gives smoothness of motion and high visual quality;
+ * multiple deinterlacing algorithms for finding the optimal mode for
+ the video content and available processor speed;
* 16:9 aspect ratio mode for the highest available resolution when
processing input from an external DVD player or digital satellite
- receiver.
- * A super-slick on-screen-display for the complete television
- experience, with a featureful menu system.
+ receiver;
+ * super-slick on-screen-display for the complete television
+ experience, with a featureful menu system;
* 2-3 Pulldown detection for optimal quality viewing of film content
from NTSC sources.
Replace the enumeration introduction with "Main features". Here again,
that avoids the leading article and the repetition of the software
name.
Standardize the enumeration: leading non-capitals, ending with ";",
except the last item.
--
Template: tvtime/norm Type: select Choices: NTSC, PAL, SECAM, PAL-Nc, PAL-M, PAL-N, NTSC-JP, PAL-60 _Description: TV standard: Please choose the TV standard to use. NTSC is used in North America, much of South America, and Japan; SECAM in France, the former USSR, and parts of Africa and the Middle East; and PAL elsewhere. Template: tvtime/frequencies-ntsc Type: select __Choices: Cable, Broadcast, Cable including channels 100+ _Description: Default frequency table: Please choose the frequency table to use. It specifies which frequencies correspond to the familiar channel numbers. You should select "Broadcast" if you use an antenna for over-the-air signals. Template: tvtime/frequencies-jp Type: select __Choices: Cable, Broadcast _Description: Default frequency table: Please choose the frequency table to use. It specifies which frequencies correspond to the familiar channel numbers. . You should select "Broadcast" if you use an antenna for over-the-air signals. Template: tvtime/frequencies-pal Type: select __Choices: Europe, France, Russia, Australia, New-Zealand, China Broadcast, Australia Optus, Custom (must run tvtime-scanner first) _Description: Default frequency table: Please choose the frequency table to use. It specifies which frequencies correspond to the familiar channel numbers. . If you are a user of a cable company that does not use standard frequencies, you should select "Custom" and run the tvtime-scanner application before using tvtime. Template: tvtime/v4ldevice Type: string Default: /dev/video0 _Description: Default television capture device: Please choose the video4linux device which corresponds to your capture card. Template: tvtime/vbidevice Type: string Default: /dev/vbi0 _Description: Device to use for VBI decoding: Please choose the device that will be used in NTSC areas for decoding closed captions and XDS channel information. Template: tvtime/setuid Type: boolean Default: false _Description: Allow tvtime to run with root privileges? Please choose whether tvtime should be "setuid root", therefore getting root privileges when running. . This allows tvtime to run at a high priority to ensure smooth video and should be used for high quality video output even during high CPU load. Template: tvtime/processpriority Type: string Default: -10 _Description: Process priority for the tvtime binary: This setting controls the priority of the tvtime process relative to other processes on the system. . Allowed values are integers between -19 and 19. Lower values indicate higher priority, and a value of 0 would give tvtime the same priority as a normal process.
--- tvtime.old/debian/templates 2009-06-11 07:22:28.836198377 +0200
+++ tvtime/debian/templates 2009-06-11 08:19:15.094897561 +0200
@@ -1,52 +1,61 @@
Template: tvtime/norm
Type: select
-_Choices: NTSC, PAL, SECAM, PAL-Nc, PAL-M, PAL-N, NTSC-JP, PAL-60
-_Description: Default television standard for your location:
- North American users should select NTSC. Most areas in the world use PAL.
+Choices: NTSC, PAL, SECAM, PAL-Nc, PAL-M, PAL-N, NTSC-JP, PAL-60
+_Description: TV standard:
+ Please choose the TV standard to use. NTSC is used in North America,
+ much of South America, and Japan; SECAM in France, the former USSR,
+ and parts of Africa and the Middle East; and PAL elsewhere.
Template: tvtime/frequencies-ntsc
Type: select
-_Choices: Cable, Broadcast, Cable including channels 100+
+__Choices: Cable, Broadcast, Cable including channels 100+
_Description: Default frequency table:
- The frequency table specifies which frequencies correspond to the familiar
- channel numbers. Select broadcast if you use an antenna for over-the-air
+ Please choose the frequency table to use. It specifies which frequencies correspond to the familiar
+ channel numbers. You should select "Broadcast" if you use an antenna for over-the-air
signals.
Template: tvtime/frequencies-jp
Type: select
-_Choices: Cable, Broadcast
+__Choices: Cable, Broadcast
_Description: Default frequency table:
- The frequency table specifies which frequencies correspond to the familiar
- channel numbers. Select broadcast if you use an antenna for over-the-air
+ Please choose the frequency table to use. It specifies which
+ frequencies correspond to the familiar channel numbers.
+ .
+ You should select "Broadcast" if you use an antenna for over-the-air
signals.
Template: tvtime/frequencies-pal
Type: select
-_Choices: Europe, France, Russia, Australia, New Zealand, China Broadcast, Australia Optus, Custom (must run tvtime-scanner first)
+__Choices: Europe, France, Russia, Australia, New-Zealand, China Broadcast, Australia Optus, Custom (must run tvtime-scanner first)
_Description: Default frequency table:
- Users of the Optus cable company in Australia should select Australia
- Optus. If you are a user of a cable company that does not use standard
- frequencies, such as Casema, UPC or Mixtics, please select Custom and run
+ Please choose the frequency table to use. It specifies which
+ frequencies correspond to the familiar channel numbers.
+ .
+ If you are a user of a cable company that does not use standard
+ frequencies, you should select "Custom" and run
the tvtime-scanner application before using tvtime.
Template: tvtime/v4ldevice
Type: string
Default: /dev/video0
_Description: Default television capture device:
- This should be the video4linux device which corresponds to your capture
+ Please choose the video4linux device which corresponds to your capture
card.
Template: tvtime/vbidevice
Type: string
Default: /dev/vbi0
_Description: Device to use for VBI decoding:
- This will only be used in NTSC areas for decoding closed captions and XDS
+ Please choose the device that will be used in NTSC areas for decoding closed captions and XDS
channel information.
Template: tvtime/setuid
Type: boolean
Default: false
-_Description: Do you wish to make `/usr/bin/tvtime' setuid root?
+_Description: Allow tvtime to run with root privileges?
+ Please choose whether tvtime should be "setuid root", therefore getting
+ root privileges when running.
+ .
This allows tvtime to run at a high priority to ensure smooth video and
should be used for high quality video output even during high CPU load.
@@ -55,6 +64,8 @@
Default: -10
_Description: Process priority for the tvtime binary:
This setting controls the priority of the tvtime process relative to other
- processes on the system. The allowed range is from -19 to 19. Lower
+ processes on the system.
+ .
+ Allowed values are integers between -19 and 19. Lower
values indicate higher priority, and a value of 0 would give tvtime the
same priority as a normal process.
--- tvtime.old/debian/control 2009-06-11 07:22:28.824183081 +0200
+++ tvtime/debian/control 2009-06-11 08:21:39.699311597 +0200
@@ -28,23 +28,22 @@
ucf,
Recommends: xmltv-util
Suggests: lirc-x
-Description: A high quality television application
- tvtime is a high quality television application for use with video
- capture cards. tvtime processes the input from a capture card and
- displays it on a computer monitor or projector. Unlike other
- television applications, tvtime focuses on high visual quality making
- it ideal for videophiles.
+Description: television display application
+ This package provides a high quality television application for use with video
+ capture cards. It processes the input from a capture card and
+ displays it on a computer monitor or projector. Tvtime focuses on high
+ visual quality making it ideal for videophiles.
.
- tvtime supports:
- * Deinterlaced output at a full interlaced rate of 59.94 frames per
+ Main features:
+ * deinterlaced output at a full interlaced rate of 59.94 frames per
second for NTSC source, or 50 frames per second for PAL sources.
- This gives smoothness of motion and high visual quality.
- * Multiple deinterlacing algoritms for finding the optimal mode for
- your video content and available processor speed.
+ This gives smoothness of motion and high visual quality;
+ * multiple deinterlacing algorithms for finding the optimal mode for
+ the video content and available processor speed;
* 16:9 aspect ratio mode for the highest available resolution when
processing input from an external DVD player or digital satellite
- receiver.
- * A super-slick on-screen-display for the complete television
- experience, with a featureful menu system.
+ receiver;
+ * super-slick on-screen-display for the complete television
+ experience, with a featureful menu system;
* 2-3 Pulldown detection for optimal quality viewing of film content
from NTSC sources.
Source: tvtime
Section: x11
Priority: optional
Maintainer: Bart Martens <bartm@debian.org>
Build-Depends:
debhelper (>= 7),
zlib1g-dev,
libpng-dev,
libfreetype6-dev,
libx11-dev,
libxext-dev,
libxinerama-dev,
libxt-dev,
libxtst-dev,
libxv-dev,
libxxf86vm-dev,
libxml2-dev,
fontforge,
Standards-Version: 3.8.1
Homepage: http://tvtime.net/
Package: tvtime
Architecture: any
Depends:
${shlibs:Depends},
${misc:Depends},
ttf-freefont,
ucf,
Recommends: xmltv-util
Suggests: lirc-x
Description: television display application
This package provides a high quality television application for use with video
capture cards. It processes the input from a capture card and
displays it on a computer monitor or projector. Tvtime focuses on high
visual quality making it ideal for videophiles.
.
Main features:
* deinterlaced output at a full interlaced rate of 59.94 frames per
second for NTSC source, or 50 frames per second for PAL sources.
This gives smoothness of motion and high visual quality;
* multiple deinterlacing algorithms for finding the optimal mode for
the video content and available processor speed;
* 16:9 aspect ratio mode for the highest available resolution when
processing input from an external DVD player or digital satellite
receiver;
* super-slick on-screen-display for the complete television
experience, with a featureful menu system;
* 2-3 Pulldown detection for optimal quality viewing of film content
from NTSC sources.
Attachment:
signature.asc
Description: Digital signature