Package: concordance
Version: 0.24-1
Severity: wishlist
Tags: patch
Concordance and related packages have a number of minor typos and
other language issues in their descriptions.
> Package: concordance
> Architecture: any
> Depends: ${misc:Depends}, ${shlibs:Depends}
> Description: Harmony remote configuration tool
The natural way to interpret this (especially if you don't recognise
the brand name) is as "a tool for the remote configuration of Harmony"
rather than as "a configuration tool for Harmony remotes".
> The concordance software suite allows you to program your Logitech Harmony
> remote using a configuration object retreived from the harmony website.
> The Logitech Harmony is a highly configuration universal remote than can
> control most multimedia devices.
To start with something utterly trivial: inconsistent spacing.
We don't need to repeat the Harmony brand name quite this often (and
it needn't be "your" Logitech Harmony remote).
Typo: s/retreived/retrieved/
"The harmony website" should either be "the Harmony website" or more
informatively "the harmonyremote.com website".
Presumably, s/highly configuration/highly configurable/
Also, s/than/that/, but calling it a "remote that can control" devices
is awkward; just say it's a "remote control compatible with" most
multimedia devices.
These sentences are in the wrong order. First tell me what a Logitech
Harmony is (an explanation that should probably involve "IR"), then
explain how this software is useful.
Plus, a separate issue that belongs in a separate bug with a much
higher severity: if this software is useless without a proprietary
firmware blob (cf. b43-fwcutter or isight-firmware-tools), what is it
doing in Debian main rather than contrib? (But that report can wait
until you've had a chance to comment. If that isn't in fact the
package's function, the package description is in urgent need of
improvement.)
> .
> This package contains the binary utility to control and configure the Harmony
> remote.
>
> Package: libconcord2
[...]
> This package contains the C Libraries for the concordance framework.
^
Excess capitalisation.
>
> Package: libconcord-dev
[...]
> This package contains the C libraries development files for the concordance
^^^^^^^^^^^
Cut'n'paste error?
> framework.
>
> Package: python-libconcord
[...]
No problems!
So my suggested revised version is:
[...]
| Package: concordance
[...]
| Description: configuration tool for Harmony remotes
| The Logitech Harmony is a highly configurable universal IR remote control
| compatible with most multimedia devices. The concordance software suite
| allows you to program such remotes using a configuration object retrieved
| from the harmonyremote.com website.
| .
| This package contains the binary utility to control and configure the Harmony
| remote.
|
| Package: libconcord2
[...]
| Description: configuration tool for Harmony remotes - runtime libraries
[...]
| This package contains the C libraries for the concordance framework.
|
| Package: libconcord-dev
[...]
| Description: configuration tool for Harmony remotes - development files
[...]
| This package contains the development files for the concordance framework.
|
| Package: python-libconcord
| Description: configuration tool for Harmony remotes - Python bindings
[...]
| This package contains the Python bindings for the concordance framework.
--
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru concordance-0.24.pristine/debian/control concordance-0.24/debian/control
--- concordance-0.24.pristine/debian/control 2012-04-13 15:47:31.000000000 +0100
+++ concordance-0.24/debian/control 2012-07-12 16:24:09.919392201 +0100
@@ -9,11 +9,11 @@
Package: concordance
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: Harmony remote configuration tool
- The concordance software suite allows you to program your Logitech Harmony
- remote using a configuration object retreived from the harmony website.
- The Logitech Harmony is a highly configuration universal remote than can
- control most multimedia devices.
+Description: configuration tool for Harmony remotes
+ The Logitech Harmony is a highly configurable universal IR remote control
+ compatible with most multimedia devices. The concordance software suite
+ allows you to program such remotes using a configuration object retrieved
+ from the harmonyremote.com website.
.
This package contains the binary utility to control and configure the Harmony
remote.
@@ -22,36 +22,35 @@
Architecture: any
Section: libs
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: Harmony remote configuration tool - runtime libraries
- The concordance software suite allows you to program your Logitech Harmony
- remote using a configuration object retreived from the harmony website.
- The Logitech Harmony is a highly configuration universal remote than can
- control most multimedia devices.
+Description: configuration tool for Harmony remotes - runtime libraries
+ The Logitech Harmony is a highly configurable universal IR remote control
+ compatible with most multimedia devices. The concordance software suite
+ allows you to program such remotes using a configuration object retrieved
+ from the harmonyremote.com website.
.
- This package contains the C Libraries for the concordance framework.
+ This package contains the C libraries for the concordance framework.
Package: libconcord-dev
Architecture: any
Section: libdevel
Depends: libconcord2 (= ${binary:Version}), ${misc:Depends}
-Description: Harmony remote configuration tool - development files
- The concordance software suite allows you to program your Logitech Harmony
- remote using a configuration object retreived from the harmony website.
- The Logitech Harmony is a highly configuration universal remote than can
- control most multimedia devices.
+Description: configuration tool for Harmony remotes - development files
+ The Logitech Harmony is a highly configurable universal IR remote control
+ compatible with most multimedia devices. The concordance software suite
+ allows you to program such remotes using a configuration object retrieved
+ from the harmonyremote.com website.
.
- This package contains the C libraries development files for the concordance
- framework.
+ This package contains the development files for the concordance framework.
Package: python-libconcord
Architecture: all
Section: python
Depends: libconcord2 (>= ${source:Version}), ${python:Depends}, ${misc:Depends}
Provides: ${python:Provides}
-Description: Harmony remote configuration tool - Python bindings
- The concordance software suite allows you to program your Logitech Harmony
- remote using a configuration object retreived from the harmony website.
- The Logitech Harmony is a highly configuration universal remote than can
- control most multimedia devices.
+Description: configuration tool for Harmony remotes - Python bindings
+ The Logitech Harmony is a highly configurable universal IR remote control
+ compatible with most multimedia devices. The concordance software suite
+ allows you to program such remotes using a configuration object retrieved
+ from the harmonyremote.com website.
.
This package contains the Python bindings for the concordance framework.
Source: concordance
Section: utils
Priority: optional
Homepage: http://sourceforge.net/projects/concordance
Maintainer: Mathieu Trudel-Lapierre <[email protected]>
Build-Depends: debhelper (>= 8), libusb-dev, python-all-dev (>= 2.6.6-3~)
Standards-Version: 3.9.3
Package: concordance
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: configuration tool for Harmony remotes
The Logitech Harmony is a highly configurable universal IR remote control
compatible with most multimedia devices. The concordance software suite
allows you to program such remotes using a configuration object retrieved
from the harmonyremote.com website.
.
This package contains the binary utility to control and configure the Harmony
remote.
Package: libconcord2
Architecture: any
Section: libs
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: configuration tool for Harmony remotes - runtime libraries
The Logitech Harmony is a highly configurable universal IR remote control
compatible with most multimedia devices. The concordance software suite
allows you to program such remotes using a configuration object retrieved
from the harmonyremote.com website.
.
This package contains the C libraries for the concordance framework.
Package: libconcord-dev
Architecture: any
Section: libdevel
Depends: libconcord2 (= ${binary:Version}), ${misc:Depends}
Description: configuration tool for Harmony remotes - development files
The Logitech Harmony is a highly configurable universal IR remote control
compatible with most multimedia devices. The concordance software suite
allows you to program such remotes using a configuration object retrieved
from the harmonyremote.com website.
.
This package contains the development files for the concordance framework.
Package: python-libconcord
Architecture: all
Section: python
Depends: libconcord2 (>= ${source:Version}), ${python:Depends}, ${misc:Depends}
Provides: ${python:Provides}
Description: configuration tool for Harmony remotes - Python bindings
The Logitech Harmony is a highly configurable universal IR remote control
compatible with most multimedia devices. The concordance software suite
allows you to program such remotes using a configuration object retrieved
from the harmonyremote.com website.
.
This package contains the Python bindings for the concordance framework.
