Why does dynamic doc string do not work?

Miki Tebeka miki.tebeka at gmail.com
Tue Aug 21 13:40:04 EDT 2012


Thanks!

> On 08/21/2012 12:44 PM, Miki Tebeka wrote:
> 
> > <snip>
> 
> >>> class B:
> 
> > ...     '''a {} string'''.format('doc')
> 
> > ... 
> 
> >>>> B.__doc__
> 
> >>>>
> 
> > <snip>      I wonder why the first B docstring is empty. Thanks, -- Miki
> 
> 
> 
> According to some early documentation:
> 
> 
> 
> "convenient initialization of the |__doc__| attribute of modules,
> 
> classes and functions by placing a string literal by itself as the first
> 
> statement in the suite. It must be a literal -- an expression yielding a
> 
> string object is not accepted as a documentation string, since future
> 
> tools may need to derive documentation from source by parsing."
> 
> 
> 
> -- 
> 
> 
> 
> DaveA




More information about the Python-list mailing list