[ubuntu-dev] Bug#804199: Bug#804199: python-ubuntutools: clarify description and relation to Python 2

[Ben Finney]

On 08-Nov-2015, Benjamin Drung wrote:
> Am Freitag, den 06.11.2015, 12:34 +1100 schrieb Ben Finney:
> > The package description could be clarified to more closely follow
> > Debian packaging guidelines, and make clear this installs a Python
> > 2 library.
> 
> Can you point me to the part of the Debian packaging guidelines that
> you refer to?

For one, the Developer's Reference §6.2. As far as I know this package
has no outright violations (this bug is of “minor”-level severity).

To be clear, the issues I'm reporting and addressing with this bug
report are:

* The synopsis of each package should be informative; one of them
  fails to distinguish that it's specifically for Python 3.

* The long description of each package should consist of complete
  sentences (as you observed).

I also wanted to address the ambiguity of “library”; it's not clear
whether the synopses are referring to the technical sense of a code
library, or the colloquial sense of a simple collection. I offer my
suggestion as a way to clarify the use of “library in the synopsis.

> I will apply the attached patch instead if you are fine with it.

Since that patch also addresses the main issues above, sure I'd be
fine with either patch.

-- 
 \          “I used to be an airline pilot. I got fired because I kept |
  `\       locking the keys in the plane. They caught me on an 80 foot |
_o__)                    stepladder with a coathanger.” —Steven Wright |
Ben Finney <ben at benfinney.id.au>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/ubuntu-dev-team/attachments/20151109/60088c9e/attachment.sig>