Re: [Lcd4linux-devel] manpage for lcd4linux

[Martin H. <ma...@he...>]

Hi Xavier,

>>There are plans to generate both the manpage and the web page out of 
>>something like "docbook". I don't know it, so I can't tell you if its a 
>>good or bad idea. But having a common source is a good thing in any case...
> 
> In fact, DTML is as easy as writing HTML, but then it can be processed
> to create manpages and HTML pages. This would help keeping it all in
> sync.
> Read doc in docbook-doc package to find out.
I actually got started writing up a users manual for the 
"next-generation lcd4linux" in docbook - but unfortunately, other (more 
urgent) things to do got in the way, so there's not much to show (and 
it's a _lot_ to document, especially when one is still in the process 
finding out all the implications and possibilities of the new config 
system).

I guess documenting the drivers should be fairly easy (since most of it 
is the same as with the old version, it's just expressed in a different 
format in the config file) - but the plugin and layout definition surely 
is a different story.

Besides, I was struggling a bit with where to start, and what to explain 
where - I mean, looking at it from a new user's perspective, this can 
all be pretty overwhelming.

In short, I'm all for docbook (we use it at LEAF with great success), 
and I'm surely willing to help out with documentation (especially if 
it's in docbook-XML format)

Martin