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

[Yuppie]

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