> I want to keep comments and doc-strings separate. > > By the by: what were the eventual conclusions of all that discussion > about how to specify cross-references in docstrings ? Is there a > succinct statement of it somewhere ? > > Eddy. http://starship.skyport.net/crew/danilo/pythondoc/pythondoc.htm Click the second footnote. Pipermail can show the whole thread as well.