"help( pi )"

[Chris Angelico]

On Sat, Nov 18, 2017 at 2:12 PM, Python <python at bladeshadow.org> wrote:
> On Sat, Nov 18, 2017 at 10:47:55AM +1100, Chris Angelico wrote:
>> On Sat, Nov 18, 2017 at 10:34 AM, Python <python at bladeshadow.org> wrote:
>> > On Sat, Nov 18, 2017 at 09:50:29AM +1100, Chris Angelico wrote:
>> >> Perhaps what we want is not so much "attach docstrings to floats" but
>> >> "get documentation for a module attribute, not for the object referred
>> >> to".
>> >
>> > The reason this can't really work is that members are just variables
>> > with arbitrary values.  It does not make sense for them to have doc
>> > strings.
>>
>> Did you read my post?
>
> Yes!  Did you read mine?  I tried to explain to you that what you're
> suggesting doesn't really fit Python's paradigm: Doc strings describe
> their owner class, not individual instances--the class' doc string is
> where the description of your class (or module--same thing) attributes
> should go.

I gave a detailed example of something that was NOT a docstring. That
was, in fact, the whole point of my post.

ChrisA