2007-07-25 Jorn Baayen <jorn@openedhand.com>

	A doc/gupnp-sections.txt:
	* libgupnp/gupnp-error.c:
	* libgupnp/gupnp-service-introspection.h:
	* libgupnp/gupnp-service.h:
	* libgupnp/gupnp-types.c:

	Doc polish.



git-svn-id: https://svn.o-hand.com/repos/gupnp/trunk/gupnp@322 d8cb91d7-bff9-0310-92b9-80b65e4482b2

4 files changed, 9 insertions, 14 deletions

diff --git a/libgupnp/gupnp-error.c b/libgupnp/gupnp-error.c
index 282c346..743b06f 100644
--- a/libgupnp/gupnp-error.c
+++ b/libgupnp/gupnp-error.c
@@ -19,11 +19,6 @@
  * Boston, MA 02111-1307, USA.
  */
 
-/**
- * SECTION:gupnp-error
- * @short_description: Error information.
- */
-
 #include "gupnp-error.h"
 #include "gupnp-error-private.h"
 
diff --git a/libgupnp/gupnp-service-introspection.h b/libgupnp/gupnp-service-introspection.h
index d221cb7..26b2b6b 100644
--- a/libgupnp/gupnp-service-introspection.h
+++ b/libgupnp/gupnp-service-introspection.h
@@ -62,18 +62,18 @@ typedef struct {
         char                          *name;
         GUPnPServiceActionArgDirection direction;
         char                          *related_state_variable;
-        gboolean                       retval;
+        gboolean                       retval; /* Is this the return value? */
 } GUPnPServiceActionArgInfo;
 
 typedef struct {
         char  *name;
-        GList *arguments;
+        GList *arguments; /* list of #GUPnPServiceActionArgInfo */
 } GUPnPServiceActionInfo;
 
 typedef struct {
         char    *name;
-        gboolean send_events;
-        gboolean is_numeric;
+        gboolean send_events;     /* Capable of sourcing events?           */
+        gboolean is_numeric;      /* Is this a numeric type?               */
         GType    type;
         GValue   default_value;
         GValue   minimum;         /* only for numeric data types           */
diff --git a/libgupnp/gupnp-service.h b/libgupnp/gupnp-service.h
index 9821318..49d6450 100644
--- a/libgupnp/gupnp-service.h
+++ b/libgupnp/gupnp-service.h
@@ -52,6 +52,11 @@ gupnp_service_get_type (void) G_GNUC_CONST;
                  GUPNP_TYPE_SERVICE, \
                  GUPnPServiceClass))
 
+/**
+ * GUPnPServiceAction
+ *
+ * An opaque structure for holding in-progress action data.
+ **/
 typedef struct _GUPnPServiceAction GUPnPServiceAction;
 
 typedef struct _GUPnPServicePrivate GUPnPServicePrivate;
diff --git a/libgupnp/gupnp-types.c b/libgupnp/gupnp-types.c
index 581e0de..4d38879 100644
--- a/libgupnp/gupnp-types.c
+++ b/libgupnp/gupnp-types.c
@@ -20,11 +20,6 @@
  * Boston, MA 02111-1307, USA.
  */
 
-/**
- * SECTION:gupnp-types
- * @short_description: Special types.
- */
-
 #include <string.h>
 
 #include "gupnp-types.h"