Please find, for review, the debconf templates and packages descriptions for the phonon source package.
This review will last from Tuesday, March 22, 2011 to Friday, April 01, 2011.
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:
--- phonon.old/debian/phonon-backend-null.templates 2011-03-14 20:13:00.515104440 +0100
+++ phonon/debian/phonon-backend-null.templates 2011-03-18 06:51:42.699253466 +0100
@@ -3,15 +3,18 @@
_Description: Warning: Phonon is not functional
Template: phonon-backend-null/isnt_functional
-Type: note
-_Description: Phonon multimedia capabilities are disabled
- Phonon based (i.e. most KDE and some Qt) applications will produce no audio or
- video output because there is no real Phonon backend installed on your system.
+Type: error
+#flag:comment:4
+# Translators: do not translate variable names
+# only translate "(recommended)" (the one in parenthesis)
+_Description: Missing backend for Phonon
+ Phonon-based (i.e. most KDE and some Qt) applications will produce no audio or
+ video output because there is no real Phonon backend installed on this system.
Typically, this is an undesirable configuration which you might have gotten to
unintentionally.
.
- If you wish to restore full Phonon multimedia capabilities, install a real
- Phonon backend with your favourite package manager. The following Phonon
- backend packages seem to be available for your system at the moment:
+ If you wish to restore full Phonon multimedia capabilities, you
+ should install a real Phonon backend. The following Phonon
+ backend packages seem to be available for this system at the moment:
.
${recommended_backend} (recommended)${other_backends}
I think that "error" is more well suited for this warning
"flag:comment" (see po-debconf(7)) is helpful because translating the
last paragraph is tricky: translators should not translate variable
names BUT should translate the word "recommended".
s/Phonon based/Phonon-based
s/your/this: the system is maybe not "my" system
Turn imperative form "install <foo>" into a suggestion "you should
install <foo>".Drop useless "with your favourite package manager".
--- phonon.old/debian/control 2011-03-14 20:13:00.515104440 +0100
+++ phonon/debian/control 2011-03-18 06:55:23.436332507 +0100
@@ -17,11 +17,11 @@
${phonon:Recommended-Backend} | phonon-backend
Suggests: ${phonon:Recommended-Backend}, phonon-backend-gstreamer,
phonon-backend-xine, phonon-backend-mplayer
-Description: metapackage for the Phonon multimedia framework
+Description: Phonon multimedia framework - metapackage
Standardize short description with our usual "general common
description - specific description" style.
This is repeated over packages.
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
- This metapackage ensures that a user has working Phonon configuration
+ This metapackage ensures that a user has a working Phonon configuration
installed on the system (the core library and at least one backend).
Missing article.
@@ -55,12 +55,12 @@
${sameVersionDep:libqt4-dev:libphononexperimental4}
Replaces: libphonon-dev (<< 4:4.6.0really4.4.4)
Breaks: libphonon-dev (<< 4:4.6.0really4.4.4)
-Description: development files for the Phonon-Experimental library
+Description: Phonon-Experimental multimedia framework - development files
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the development files needed to build Phonon backends or
- internal applications which need the Phonon-Experimental library. Third party
+ internal applications which need the Phonon-Experimental library. Third-party
applications should not depend on this library. Please read README.Debian if
you consider to Build-Depend on this package.
Missing dash in "third-party"
Template: phonon-backend-null/isnt_functional_title
Type: title
_Description: Warning: Phonon is not functional
Template: phonon-backend-null/isnt_functional
Type: error
#flag:comment:4
# Translators: do not translate variable names
# only translate "(recommended)" (the one in parenthesis)
_Description: Missing backend for Phonon
Phonon-based (i.e. most KDE and some Qt) applications will produce no audio or
video output because there is no real Phonon backend installed on this system.
Typically, this is an undesirable configuration which you might have gotten to
unintentionally.
.
If you wish to restore full Phonon multimedia capabilities, you
should install a real Phonon backend. The following Phonon
backend packages seem to be available for this system at the moment:
.
${recommended_backend} (recommended)${other_backends}
--- phonon.old/debian/phonon-backend-null.templates 2011-03-14 20:13:00.515104440 +0100
+++ phonon/debian/phonon-backend-null.templates 2011-03-18 06:51:42.699253466 +0100
@@ -3,15 +3,18 @@
_Description: Warning: Phonon is not functional
Template: phonon-backend-null/isnt_functional
-Type: note
-_Description: Phonon multimedia capabilities are disabled
- Phonon based (i.e. most KDE and some Qt) applications will produce no audio or
- video output because there is no real Phonon backend installed on your system.
+Type: error
+#flag:comment:4
+# Translators: do not translate variable names
+# only translate "(recommended)" (the one in parenthesis)
+_Description: Missing backend for Phonon
+ Phonon-based (i.e. most KDE and some Qt) applications will produce no audio or
+ video output because there is no real Phonon backend installed on this system.
Typically, this is an undesirable configuration which you might have gotten to
unintentionally.
.
- If you wish to restore full Phonon multimedia capabilities, install a real
- Phonon backend with your favourite package manager. The following Phonon
- backend packages seem to be available for your system at the moment:
+ If you wish to restore full Phonon multimedia capabilities, you
+ should install a real Phonon backend. The following Phonon
+ backend packages seem to be available for this system at the moment:
.
${recommended_backend} (recommended)${other_backends}
--- phonon.old/debian/control 2011-03-14 20:13:00.515104440 +0100
+++ phonon/debian/control 2011-03-18 06:55:23.436332507 +0100
@@ -17,11 +17,11 @@
${phonon:Recommended-Backend} | phonon-backend
Suggests: ${phonon:Recommended-Backend}, phonon-backend-gstreamer,
phonon-backend-xine, phonon-backend-mplayer
-Description: metapackage for the Phonon multimedia framework
+Description: Phonon multimedia framework - metapackage
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
- This metapackage ensures that a user has working Phonon configuration
+ This metapackage ensures that a user has a working Phonon configuration
installed on the system (the core library and at least one backend).
Package: libphonon-dev
@@ -29,7 +29,7 @@
Section: libdevel
Depends: ${misc:Depends}, libphonon4 (= ${binary:Version}),
${sameVersionDep:libqt4-dev:libphonon4}, phonon-backend-null | phonon
-Description: development files for the Phonon multimedia framework
+Description: Phonon multimedia framework - development files
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
@@ -41,12 +41,12 @@
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
Breaks: phonon-backend-xine (<< 4:4.6.0really4.3.80)
-Description: the core library of the Phonon multimedia framework
+Description: Phonon multimedia framework - core library
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the core library of the Phonon cross-platform multimedia
- framework for Qt 4. It is required to run applications that use Phonon.
+ framework for Qt 4. It is required to run applications that use Phonon.
Package: libphononexperimental-dev
Architecture: any
@@ -55,12 +55,12 @@
${sameVersionDep:libqt4-dev:libphononexperimental4}
Replaces: libphonon-dev (<< 4:4.6.0really4.4.4)
Breaks: libphonon-dev (<< 4:4.6.0really4.4.4)
-Description: development files for the Phonon-Experimental library
+Description: Phonon-Experimental multimedia framework - development files
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the development files needed to build Phonon backends or
- internal applications which need the Phonon-Experimental library. Third party
+ internal applications which need the Phonon-Experimental library. Third-party
applications should not depend on this library. Please read README.Debian if
you consider to Build-Depend on this package.
@@ -70,12 +70,12 @@
Depends: ${shlibs:Depends}, ${misc:Depends}
Replaces: libphonon4 (<< 4:4.6.0really4.3.80)
Breaks: libphonon4 (<< 4:4.6.0really4.3.80)
-Description: the Phonon Experimental library (internal)
+Description: Phonon-Experimental multimedia framework - library (internal)
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the Phonon-Experimental library which might be needed by
- Phonon backends or other internal applications. Third party applications
+ Phonon backends or other internal applications. Third-party applications
should not depend on this library. Please read README.Debian before using this
library.
@@ -84,7 +84,7 @@
Provides: phonon-backend
Depends: libphonon4, ${misc:Depends}
Conflicts: phonon-backend
-Description: Phonon null backend (no real backend)
+Description: Phonon multimedia framework - null backend (no real backend)
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
@@ -98,7 +98,7 @@
Section: debug
Depends: ${misc:Depends}, libphonon4 (= ${binary:Version})
Suggests: libphononexperimental4 (= ${binary:Version})
-Description: Phonon debugging symbols
+Description: Phonon multimedia framework - debugging symbols
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
Source: phonon
Section: sound
Priority: optional
Maintainer: Debian Qt/KDE Maintainers <debian-qt-kde@lists.debian.org>
Uploaders: Modestas Vainius <modax@debian.org>, Fathi Boudra <fabo@debian.org>
Build-Depends: cdbs (>= 0.4.51), debhelper (>= 7.4.13), cmake (>= 2.6.2),
pkg-kde-tools (>= 0.11), dpkg-dev (>= 1.15.5), automoc, libglib2.0-dev,
libpulse-dev (>= 0.9.21), libqt4-dev (>= 4.5)
Standards-Version: 3.9.1
Homepage: http://phonon.kde.org/
Vcs-Browser: http://git.debian.org/?p=pkg-kde/kde-req/phonon.git
Vcs-Git: git://git.debian.org/pkg-kde/kde-req/phonon.git
Package: phonon
Architecture: all
Depends: ${misc:Depends}, libphonon4 (>= ${source:Version}),
${phonon:Recommended-Backend} | phonon-backend
Suggests: ${phonon:Recommended-Backend}, phonon-backend-gstreamer,
phonon-backend-xine, phonon-backend-mplayer
Description: Phonon multimedia framework - metapackage
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This metapackage ensures that a user has a working Phonon configuration
installed on the system (the core library and at least one backend).
Package: libphonon-dev
Architecture: any
Section: libdevel
Depends: ${misc:Depends}, libphonon4 (= ${binary:Version}),
${sameVersionDep:libqt4-dev:libphonon4}, phonon-backend-null | phonon
Description: Phonon multimedia framework - development files
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the development files needed to build Qt 4 applications
using Phonon cross-platform multimedia framework.
Package: libphonon4
Architecture: any
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
Breaks: phonon-backend-xine (<< 4:4.6.0really4.3.80)
Description: Phonon multimedia framework - core library
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the core library of the Phonon cross-platform multimedia
framework for Qt 4. It is required to run applications that use Phonon.
Package: libphononexperimental-dev
Architecture: any
Section: libdevel
Depends: ${misc:Depends}, libphononexperimental4 (= ${binary:Version}),
${sameVersionDep:libqt4-dev:libphononexperimental4}
Replaces: libphonon-dev (<< 4:4.6.0really4.4.4)
Breaks: libphonon-dev (<< 4:4.6.0really4.4.4)
Description: Phonon-Experimental multimedia framework - development files
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the development files needed to build Phonon backends or
internal applications which need the Phonon-Experimental library. Third-party
applications should not depend on this library. Please read README.Debian if
you consider to Build-Depend on this package.
Package: libphononexperimental4
Architecture: any
Section: libs
Depends: ${shlibs:Depends}, ${misc:Depends}
Replaces: libphonon4 (<< 4:4.6.0really4.3.80)
Breaks: libphonon4 (<< 4:4.6.0really4.3.80)
Description: Phonon-Experimental multimedia framework - library (internal)
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains the Phonon-Experimental library which might be needed by
Phonon backends or other internal applications. Third-party applications
should not depend on this library. Please read README.Debian before using this
library.
Package: phonon-backend-null
Architecture: all
Provides: phonon-backend
Depends: libphonon4, ${misc:Depends}
Conflicts: phonon-backend
Description: Phonon multimedia framework - null backend (no real backend)
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package does not provide any real Phonon backend. It can be used to
disable Phonon audio/video capabilities. Please note that Phonon behaviour
with this package installed has not been well tested.
Package: phonon-dbg
Priority: extra
Architecture: any
Section: debug
Depends: ${misc:Depends}, libphonon4 (= ${binary:Version})
Suggests: libphononexperimental4 (= ${binary:Version})
Description: Phonon multimedia framework - debugging symbols
Phonon is the Qt 4 multimedia API, which provides a task-oriented abstraction
layer for capturing, mixing, processing, and playing audio and video content.
.
This package contains debugging symbols of the Phonon library and main
backends You should install this package when you are about to report a crash
or want to debug a problem with Phonon or its backends.
Attachment:
signature.asc
Description: Digital signature