pydoc preference for triple double over triple single quotes -- anyreason?
Kent Johnson
kent37 at tds.net
Sat Apr 16 16:41:28 EDT 2005
Brian van den Broek wrote:
> Hi all,
>
> I'm posting partly so my problem and solution might be more easily found
> by google, and partly out of mere curiosity.
>
> I've just spent a frustrating bit of time figuring out why pydoc didn't
> extract a description from my module docstrings. Even though I had a
> well formed docstring (one line, followed by a blank line, followed by
> the rest of the docstring), when I ran Module docs, my modules showed up
> as having "no description". ("Module docs" referring to the shortcut
> installed on Windows that launches the pydoc server.)
?? It works for me with triple-single quoted strings...from a quick look it appears that pydoc uses
inspect which looks at the __doc__ attribute; do your modules have __doc__ attributes?
Kent
More information about the Python-list
mailing list