Package: tercpp
Version: 0.6.2+dfsg-1
Severity: wishlist
Tags: patch l10n
The short and long descriptions for tercpp are unhelpful and contain
several trivial errors, which are unlikely to fill people with
confidence about the package's usefulness.
> Package: libtercpp-dev
[...]
> Description: C++ implementation of TER (development files)
This is a bad synopsis. Users have no reason to care what language a
tool is implemented in - what they want to know is what it's *for*.
If we need to explain the package name, there's plenty of room for
that in the long description. I would suggest:
Description: Translation Error Rate scoring tool - development files
> This tool scores machine translation performance with the TER (Translation
You haven't introduced "this tool" yet (and only one of these packages
actually contains it).
> Error Rate) metric. TER mesures edit distance between traslations and
> references.
At least two misspellings (meAsures, traNslations) and some wobbly
phrasing. It might be better as something like "TER measures the edit
distance between a translation and a gold-standard reference", but
I'll go for something with a lower edit distance:
TERCpp is a tool (implemented in C++) for scoring machine translation
performance. It uses the Translation Error Rate (TER) metric to measure
edit distances between translations and references.
> .
> This package contains development files of tercpp.
Make that "for TERCpp".
Likewise for the other packages in the set:
> Package: libtercpp0
[...]
> Description: C++ implementation of TER
Make it clear that this doesn't contain the binary:
Description: Translation Error Rate scoring tool - shared library
> This tool scores machine translation performance with the TER (Translation
> Error Rate) metric. TER mesures edit distance between traslations and
> references.
As above.
> This package contains a library of tercpp.
Again "for TERCpp".
> Package: tercpp
[...]
> Description: C++ implementation of TER (frontend)
Only developers think of a binary as a "frontend" to its library.
Indeed, only developers think "frontend" is a word. Make it:
Description: Translation Error Rate scoring tool - binary
> This tool scores machine translation performance with the TER (Translation
> Error Rate) metric. TER mesures edit distance between traslations and
> references.
As above.
> This package contains a frontend program of tercpp.
This package contains the tercpp binary.
I don't know about TER, but that's a total Levenshtein distance of 340.
-- System Information:
Debian Release: jessie/sid
APT prefers testing
APT policy: (990, 'testing'), (50, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 3.13-rc6-686-pae (SMP w/1 CPU core)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages tercpp depends on:
ii libc6 2.17-97
ii libgcc1 1:4.8.2-14
ii libstdc++6 4.8.2-14
ii libtercpp0 0.6.2+dfsg-1
ii libtinyxml2.6.2 2.6.2-2
tercpp recommends no packages.
tercpp suggests no packages.
-- no debconf information
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ru tercpp-0.6.2+dfsg.pristine/debian/control tercpp-0.6.2+dfsg/debian/control
--- tercpp-0.6.2+dfsg.pristine/debian/control 2014-01-21 08:49:08.000000000 +0000
+++ tercpp-0.6.2+dfsg/debian/control 2014-01-28 13:49:12.565508698 +0000
@@ -11,12 +11,12 @@
Architecture: any
Multi-Arch: same
Depends: ${misc:Depends}, libtercpp0 (= ${binary:Version}), libtinyxml-dev
-Description: C++ implementation of TER (development files)
- This tool scores machine translation performance with the TER (Translation
- Error Rate) metric. TER mesures edit distance between traslations and
- references.
+Description: Translation Error Rate scoring tool - development files
+ TERCpp is a tool (implemented in C++) for scoring machine translation
+ performance. It uses the Translation Error Rate (TER) metric to measure
+ edit distances between translations and references.
.
- This package contains development files of tercpp.
+ This package contains development files for TERCpp.
Package: libtercpp0
Section: libs
@@ -24,19 +24,19 @@
Multi-Arch: same
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: C++ implementation of TER
- This tool scores machine translation performance with the TER (Translation
- Error Rate) metric. TER mesures edit distance between traslations and
- references.
+Description: Translation Error Rate scoring tool - shared library
+ TERCpp is a tool (implemented in C++) for scoring machine translation
+ performance. It uses the Translation Error Rate (TER) metric to measure
+ edit distances between translations and references.
.
- This package contains a library of tercpp.
+ This package contains the library for TERCpp.
Package: tercpp
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, libtercpp0 (= ${binary:Version})
-Description: C++ implementation of TER (frontend)
- This tool scores machine translation performance with the TER (Translation
- Error Rate) metric. TER mesures edit distance between traslations and
- references.
+Description: Translation Error Rate scoring tool - binary
+ TERCpp is a tool (implemented in C++) for scoring machine translation
+ performance. It uses the Translation Error Rate (TER) metric to measure
+ edit distances between translations and references.
.
- This package contains a frontend program of tercpp.
+ This package contains the tercpp binary.
