This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ron_adam
Recipients belopolsky, docs@python, eric.araujo, georg.brandl, ron_adam
Date 2010-11-18.04:21:18
SpamBayes Score 0.0060475394
Marked as misclassified No
Message-id <1290054080.09.0.453976305121.issue10446@psf.upfronthosting.co.za>
In-reply-to
Content
I noticed in your patch, the disclaimer only prints when pydoc can find a doc location (docloc is not None).  So it may not get displayed at all depending on how python is installed.  I also think having it on every page may be a bit overly cautious. (IMHO)

I'm also not sure it is correct to have that when viewing third party modules as the doc location in those cases will be broken anyway.

The obvious places to put it are:
   * top of the pydoc html module index.  (first page displayed)
   * in the welcome message for interactive help()
   * help(help)
   * help(pydoc)

It can still be defined in one location and then use "+ pydoc_disclaimer" in the desired locations.
History
Date User Action Args
2010-11-18 04:21:20ron_adamsetrecipients: + ron_adam, georg.brandl, belopolsky, eric.araujo, docs@python
2010-11-18 04:21:20ron_adamsetmessageid: <1290054080.09.0.453976305121.issue10446@psf.upfronthosting.co.za>
2010-11-18 04:21:18ron_adamlinkissue10446 messages
2010-11-18 04:21:18ron_adamcreate