Bug#425963: libglazedlists-java-doc has inadequate package description

2007-05-25 Thread Craig Sanders
Package: libglazedlists-java-doc
Version: 1.7.0.dfsg-1

This package contains the documentation for libglazedlists-java. is
an inadequate description. it's also redundant - the package name alone
tells the user that it is documentation for a java library.

what the desc should provide is a brief description of what libglazedlists
is/does.

btw, don't assume that someone reading the description for a -doc
package has already read the desc for the lib package, or vice-versa,
or that they have encountered the software on the previously. the
description for all related packages should assume that the reader has
no prior knowledge of what the package is, so should provide a brief
description/summary.


this bug probably applies to the other libglazedlists packages.  dunno,
haven't checked.


craig

-- 
craig sanders [EMAIL PROTECTED]


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#425963: libglazedlists-java-doc has inadequate package description

2007-05-25 Thread gregor herrmann
On Fri, 25 May 2007 18:01:36 +1000, Craig Sanders wrote:

 This package contains the documentation for libglazedlists-java. is
 an inadequate description. it's also redundant - the package name alone
 tells the user that it is documentation for a java library.
 
 what the desc should provide is a brief description of what libglazedlists
 is/does.

Agreed.
I've fixed the description in svn, my sponsor will probably upload
the new revision in a few days after his vacancy.

Thank for bringing this issue up!
 
Cheers,
gregor 
-- 
 .''`.   http://info.comodo.priv.at/ | gpg key ID: 0x00F3CFE4
 : :' :  debian: the universal operating system - http://www.debian.org/
 `. `'   member of https://www.vibe.at/ | how to reply: http://got.to/quote/
   `-NP: Cat Stevens: Where Do The Children Play?


signature.asc
Description: Digital signature


Bug#425963: libglazedlists-java-doc has inadequate package description

2007-05-25 Thread Craig Sanders
On Fri, May 25, 2007 at 11:06:49PM +0200, gregor herrmann wrote:
 On Fri, 25 May 2007 18:01:36 +1000, Craig Sanders wrote:
  what the desc should provide is a brief description of what libglazedlists
  is/does.
 
 Agreed.
 I've fixed the description in svn, my sponsor will probably upload
 the new revision in a few days after his vacancy.
 
 Thank for bringing this issue up!

thanks for fixing it so quickly.

desc bugs like these aren't urgent...they can wait until the next upload
(for packages with a reasonably rapid dev cycle, anyway).


craig

-- 
craig sanders [EMAIL PROTECTED]


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]