[mod_python] Re: Mod_python Digest, Vol 42, Issue 4

Steve Holden steve at holdenweb.com
Thu Sep 14 07:51:28 EDT 2006

Graham Dumpleton wrote:
> All I can say is that we know the documentation is inadequate.
> We have been waiting for a long time for the ASF to setup a wiki
> page for mod_python so that we have a more flexible forum for
> putting up documentation that can better explain things. Ie., a
> place where documentation can be quickly added/changed as
> issues come up. At the moment the documentation is LaTeX based
> and a part of the source code. This doesn't lend itself to easy or quick
> updates as the main site is only updated when major releases occur.
> Anyway, for myself I have given up waiting for the wiki and am
> turning my existing mod_python articles into my own unofficial
> wiki so I can at least more quickly add new stuff. I have quite a
> long list of mini articles I want to write that I have been holding off
> doing due to the lack of an official wiki. Keep an eye out for more
> on this in the near future.
Why not just start using an exisitng Wiki like the one at python.org, 
then migrate when the ASF wiki is ready?

> In respect of mod_python vs mod_python.publisher, they are actually
> two totally different things. In some respects, mod_python.publisher
> and mod_python.psp should be released as totally separate products
> from the mod_python core. That they aren't often causes a lot of
> confusion as people, like yourself, see mod_python.publisher and
> mod_python as one in the same, when in fact mod_python.publisher
> is a higher level interface which is used in a totally different way.
Yup. It might make more sense to distinguish it as an add-on (or at 
least flag the differences clearly for novices).

> In respect of AddHandler, SetHandler, MultiViews etc, you need to  realise
> that mod_python is an extension for Apache. Thus, such things like this
> aren't actually implemented by mod_python but are implemented
> by Apache. To use mod_python properly, you also need to understand
> Apache to some degree and that means also referring to the Apache
> documentation.
Which, IMHO, is even more obscurantist than the mod_python 
documentation. It seems to assume you've already read much of the source 
code and are familiar with C ... in which case why would you be using 
mod_python in the first place :-) ?

Steve Holden       +44 150 684 7255  +1 800 494 3119
Holden Web LLC/Ltd          http://www.holdenweb.com
Skype: holdenweb       http://holdenweb.blogspot.com
Recent Ramblings     http://del.icio.us/steve.holden

More information about the Mod_python mailing list