Author ron_adam
Recipients belopolsky, docs@python, eric.araujo, georg.brandl, ron_adam
Date 2010-11-18.04:21:18
SpamBayes Score 0.00604754
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