Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > comp.lang.python > #27586
| Date | 2012-08-21 13:30 -0400 |
|---|---|
| From | Dave Angel <d@davea.name> |
| Subject | Re: Why does dynamic doc string do not work? |
| References | <3a128081-7f5d-4641-bc5d-8cffe64f5eee@googlegroups.com> |
| Newsgroups | comp.lang.python |
| Message-ID | <mailman.3613.1345570273.4697.python-list@python.org> (permalink) |
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
Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread
Why does dynamic doc string do not work? Miki Tebeka <miki.tebeka@gmail.com> - 2012-08-21 09:44 -0700
Re: Why does dynamic doc string do not work? Ian Kelly <ian.g.kelly@gmail.com> - 2012-08-21 11:09 -0600
Re: Why does dynamic doc string do not work? MRAB <python@mrabarnett.plus.com> - 2012-08-21 18:16 +0100
Re: Why does dynamic doc string do not work? Ian Kelly <ian.g.kelly@gmail.com> - 2012-08-21 11:21 -0600
Re: Why does dynamic doc string do not work? Steven D'Aprano <steve+comp.lang.python@pearwood.info> - 2012-08-21 17:22 +0000
Re: Why does dynamic doc string do not work? Dave Angel <d@davea.name> - 2012-08-21 13:30 -0400
Re: Why does dynamic doc string do not work? Miki Tebeka <miki.tebeka@gmail.com> - 2012-08-21 10:40 -0700
Re: Why does dynamic doc string do not work? Miki Tebeka <miki.tebeka@gmail.com> - 2012-08-21 10:40 -0700
csiph-web