[Distutils] DRAFT PEP 396 - module version number

[Ben Finney]

Barry Warsaw <barry at python.org> writes:

> Hi Éric,
>
> On Jun 07, 2011, at 05:30 PM, Éric Araujo wrote:
>
> >Just two things I thought about while perusing my archives yesterday.
> >
> >>>>     #. For modules which are also packages, the module namespace
> >>>>        SHOULD include the ``__version__`` attribute.
> >>>
> >>> I’m still not sure “module namespace” will be clear to everyone.
[…]

Agreed. Damn English and its ample opportunities for ambiguity.

> So, what *should* we call this thing? Note that in the PEP, I'm
> specifically talking about the namespace, not the file. Maybe
> "module's namespace" would be clearer?

+1.

I think the grammar could be even clearer:

    For modules which are also packages, the ``__version__`` attribute
    SHOULD be in the module's namespace.

-- 
 \      “The opposite of a correct statement is a false statement. But |
  `\     the opposite of a profound truth may well be another profound |
_o__)                                              truth.” —Niels Bohr |
Ben Finney
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/distutils-sig/attachments/20110608/c5e12fd7/attachment.pgp>