docs: unhide docs for allocator
authorStefan Sauer <ensonic@users.sf.net>
Fri, 31 Jan 2014 07:35:41 +0000 (08:35 +0100)
committerStefan Sauer <ensonic@users.sf.net>
Fri, 31 Jan 2014 07:36:55 +0000 (08:36 +0100)
Unhinde the class docs. Tech gtk-doc about GST_EXPORTS.

docs/gst/Makefile.am
docs/gst/gstreamer-sections.txt
gst/gstallocator.h

index c0dedc6..640bf56 100644 (file)
@@ -24,7 +24,8 @@ DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
 DOC_SOURCE_DIR = $(top_srcdir)/gst
 
 # Extra options to supply to gtkdoc-scan.
-SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED"
+SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED" \
+  --ignore-decorators='GST_EXPORT'
 
 # Extra options to supply to gtkdoc-mkdb.
 MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files=parse
index f20029d..b198b63 100644 (file)
@@ -1375,6 +1375,7 @@ gst_iterator_result_get_type
 gst_memory_alignment
 
 GstAllocator
+GstAllocatorClass
 GstAllocatorFlags
 GstAllocationParams
 
@@ -1399,7 +1400,6 @@ GST_ALLOCATOR_CLASS
 GST_ALLOCATOR_GET_CLASS
 GST_IS_ALLOCATOR
 GST_IS_ALLOCATOR_CLASS
-GstAllocatorClass
 <SUBSECTION Private>
 GST_TYPE_ALLOCATOR_FLAGS
 GstAllocatorPrivate
index 2337855..99deee2 100644 (file)
@@ -92,8 +92,6 @@ typedef enum {
 
 /**
  * GstAllocator:
- * @object: parent structure
- * @mem_type: the memory type this allocator provides
  * @mem_map: the implementation of the GstMemoryMapFunction
  * @mem_unmap: the implementation of the GstMemoryUnmapFunction
  * @mem_copy: the implementation of the GstMemoryCopyFunction
@@ -108,6 +106,7 @@ struct _GstAllocator
 
   const gchar              *mem_type;
 
+  /*< public >*/
   GstMemoryMapFunction      mem_map;
   GstMemoryUnmapFunction    mem_unmap;
 
@@ -121,9 +120,18 @@ struct _GstAllocator
   GstAllocatorPrivate *priv;
 };
 
+/**
+ * GstAllocatorClass:
+ * @object_class:  Object parent class
+ * @alloc: implementation that acquires memory
+ * @free: implementation that releases memory
+ *
+ * The #GstAllocator is used to create new memory.
+ */
 struct _GstAllocatorClass {
   GstObjectClass object_class;
 
+  /*< public >*/
   GstMemory *  (*alloc)      (GstAllocator *allocator, gsize size,
                               GstAllocationParams *params);
   void         (*free)       (GstAllocator *allocator, GstMemory *memory);