Package: felix-latin
Version: 2.0-3.1
Severity: wishlist
Tags: patch

felix-latin and -data have quite a few problems in their package
descriptions.  Here's a pedantic review and a suggested patch.


# Source: felix-latin
# Section: misc
# Priority: extra
# Maintainer: Georges Khaznadar <georg...@ofset.org>
# Build-Depends: debhelper (>= 7.0.50~), qt4-qmake, libqt4-dev, xsltproc, 
#  docbook-xsl, texlive-xetex, texlive-latex-recommended, 
#  ttf-linux-libertine (>=4.4.1-4), lmodern, imagemagick, ghostscript, tipa
# Standards-Version: 3.9.1
# Homepage: http://home.gna.org/felix/

This site only shows the "It works!" page from an outdated Apache
install.
 
# Package: felix-latin
# Architecture: any
# Depends: ${shlibs:Depends}, ${misc:Depends}, felix-latin-data, djvulibre-bin
# Description: Latin-French dictionary, by Felix Gaffiot

If that's "by" as a translation of "de", you might be better off
rendering it as "Felix Gaffiot's" (as for felix-latin-data below).

Synopses don't need to be 7-bit-clean; give Félix his acute accent.

This package isn't a dictionary; it's a viewer for the dictionary.

#  Félix Gaffiot was born in 1870 in Liesle 

Why exactly is his home village relevant to deciding whether I want to
install this package?  What matters is that a guy named Félix 
published a Latin-French dictionary between the wars; the rest is
essentially decorative, and can afford to be trimmed a bit.

#  (Doubs, France) and is dead in  1937, he is a philologue and a teacher of 

"Is dead" is a translation error - you mean "died".  But just give his
dates: "Félix Gaffiot (1870-1937)..."

"Philologue" is "philologist" in English, but it isn't true that he
"is" a philologist.

#  French, he authored a reference Latin-French dictionary.
         ^
This is deprecated by anglophone style guides as a "comma splice".
Instead let's make him a "tricolon crescens": he was a philologist, a
teacher of French, and the author of this dictionary.

#  .
#  The program "felix" allows to search easily in the Latin-French dictionary.
                       ^^^^^^^^^
"Allow" requires an object, and rarely contributes anything to the
meaning of a package description (this is a program for looking things
up, not for allowing things).

You've already said twice that it's Latin/French.

#  You type a Latin word, and you get an image scanned from the dictionary.

Presumably it's a *relevant* image, right?

The previous and following sentences are third person; switching to
second person just for this one is a bit jarring.

#  The graphic interface allows to zoom and pan this image easily.

The same unnecessary grammar error again, plus a boring repetition of
the word "easily".

Does felix have any interface apart from the graphical one?  I'm
guessing no, so mention that aspect earlier.

# 
# Package: felix-latin-data
# Architecture: all
# Depends: ${misc:Depends}
# Description: Scanned pages of Felix Gaffiot's Latin-French dictionary
               ^
DevRef recommends no (extra) capitalisation in a synopsis.  But this
might as well be parallel to felix-latin.

#  Félix Gaffiot was born in 1870 in Liesle 
#  (Doubs, France) and is dead in  1937, he is a philologue and a teacher of 
#  French, he authored a reference Latin-French dictionary.

As above.

#  .
#  this package provides the data for the program "felix".
   ^
Compensatory capitalisation failure.

#  Felix allows to search easily in the Latin-French dictionary.
#  You type a Latin word, and you get an image scanned from the dictionary.
#  The graphic interface allows to zoom and pan this image easily.

This information only belongs in the description for the package that
actually provides felix; and the pointer should be to the name of the
package, not the executable.  (What, no "Suggests: felix-latin"?)

My versions:

| Description: Félix Gaffiot's Latin-French dictionary - viewer
|  Félix Gaffiot (1870-1937) was a philologist, a teacher of French, and the
|  author of a Latin-French reference dictionary.
|  .
|  This package provides "felix", a graphical interface for searching the
|  dictionary. Entering a Latin word opens the corresponding page in the
|  form of a scanned image that can be zoomed and panned over.

| Description: Félix Gaffiot's Latin-French dictionary - data
|  Félix Gaffiot (1870-1937) was a philologist, a teacher of French, and the
|  author of a Latin-French reference dictionary.
|  .
|  This package provides the dictionary pages (in scanned image form) for
|  use with the package felix-latin.


-- 
JBR     with qualifications in linguistics, experience as a Debian
        sysadmin, and probably no clue about this particular package

diff -ru felix-latin-2.0.pristine/debian/control felix-latin-2.0/debian/control
--- felix-latin-2.0.pristine/debian/control	2012-05-01 17:03:27.000000000 +0100
+++ felix-latin-2.0/debian/control	2012-12-15 23:57:47.366724215 +0000
@@ -11,24 +11,20 @@
 Package: felix-latin
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, felix-latin-data, djvulibre-bin
-Description: Latin-French dictionary, by Felix Gaffiot
- Félix Gaffiot was born in 1870 in Liesle 
- (Doubs, France) and is dead in  1937, he is a philologue and a teacher of 
- French, he authored a reference Latin-French dictionary.
+Description: Félix Gaffiot's Latin-French dictionary - viewer
+ Félix Gaffiot (1870-1937) was a philologist, a teacher of French, and the
+ author of a Latin-French reference dictionary.
  .
- The program "felix" allows to search easily in the Latin-French dictionary.
- You type a Latin word, and you get an image scanned from the dictionary.
- The graphic interface allows to zoom and pan this image easily.
+ This package provides "felix", a graphical interface for searching the
+ dictionary. Entering a Latin word opens the corresponding page in the
+ form of a scanned image that can be zoomed and panned over.
 
 Package: felix-latin-data
 Architecture: all
 Depends: ${misc:Depends}
-Description: Scanned pages of Felix Gaffiot's Latin-French dictionary
- Félix Gaffiot was born in 1870 in Liesle 
- (Doubs, France) and is dead in  1937, he is a philologue and a teacher of 
- French, he authored a reference Latin-French dictionary.
+Description: Félix Gaffiot's Latin-French dictionary - data
+ Félix Gaffiot (1870-1937) was a philologist, a teacher of French, and the
+ author of a Latin-French reference dictionary.
  .
- this package provides the data for the program "felix".
- Felix allows to search easily in the Latin-French dictionary.
- You type a Latin word, and you get an image scanned from the dictionary.
- The graphic interface allows to zoom and pan this image easily.
+ This package provides the dictionary pages (in scanned image form) for
+ use with the package felix-latin.

Reply via email to