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.