Please find, for review, the debconf templates and packages descriptions for the xawtv source package.
This review will last from Sunday, October 07, 2007 to Wednesday, October 17, 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:
--- ../xawtv.old/debian/xawtv.templates 2007-10-06 19:13:21.501393179 +0200
+++ debian/xawtv.templates 2007-10-07 08:46:27.281536349 +0200
@@ -6,37 +6,34 @@
Template: xawtv/channel-scan
Type: boolean
Default: true
-_Description: scan for TV stations?
- This can do a scan of all channels and put a list of the TV stations I've
- found into the config file.
+_Description: Scan for TV stations?
Use an initial capital.
+ A scan of all channels can be run and a list of the TV stations included
+ in the configuration file.
More neutral language. Avoid first person use.
.
- This requires a working bttv driver. If bttv isn't configured correctly I
- might not find the TV stations.
+ This requires a working bttv driver. If bttv isn't configured correctly, TV
+ stations will not be found.
Remove double spaces. Again remove 1st person.
.
- I'll try to pick up the channel names from videotext. This will work with
- PAL only.
+ Channel names will be retrieved from videotext informations, which
+ is only possible for PAL channels.
Ditto.
Template: xawtv/tvnorm
Type: select
-_Choices: PAL, SECAM, NTSC
-_Description: TV norm is used in your country:
+Choices: PAL, SECAM, NTSC
+_Description: TV standard:
I don't think the standard anmes should be translatable.
Let's be neutral about "your country". After all, the user may choose
the TV standard of another country..:-)
Template: xawtv/build-config
Type: boolean
Default: false
_Description: Create a default configuration for xawtv?
- You can create a system-wide configuration file for xawtv with reasonable
- default values for the country you live in (which TV norm is used for
- example).
+ A system-wide configuration file for xawtv can be created, with reasonable
+ default values for the local country.
.
- It is not required to have a global configuration file, but it will be
- more comfortable for your users if they find a working default
- configuration.
+ That file is not required but will simplify the software configuration
+ for users of this system.
The file will be created by the maintainer scripts, not the admin.
Again, same change wrt country. We could even remove mention of
"country".
Reword the second paragraph to avoid "your users".
Template: xawtv/freqtab
Type: select
-_Choices: us-bcast, us-cable, us-cable-hrc, japan-bcast, japan-cable, europe-west, europe-east, italy, newzealand, australia, ireland, france, china-bcast
-_Description: Frequency table that should be used:
- A frequency table is just a list of TV channel names/numbers and the
- corresponding broadcast frequencies for these channels. Different regions
- use different standards here...
+__Choices: us-bcast, us-cable, us-cable-hrc, japan-bcast, japan-cable, europe-west, europe-east, italy, newzealand, australia, ireland, france, china-bcast
+_Description: Frequency table to use:
+ A frequency table is a list of TV channel names and numbers with
+ their broadcast frequencies.
Split out Choices to make the translators work easier.
Simpler formulation.
--- ../xawtv.old/debian/control 2007-10-06 19:13:21.501393179 +0200
+++ debian/control 2007-10-07 08:59:08.824934234 +0200
@@ -10,51 +10,51 @@
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, v4l-conf [linux-any], xutils, scantv, xawtv-plugins (=${binary:Version}), pia
Suggests: xawtv-plugin-qt (=${binary:Version}), tv-fonts
-Description: X11 TV application
- TV application for X11. Supports video4linux
- devices and the Xvideo extension.
+Description: television software - X11 application
+ XawTV is an X11 application which allows to watch television channels. It
+ supports video4linux devices and the Xvideo extension.
Use a "generic description - specific description" style for synopsis.
Try to standardize the first paragraphs for most of the packages.
Package: pia
Section: x11
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
-Description: movie player
- This is a simple movie player. It is used by xawtv and motv to
+Description: movie player for xawtw
+ This package provides a simple movie player used by xawtv and motv to
playback movie files which are recorded from TV.
"This is <foo>" should be avoided (see 6.2 in Developer's
Reference). Therefore, rephrase.
Package: fbtv
Architecture: linux-any
Depends: ${shlibs:Depends}, v4l-conf, xawtv-plugins (=${binary:Version})
Suggests: xawtv
-Description: linux console (fbcon) TV application
- TV application for the linux console, requires a
- framebuffer device (vesafb, matroxfb, atyfb, ...)
- and a video4linux driver like bttv.
+Description: television software - Linux framebuffer application
+ FbTV is a Linux framebuffer application which allows to watch television
+ channels. It supports video4linux devices and requires a framebuffer
+ device (vesafb, matroxfb, atyfb, ...).
Same than above
Package: ttv
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Suggests: xawtv
-Description: tty TV application
- TV application for terminals, based on aalib.
- Uses video4linux devices as video input.
+Description: television software - console application
+ TTV is a console application, based on aalib, which allows to watch
+ television channels. It supports video4linux devices.
Same than above. Ditto for all other binary packages.
Template: xawtv/makedev Type: boolean Default: true _Description: Create video4linux (/dev/video*) special files? Template: xawtv/channel-scan Type: boolean Default: true _Description: Scan for TV stations? A scan of all channels can be run and a list of the TV stations included in the configuration file. . This requires a working bttv driver. If bttv isn't configured correctly, TV stations will not be found. . Channel names will be retrieved from videotext informations, which is only possible for PAL channels. Template: xawtv/tvnorm Type: select Choices: PAL, SECAM, NTSC _Description: TV standard: Template: xawtv/build-config Type: boolean Default: false _Description: Create a default configuration for xawtv? A system-wide configuration file for xawtv can be created, with reasonable default values for the local country. . That file is not required but will simplify the software configuration for users of this system. Template: xawtv/freqtab Type: select __Choices: us-bcast, us-cable, us-cable-hrc, japan-bcast, japan-cable, europe-west, europe-east, italy, newzealand, australia, ireland, france, china-bcast _Description: Frequency table to use: A frequency table is a list of TV channel names and numbers with their broadcast frequencies.
--- ../xawtv.old/debian/xawtv.templates 2007-10-06 19:13:21.501393179 +0200
+++ debian/xawtv.templates 2007-10-07 08:46:27.281536349 +0200
@@ -6,37 +6,34 @@
Template: xawtv/channel-scan
Type: boolean
Default: true
-_Description: scan for TV stations?
- This can do a scan of all channels and put a list of the TV stations I've
- found into the config file.
+_Description: Scan for TV stations?
+ A scan of all channels can be run and a list of the TV stations included
+ in the configuration file.
.
- This requires a working bttv driver. If bttv isn't configured correctly I
- might not find the TV stations.
+ This requires a working bttv driver. If bttv isn't configured correctly, TV
+ stations will not be found.
.
- I'll try to pick up the channel names from videotext. This will work with
- PAL only.
+ Channel names will be retrieved from videotext informations, which
+ is only possible for PAL channels.
Template: xawtv/tvnorm
Type: select
-_Choices: PAL, SECAM, NTSC
-_Description: TV norm is used in your country:
+Choices: PAL, SECAM, NTSC
+_Description: TV standard:
Template: xawtv/build-config
Type: boolean
Default: false
_Description: Create a default configuration for xawtv?
- You can create a system-wide configuration file for xawtv with reasonable
- default values for the country you live in (which TV norm is used for
- example).
+ A system-wide configuration file for xawtv can be created, with reasonable
+ default values for the local country.
.
- It is not required to have a global configuration file, but it will be
- more comfortable for your users if they find a working default
- configuration.
+ That file is not required but will simplify the software configuration
+ for users of this system.
Template: xawtv/freqtab
Type: select
-_Choices: us-bcast, us-cable, us-cable-hrc, japan-bcast, japan-cable, europe-west, europe-east, italy, newzealand, australia, ireland, france, china-bcast
-_Description: Frequency table that should be used:
- A frequency table is just a list of TV channel names/numbers and the
- corresponding broadcast frequencies for these channels. Different regions
- use different standards here...
+__Choices: us-bcast, us-cable, us-cable-hrc, japan-bcast, japan-cable, europe-west, europe-east, italy, newzealand, australia, ireland, france, china-bcast
+_Description: Frequency table to use:
+ A frequency table is a list of TV channel names and numbers with
+ their broadcast frequencies.
--- ../xawtv.old/debian/control 2007-10-06 19:13:21.501393179 +0200
+++ debian/control 2007-10-07 08:59:08.824934234 +0200
@@ -10,51 +10,51 @@
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, v4l-conf [linux-any], xutils, scantv, xawtv-plugins (=${binary:Version}), pia
Suggests: xawtv-plugin-qt (=${binary:Version}), tv-fonts
-Description: X11 TV application
- TV application for X11. Supports video4linux
- devices and the Xvideo extension.
+Description: television software - X11 application
+ XawTV is an X11 application which allows to watch television channels. It
+ supports video4linux devices and the Xvideo extension.
Package: pia
Section: x11
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
-Description: movie player
- This is a simple movie player. It is used by xawtv and motv to
+Description: movie player for xawtw
+ This package provides a simple movie player used by xawtv and motv to
playback movie files which are recorded from TV.
Package: fbtv
Architecture: linux-any
Depends: ${shlibs:Depends}, v4l-conf, xawtv-plugins (=${binary:Version})
Suggests: xawtv
-Description: linux console (fbcon) TV application
- TV application for the linux console, requires a
- framebuffer device (vesafb, matroxfb, atyfb, ...)
- and a video4linux driver like bttv.
+Description: television software - Linux framebuffer application
+ FbTV is a Linux framebuffer application which allows to watch television
+ channels. It supports video4linux devices and requires a framebuffer
+ device (vesafb, matroxfb, atyfb, ...).
Package: ttv
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Suggests: xawtv
-Description: tty TV application
- TV application for terminals, based on aalib.
- Uses video4linux devices as video input.
+Description: television software - console application
+ TTV is a console application, based on aalib, which allows to watch
+ television channels. It supports video4linux devices.
Package: scantv
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Replaces: xawtv (<< 3.53)
-Description: scan TV channels for stations
- This utility can scan a channel set for TV stations
- and write the ones found into a xawtv config file
- (which is also read by some other utilities like fbtv).
- It also tries to extract the station names from vbi data.
+Description: scan television channels for stations
+ This package provides a utility that can scan a channel set for TV
+ stations and write the ones found in an xawtv configuration file
+ (which is also read by some other utilities like fbtv). It also
+ attempts to extract the station names from vbi data.
Package: streamer
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Suggests: xawtv
-Description: capture tool (images / movies)
- A tool to capture single/multiple images or
+Description: television capture tool (images / movies)
+ This package provides a tool to capture single/multiple images or
record movies from a video4linux device.
Package: radio
@@ -62,7 +62,7 @@
Architecture: linux-any
Depends: ${shlibs:Depends}
Description: ncurses-based radio application
- This is a ncurses-based radio application. It
+ This package provides a ncurses-based radio application. It
supports the video4linux API.
Package: v4l-conf
@@ -71,38 +71,36 @@
Conflicts: suidmanager (<< 0.50)
Replaces: xawtv (<=3.95-3)
Description: tool to configure video4linux drivers
- This is a small tool to configure a video4linux
- device driver. It is required to make the video
+ This package provides a small tool to configure a video4linux
+ device driver. It is required to make the video
overlay work in fbtv and xawtv.
Package: xawtv-tools
Architecture: any
Depends: ${shlibs:Depends}
-Description: Miscellaneous tools distributed with xawtv
- This package has a few tools you might find useful. They
- have not to do very much to do with xawtv. I've used/wrote
- them for debugging:
- * propwatch - monitors properties of X11 windows. If you
- want to know how to keep track of xawtv's
- _XAWTV_STATION property, look at this.
- * dump-mixers - dump mixer settings to stdout
- * record - console sound recorder. Has a simple input
+Description: television software - tools
+ This package provides some tools that may be useful with xawtv:
+ - propwatc: monitors properties of X11 windows. Helps
+ keeping track of xawtv's
+ _XAWTV_STATION property;
+ - dump-mixers: dump mixer settings to stdout;
+ - record: console sound recorder. It has a simple input
level meter which might be useful to trouble
- shoot sound problems.
- * showriff - display the structure of RIFF files (avi, wav).
+ shoot sound problems;
+ - showriff: display the structure of RIFF files (avi, wav).
Package: xawtv-plugin-qt
Architecture: any
Depends: ${shlibs:Depends}
-Description: quicktime plugin for xawtv and motv
- this plugin is needed to record quicktime movies with
+Description: television software - QuickTime plugin
+ This package provides a plugin to record QuickTime movies with
xawtv and motv.
Package: xawtv-plugins
Architecture: any
Depends: ${shlibs:Depends}
-Description: plugins for xawtv and motv
- A number of plugins for xawtv and motv: driver interfaces for
+Description: television software - plugins
+ This package provides plugins for xawtv and motv: driver interfaces for
hardware access (video4linux API, ...), plugins for reading/writing
movie files and some image processing filters.
@@ -112,7 +110,7 @@
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Recommends: ftp, ssh
Description: capture and upload images
- webcam captures images from a video4linux device like
+ The webcam software captures images from a video4linux device like
bttv, annotates them and uploads them to a webserver
using ftp or ssh in an endless loop.
@@ -120,6 +118,6 @@
Section: net
Architecture: any
Depends: ${shlibs:Depends}
-Description: http daemon for videotext pages
- alevtd is http daemon which servers videotext pages as
+Description: HTTP daemon for videotext pages
+ The package provides an HTTO daemon which serves videotext pages as
HTML.
Source: xawtv
Section: graphics
Priority: extra
Build-Depends: debhelper (>= 5), dpatch, libjpeg62-dev, libncurses5-dev, libx11-dev, libxext-dev, libxinerama-dev, libxmu-dev, libxpm-dev, libxrandr-dev, libxt-dev, libxv-dev, libxxf86dga-dev, libxxf86vm-dev, x-dev, liblircclient-dev, xutils, xbase-clients, libaa1-dev, libasound2-dev [!kfreebsd-i386 !kfreebsd-amd64 !hurd-i386], libzvbi-dev (>= 0.2.1), libquicktime-dev (>= 0.9.9), libxaw7-dev, libgl1-mesa-dev, libxft-dev, po-debconf, libpng12-dev, libglib1.2-dev, libfs-dev, libdv-dev
Maintainer: Krzysztof Burghardt <krzysztof@burghardt.pl>
Standards-Version: 3.7.2
Package: xawtv
Section: x11
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, v4l-conf [linux-any], xutils, scantv, xawtv-plugins (=${binary:Version}), pia
Suggests: xawtv-plugin-qt (=${binary:Version}), tv-fonts
Description: television software - X11 application
XawTV is an X11 application which allows to watch television channels. It
supports video4linux devices and the Xvideo extension.
Package: pia
Section: x11
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Description: movie player for xawtw
This package provides a simple movie player used by xawtv and motv to
playback movie files which are recorded from TV.
Package: fbtv
Architecture: linux-any
Depends: ${shlibs:Depends}, v4l-conf, xawtv-plugins (=${binary:Version})
Suggests: xawtv
Description: television software - Linux framebuffer application
FbTV is a Linux framebuffer application which allows to watch television
channels. It supports video4linux devices and requires a framebuffer
device (vesafb, matroxfb, atyfb, ...).
Package: ttv
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Suggests: xawtv
Description: television software - console application
TTV is a console application, based on aalib, which allows to watch
television channels. It supports video4linux devices.
Package: scantv
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Replaces: xawtv (<< 3.53)
Description: scan television channels for stations
This package provides a utility that can scan a channel set for TV
stations and write the ones found in an xawtv configuration file
(which is also read by some other utilities such as fbtv). It also
attempts to extract the station names from vbi data.
Package: streamer
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Suggests: xawtv
Description: television capture tool (images / movies)
This package provides a tool to capture single/multiple images or
record movies from a video4linux device.
Package: radio
Section: sound
Architecture: linux-any
Depends: ${shlibs:Depends}
Description: ncurses-based radio application
This package provides a ncurses-based radio application. It
supports the video4linux API.
Package: v4l-conf
Architecture: linux-any
Depends: ${shlibs:Depends}
Conflicts: suidmanager (<< 0.50)
Replaces: xawtv (<=3.95-3)
Description: tool to configure video4linux drivers
This package provides a small tool to configure a video4linux
device driver. It is required to make the video
overlay work in fbtv and xawtv.
Package: xawtv-tools
Architecture: any
Depends: ${shlibs:Depends}
Description: television software - tools
This package provides some tools that may be useful with xawtv:
- propwatc: monitors properties of X11 windows. Helps
keeping track of xawtv's
_XAWTV_STATION property;
- dump-mixers: dump mixer settings to stdout;
- record: console sound recorder. It has a simple input
level meter which might be useful to trouble
shoot sound problems;
- showriff: display the structure of RIFF files (avi, wav).
Package: xawtv-plugin-qt
Architecture: any
Depends: ${shlibs:Depends}
Description: television software - QuickTime plugin
This package provides a plugin to record QuickTime movies with
xawtv and motv.
Package: xawtv-plugins
Architecture: any
Depends: ${shlibs:Depends}
Description: television software - plugins
This package provides plugins for xawtv and motv: driver interfaces for
hardware access (video4linux API, ...), plugins for reading/writing
movie files and some image processing filters.
Package: webcam
Section: net
Architecture: any
Depends: ${shlibs:Depends}, xawtv-plugins (=${binary:Version})
Recommends: ftp, ssh
Description: capture and upload images
The webcam software captures images from a video4linux device such as
bttv, annotates them and uploads them to a webserver
using ftp or ssh in an endless loop.
Package: alevtd
Section: net
Architecture: any
Depends: ${shlibs:Depends}
Description: HTTP daemon for videotext pages
The package provides an HTTO daemon which serves videotext pages as
HTML.
Attachment:
signature.asc
Description: Digital signature