[mod_python] publisher handler not working on FreeBSD, Apache 1.3 and modpython 2.7

Jorey Bump wrote:

> My recommendation to Publisher beginners is to avoid using modules named 
>  index.py and index() functions until they thoroughly understand how 
> mod_python works. Index traversal is a special case in 3.x, and it's 
> nearly impossible to understand coming from a different background. The 
> documentation can also be misleading (note that this is for mod_python 
> 3.x, not 2.x!):
> 
> http://www.modpython.org/live/current/doc-html/hand-pub-alg-trav.html

In what way is it misleading? Suggestions to make it clearer are welcome.

Jim