[Zope-dev] Re: api docs [Was: Re: Post-mortem ...]

11 Dec 2003

      Hi!

Paul Winkler wrote:
...
What would be "sane" in your view?  
Using interfaces for help, as CMF does?
I was curious how CMF sets this up, and found the following
in CMFCore/__init__.py:
try:
        context.registerHelpTitle( 'CMF Core Help' )
        context.registerHelp(directory='interfaces')
    except: # AARGH!!
        pass
I love comments like that :-)
This bare except is removed in CMF HEAD, it's not necessary for current 
Zope versions.
<http://cvs.zope.org/CMF/CMFCore/__init__.py.diff?r1=1.24&r2=1.25>

But there are other issues with this approach. I never got a reply to 
this mail:
<http://mail.zope.org/pipermail/zope-dev/2002-November/018103.html>

Maybe the Zope X3 Introspector is a sane solution?

Cheers,
	Yuppie