[glib/wip/desrt/xclasse-docs: 3/7] Doc: gio: Fix all undocumented/unused/undeclared symbols

[Ryan Lortie <desrt src gnome org>]

commit 445d3bf10a5f4edaf7251c0b751f007f43a11438
Author: Xavier Claessens <xavier claessens collabora com>
Date:   Sat Nov 29 08:41:32 2014 -0500

    Doc: gio: Fix all undocumented/unused/undeclared symbols
    
    https://bugzilla.gnome.org/show_bug.cgi?id=740814

 gio/gaction.c                 |    1 +
 gio/gactiongroup.c            |    1 +
 gio/gactionmap.c              |    1 +
 gio/ginetaddressmask.h        |    2 +-
 gio/gnetworking.h.in          |    4 ++++
 gio/gproxyaddress.h           |    1 +
 gio/gremoteactiongroup.c      |    1 +
 gio/gresource.c               |    2 ++
 gio/gresource.h               |    1 +
 gio/gsettingsbackend.h        |    3 +++
 gio/gtlspassword.h            |    2 ++
 gio/gunixcredentialsmessage.h |    5 ++++-
 gio/gwin32inputstream.h       |    2 +-
 gio/gwin32outputstream.h      |    2 +-
 14 files changed, 24 insertions(+), 4 deletions(-)
---
diff --git a/gio/gaction.c b/gio/gaction.c
index a280256..c540a3b 100644
--- a/gio/gaction.c
+++ b/gio/gaction.c
@@ -71,6 +71,7 @@ G_DEFINE_INTERFACE (GAction, g_action, G_TYPE_OBJECT)
 
 /**
  * GActionInterface:
+ * @g_iface: The parent interface.
  * @get_name: the virtual function pointer for g_action_get_name()
  * @get_parameter_type: the virtual function pointer for g_action_get_parameter_type()
  * @get_state_type: the virtual function pointer for g_action_get_state_type()
diff --git a/gio/gactiongroup.c b/gio/gactiongroup.c
index fcedb95..0f7c5ca 100644
--- a/gio/gactiongroup.c
+++ b/gio/gactiongroup.c
@@ -85,6 +85,7 @@
 
 /**
  * GActionGroupInterface:
+ * @g_iface: The parent interface.
  * @has_action: the virtual function pointer for g_action_group_has_action()
  * @list_actions: the virtual function pointer for g_action_group_list_actions()
  * @get_action_parameter_type: the virtual function pointer for g_action_group_get_action_parameter_type()
diff --git a/gio/gactionmap.c b/gio/gactionmap.c
index 778ca25..4b7ed6b 100644
--- a/gio/gactionmap.c
+++ b/gio/gactionmap.c
@@ -51,6 +51,7 @@
 
 /**
  * GActionMapInterface:
+ * @g_iface: The parent interface.
  * @lookup_action: the virtual function pointer for g_action_map_lookup_action()
  * @add_action: the virtual function pointer for g_action_map_add_action()
  * @remove_action: the virtual function pointer for g_action_map_remove_action()
diff --git a/gio/ginetaddressmask.h b/gio/ginetaddressmask.h
index 03db50d..883cffa 100644
--- a/gio/ginetaddressmask.h
+++ b/gio/ginetaddressmask.h
@@ -39,9 +39,9 @@ typedef struct _GInetAddressMaskPrivate GInetAddressMaskPrivate;
 
 struct _GInetAddressMask
 {
+  /*< private >*/
   GObject parent_instance;
 
-  /*< private >*/
   GInetAddressMaskPrivate *priv;
 };
 
diff --git a/gio/gnetworking.h.in b/gio/gnetworking.h.in
index 0bb21c3..0747952 100644
--- a/gio/gnetworking.h.in
+++ b/gio/gnetworking.h.in
@@ -21,6 +21,8 @@
 
 #include <glib.h>
 
+#ifndef __GTK_DOC_IGNORE__
+
 #ifdef G_OS_WIN32
 
 #ifndef _WIN32_WINNT
@@ -72,6 +74,8 @@
 #endif
 #endif
 
+#endif /* __GTK_DOC_IGNORE__ */
+
 G_BEGIN_DECLS
 
 GLIB_AVAILABLE_IN_2_36
diff --git a/gio/gproxyaddress.h b/gio/gproxyaddress.h
index 11942de..298f285 100644
--- a/gio/gproxyaddress.h
+++ b/gio/gproxyaddress.h
@@ -49,6 +49,7 @@ struct _GProxyAddress
 
 struct _GProxyAddressClass
 {
+  /*< private >*/
   GInetSocketAddressClass parent_class;
 };
 
diff --git a/gio/gremoteactiongroup.c b/gio/gremoteactiongroup.c
index ad0655c..7ba838b 100644
--- a/gio/gremoteactiongroup.c
+++ b/gio/gremoteactiongroup.c
@@ -64,6 +64,7 @@
 
 /**
  * GRemoteActionGroupInterface:
+ * @g_iface: The parent interface.
  * @activate_action_full: the virtual function pointer for g_remote_action_group_activate_action_full()
  * @change_action_state_full: the virtual function pointer for 
g_remote_action_group_change_action_state_full()
  *
diff --git a/gio/gresource.c b/gio/gresource.c
index 0b05646..5734d2c 100644
--- a/gio/gresource.c
+++ b/gio/gresource.c
@@ -190,6 +190,8 @@ g_resource_unref (GResource *resource)
  * g_resource_new_from_table:
  * @table: (transfer full): a GvdbTable
  *
+ * < private >
+ *
  * Returns: (transfer full): a new #GResource for @table
  */
 static GResource *
diff --git a/gio/gresource.h b/gio/gresource.h
index 9c79db9..e592b06 100644
--- a/gio/gresource.h
+++ b/gio/gresource.h
@@ -51,6 +51,7 @@ GQuark g_resource_error_quark (void);
 typedef struct _GStaticResource GStaticResource;
 
 struct _GStaticResource {
+  /*<private>*/
   const guint8 *data;
   gsize data_len;
   GResource *resource;
diff --git a/gio/gsettingsbackend.h b/gio/gsettingsbackend.h
index 96ce141..b354eec 100644
--- a/gio/gsettingsbackend.h
+++ b/gio/gsettingsbackend.h
@@ -76,8 +76,10 @@ typedef struct _GSettingsBackendClass                       GSettingsBackendClas
  */
 struct _GSettingsBackendClass
 {
+  /*<private>*/
   GObjectClass parent_class;
 
+  /*<public>*/
   GVariant *    (*read)             (GSettingsBackend    *backend,
                                      const gchar         *key,
                                      const GVariantType  *expected_type,
@@ -110,6 +112,7 @@ struct _GSettingsBackendClass
                                      const gchar         *key,
                                      const GVariantType  *expected_type);
 
+  /*<private>*/
   gpointer padding[23];
 };
 
diff --git a/gio/gtlspassword.h b/gio/gtlspassword.h
index 1b57868..dc7e9ef 100644
--- a/gio/gtlspassword.h
+++ b/gio/gtlspassword.h
@@ -57,9 +57,11 @@ struct _GTlsPassword
  */
 struct _GTlsPasswordClass
 {
+  /*< private >*/
   GObjectClass parent_class;
 
   /* methods */
+  /*< public >*/
 
   const guchar *    ( *get_value)            (GTlsPassword  *password,
                                               gsize         *length);
diff --git a/gio/gunixcredentialsmessage.h b/gio/gunixcredentialsmessage.h
index f6cb4e8..1e63a70 100644
--- a/gio/gunixcredentialsmessage.h
+++ b/gio/gunixcredentialsmessage.h
@@ -47,11 +47,14 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GUnixCredentialsMessage, g_object_unref)
  */
 struct _GUnixCredentialsMessageClass
 {
+  /*< private >*/
   GSocketControlMessageClass parent_class;
 
-  /*< private >*/
+  /*< public >*/
+
 
   /* Padding for future expansion */
+  /*< private >*/
   void (*_g_reserved1) (void);
   void (*_g_reserved2) (void);
 };
diff --git a/gio/gwin32inputstream.h b/gio/gwin32inputstream.h
index 44f97b6..0e4b36c 100644
--- a/gio/gwin32inputstream.h
+++ b/gio/gwin32inputstream.h
@@ -46,9 +46,9 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GWin32InputStream, g_object_unref)
 
 struct _GWin32InputStream
 {
+  /*< private >*/
   GInputStream parent_instance;
 
-  /*< private >*/
   GWin32InputStreamPrivate *priv;
 };
 
diff --git a/gio/gwin32outputstream.h b/gio/gwin32outputstream.h
index c308965..074886e 100644
--- a/gio/gwin32outputstream.h
+++ b/gio/gwin32outputstream.h
@@ -46,9 +46,9 @@ G_DEFINE_AUTOPTR_CLEANUP_FUNC(GWin32OutputStream, g_object_unref)
 
 struct _GWin32OutputStream
 {
+  /*< private >*/
   GOutputStream parent_instance;
 
-  /*< private >*/
   GWin32OutputStreamPrivate *priv;
 };