[librsvg] Fix the documentation infrastructure a bit

[Federico Mena Quintero <federico src gnome org>]

commit 4262b205027ff5cc7a5a0b66d578dc9f9ed02215
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Dec 8 14:25:51 2017 -0600

    Fix the documentation infrastructure a bit

 doc/Makefile.am       |   39 ++++++++++++++++++++-------------------
 doc/rsvg-sections.txt |    2 --
 doc/rsvg.types        |    3 ---
 rsvg.h                |   15 ++++++++-------
 4 files changed, 28 insertions(+), 31 deletions(-)
---
diff --git a/doc/Makefile.am b/doc/Makefile.am
index a2d2ed4..1aca98b 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -68,25 +68,26 @@ EXTRA_HFILES =
 
 # Header files to ignore when scanning. Use base file name, no paths
 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES = \
-       config.h \
-       rsvg-bpath-util.h \
-       rsvg-cairo-clip.h \
-       rsvg-cairo-draw.h \
-       rsvg-cairo-render.h \
-       rsvg-css.h \
-       rsvg-defs.h \
-       rsvg-filter.h \
-       rsvg-image.h \
-       rsvg-marker.h \
-       rsvg-mask.h \
-       rsvg-paint-server.h \
-       rsvg-path.h \
-       rsvg-private.h \
-       rsvg-shapes.h \
-       rsvg-structure.h \
-       rsvg-styles.h \
-       rsvg-text.h \
+IGNORE_HFILES =                        \
+       config.h                \
+       rsvg-cairo-clip.h       \
+       rsvg-cairo-draw.h       \
+       rsvg-cairo-render.h     \
+       rsvg-compat.h           \
+       rsvg-css.h              \
+       rsvg-defs.h             \
+       rsvg-filter.h           \
+       rsvg-io.h               \
+       rsvg-marker.h           \
+       rsvg-mask.h             \
+       rsvg-paint-server.h     \
+       rsvg-path-builder.h     \
+       rsvg-private.h          \
+       rsvg-shapes.h           \
+       rsvg-size-callback.h    \
+       rsvg-structure.h        \
+       rsvg-styles.h           \
+       rsvg-text.h             \
        rsvg-xml.h
 
 # Images to copy into HTML directory.
diff --git a/doc/rsvg-sections.txt b/doc/rsvg-sections.txt
index 7614c56..7155018 100644
--- a/doc/rsvg-sections.txt
+++ b/doc/rsvg-sections.txt
@@ -94,6 +94,4 @@ LIBRSVG_HAVE_SVGZ
 LIBRSVG_HAVE_CSS
 LIBRSVG_CHECK_FEATURE
 librsvg_version
-librsvg_preinit
-librsvg_postinit
 </SECTION>
diff --git a/rsvg.h b/rsvg.h
index fdc6aa9..9461085 100644
--- a/rsvg.h
+++ b/rsvg.h
@@ -65,11 +65,6 @@ typedef enum {
 #define RSVG_ERROR (rsvg_error_quark ())
 GQuark rsvg_error_quark (void) G_GNUC_CONST;
 
-/**
- * RsvgHandle:
- *
- * The #RsvgHandle is an object representing the parsed form of a SVG
- */
 typedef struct _RsvgHandle RsvgHandle;
 typedef struct RsvgHandlePrivate RsvgHandlePrivate;
 typedef struct _RsvgHandleClass RsvgHandleClass;
@@ -80,7 +75,7 @@ typedef struct _RsvgPositionData RsvgPositionData;
  * RsvgHandleClass:
  * @parent: parent class
  *
- * Class structure for #RsvgHandle
+ * Class structure for #RsvgHandle.
  */
 struct _RsvgHandleClass {
     GObjectClass parent;
@@ -89,6 +84,12 @@ struct _RsvgHandleClass {
     gpointer _abi_padding[15];
 };
 
+/**
+ * RsvgHandle:
+ * @parent: parent instance
+ *
+ * Lets you load SVG data and render it.
+ */
 struct _RsvgHandle {
     GObject parent;
 
@@ -219,7 +220,7 @@ void rsvg_handle_free (RsvgHandle * handle);
  * Deprecated: Set up a cairo matrix and use rsvg_handle_render_cairo() instead.
  * See the documentation for rsvg_handle_set_size_callback() for an example.
  */
-typedef /* RSVG_DEPRECATED */ void (*RsvgSizeFunc) (gint * width, gint * height, gpointer user_data);
+/* RSVG_DEPRECATED */ typedef void (*RsvgSizeFunc) (gint * width, gint * height, gpointer user_data);
 
 RSVG_DEPRECATED
 void rsvg_handle_set_size_callback (RsvgHandle * handle,