help file formats (was: Re: [Pyobjc-dev] problem accessing outlet)

[Steven D. A. <st...@ne...>]

On 10/29/02 4:31 PM, "Jack Jansen" <Jac...@or...> wrote:

> 
> Bill Fancher contributed a script to convert the Python manual
> from it's HTML form to the form required by Apple Help Viewer
> (see Mac/OSX/setupDocs.py in the Python CVS tree).
> 
> Even though help viewer is a [censored] piece of [censored]
> (although it's slightly better in Jaguar, admitted) it has the
> advantage of the search engine and of everyone understanding it.
> And I think it would be good to have all the Python
> documentation together in one place, which would then have
> sections for Python Language, IDE, PyObjC and anything else.

That makes a lot of sense.  It almost sounds like I should use a version of
XML with some tool that can convert to HTML, text, or other formats.  I
could then hack the script you mentioned so that the same XML source could
be converted to Apple Help format.

I'll do a search for such tools; if anyone knows of such a tool, please send
me a link.  In the absence of such a tool, I'll go ahead with HTML for now,
and keep my eyes open.

steve
--