docs: fix assorted warnings

diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am
index 3ae2f89..e95e9e9 100644 (file)
--- a/docs/reference/Makefile.am
+++ b/docs/reference/Makefile.am
@@ -29,7 +29,8 @@ SCAN_OPTIONS=--rebuild-types --deprecated-guards="SIGNON_DISABLE_DEPRECATED"
 
 # Extra options to supply to gtkdoc-mkdb.
 # e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
-MKDB_OPTIONS=--source-dir=$(top_srcdir)/libgsignon-glib --sgml-mode --output-format=xml --name-space=signon
+MKDB_OPTIONS=--source-dir=$(top_srcdir)/libgsignon-glib --sgml-mode --output-format=xml --name-space=signon \
+--ignore-files="sso-auth-service-gen.c sso-auth-session-gen.c sso-identity-gen.c"
 
 # Extra options to supply to gtkdoc-fixref. Not normally needed.
 # e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
@@ -48,14 +49,17 @@ IGNORE_HFILES= \
        signon-client-glib-gen.h \
        signon-identity-glib-gen.h \
        signon-dbus-queue.h \
+       signon-enum-types.h \
        signon-internals.h \
        signon-proxy.h \
+       signon-types.h \
        signon-utils.h \
        signon-marshal.h \
        sso-auth-service-gen.h \
        sso-auth-service.h \
        sso-auth-session-gen.h \
-       sso-identity-gen.h
+       sso-identity-gen.h \
+       stamp-signon-enum-types.h
 
 # Images to copy into HTML directory.
 # e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png

diff --git a/libgsignon-glib/signon-glib.h b/libgsignon-glib/signon-glib.h
index 971cdfa..f44acc0 100644 (file)
--- a/libgsignon-glib/signon-glib.h
+++ b/libgsignon-glib/signon-glib.h
@@ -32,4 +32,12 @@
 #include <libgsignon-glib/signon-identity-info.h>
 #include <libgsignon-glib/signon-identity.h>
 
+/**
+ * SECTION:signon-glib
+ * @title: libgsignon-glib headers
+ * @short_description: what headers to include
+ *
+ * Include signon-glib.h header to get all necessary library declarations.
+ */ 
+
 #endif /* SIGNON_GLIB_H */

diff --git a/libgsignon-glib/signon-identity.h b/libgsignon-glib/signon-identity.h
index 18c0d4b..98d0977 100644 (file)
--- a/libgsignon-glib/signon-identity.h
+++ b/libgsignon-glib/signon-identity.h
@@ -46,6 +46,7 @@ typedef struct _SignonIdentity SignonIdentity;
 
 /**
  * SignonIdentityClass:
+ * @parent_class: reference to a parent class
  *
  * Opaque struct. Use the accessor functions below.
  */