[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Request for improve a package description



Yes it was not clear about the language
so we can turn the description like this :

Package: libxr
Description: SSL-capable XML-RPC implementation - shared libraries
  This cross-platform XML-RPC library supports persistent HTTP/1.1
  connections over SSL. It comes with an XML-RPC interface description
  language compiler.

Package: libxr-dev
Description: SSL-capable XML-RPC implementation - development files
  This cross-platform XML-RPC library supports persistent HTTP/1.1
  connections over SSL. It comes with an XML-RPC interface description
  language compiler.
  .
  The development headers for compiling programs that use libxr are
  provided by this package.

Package: libxr-dbg
Description: SSL-capable XML-RPC implementation - debug symbols
  This cross-platform XML-RPC library supports persistent HTTP/1.1
  connections over SSL. It comes with an XML-RPC interface description
  language compiler.
  .
  The debugging symbols for tracking down bugs in applications
  that use libxr are provided by this package.

It seems good, is that okay for you ?
Fabien


2009/11/10 Justin B Rye <jbr@edlug.org.uk>
fabien boucher wrote:
> For the long desc i think explaining that the library comes with an XML-RPC
> interface description language is really important.

That's the part that doesn't make sense to me (I can see that the
.deb contains software that can compile XDL code into C... but in
what sense does it also contain the language?), so I'll just take
your word for it.

> So following your point of view the rewrite could be :
>
> Package: libxr
> Description: SSL-capable XML-RPC implementation - shared libraries
>  This cross-platform XML-RPC library supports persistent HTTP/1.1
>  connections over SSL. It comes with XML-RPC interface description
>  language and client/server code compiler.

This definitely needs an indefinite article:

  connections over SSL. It comes with an XML-RPC interface description
                                      ^^
[...]
>  Development headers needed to compile programs that use libxr.
[...]
>  Debugging symbols useful for tracking down bugs in
>  applications with libxr.

I could insist on turning these into complete sentences, but "This
package provides..." gets very repetitive.  Of course you could just
scramble them slightly:

  The development headers for compiling programs that use libxr are
  provided by this package.
[...]
  The debugging symbols for tracking down bugs in applications
  that use libxr are provided by this package.

Or maybe they're okay as they are - any other reviewers out there?
--
JBR     with qualifications in linguistics, experience as a Debian
       sysadmin, and probably no clue about this particular package


--
To UNSUBSCRIBE, email to debian-l10n-english-REQUEST@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org



Reply to: