[libgnome] Deprecate gnome-sound

[Christian Persch <chpe src gnome org>]

commit 4d1288eca1689bd3dbca00c8f67b4f46ad4ce9af
Author: Christian Persch <chpe gnome org>
Date:   Mon Nov 30 14:13:29 2009 +0100

    Deprecate gnome-sound
    
    Bug #603349.

 ChangeLog                           | 5769 -----------------------------------
 doc/reference/tmpl/gnome-sound.sgml |    5 +
 libgnome/gnome-sound.c              |   10 +
 libgnome/gnome-sound.h              |    4 +
 4 files changed, 19 insertions(+), 5769 deletions(-)
---
diff --git a/doc/reference/tmpl/gnome-sound.sgml b/doc/reference/tmpl/gnome-sound.sgml
index 4b11087..3a2891d 100644
--- a/doc/reference/tmpl/gnome-sound.sgml
+++ b/doc/reference/tmpl/gnome-sound.sgml
@@ -4,8 +4,13 @@ gnome-sound
 <!-- ##### SECTION Short_Description ##### -->
 Sound playing routines.
 
+ Deprecated: 2.30
+
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+This API has been deprecated. Use libcanberra or libcanberra-gtk instead.
+</para>
+<para>
 This module provides wrapper functions for playing sound samples. Currently it
 just wraps the esound daemon, but the API is flexible enough that other sound
 infrastructures can be included in the future.
diff --git a/libgnome/gnome-sound.c b/libgnome/gnome-sound.c
index 5bd436d..e44cb32 100644
--- a/libgnome/gnome-sound.c
+++ b/libgnome/gnome-sound.c
@@ -490,6 +490,8 @@ send_all (int fd, const char *buf, size_t buflen)
  *
  * Returns: The esound sample_id or %-1 if the sample was unable to be cached
  * for esound.
+ *
+ * @Deprecated: 2.30: Use ca_context_cache() or ca_context_cache_full() instead
  */
 int
 gnome_sound_sample_load(const char *sample_name, const char *filename)
@@ -564,6 +566,8 @@ gnome_sound_sample_load(const char *sample_name, const char *filename)
  *
  * Plays the audio stored in @filename, if possible. Fail quietly if playing is
  * not possible (due to missing sound support or for other reasons).
+ *
+ * @Deprecated: 2.30: Use ca_context_play(), ca_gtk_play_for_widget() or ca_gtk_play_for_event() instead
  */
 void
 gnome_sound_play (const char * filename)
@@ -602,6 +606,8 @@ gnome_sound_play (const char * filename)
  * @hostname: Hostname where esd daemon resides.
  *
  * Initialize the esd connection.
+ *
+ * @Deprecated: 2.30
  */
 void
 gnome_sound_init(const char *hostname)
@@ -617,6 +623,8 @@ gnome_sound_init(const char *hostname)
  * gnome_sound_shutdown:
  *
  * Shuts down the gnome sound support.
+ *
+ * @Deprecated: 2.30
  */
 void
 gnome_sound_shutdown(void)
@@ -638,6 +646,8 @@ gnome_sound_shutdown(void)
  *
  * Returns: the file descriptor of our esound connection or %-1
  * on error.
+ *
+ * @Deprecated: 2.30
  **/
 int
 gnome_sound_connection_get (void)
diff --git a/libgnome/gnome-sound.h b/libgnome/gnome-sound.h
index 0e910fc..c68c835 100644
--- a/libgnome/gnome-sound.h
+++ b/libgnome/gnome-sound.h
@@ -26,6 +26,8 @@
 #ifndef __GNOME_SOUND_H__
 #define __GNOME_SOUND_H__ 1
 
+#ifndef GNOME_DISABLE_DEPRECATED
+
 #include <glib.h>
 
 G_BEGIN_DECLS
@@ -47,4 +49,6 @@ void gnome_sound_play (const char * filename);
 
 G_END_DECLS
 
+#endif /* !GNOME_DISABLE_DEPRECATED */
+
 #endif /* __GNOME_SOUND_H__ */