Add signond D-Bus API documentation
authorDavid King <david.king@canonical.com>
Thu, 18 Oct 2012 11:03:08 +0000 (12:03 +0100)
committerDavid King <david.king@canonical.com>
Thu, 18 Oct 2012 11:05:05 +0000 (12:05 +0100)
.gitignore
docs/reference/libsignon-glib-docs.xml
libsignon-glib/Makefile.am

index 95a98ed..53043fe 100644 (file)
@@ -19,6 +19,7 @@ gtk-doc.make
 /libsignon-glib/signon-marshal.c
 /libsignon-glib/signon-marshal.h
 /libsignon-glib/sso-*-gen.*
+/libsignon-glib/sso-*-gen-doc-*
 libtool
 m4/gtk-doc.m4
 m4/libtool.m4
index 4521f38..800c396 100644 (file)
     </chapter>
   </part>
 
+  <part id="signond-dbus-api">
+    <title>signond D-Bus API</title>
+      <xi:include href="../../libsignon-glib/sso-auth-service-gen-doc-com.google.code.AccountsSSO.SingleSignOn.AuthService.xml"/>
+      <xi:include href="../../libsignon-glib/sso-auth-session-gen-doc-com.google.code.AccountsSSO.SingleSignOn.AuthSession.xml"/>
+      <xi:include href="../../libsignon-glib/sso-identity-gen-doc-com.google.code.AccountsSSO.SingleSignOn.Identity.xml"/>
+  </part>
+
   <part id="appendices">
     <title>Appendices</title>
     <index id="api-index-full">
index 216bda0..17b0529 100644 (file)
@@ -73,16 +73,25 @@ libsignon_glib_headers_with_enums = \
 DBUS_INTERFACES_DIR = /usr/share/dbus-1/interfaces
 
 sso-auth-service-gen.h sso-auth-service-gen.c: $(DBUS_INTERFACES_DIR)/com.google.code.AccountsSSO.SingleSignOn.AuthService.xml
-       $(AM_V_GEN)gdbus-codegen --generate-c-code sso-auth-service-gen \
-               --annotate "com.google.code.AccountsSSO.SingleSignOn.AuthService" org.gtk.GDBus.C.Name SsoAuthService $<
+       $(AM_V_GEN)gdbus-codegen \
+               --generate-c-code sso-auth-service-gen \
+               --generate-docbook sso-auth-service-gen-doc \
+               --annotate "com.google.code.AccountsSSO.SingleSignOn.AuthService" org.gtk.GDBus.C.Name SsoAuthService \
+               $<
 
 sso-auth-session-gen.h sso-auth-session-gen.c: $(DBUS_INTERFACES_DIR)/com.google.code.AccountsSSO.SingleSignOn.AuthSession.xml
-       $(AM_V_GEN)gdbus-codegen --generate-c-code sso-auth-session-gen \
-               --annotate "com.google.code.AccountsSSO.SingleSignOn.AuthSession" org.gtk.GDBus.C.Name SsoAuthSession $<
+       $(AM_V_GEN)gdbus-codegen \
+               --generate-c-code sso-auth-session-gen \
+               --generate-docbook sso-auth-session-gen-doc \
+               --annotate "com.google.code.AccountsSSO.SingleSignOn.AuthSession" org.gtk.GDBus.C.Name SsoAuthSession \
+               $<
 
 sso-identity-gen.h sso-identity-gen.c: $(DBUS_INTERFACES_DIR)/com.google.code.AccountsSSO.SingleSignOn.Identity.xml
-       $(AM_V_GEN)gdbus-codegen --generate-c-code sso-identity-gen \
-               --annotate "com.google.code.AccountsSSO.SingleSignOn.Identity" org.gtk.GDBus.C.Name SsoIdentity $<
+       $(AM_V_GEN)gdbus-codegen \
+               --generate-c-code sso-identity-gen \
+               --generate-docbook sso-identity-gen-doc \
+               --annotate "com.google.code.AccountsSSO.SingleSignOn.Identity" org.gtk.GDBus.C.Name SsoIdentity \
+               $<
 
 signon-marshal.h: signon-marshal.list Makefile
        $(AM_V_GEN)glib-genmarshal --header --prefix=_signon_marshal $< > $@