Bug#633857: Package description is infortunate
Justin B Rye
jbr at edlug.org.uk
Thu Jul 14 14:25:52 UTC 2011
Martin Eberhard Schauer wrote:
> Description: Robust HTTP client library for Java
> This library provides a Java InputStream implementation around a
> HTTP connection that automatically reconnects if the connection
> fails in the middle communication.
>
> Perhaps it's a good idea just to
> sed -e s/in the middle/during/ debian/control.
> In the middle communication seems incorrect and redundant to me
> reconnect implies a previous connection/communication.
Yes, that would make sense. Alternatively, the phrasing used in the
-doc package is just "if the connection fails in the middle".
If we were doing a full d-l-e package description review I would also
suggest s/Robust/robust/ in the synopsis, and some minor rephrasing of
the long description - I have no idea what it's supposed to mean for
an implementation to be "around" a connection. Is it an InputStream
library built on HttpURLConnection, or vice versa? Maybe something
like:
Description: robust HTTP client library for Java
This library provides a Java InputStream implementation of a
retryable HTTP connection, which reconnects automatically if a
connection fails in the middle.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
More information about the pkg-java-maintainers
mailing list