Package: cconv Version: 0.6.2 Severity: wishlist Tags: patch Cconv's package description has several problems; for instance it spells the word "characters" in three different ways.
> Package: cconv > Architecture: any > Depends: ${shlibs:Depends}, ${misc:Depends} > Recommends: iconv > Description: simplified-traditional chinese conversion tool Problem one: Simplified and Traditional Chinese should be capitalised. Problem two: there's no such thing as Simplified-hyphen-Traditional Chinese. It might be intended as an n-dash, saying that cconv is a Simplified-to-Traditional conversion tool, but that wrongly implies it's one-way. What you really mean is: Description: Simplified/Traditional Chinese conversion tool > The Chinese national GB standard defines a basic set of (around 6,000) > characters for use with Simplified Chinese writing that does not include many "With" (implying the characters merely accompany the writing) is the wrong preposition; you mean "in" (or maybe "for"). This sentence is fairly long and complicated (and for instance it's not immediately obvious that the thing that "does not include" certain characters is the "basic set"); it would be easier to follow if there was more of a break in the middle here. I suggest: The Chinese national GB standard defines a basic set of (around 6,000) characters for use in Simplified Chinese writing; this excludes many of > of the characters in the Taiwanese industry standard for Traditional Chinese > called Big5 (around 13,000 characters in the basic set). Unicode is however a > superset of both with all duplication removed down to the level of detail > described above. No "level of detail" is described above - was this text cut'n'pasted from elsewhere? Besides, the de-duplication doesn't stop at any predefined "level of detail"; it applies to every case that's considered to count as duplication. So we might as well just say: [...] However, Unicode is a superset of both (with the duplication removed). > . > This tool is used for converting a UTF-8 string which combining both ^^^^^^^^^ > Simplified Chinese characters and Traditional Chinese charcters directly into ~~~~~~~~~ > one type Chinese chareacters. ^^^^^^^^ ~~~~~~~~~~~ Taking out the grammar (^^^) and spelling (~~~) problems and doing some de-duping of my own, I would suggest: This tool is used for converting a UTF-8 string which contains both Simplified and Traditional Chinese characters directly into a single Chinese character set. > Package: libcconv0 > Section: libs > Architecture: any > Depends: ${shlibs:Depends}, ${misc:Depends} > Description: library for CCONV ~~~~~ There's no particular reason for uppercase - it isn't an acronym, and it isn't the upstream project name. > CCONV is a simplified-traditional chinese conversion tool. ~~~~~ ~ ^~ ~ > . > This package provide runtime libraries for CCONV. ^ """ ~~~~~ > . > For more information about CCONV, please see the description of cconv > package. ~~~~~ ^^^^^^^ A factual problem ("""): is it one library or several? It looks to me like just one. Merge the boilerplate "about cconv" lines, separate out the section describing this package, and fix the English: Description: library for cconv Cconv is a Simplified/Traditional Chinese conversion tool. For more information, see the description of the package cconv. . This package provides the runtime library for cconv. (Or you could even shorten it down to: Description: Chinese conversion tool - runtime library This package provides the runtime library for cconv, the Simplified/Traditional Chinese conversion tool. but my patch has the longer version.) > Package: libcconv-dev > Section: libdevel > Architecture: any > Depends: libcconv0 (= ${binary:Version}), ${misc:Depends} > Description: development library for CCONV > CCONV is a simplified-traditional chinese conversion tool. > . > This package provide development libraries and documentations for CCONV. > . > For more information about CCONV, please see the description of cconv > package. Ditto, with an extra grammar error (s/documentations/documentation/); I would suggest: Description: development libraries for cconv Cconv is a Simplified/Traditional Chinese conversion tool. For more information, see the description of the package cconv. . This package provides development libraries and documentation for cconv. (Or you could even shorten it down to: Description: Chinese conversion tool - development libraries This package provides development files and documentation for cconv, the Simplified/Traditional Chinese conversion tool. but my patch has the longer version.) -- JBR Ankh kak! (Ancient Egyptian blessing)
diff -ru cconv-0.6.2.pristine/debian/control cconv-0.6.2/debian/control --- cconv-0.6.2.pristine/debian/control 2012-06-27 15:33:36.000000000 +0100 +++ cconv-0.6.2/debian/control 2012-06-28 10:47:02.683725741 +0100 @@ -10,36 +10,33 @@ Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Recommends: iconv -Description: simplified-traditional chinese conversion tool +Description: Simplified/Traditional Chinese conversion tool The Chinese national GB standard defines a basic set of (around 6,000) - characters for use with Simplified Chinese writing that does not include many - of the characters in the Taiwanese industry standard for Traditional Chinese - called Big5 (around 13,000 characters in the basic set). Unicode is however a - superset of both with all duplication removed down to the level of detail - described above. + characters for use in Simplified Chinese writing; this excludes many of + the characters in the Taiwanese industry standard for Traditional Chinese + called Big5 (around 13,000 characters in the basic set). However, Unicode + is a superset of both (with the duplication removed). . - This tool is used for converting a UTF-8 string which combining both - Simplified Chinese characters and Traditional Chinese charcters directly into - one type Chinese chareacters. + This tool is used for converting a UTF-8 string which contains both + Simplified and Traditional Chinese characters directly into a single + Chinese character set. Package: libcconv0 Section: libs Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} -Description: library for CCONV - CCONV is a simplified-traditional chinese conversion tool. +Description: library for cconv + Cconv is a Simplified/Traditional Chinese conversion tool. For more + information, see the description of the package cconv. . - This package provide runtime libraries for CCONV. - . - For more information about CCONV, please see the description of cconv package. + This package provides the runtime library for cconv. Package: libcconv-dev Section: libdevel Architecture: any Depends: libcconv0 (= ${binary:Version}), ${misc:Depends} -Description: development library for CCONV - CCONV is a simplified-traditional chinese conversion tool. - . - This package provide development libraries and documentations for CCONV. +Description: development libraries for CCONV + Cconv is a Simplified/Traditional Chinese conversion tool. For more + information, see the description of the package cconv. . - For more information about CCONV, please see the description of cconv package. + This package provides development libraries and documentation for cconv.