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