From 18640abf91cf856bc3a458ed816cf5076da705bd Mon Sep 17 00:00:00 2001 From: Alexander Kanavin Date: Fri, 30 Aug 2013 18:43:24 +0300 Subject: [PATCH] docs: fix assorted warnings --- docs/reference/Makefile.am | 8 ++++++-- libgsignon-glib/signon-glib.h | 8 ++++++++ libgsignon-glib/signon-identity.h | 1 + 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am index 3ae2f89..e95e9e9 100644 --- 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 --- a/libgsignon-glib/signon-glib.h +++ b/libgsignon-glib/signon-glib.h @@ -32,4 +32,12 @@ #include #include +/** + * 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 --- 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. */ -- 2.34.1