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