Bug#680746: entagged: package description review

[Justin B Rye]

Package: entagged
Version: 0.35-4
Severity: wishlist
Tags: patch

The package description for entagged has a couple of typos and
stylistic issues.  Currently:

> Description: Java Audio File Tagger

This capitalisation would make sense if its name was JAFT, but given
that it isn't, leave the words "audio file tagger" lowercase. 

It's unclear why end users would care that it's written in Java; the
long description doesn't seem to think it's worth mentioning, so what
is it doing here in the synopsis?  Demote it and replace it with a
mention of the app's main selling point over its rivals: "with freedb
support".

Another major feature that this description fails to hint at is that
entagged is a *graphical* tagger (like easytag), not a commandline
tool (like vorbiscomment).

> Entagged is a audiofile tagger, using the freedb online database for

Typos: s/a audio/an audio/, and s/audiofile/audio file/.

> the retrieval of the tags. It supports custom file renaming from tags
> (with any directory stucture) and vice versa. Supports: mp3, ogg,

Typo: s/stucture/structure/.

The "vice versa" is a bit confusing: entagged supports file renaming
from tags, and... tag renaming from files?  Leave out the "vice versa"
and just use roughly the same phrasing as in the man page.

> flac, mpc, ape, wma.

Since I'm already editing this I'll sort the formats into alphabetical
order and (again as in the man page) put them in caps - these are the
equivalents of "JPEG", not ".jpg").

So my suggested version is:

| Description: graphical audio file tagger with freedb support
|  Entagged is an audio file tagger written in Java, using the freedb online
|  database for the retrieval of the tags. It can be used to organize files
|  into complex directory structures according to their tags, or to tag them
|  from their filenames. Supports: APE, FLAC, MP3, MPC, OGG, WMA.

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pd.diff
Type: text/x-diff
Size: 972 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-java-maintainers/attachments/20120708/f6d274df/attachment.diff>