55 lines
2.2 KiB
Plaintext
55 lines
2.2 KiB
Plaintext
/*! \page Index Preamble and License
|
|
|
|
\author Jaroslav Kysela <perex@perex.cz>
|
|
\author Abramo Bagnara <abramo@alsa-project.org>
|
|
\author Takashi Iwai <tiwai@suse.de>
|
|
\author Frank van de Pol <fvdpol@coil.demon.nl>
|
|
|
|
<H2>Preface</H2>
|
|
<P>The Advanced Linux Sound Architecture (\e ALSA) comes with a kernel
|
|
API and a library API. This document describes the library API and how
|
|
it interfaces with the kernel API.</P>
|
|
|
|
<H2>Documentation License</H2>
|
|
|
|
<P>This documentation is free; you can redistribute it without
|
|
any restrictions. Modifications or derived work must retain
|
|
the copyright and list all authors.</P>
|
|
|
|
<P>This documentation is distributed in the hope that it will be
|
|
useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>
|
|
|
|
<H2>API usage</H2>
|
|
<P>Application programmers should use the library API rather than the
|
|
kernel API. The library offers 100% of the functionality of the kernel API,
|
|
but adds major improvements in usability, making the application code simpler
|
|
and better looking. In addition, future fixes or compatibility code
|
|
may be placed in the library code instead of the kernel driver.</P>
|
|
|
|
<H2>API links</H2>
|
|
|
|
<UL>
|
|
<LI>Page \ref control explains the primitive controls API.
|
|
<LI>Page \ref hcontrol explains the high-level primitive controls API.
|
|
<LI>Page \ref mixer explains the mixer controls API.
|
|
<LI>Page \ref pcm explains the design of the PCM (digital audio) API.
|
|
<LI>Page \ref pcm_plugins explains the design of PCM (digital audio) plugins.
|
|
<LI>Page \ref pcm_external_plugins explains the external PCM plugin SDK.
|
|
<LI>Page \ref ctl_external_plugins explains the external control plugin SDK.
|
|
<LI>Page \ref rawmidi explains the design of the RawMidi API.
|
|
<LI>Page \ref timer explains the design of the Timer API.
|
|
<LI>Page \ref seq explains the design of the Sequencer API.
|
|
</UL>
|
|
|
|
<H2>Configuration</H2>
|
|
|
|
<UL>
|
|
<LI>Page \ref conf explains the syntax of library configuration files.
|
|
<LI>Page \ref confarg explains the run-time argument syntax.
|
|
<LI>Page \ref conffunc explains run-time function definitions and their usage.
|
|
<LI>Page \ref confhooks explains run-time hook definitions and their usage.
|
|
</UL>
|
|
|
|
*/
|