docs: fixup audio-library docs

gst-libs/gst/audio/gstaudioclock.h

@@ -60,14 +60,13 @@ typedef GstClockTime (*GstAudioClockGetTimeFunc) (GstClock *clock, gpointer user
 
 /**
  * GstAudioClock:
- * @clock: parent #GstSystemClock
  *
  * Opaque #GstAudioClock.
  */
 struct _GstAudioClock {
   GstSystemClock clock;
 
-  /* --- protected --- */
+  /*< protected >*/
   GstAudioClockGetTimeFunc func;
   gpointer user_data;
 

gst-libs/gst/audio/gstaudiofilter.h

@@ -47,7 +47,6 @@ typedef struct _GstAudioFilterClass GstAudioFilterClass;
 
 /**
  * GstAudioFilter:
- * @basetransform: Element parent class
  *
  * Base class for audio filters with the same format for input and output.
  *

gst-libs/gst/audio/gstaudiosrc.h

@@ -40,7 +40,6 @@ typedef struct _GstAudioSrcClass GstAudioSrcClass;
 
 /**
  * GstAudioSrc:
- * @element: parent class
  *
  * Base class for simple audio sources.
  */

gst-libs/gst/audio/multichannel.h

@@ -42,6 +42,9 @@ G_BEGIN_DECLS
  * @GST_AUDIO_CHANNEL_POSITION_NONE: used for position-less channels, e.g.
  *     from a sound card that records 1024 channels; mutually exclusive with
  *     any other channel position
+ * @GST_AUDIO_CHANNEL_POSITION_INVALID: invalid position
+ *
+ * Audio channel positions.
  */
 typedef enum {
   GST_AUDIO_CHANNEL_POSITION_INVALID = -1,
@@ -74,6 +77,7 @@ typedef enum {
    * are defined or all positions are undefined, but can't mix'n'match  */
   GST_AUDIO_CHANNEL_POSITION_NONE,
 
+  /*< private >*/
   /* don't use - counter */
   GST_AUDIO_CHANNEL_POSITION_NUM
 } GstAudioChannelPosition;