Re: [Lcd4linux-devel] manpage for lcd4linux

[Michael R. <re...@eu...>]

Hi Jerry,

>>Unfortunately, we are in a process of reorganizing lcd4linux rather 
>>completely. Therefore writing a man page especially for the .conf is 
>>impossible or useless, because it will look very different for 0.9.12 
>>(we call it the "NextGeneration" internally.
> 
> Okay.  Ideally it would be nice to have the docs ready to go when 0.9.12
> is ready.  Can you give me a couple of weeks notice when you think it
> is close to being ready?

Of course, no problem.

>>Are you willing to become a "Documentation Manager" for lcd4linux? We 
>>would really need someone who takes care of that...

> If no one else wants to, sure, I'll do it.  I'll need some hand-holding
> in the form of "document this" and "that needs to be done".

I'd really appreciate it!

As a documentation manager, you should not only keep the man page up to 
date, but also some README's (maybe), and, most important, the web page, 
at least the "documentation" part of it.

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...

There are plans to do a rewrite of the webpage as a whole (avoid frames, 
use PHP).

I want all this stuff to be decided by the guy who's job is to manage 
it. So this would be you...


bye, Michael

-- 
Michael Reinelt                                   Tel: +43 676 3079941
Geisslergasse 4                                   Fax: +43 316  692343
A-8045 Graz, Austria                          e-mail: re...@eu...