From alsa-devel-owner@alsa.jcu.cz  Tue Mar  9 23:48:03 1999
Received: from mail.tvamidwest.com ([152.160.66.1])
	by marvin.jcu.cz (8.9.1a/8.9.1) with SMTP id XAA14321
	for <alsa-devel@alsa.jcu.cz>; Tue, 9 Mar 1999 23:47:39 +0100
Received: (qmail 27209 invoked from network); 10 Mar 1999 03:29:34 -0000
Received: from p61.a3.aa.ic.net (HELO ketl.com) (@152.160.123.189)
  by mail.ketl.com with SMTP; 10 Mar 1999 03:29:34 -0000
Message-ID: <36E6F6B8.48D28720@ketl.com>
Date: Wed, 10 Mar 1999 17:48:24 -0500
From: Chris David <cdavid@ketl.com>
MIME-Version: 1.0
To: alsa-devel@alsa.jcu.cz
Subject: Re: New call.html
References: <Pine.LNX.4.05.9903091417330.9233-100000@cyphyn.219.org>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Reply-To: alsa-devel@alsa.jcu.cz
Sender: alsa-devel-owner@alsa.jcu.cz
Precedence: list

Well, here is my view on it...

I think the source should stay in HTML.  Maybe its not the best, but its
probably the easist because everybody and their dogs know how to do
HTML.  Its also is the format that most people will see when they first
find ALSA, so I think its very important it looks the best.

That HTMLDoc program I like so much converts HTML to PDF and PS (level 1
and 2), I just happened to only target PDF. PS versions coming soon!

I use a perl program I wrote to dump the HTML to text.

So my point is, the source files (for documentation) for now are in
HTML.  Given that, I will create PDF, PS, and text files.

Average time for me to convert one HTML doc by hand to all these formats
is about 5 minutes, which is great.  It took me about 2 hours to setup
all this up on my system.  I'm in general a slow person, so if anyone
replaces me, they probably do it in much less time.

The whole system could be automated as well.  Everything can be command
line. (HTMLDoc does have a nice UI too.)

This works well for me, and I think it covers the most important
formats, PDF, PS, HTML, and text.  Its uses all GPL software, and Perl.
(Perl isn't GPL right?)

Honestly, I'd like to fit in LyX in here if possible, I think its a fun
program to use.  I just wish it would target HTML.

All we need now is a way to get man pages and info files :)

thanks

-Chris

