[Python-Dev] Writable __doc__

[Eric Snow]

On Wed, Jan 18, 2012 at 5:01 PM, Ethan Furman <ethan at stoneleaf.us> wrote:
> Is there a reason why normal classes can't have their __doc__ strings
> rewritten?  Creating a do-nothing metaclass seems like overkill for such a
> simple operation.
>
> Python 3.2 ... on win32
> --> class Test():
> ...   __doc__ = 'am I permanent?'
> ...
> --> Test.__doc__
> 'am I permanent?'
> --> Test.__doc__ = 'yes'
> Traceback (most recent call last):
>  File "<stdin>", line 1, in <module>
> AttributeError: attribute '__doc__' of 'type' objects is not writable
> --> type(Test)
> <class 'type'>
>
> --> class Meta(type):
> ...   "only for exists to allow writable __doc__"
> ...
> --> class Test(metaclass=Meta):
> ...   __doc__ = 'am I permanent?'
> ...
> --> Test.__doc__
> 'am I permanent?'
> --> Test.__doc__ = 'No!'
> --> Test.__doc__
> 'No!'
> --> type(Test)
> <class '__main__.Meta'>
>
> Should I create a bug report?

http://bugs.python.org/issue12773  :)

-eric