Documentation questions (was: Re: Questions)

[Svetlana A. Tkachenko]

I'm renaming the thread to get help with answers to some questions
contained therein.
These questions are included below.

> Debian should perhaps ship them as doc packages ? Are you using debian 
> packages for GNUstep?

Yes, I am. Which packages?

> It would make sense to use HTML as the viewable format,

There also needs to be a way to structure the documentation ("this is
chapter 1", "this is chapter 1.2.2", etc).

> Since NSHelpManager lets you use any external app, you are not limited; if 
> you can find a good one, then simply providing an app wrappper for the 
> non-GNUstep app would make it easy for people to use it.  

Yes using SimpleWebKit/Vespucci.app or a Firefox engine with wrapper
sounds good, but I did not find source code for the latter effort (even
though it was mentioned on list).

One fundamental difference of such app from a help viewer is ability to
show a list of available documentation, and to search it.

> It ought to be a fairly simple research project to see;
> a. if Apple have changed to use a new format (or added a new format so you 
> can use both)
> b. If GNUstep-GUI has followed any change (normal policy is to try to retain 
> support for old API/format while adding support for new ones introduced by 
> Apple).

This could be interesting to do, but is out of my depth (I don't have a
Mac and don't know where to look for such information).

-- 
Svetlana A. Tkachenko
Member of the Free Software Foundation
www.fsf.org  www.gnu.org www.freenode.net