Barry Warsaw <[email protected]> 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

Attachment: pgpRaz71oLCew.pgp
Description: PGP signature

_______________________________________________
Distutils-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/distutils-sig

Reply via email to