On Sat, Nov 18, 2017 at 2:12 PM, Python <pyt...@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 <pyt...@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 -- https://mail.python.org/mailman/listinfo/python-list