Diff: README - README

	README	README

	libcanberra 0.29	libcanberra 0.30

	Copyright 2008-2012 Lennart Poettering <mzyvopnaoreen (at) 0pointer	Copyright 2008-2012 Lennart Poettering <mzyvopnaoreen (at) 0pointer
	(dot) de>	(dot) de>
	* [1]License	* [1]License
	* [2]News	* [2]News
	* [3]Overview	* [3]Overview
	* [4]Current Status	* [4]Current Status
	* [5]Documentation	* [5]Documentation
	* [6]Requirements	* [6]Requirements
	* [7]Installation	* [7]Installation

	skipping to change at line 29	skipping to change at line 29
	by the Free Software Foundation, either version 2.1 of the License, or	by the Free Software Foundation, either version 2.1 of the License, or
	(at your option) any later version.	(at your option) any later version.

	This program is distributed in the hope that it will be useful, but	This program is distributed in the hope that it will be useful, but
	WITHOUT ANY WARRANTY; without even the implied warranty of	WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
	General Public License for more details.	General Public License for more details.

	News	News


		Tue 25 Sep 2012:

		[10]Version 0.30 released; Port to GStreamer 1.0.

	Tue 15 May 2012:	Tue 15 May 2012:


	[10]Version 0.29 released; A couple of bugfixes, drop GConf usage.	[11]Version 0.29 released; A couple of bugfixes, drop GConf usage.

	Thu 24 Feb 2011:	Thu 24 Feb 2011:


	[11]Version 0.28 released; Hook properly into GNOME 3.0 sessions; this	[12]Version 0.28 released; Hook properly into GNOME 3.0 sessions; this
	drops support for GNOME 2.0 sessions, but not applications.	drops support for GNOME 2.0 sessions, but not applications.

	Fri 18 Feb 2011:	Fri 18 Feb 2011:


	[12]Version 0.27 released; Gtk+ 3.x fixes; add new tool to implement	[13]Version 0.27 released; Gtk+ 3.x fixes; add new tool to implement
	boot-up sounds when used with systemd; other fixes	boot-up sounds when used with systemd; other fixes

	Mon 4 Oct 2010:	Mon 4 Oct 2010:


	[13]Version 0.26 released; Gtk+ 3.x fixes.	[14]Version 0.26 released; Gtk+ 3.x fixes.

	Sun 13 Jun 2010:	Sun 13 Jun 2010:


	[14]Version 0.25 released; Optionally build with Gtk+ 3.x in addition	[15]Version 0.25 released; Optionally build with Gtk+ 3.x in addition
	to Gtk+ 2.x.	to Gtk+ 2.x.

	Mon 19 Apr 2010:	Mon 19 Apr 2010:


	[15]Version 0.24 released; GTK code is now fine with GSEAL. Minor fixes	[16]Version 0.24 released; GTK code is now fine with GSEAL. Minor fixes
	in the PulseAudio backend, other fixes.	in the PulseAudio backend, other fixes.

	Sat 20 Feb 2010:	Sat 20 Feb 2010:


	[16]Version 0.23 released; various minor fixes in the pulse and	[17]Version 0.23 released; various minor fixes in the pulse and
	gstreamer backends as well in the Vala API. Support for the recently	gstreamer backends as well in the Vala API. Support for the recently
	standardized Vorbis 6.1/7.1 multichannel modes.	standardized Vorbis 6.1/7.1 multichannel modes.

	Tue 20 Oct 2009:	Tue 20 Oct 2009:


	[17]Version 0.22 released; small fix to make sure we don't dereference	[18]Version 0.22 released; small fix to make sure we don't dereference
	a null pointer.	a null pointer.

	Fri 16 Oct 2009:	Fri 16 Oct 2009:


	[18]Version 0.21 released; suppress casting warning	[19]Version 0.21 released; suppress casting warning

	Thu 15 Oct 2009:	Thu 15 Oct 2009:


	[19]Version 0.20 released; minor casting fix	[20]Version 0.20 released; minor casting fix

	Wed 14 Oct 2009:	Wed 14 Oct 2009:


	[20]Version 0.19 released; some important fixes for the Gtk support	[21]Version 0.19 released; some important fixes for the Gtk support

	Sun 20 Sep 2009:	Sun 20 Sep 2009:


	[21]Version 0.18 released; numerous updates for the Gtk support	[22]Version 0.18 released; numerous updates for the Gtk support

	Fri 12 Sep 2009:	Fri 12 Sep 2009:


	[22]Version 0.17 released; add vala vapi file; numerous updates to Gtk	[23]Version 0.17 released; add vala vapi file; numerous updates to Gtk
	support	support

	Thu 27 Aug 2009:	Thu 27 Aug 2009:


	[23]Version 0.16 released; add new ca_context_playing() call	[24]Version 0.16 released; add new ca_context_playing() call

	Wed 5 Aug 2009:	Wed 5 Aug 2009:


	[24]Version 0.15 released; bug fixes	[25]Version 0.15 released; bug fixes

	Thu 2 Jul 2009:	Thu 2 Jul 2009:


	[25]Version 0.14 released; bug fixes	[26]Version 0.14 released; bug fixes

	Tue 23 Jun 2009:	Tue 23 Jun 2009:


	[26]Version 0.13 released; multichannel support; gtk multihead support;	[27]Version 0.13 released; multichannel support; gtk multihead support;
	bug fixes	bug fixes

	Mon 13 Apr 2009:	Mon 13 Apr 2009:


	[27]Version 0.12 released; changes include: various fixes and updates	[28]Version 0.12 released; changes include: various fixes and updates
	for the PulseAudio backend; detect forks and return an error for all	for the PulseAudio backend; detect forks and return an error for all
	functions in that case	functions in that case

	Wed 21 Jan 2009:	Wed 21 Jan 2009:


	[28]Version 0.11 released; changes include: major GStreamer backend	[29]Version 0.11 released; changes include: major GStreamer backend
	fixes; update to libtool 2.2; a few other fixes	fixes; update to libtool 2.2; a few other fixes

	Mon 6 Oct 2008:	Mon 6 Oct 2008:


	[29]Version 0.10 released; changes include: install Gtk+ module using	[30]Version 0.10 released; changes include: install Gtk+ module using
	GConf; a few other fixes	GConf; a few other fixes

	Tue 9 Sep 2008:	Tue 9 Sep 2008:


	[30]Version 0.9 released; changes include: GStreamer fixes, include	[31]Version 0.9 released; changes include: GStreamer fixes, include
	(optional) libtdb based lookup cache.	(optional) libtdb based lookup cache.

	Thu 28 Aug 2008:	Thu 28 Aug 2008:


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

	Thu 14 Aug 2008:	Thu 14 Aug 2008:


	[32]Version 0.7 released; changes include: documentation updates;	[33]Version 0.7 released; changes include: documentation updates;
	various bug fixes; add this web site/README; allow playback of event	various bug fixes; add this web site/README; allow playback of event
	sounds with only a sound file path specified; other changes	sounds with only a sound file path specified; other changes

	Overview	Overview


	libcanberra is an implementation of the [33]XDG Sound Theme and Name	libcanberra is an implementation of the [34]XDG Sound Theme and Name
	Specifications, for generating event sounds on free desktops, such as	Specifications, for generating event sounds on free desktops, such as

	[34]GNOME. It comes with several backends ([35]ALSA, [36]PulseAudio,	[35]GNOME. It comes with several backends ([36]ALSA, [37]PulseAudio,
	OSS, [37]GStreamer, null) and is designed to be portable. It consists	OSS, [38]GStreamer, null) and is designed to be portable. It consists
	of the following parts:	of the following parts:
	1. libcanberra: the main library	1. libcanberra: the main library
	2. libcanberra-gtk: some glue code to make it easier to use	2. libcanberra-gtk: some glue code to make it easier to use
	libcanberra from Gtk+ applications	libcanberra from Gtk+ applications
	3. libcanberra-gtk-module: a Gtk+ module that uses libcanberra-gtk to	3. libcanberra-gtk-module: a Gtk+ module that uses libcanberra-gtk to
	trigger input feedback event sounds	trigger input feedback event sounds


	For more information see [38]the original announcement.	For more information see [39]the original announcement.

	Current Status	Current Status

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


	libcanberra has been declared [39]a blessed GNOME dependency.	libcanberra has been declared [40]a blessed GNOME dependency.

	The OSS driver is incomplete: only sound files that are in a format	The OSS driver is incomplete: only sound files that are in a format
	natively understood by the sound card are supported. If the sample	natively understood by the sound card are supported. If the sample
	type, channel map or sampling rate of the sound file are not supported	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	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	will not be played. Also note that the OSS backend is most likely
	incompatible with OSS4, due to subtle incompatibilities between OSS4	incompatible with OSS4, due to subtle incompatibilities between OSS4
	and the OSS 3.x.	and the OSS 3.x.

	It is recommended to always take the "shortest" path from libcanberra	It is recommended to always take the "shortest" path from libcanberra

	skipping to change at line 181	skipping to change at line 185
	supports the final output target natively. Besides being more	supports the final output target natively. Besides being more
	resource-friendly and less error-prone, some advanced functionality	resource-friendly and less error-prone, some advanced functionality
	might get lost with each layer you add to your stack. For example:	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	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	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,	or will be able to attach additional meta data to the sounds played,
	which might be necessary for effects like positional event sounds.	which might be necessary for effects like positional event sounds.

	Documentation	Documentation


	You may browse the [40]gtkdoc generated [41]programing documentation of	You may browse the [41]gtkdoc generated [42]programing documentation of
	the API.	the API.

	Requirements	Requirements

	Currently, libcanberra is tested on Linux only.	Currently, libcanberra is tested on Linux only.

	libcanberra was developed and tested on Fedora Rawhide from August	libcanberra was developed and tested on Fedora Rawhide from August
	2008, it should work on most other Linux distributions (and maybe Unix	2008, it should work on most other Linux distributions (and maybe Unix
	versions) since it uses GNU autoconf and GNU libtool for source code	versions) since it uses GNU autoconf and GNU libtool for source code
	configuration and shared library management.	configuration and shared library management.

	skipping to change at line 216	skipping to change at line 220

	Marc-André Lureau and Brian Cameron for the GStreamer backend.	Marc-André Lureau and Brian Cameron for the GStreamer backend.

	Joe Marcus Clarke for the OSS backend.	Joe Marcus Clarke for the OSS backend.

	Diego Elio Pettenò for various build system fixes.	Diego Elio Pettenò for various build system fixes.

	Download	Download

	The newest release is always available from	The newest release is always available from

	[42]http://0pointer.de/lennart/projects/libcanberra/	[43]http://0pointer.de/lennart/projects/libcanberra/


	The current release is [43]0.29	The current release is [44]0.30


	Get libcanberra's development sources from the [44]GIT [45]repository	Get libcanberra's development sources from the [45]GIT [46]repository
	([46]gitweb):	([47]gitweb):
	git clone git://git.0pointer.de/libcanberra	git clone git://git.0pointer.de/libcanberra

	If you want to report bugs, have questions or want to be notified about	If you want to report bugs, have questions or want to be notified about

	new releases, please join the [47]libcanberra-discuss mailing list.	new releases, please join the [48]libcanberra-discuss mailing list.

	If you want to be notified about new git commits, please join the	If you want to be notified about new git commits, please join the

	[48]libcanberra-commits mailing list.	[49]libcanberra-commits mailing list.


	libcanberra's bugs are tracked at [49]bugs.freedesktop.org.	libcanberra's bugs are tracked at [50]bugs.freedesktop.org.
	__________________________________________________________________	__________________________________________________________________


	Lennart Poettering <mzyvopnaoreen (at) 0pointer (dot) de>, May 2012	Lennart Poettering <mzyvopnaoreen (at) 0pointer (dot) de>, September
		2012

	References	References

	1. README#license	1. README#license
	2. README#news	2. README#news
	3. README#overview	3. README#overview
	4. README#status	4. README#status
	5. README#documentation	5. README#documentation
	6. README#requirements	6. README#requirements
	7. README#installation	7. README#installation
	8. README#acks	8. README#acks
	9. README#download	9. README#download

	10. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.29.tar.	10. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.
	xz	xz
	11. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.28.tar.	11. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.29.tar.
	gz	xz
	12. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.27.tar.	12. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.28.tar.
	gz	gz
	13. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.26.tar.	13. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.27.tar.
	gz	gz
	14. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.25.tar.	14. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.26.tar.
	gz	gz
	15. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.24.tar.	15. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.25.tar.
	gz	gz
	16. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.23.tar.	16. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.24.tar.
	gz	gz
	17. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.22.tar.	17. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.23.tar.
	gz	gz
	18. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.21.tar.	18. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.22.tar.
	gz	gz
	19. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.20.tar.	19. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.21.tar.
	gz	gz
	20. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.19.tar.	20. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.20.tar.
	gz	gz
	21. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.18.tar.	21. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.19.tar.
	gz	gz
	22. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.17.tar.	22. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.18.tar.
	gz	gz
	23. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.16.tar.	23. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.17.tar.
	gz	gz
	24. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.15.tar.	24. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.16.tar.
	gz	gz
	25. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.14.tar.	25. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.15.tar.
	gz	gz
	26. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.13.tar.	26. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.14.tar.
	gz	gz
	27. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.12.tar.	27. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.13.tar.
	gz	gz
	28. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.11.tar.	28. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.12.tar.
	gz	gz
	29. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.10.tar.	29. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.11.tar.
	gz	gz
	30. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.9.tar.g	30. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.10.tar.
	z	gz
	31. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.8.tar.g	31. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.9.tar.g
	z	z
	32. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.7.tar.g	32. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.8.tar.g
	z	z
	33. http://freedesktop.org/wiki/Specifications/sound-theme-spec	33. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.7.tar.g
	34. http://www.gnome.org/	z
	35. http://alsa-project.org/	34. http://freedesktop.org/wiki/Specifications/sound-theme-spec
	36. http://pulseaudio.org/	35. http://www.gnome.org/
	37. http://gstreamer.org/	36. http://alsa-project.org/
	38. http://0pointer.de/blog/projects/sixfold-announcement.html	37. http://pulseaudio.org/
	39. http://mail.gnome.org/archives/devel-announce-list/2008-August/msg000	38. http://gstreamer.org/
	01.html	39. http://0pointer.de/blog/projects/sixfold-announcement.html
	40. http://www.gtk.org/gtk-doc/	40. http://mail.gnome.org/archives/devel-announce-list/2008-August/msg000
	41. http://0pointer.de/lennart/projects/libcanberra/gtkdoc/	01.html
	42. http://0pointer.de/lennart/projects/libcanberra/	41. http://www.gtk.org/gtk-doc/
	43. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.29.tar.	42. http://0pointer.de/lennart/projects/libcanberra/gtkdoc/
	xz	43. http://0pointer.de/lennart/projects/libcanberra/
	44. http://git-scm.com/	44. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.
	45. git://git.0pointer.de/libcanberra	xz
	46. http://git.0pointer.de/?p=libcanberra.git	45. http://git-scm.com/
	47. https://tango.0pointer.de/mailman/listinfo/libcanberra-discuss/	46. git://git.0pointer.de/libcanberra
	48. https://tango.0pointer.de/mailman/listinfo/libcanberra-commits/	47. http://git.0pointer.de/?p=libcanberra.git
	49. http://bugs.freedesktop.org/buglist.cgi?bug_status=__open__&product=l	48. https://tango.0pointer.de/mailman/listinfo/libcanberra-discuss/
	ibcanberra	49. https://tango.0pointer.de/mailman/listinfo/libcanberra-commits/
		50. http://bugs.freedesktop.org/buglist.cgi?bug_status=__open__&product=l
		ibcanberra

End of changes. 38 change blocks.
	38 lines changed or deleted	43 lines changed or added
This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/