From eae317c6cd39f46508bd0e4855c822660a329246 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 28 Aug 2008 17:59:34 +0200 Subject: update README for 0.8 --- doc/README.html.in | 39 ++++++++++++++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 5 deletions(-) (limited to 'doc/README.html.in') diff --git a/doc/README.html.in b/doc/README.html.in index 674cabc..a49840e 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -38,6 +38,11 @@ Lesser General Public License for more details.

News

+
Thu 28 Aug +2008:

Version +0.8 released; changes include: new OSS and GStreamer backend; +portability fixes for FreeBSD/Solaris; the multi backend works now

+
Thu 14 Aug 2008:

Version 0.7 released; changes include: documentation updates; various bug @@ -49,9 +54,12 @@ only a sound file path specified; other changes

libcanberra is an implementation of the XDG Sound Theme and Name Specifications, for generating event sounds -on free desktops, such as GNOME. It comes with several backends (ALSA, PulseAudio, -null) and is designed to be portable. It consists of the following -parts:

+on free desktops, such +as GNOME. It comes with several +backends +(ALSA, PulseAudio, +OSS, GStreamer, null) and is +designed to be portable. It consists of the following parts:

  1. libcanberra: the main library
    2. @@ -64,12 +72,31 @@ parts:

    Current Status

    libcanberra is mostly feature complete. For now however it -includes backends only for ALSA and PulseAudio.

    +includes backends only for ALSA, PulseAudio, OSS and GStreamer.

    libcanberra has been declared a blessed GNOME dependency.

    +

    The OSS driver is incomplete: only sound files that are in a format +natively understood by the sound card are supported. If the sample +type, channel map or sampling rate of the sound file are not supported +by the sound card no automatic conversion will take place and the file +will not be played. Also note that the OSS backend is most likely +incompatible with OSS4, due to subtle incompatibilities between OSS4 +and the OSS 3.x.

    + +

    It is recommended to always take the "shortest" path from +libcanberra to the audio device. I.e. don't use the GStreamer plugin +if libcanberra supports the final output target natively. Besides +being more resource-friendly and less error-prone, some advanced +functionality might get lost with each layer you add to your +stack. For example: while you could use libcanberra's Gstreamer +backend to output to a PulseAudio server this will not be able to make +use of sample cacheing or will be able to attach additional meta data +to the sounds played, which might be necessary for effects like +positional event sounds.

    +

    Documentation

    You may browse the gtkdoc @@ -100,7 +127,9 @@ compilation and make install (as root) for installation of

    Acknowledgements

    -

    None so far.

    +

    Marc-André Lureau for the GStreamer backend.

    + +

    Joe Marcus Clarke for the OSS backend.

    Download

    -- cgit