Re: [Lcd4linux-devel] manpage for lcd4linux

[Samuel M. <sam...@en...>]

Hello,

I had started a docbook version of the help webpage which I joined to
this mail. It is far from being complete but it shows that it is quite
easy to make an sgml document from which you'll be able to generate the
man page as well as a webpage.

Cheers,

Sam.

On Mon, 23 Feb 2004 23:46:28 +0100
Martin Hejl <ma...@he...> wrote:

> 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
> 
> 
> 
> 
> -------------------------------------------------------
> SF.Net is sponsored by: Speed Start Your Linux Apps Now.
> Build and deploy apps & Web services for Linux with
> a free DVD software kit from IBM. Click Now!
> http://ads.osdn.com/?ad_id=1356&alloc_id=3438&op=click
> _______________________________________________
> Lcd4linux-devel mailing list
> Lcd...@li...
> https://lists.sourceforge.net/lists/listinfo/lcd4linux-devel


-- 
Samuel Mimram

sam...@en...

BOFH excuse #141:

disks spinning backwards - toggle the hemisphere jumper.