tell gtk-doc about the deprecation guard. Apply more doc fixes.

Original commit message from CVS:
* docs/libs/Makefile.am:
* gst-libs/gst/audio/audio.c:
* gst-libs/gst/audio/audio.h:
* gst-libs/gst/interfaces/mixer.c:
tell gtk-doc about the deprecation guard. Apply more doc fixes.
This commit is contained in:
Stefan Kost 2007-10-31 12:47:41 +00:00
parent cfecc1f025
commit e37568c196
5 changed files with 17 additions and 7 deletions

View file

@ -1,3 +1,11 @@
2007-10-31 Stefan Kost <ensonic@users.sf.net>
* docs/libs/Makefile.am:
* gst-libs/gst/audio/audio.c:
* gst-libs/gst/audio/audio.h:
* gst-libs/gst/interfaces/mixer.c:
tell gtk-doc about the deprecation guard. Apply more doc fixes.
2007-10-31 Tim-Philipp Müller <tim at centricular dot net>
* tests/check/libs/audio.c: (init_value_to_channel_layout),

View file

@ -43,7 +43,7 @@ DOC_SOURCE_DIR=$(top_srcdir)/gst-libs/gst
DOC_BUILD_DIR=$(top_builddir)/gst-libs/gst
# Extra options to supply to gtkdoc-scan.
SCAN_OPTIONS=
SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED"
# FIXME :
# there's something wrong with gstreamer-sections.txt not being in the dist

View file

@ -224,8 +224,10 @@ _gst_audio_structure_set_list (GstStructure * structure,
* @flag: a set of #GstAudioFieldFlag
*
* Do not use anymore.
* @Deprecated: use gst_structure_set()
*
* Deprecated: use gst_structure_set()
*/
#ifndef GST_REMOVE_DEPRECATED
void
gst_audio_structure_set_int (GstStructure * structure, GstAudioFieldFlag flag)
{
@ -251,6 +253,7 @@ gst_audio_structure_set_int (GstStructure * structure, GstAudioFieldFlag flag)
_gst_audio_structure_set_list (structure, "signed", G_TYPE_BOOLEAN, 2, TRUE,
FALSE, NULL);
}
#endif /* GST_REMOVE_DEPRECATED */
/**
* gst_audio_buffer_clip:

View file

@ -132,8 +132,10 @@ gboolean gst_audio_is_buffer_framed (GstPad* pad, GstBuffer* buf);
* GstAudioFieldFlag:
*
* Do not use anymore.
* @Deprecated: use gst_structure_set() directly
*
* Deprecated: use gst_structure_set() directly
*/
#ifndef GST_DISABLE_DEPRECATED
typedef enum {
GST_AUDIO_FIELD_RATE = (1 << 0),
GST_AUDIO_FIELD_CHANNELS = (1 << 1),
@ -142,6 +144,7 @@ typedef enum {
GST_AUDIO_FIELD_DEPTH = (1 << 4),
GST_AUDIO_FIELD_SIGNED = (1 << 5),
} GstAudioFieldFlag;
#endif /* GST_DISABLE_DEPRECATED */
#ifndef GST_DISABLE_DEPRECATED
void gst_audio_structure_set_int (GstStructure *structure, GstAudioFieldFlag flag);

View file

@ -345,7 +345,6 @@ gst_mixer_get_mixer_flags (GstMixer * mixer)
/**
* gst_mixer_mute_toggled:
*
* @mixer: the #GstMixer (a #GstElement) that owns the track
* @track: the GstMixerTrack that has change mute state.
* @mute: the new state of the mute flag on the track
@ -379,7 +378,6 @@ gst_mixer_mute_toggled (GstMixer * mixer, GstMixerTrack * track, gboolean mute)
/**
* gst_mixer_record_toggled:
*
* @mixer: the #GstMixer (a #GstElement) that owns the track
* @track: the GstMixerTrack that has changed recording state.
* @record: the new state of the record flag on the track
@ -415,7 +413,6 @@ gst_mixer_record_toggled (GstMixer * mixer,
/**
* gst_mixer_volume_changed:
*
* @mixer: the #GstMixer (a #GstElement) that owns the track
* @track: the GstMixerTrack that has changed.
* @volumes: Array of volume values, one per channel on the mixer track.
@ -467,7 +464,6 @@ gst_mixer_volume_changed (GstMixer * mixer,
/**
* gst_mixer_option_changed:
*
* @mixer: the #GstMixer (a #GstElement) that owns the options
* @opts: the GstMixerOptions that has changed value.
* @value: the new value of the GstMixerOptions.