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

[Xavier V. <xav...@fr...>]

Hi Michael, Jerry and the others !

> > Hey! This look cool! I really like it! Great! Congratulations!
Thanks ;) 
BTW, the CSS isn't finished. There are some glitches, especially with
KHTML.

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

> I'm okay with it.  Xavier pointed out that man pages and html pages are
> directed at different audiences, and I agree with him to a certain
> degree.  I think the driver documentation can be useful in both formats,
> so I might look at hacking something together to make the driver docs 
> into part of a man page.
Maybe an xsl to outpub docbook, but I  don't think it would be useful nor
coherent. Another solution would be to genrate plain text to be read
with a terminal (this one is easy !)

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

Another point :
> > If this is okay with all of you, I'd like to add this stuff to the
CVS. 
> > 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.
I don't know if we should include the whole build system in the releases or
just the compiled html ...

Bye !
-- 
Xavier VELLO <xav...@fr...>