Re: [Lcd4linux-devel] function naming changed in CVS

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

Hi there,

>>>Is it possible to create a "standard unix man page" out of this?
>>
>>>From my understanding, no.
> 
> Right ! In fact, I'd prefer the html doc and the manpage not to be identical.
> In fact, the manpage should just list the comandline options and point to
> the html doc for the config. Moreover, I don't think we can generate manpages
> with xslt (it may be possible to output docbook and them process it to
> man, but it's not very clean).

Okay, forget about the man page for now.

>>>As a last step, we have to agree on who writes what parts of the 
>>>documentation. I think I should write the drivers section, because I 
>>>know most of them by heart :-)
>>
>>All right.  You're nominated for writing driver documentation.  I've 
>>been working on what basically is a "getting started" section.  I'll
>>also work on basic program usage.  What other areas need documentation?
> 
> I think I'll write the plugins section, as I know them well.
Fine!

>>>Xavier, you'll have to tell me what belongs into CVS, and what into a 
>>>distribution tarball.
> 
> The data, drivers, dtd, lcd4linux, plugins and xsl folder and Makefile and
> Makefile.generic are part of the build system. The HTML folder should never
> be on the CVS, but in the tarballs.
Check in done.

> I don't know if we should include the whole build system in the releases or
> just the compiled html ...

Hmmm... Good question...

Another point: how to include the documentation tree into the main 
Makefile? (automake!?!)


bye, Michael

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