Subject: Re: [linux-audio-dev] documentation
From: Kevin Conder (kconder_AT_interaccess.com)
Date: Fri Jul 27 2001 - 02:57:41 EEST
On Thu, 26 Jul 2001, Richard Dobson wrote:
>
> Now I am well aware that Linux/unix inherits and gleefully preserves a
> aura of obscurantism, with requests (often none too polite!) to RTFM at
> every turn, but often the FM is incomprehensible unless you already know
> what it means, and often the FM doesn't exist anyway. Where
> documentation does exist, it often says things like "to un-mitigate the
> interface manifold bi-furcation, de-synchronize the positronic
> lambdoma". Fistly, it assumes you know how to do the latter, and
> secondly, it assumes you know ~why~ you would want to do the former in
> the first place.
Please, could you provide some real examples?
Could you provide examples of Linux audio documentation that you
found to be unclear? (Please include URLs and passages that were
confusing.) You mentioned missing documentation. What needs to be
documented? Is there any incomplete documentation that you would like
to see completed?
Also, could you provide examples of documentation for an audio
application that you found helpful? (Any program/any platform, just
include a URL where the docs may be freely downloaded.) Did you find *any*
good Linux documentation at all? If so, could you include its URL also.
BTW: Did you report the problems you had with any documentation to
its respective author? The author may not know there is a problem until
someone reports it.
=== Kevin Conder
This archive was generated by hypermail 2b28 : Fri Jul 27 2001 - 02:57:44 EEST