doc buglets?

Rustom Mody rustompmody at gmail.com
Tue Feb 10 06:40:15 EST 2015


On Monday, February 9, 2015 at 9:25:45 PM UTC+5:30, Mark Lawrence wrote:
> On 09/02/2015 11:28, Rustom Mody wrote:
> > Poking around in help() (python 3.4.2) I find
> >
> > * PACKAGES
> > does not seem to have anything on packages
> > * DYNAMICFEATURES
> > seems to be some kind of footnote
> > * SPECIALATTRIBUTES
> > has 'bases' and 'subclasses'. It seems to me a more consistent naming
> > for OOP would be in order.  These are the OOP-metaphors I am familiar with
> > - superclass ↔ subclass
> > - base class ↔ derived class
> > - parent class ↔ child class
> >
> > [Yeah if this is a bug its more than a docbug.
> > So no, I am not suggesting changing the actual attribute names which would be a
> > breaking change, just the stuff in help()
> > ]
> >
> 
> So raise an issue and attach a patch.

Sure – can do.
However for the first two I am not sure what the intentions of those entries are

And for the third, I am not clear that anyone other than me finds the mismatching
metaphors galling.



More information about the Python-list mailing list