[lazarus] help format

[Matjaz Mihelic]

Michael.VanCanneyt at wisa.be wrote:

>
>On Wed, 23 Jan 2002, Mattias Gaertner wrote:
>
>>Hi all,
>>
>>A month ago, there was a discussion about the help format for lazarus.
>>It was mentioned, that a browser based help system would be far too slow.
>>The alternatives for the format were html, windows help, custom format or fpdoc.
>>The alternatives for the viewer were custom helpviewer or gtkhtml.
>>
>>The help should be easily to edit under at least linux and windows.
>>The context sensitive help system for the IDE needs a link based system, which can be remote controlled. Remote control should be possible via help IDs and via keyword search like "TTreeView" -> "Items". It would be nice, if the help viewer has got only one window, instead of three like Delphi. I think, the Delphi navigation of properties to the left and explanation to the right is nice, but I miss the big context. It would help, if the left side shows a tree of the complete help instead of just one node.
>>Did I miss something important?
>>
>>Is there any help format+viewer+editor available?
>>
>>We already got some texts. But we need a format to publish them.
>>
>
>For what it is worth:
>
>The core team (i.e. mostly me, I assume) from now on uses fpdoc for the
>documentation of the FCL mainly for these reasons:
>
>- The format is more or less 'designed' for FPC documentation.
>
>- The fpdoc tool is written in pascal and maintained by us. We can extend
>  it in any way we like/see fit.
>
>- At this moment, it generates nice HTML, and printable LaTeX
>  (and hence, e.g. PDF) but it can be easily extended with any back
>  end you want. I'm myself planning to add RTF after I tweaked the
>  LaTeX
>  You could add any custom format you would like.
>
>- Making an editor for it should be easy, and is definitely planned.
>  Michael Hess knows about this.
>
>Using fpdoc would enable you to cross-link to the FCL docs without
>problem. Since you can create any back-end you like, you could make
>an output format that is easy to display for you.
>
>Michael.
>
>
>
>_________________________________________________________________
>     To unsubscribe: mail lazarus-request at miraclec.com with
>                "unsubscribe" as the Subject
>    archives at http://www.miraclec.com/list_archives/lazarus
>
The best format would be HTML.
There are light help viewers for all systems. PDF is not flexible enough.
All what is needed to make HTML help is to make one query search page, 
besides Konqueror and Yelp(new gnome help browser will be light and 
fast, same is for Windows where Netscape loads even faster than IE.

A little question, GTK2 comming to the scene and he's got some of new 
features, are these features compatible with old GTK??? Does this affect 
lazarus in any way. I know it's a bit strange question, but all new 
distros will have this new gtk, and will be probably avoiding old one. 
(Ideal would be if it would be like in KDE, where you still have the old 
core and kde 1.1.2 software is working) But, is this affecting or it 
would be good to have a port to gtk2.

matjaz