|
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 :-) ? regards Steve -- 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
|