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