GNOME.org
 

[gnome-color-manager] trivial: remove some worthless gtk-doc markup

commit 4621a12a986df1bbb94e78b830c46d90a01590dc
Author: Richard Hughes <richard hughsie com>
Date:   Thu May 26 10:02:52 2011 +0100

    trivial: remove some worthless gtk-doc markup

 src/gcm-brightness.c |   33 +--------
 src/gcm-dmi.c        |   48 +-----------
 src/gcm-edid.c       |  214 +-------------------------------------------------
 src/gcm-tables.c     |   88 +--------------------
 4 files changed, 7 insertions(+), 376 deletions(-)
---
diff --git a/src/gcm-brightness.c b/src/gcm-brightness.c
index a6e4ff5..d4d10bd 100644
--- a/src/gcm-brightness.c
+++ b/src/gcm-brightness.c
@@ -1,6 +1,6 @@
 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
  *
- * Copyright (C) 2009-2010 Richard Hughes <richard hughsie com>
+ * Copyright (C) 2009-2011 Richard Hughes <richard hughsie com>
  *
  * Licensed under the GNU General Public License Version 2
  *
@@ -30,11 +30,6 @@ static void     gcm_brightness_finalize	(GObject     *object);
 
 #define GCM_BRIGHTNESS_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), GCM_TYPE_BRIGHTNESS, GcmBrightnessPrivate))
 
-/**
- * GcmBrightnessPrivate:
- *
- * Private #GcmBrightness data
- **/
 struct _GcmBrightnessPrivate
 {
 	guint				 percentage;
@@ -53,9 +48,6 @@ G_DEFINE_TYPE (GcmBrightness, gcm_brightness, G_TYPE_OBJECT)
 #define	GPM_DBUS_INTERFACE_BACKLIGHT	"org.gnome.PowerManager.Backlight"
 #define	GPM_DBUS_PATH_BACKLIGHT		"/org/gnome/PowerManager/Backlight"
 
-/**
- * gcm_brightness_set_percentage:
- **/
 gboolean
 gcm_brightness_set_percentage (GcmBrightness *brightness, guint percentage, GError **error)
 {
@@ -98,9 +90,6 @@ out:
 	return ret;
 }
 
-/**
- * gcm_brightness_get_percentage:
- **/
 gboolean
 gcm_brightness_get_percentage (GcmBrightness *brightness, guint *percentage, GError **error)
 {
@@ -145,9 +134,6 @@ out:
 	return ret;
 }
 
-/**
- * gcm_brightness_get_property:
- **/
 static void
 gcm_brightness_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
 {
@@ -164,9 +150,6 @@ gcm_brightness_get_property (GObject *object, guint prop_id, GValue *value, GPar
 	}
 }
 
-/**
- * gcm_brightness_set_property:
- **/
 static void
 gcm_brightness_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
 {
@@ -177,9 +160,6 @@ gcm_brightness_set_property (GObject *object, guint prop_id, const GValue *value
 	}
 }
 
-/**
- * gcm_brightness_class_init:
- **/
 static void
 gcm_brightness_class_init (GcmBrightnessClass *klass)
 {
@@ -200,9 +180,6 @@ gcm_brightness_class_init (GcmBrightnessClass *klass)
 	g_type_class_add_private (klass, sizeof (GcmBrightnessPrivate));
 }
 
-/**
- * gcm_brightness_init:
- **/
 static void
 gcm_brightness_init (GcmBrightness *brightness)
 {
@@ -210,9 +187,6 @@ gcm_brightness_init (GcmBrightness *brightness)
 	brightness->priv->percentage = 0;
 }
 
-/**
- * gcm_brightness_finalize:
- **/
 static void
 gcm_brightness_finalize (GObject *object)
 {
@@ -225,11 +199,6 @@ gcm_brightness_finalize (GObject *object)
 	G_OBJECT_CLASS (gcm_brightness_parent_class)->finalize (object);
 }
 
-/**
- * gcm_brightness_new:
- *
- * Return value: a new GcmBrightness object.
- **/
 GcmBrightness *
 gcm_brightness_new (void)
 {
diff --git a/src/gcm-dmi.c b/src/gcm-dmi.c
index c55e97d..feb1f70 100644
--- a/src/gcm-dmi.c
+++ b/src/gcm-dmi.c
@@ -1,6 +1,6 @@
 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
  *
- * Copyright (C) 2009-2010 Richard Hughes <richard hughsie com>
+ * Copyright (C) 2009-2011 Richard Hughes <richard hughsie com>
  *
  * Licensed under the GNU General Public License Version 2
  *
@@ -34,11 +34,6 @@ static void     gcm_dmi_finalize	(GObject     *object);
 
 #define GCM_DMI_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), GCM_TYPE_DMI, GcmDmiPrivate))
 
-/**
- * GcmDmiPrivate:
- *
- * Private #GcmDmi data
- **/
 struct _GcmDmiPrivate
 {
 	gchar				*name;
@@ -58,9 +53,6 @@ static gpointer gcm_dmi_object = NULL;
 
 G_DEFINE_TYPE (GcmDmi, gcm_dmi, G_TYPE_OBJECT)
 
-/**
- * gcm_dmi_get_data:
- **/
 static gchar *
 gcm_dmi_get_data (const gchar *filename)
 {
@@ -91,9 +83,6 @@ gcm_dmi_get_data (const gchar *filename)
 	return data;
 }
 
-/**
- * gcm_dmi_get_name:
- **/
 const gchar *
 gcm_dmi_get_name (GcmDmi *dmi)
 {
@@ -107,9 +96,6 @@ gcm_dmi_get_name (GcmDmi *dmi)
 	return priv->name;
 }
 
-/**
- * gcm_dmi_get_version:
- **/
 const gchar *
 gcm_dmi_get_version (GcmDmi *dmi)
 {
@@ -125,9 +111,6 @@ gcm_dmi_get_version (GcmDmi *dmi)
 	return priv->version;
 }
 
-/**
- * gcm_dmi_get_vendor:
- **/
 const gchar *
 gcm_dmi_get_vendor (GcmDmi *dmi)
 {
@@ -143,9 +126,6 @@ gcm_dmi_get_vendor (GcmDmi *dmi)
 	return priv->vendor;
 }
 
-/**
- * gcm_dmi_get_property:
- **/
 static void
 gcm_dmi_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
 {
@@ -167,9 +147,6 @@ gcm_dmi_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec
 	}
 }
 
-/**
- * gcm_dmi_set_property:
- **/
 static void
 gcm_dmi_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
 {
@@ -180,9 +157,6 @@ gcm_dmi_set_property (GObject *object, guint prop_id, const GValue *value, GPara
 	}
 }
 
-/**
- * gcm_dmi_class_init:
- **/
 static void
 gcm_dmi_class_init (GcmDmiClass *klass)
 {
@@ -192,25 +166,16 @@ gcm_dmi_class_init (GcmDmiClass *klass)
 	object_class->get_property = gcm_dmi_get_property;
 	object_class->set_property = gcm_dmi_set_property;
 
-	/**
-	 * GcmDmi:name:
-	 */
 	pspec = g_param_spec_string ("name", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_NAME, pspec);
 
-	/**
-	 * GcmDmi:version:
-	 */
 	pspec = g_param_spec_string ("version", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_VERSION, pspec);
 
-	/**
-	 * GcmDmi:vendor:
-	 */
 	pspec = g_param_spec_string ("vendor", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
@@ -219,9 +184,6 @@ gcm_dmi_class_init (GcmDmiClass *klass)
 	g_type_class_add_private (klass, sizeof (GcmDmiPrivate));
 }
 
-/**
- * gcm_dmi_init:
- **/
 static void
 gcm_dmi_init (GcmDmi *dmi)
 {
@@ -231,9 +193,6 @@ gcm_dmi_init (GcmDmi *dmi)
 	dmi->priv->vendor = NULL;
 }
 
-/**
- * gcm_dmi_finalize:
- **/
 static void
 gcm_dmi_finalize (GObject *object)
 {
@@ -247,11 +206,6 @@ gcm_dmi_finalize (GObject *object)
 	G_OBJECT_CLASS (gcm_dmi_parent_class)->finalize (object);
 }
 
-/**
- * gcm_dmi_new:
- *
- * Return value: a new GcmDmi object.
- **/
 GcmDmi *
 gcm_dmi_new (void)
 {
diff --git a/src/gcm-edid.c b/src/gcm-edid.c
index 69e6e79..c7c203e 100644
--- a/src/gcm-edid.c
+++ b/src/gcm-edid.c
@@ -1,6 +1,7 @@
 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
  *
- * Copyright (C) 2009-2010 Richard Hughes <richard hughsie com>
+ * Copyright (C) 2008 Soren Sandmann <sandmann redhat com>
+ * Copyright (C) 2009-2011 Richard Hughes <richard hughsie com>
  *
  * Licensed under the GNU General Public License Version 2
  *
@@ -35,11 +36,6 @@ static void     gcm_edid_finalize	(GObject     *object);
 
 #define GCM_EDID_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), GCM_TYPE_EDID, GcmEdidPrivate))
 
-/**
- * GcmEdidPrivate:
- *
- * Private #GcmEdid data
- **/
 struct _GcmEdidPrivate
 {
 	gchar				*monitor_name;
@@ -92,14 +88,6 @@ G_DEFINE_TYPE (GcmEdid, gcm_edid, G_TYPE_OBJECT)
 #define GCM_DESCRIPTOR_ALPHANUMERIC_DATA_STRING		0xfe
 #define GCM_DESCRIPTOR_COLOR_POINT			0xfb
 
-/**
- * gcm_edid_get_monitor_name:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor name.
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_monitor_name (GcmEdid *edid)
 {
@@ -107,14 +95,6 @@ gcm_edid_get_monitor_name (GcmEdid *edid)
 	return edid->priv->monitor_name;
 }
 
-/**
- * gcm_edid_get_vendor_name:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the vendor name.
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_vendor_name (GcmEdid *edid)
 {
@@ -126,14 +106,6 @@ gcm_edid_get_vendor_name (GcmEdid *edid)
 	return priv->vendor_name;
 }
 
-/**
- * gcm_edid_get_serial_number:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the device serial number.
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_serial_number (GcmEdid *edid)
 {
@@ -141,14 +113,6 @@ gcm_edid_get_serial_number (GcmEdid *edid)
 	return edid->priv->serial_number;
 }
 
-/**
- * gcm_edid_get_eisa_id:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the EISA ID.
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_eisa_id (GcmEdid *edid)
 {
@@ -156,15 +120,6 @@ gcm_edid_get_eisa_id (GcmEdid *edid)
 	return edid->priv->eisa_id;
 }
 
-/**
- * gcm_edid_get_checksum:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the EDID MD5 checksum, which is often useful to compare binary
- * blobs.
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_checksum (GcmEdid *edid)
 {
@@ -172,14 +127,6 @@ gcm_edid_get_checksum (GcmEdid *edid)
 	return edid->priv->checksum;
 }
 
-/**
- * gcm_edid_get_pnp_id:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the device PNP ID..
- *
- * Return value: a null terminaled string value
- **/
 const gchar *
 gcm_edid_get_pnp_id (GcmEdid *edid)
 {
@@ -187,14 +134,6 @@ gcm_edid_get_pnp_id (GcmEdid *edid)
 	return edid->priv->pnp_id;
 }
 
-/**
- * gcm_edid_get_width:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the width of the panel.
- *
- * Return value: the width in mm.
- **/
 guint
 gcm_edid_get_width (GcmEdid *edid)
 {
@@ -202,14 +141,6 @@ gcm_edid_get_width (GcmEdid *edid)
 	return edid->priv->width;
 }
 
-/**
- * gcm_edid_get_height:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the panel height.
- *
- * Return value: the height in mm.
- **/
 guint
 gcm_edid_get_height (GcmEdid *edid)
 {
@@ -217,14 +148,6 @@ gcm_edid_get_height (GcmEdid *edid)
 	return edid->priv->height;
 }
 
-/**
- * gcm_edid_get_gamma:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor gamma.
- *
- * Return value: the gamma value, although this is typically 2.2
- **/
 gfloat
 gcm_edid_get_gamma (GcmEdid *edid)
 {
@@ -232,14 +155,6 @@ gcm_edid_get_gamma (GcmEdid *edid)
 	return edid->priv->gamma;
 }
 
-/**
- * gcm_edid_get_red:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor red chromaticity value.
- *
- * Return value: the #CdColorYxy value
- **/
 const CdColorYxy *
 gcm_edid_get_red (GcmEdid *edid)
 {
@@ -247,14 +162,6 @@ gcm_edid_get_red (GcmEdid *edid)
 	return edid->priv->red;
 }
 
-/**
- * gcm_edid_get_green:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor green chromaticity value.
- *
- * Return value: the #CdColorYxy value
- **/
 const CdColorYxy *
 gcm_edid_get_green (GcmEdid *edid)
 {
@@ -262,14 +169,6 @@ gcm_edid_get_green (GcmEdid *edid)
 	return edid->priv->green;
 }
 
-/**
- * gcm_edid_get_blue:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor red chromaticity value.
- *
- * Return value: the #CdColorYxy value
- **/
 const CdColorYxy *
 gcm_edid_get_blue (GcmEdid *edid)
 {
@@ -277,14 +176,6 @@ gcm_edid_get_blue (GcmEdid *edid)
 	return edid->priv->blue;
 }
 
-/**
- * gcm_edid_get_white:
- * @edid: a valid #GcmEdid instance
- *
- * Gets the monitor white chromaticity value.
- *
- * Return value: the #CdColorYxy value
- **/
 const CdColorYxy *
 gcm_edid_get_white (GcmEdid *edid)
 {
@@ -292,12 +183,6 @@ gcm_edid_get_white (GcmEdid *edid)
 	return edid->priv->white;
 }
 
-/**
- * gcm_edid_reset:
- * @edid: a valid #GcmEdid instance
- *
- * Resets all the cached values in this object.
- **/
 void
 gcm_edid_reset (GcmEdid *edid)
 {
@@ -326,11 +211,6 @@ gcm_edid_reset (GcmEdid *edid)
 	priv->gamma = 0.0f;
 }
 
-/**
- * gcm_edid_get_bit:
- *
- * Originally Copyright Soren Sandmann <sandmann redhat com>
- **/
 static gint
 gcm_edid_get_bit (gint in, gint bit)
 {
@@ -363,14 +243,6 @@ gcm_edid_decode_fraction (gint high, gint low)
 	return result;
 }
 
-/**
- * gcm_edid_parse_string:
- *
- * This is always 12 bytes, but we can't guarantee it's null terminated
- * or not junk.
- *
- * Return value: the sane text, or %NULL, use g_free() to unref.
- **/
 static gchar *
 gcm_edid_parse_string (const guint8 *data)
 {
@@ -378,7 +250,8 @@ gcm_edid_parse_string (const guint8 *data)
 	guint i;
 	guint replaced = 0;
 
-	/* copy 12 bytes */
+	/* this is always 12 bytes, but we can't guarantee it's null
+	 * terminated or not junk. */
 	text = g_strndup ((const gchar *) data, 12);
 
 	/* remove insane newline chars */
@@ -412,9 +285,6 @@ out:
 	return text;
 }
 
-/**
- * gcm_edid_get_white_temperature:
- **/
 static gdouble
 gcm_edid_get_white_temperature (CdColorYxy *yxy)
 {
@@ -432,18 +302,6 @@ gcm_edid_get_white_temperature (CdColorYxy *yxy)
 	return temp;
 }
 
-/**
- * gcm_edid_parse:
- * @edid: a valid #GcmEdid instance
- * @data: the EDID block
- * @length: the data length, typically a multiple of 128
- * @error: a valid #GError or %NULL
- *
- * Parses an EDID block, checking for sanity and decoding anything
- * important.
- *
- * Return value: %TRUE for success.
- **/
 gboolean
 gcm_edid_parse (GcmEdid *edid, const guint8 *data, gsize length, GError **error)
 {
@@ -592,9 +450,6 @@ out:
 	return ret;
 }
 
-/**
- * gcm_edid_get_property:
- **/
 static void
 gcm_edid_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
 {
@@ -647,9 +502,6 @@ gcm_edid_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec
 	}
 }
 
-/**
- * gcm_edid_set_property:
- **/
 static void
 gcm_edid_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
 {
@@ -660,9 +512,6 @@ gcm_edid_set_property (GObject *object, guint prop_id, const GValue *value, GPar
 	}
 }
 
-/**
- * gcm_edid_class_init:
- **/
 static void
 gcm_edid_class_init (GcmEdidClass *klass)
 {
@@ -672,105 +521,66 @@ gcm_edid_class_init (GcmEdidClass *klass)
 	object_class->get_property = gcm_edid_get_property;
 	object_class->set_property = gcm_edid_set_property;
 
-	/**
-	 * GcmEdid:monitor-name:
-	 */
 	pspec = g_param_spec_string ("monitor-name", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_MONITOR_NAME, pspec);
 
-	/**
-	 * GcmEdid:vendor-name:
-	 */
 	pspec = g_param_spec_string ("vendor-name", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_VENDOR_NAME, pspec);
 
-	/**
-	 * GcmEdid:serial-number:
-	 */
 	pspec = g_param_spec_string ("serial-number", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_SERIAL_NUMBER, pspec);
 
-	/**
-	 * GcmEdid:eisa-id:
-	 */
 	pspec = g_param_spec_string ("eisa-id", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_EISA_ID, pspec);
 
-	/**
-	 * GcmEdid:checksum:
-	 */
 	pspec = g_param_spec_string ("checksum", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_CHECKSUM, pspec);
 
-	/**
-	 * GcmEdid:gamma:
-	 */
 	pspec = g_param_spec_float ("gamma", NULL, NULL,
 				    1.0f, 5.0f, 1.0f,
 				    G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_GAMMA, pspec);
 
-	/**
-	 * GcmEdid:pnp-id:
-	 */
 	pspec = g_param_spec_string ("pnp-id", NULL, NULL,
 				     NULL,
 				     G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_PNP_ID, pspec);
 
-	/**
-	 * GcmEdid:width:
-	 */
 	pspec = g_param_spec_uint ("width", "in cm", NULL,
 				   0, G_MAXUINT, 0,
 				   G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_WIDTH, pspec);
 
-	/**
-	 * GcmEdid:height:
-	 */
 	pspec = g_param_spec_uint ("height", "in cm", NULL,
 				   0, G_MAXUINT, 0,
 				   G_PARAM_READABLE);
 	g_object_class_install_property (object_class, PROP_HEIGHT, pspec);
 
-	/**
-	 * GcmEdid:red:
-	 */
 	g_object_class_install_property (object_class,
 					 PROP_RED,
 					 g_param_spec_boxed ("red", NULL, NULL,
 							     CD_TYPE_COLOR_YXY,
 							     G_PARAM_READABLE));
-	/**
-	 * GcmEdid:green:
-	 */
 	g_object_class_install_property (object_class,
 					 PROP_GREEN,
 					 g_param_spec_boxed ("green", NULL, NULL,
 							     CD_TYPE_COLOR_YXY,
 							     G_PARAM_READABLE));
-	/**
-	 * GcmEdid:blue:
-	 */
 	g_object_class_install_property (object_class,
 					 PROP_BLUE,
 					 g_param_spec_boxed ("blue", NULL, NULL,
 							     CD_TYPE_COLOR_YXY,
 							     G_PARAM_READABLE));
-	/**
-	 * GcmEdid:white:
-	 */
 	g_object_class_install_property (object_class,
 					 PROP_WHITE,
 					 g_param_spec_boxed ("white", NULL, NULL,
@@ -780,18 +590,10 @@ gcm_edid_class_init (GcmEdidClass *klass)
 	g_type_class_add_private (klass, sizeof (GcmEdidPrivate));
 }
 
-/**
- * gcm_edid_init:
- **/
 static void
 gcm_edid_init (GcmEdid *edid)
 {
 	edid->priv = GCM_EDID_GET_PRIVATE (edid);
-	edid->priv->monitor_name = NULL;
-	edid->priv->vendor_name = NULL;
-	edid->priv->serial_number = NULL;
-	edid->priv->eisa_id = NULL;
-	edid->priv->checksum = NULL;
 	edid->priv->tables = gcm_tables_new ();
 	edid->priv->pnp_id = g_new0 (gchar, 4);
 	edid->priv->red = cd_color_yxy_new ();
@@ -800,9 +602,6 @@ gcm_edid_init (GcmEdid *edid)
 	edid->priv->white = cd_color_yxy_new ();
 }
 
-/**
- * gcm_edid_finalize:
- **/
 static void
 gcm_edid_finalize (GObject *object)
 {
@@ -824,11 +623,6 @@ gcm_edid_finalize (GObject *object)
 	G_OBJECT_CLASS (gcm_edid_parent_class)->finalize (object);
 }
 
-/**
- * gcm_edid_new:
- *
- * Return value: a new #GcmEdid object.
- **/
 GcmEdid *
 gcm_edid_new (void)
 {
diff --git a/src/gcm-tables.c b/src/gcm-tables.c
index eb47ec6..220fa34 100644
--- a/src/gcm-tables.c
+++ b/src/gcm-tables.c
@@ -1,6 +1,6 @@
 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*-
  *
- * Copyright (C) 2009-2010 Richard Hughes <richard hughsie com>
+ * Copyright (C) 2009-2011 Richard Hughes <richard hughsie com>
  *
  * Licensed under the GNU General Public License Version 2
  *
@@ -29,11 +29,6 @@ static void     gcm_tables_finalize	(GObject     *object);
 
 #define GCM_TABLES_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), GCM_TYPE_TABLES, GcmTablesPrivate))
 
-/**
- * GcmTablesPrivate:
- *
- * Private #GcmTables data
- **/
 struct _GcmTablesPrivate
 {
 	gchar				*data_dir;
@@ -41,19 +36,10 @@ struct _GcmTablesPrivate
 	GHashTable			*pnp_table;
 };
 
-enum {
-	PROP_0,
-	PROP_DATA_DIR,
-	PROP_LAST
-};
-
 static gpointer gcm_tables_object = NULL;
 
 G_DEFINE_TYPE (GcmTables, gcm_tables, G_TYPE_OBJECT)
 
-/**
- * gcm_tables_load:
- **/
 static gboolean
 gcm_tables_load (GcmTables *tables, GError **error)
 {
@@ -100,9 +86,6 @@ out:
 	return ret;
 }
 
-/**
- * gcm_tables_get_pnp_id:
- **/
 gchar *
 gcm_tables_get_pnp_id (GcmTables *tables, const gchar *pnp_id, GError **error)
 {
@@ -136,71 +119,14 @@ out:
 	return retval;
 }
 
-/**
- * gcm_tables_get_property:
- **/
-static void
-gcm_tables_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
-{
-	GcmTables *tables = GCM_TABLES (object);
-	GcmTablesPrivate *priv = tables->priv;
-
-	switch (prop_id) {
-	case PROP_DATA_DIR:
-		g_value_set_string (value, priv->data_dir);
-		break;
-	default:
-		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
-		break;
-	}
-}
-
-/**
- * gcm_tables_set_property:
- **/
-static void
-gcm_tables_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
-{
-	GcmTables *tables = GCM_TABLES (object);
-	GcmTablesPrivate *priv = tables->priv;
-
-	switch (prop_id) {
-	case PROP_DATA_DIR:
-		g_free (priv->data_dir);
-		priv->data_dir = g_strdup (g_value_get_string (value));
-		break;
-	default:
-		G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
-		break;
-	}
-}
-
-/**
- * gcm_tables_class_init:
- **/
 static void
 gcm_tables_class_init (GcmTablesClass *klass)
 {
-	GParamSpec *pspec;
 	GObjectClass *object_class = G_OBJECT_CLASS (klass);
 	object_class->finalize = gcm_tables_finalize;
-	object_class->get_property = gcm_tables_get_property;
-	object_class->set_property = gcm_tables_set_property;
-
-	/**
-	 * GcmTables:data-dir:
-	 */
-	pspec = g_param_spec_string ("data-dir", NULL, NULL,
-				     NULL,
-				     G_PARAM_READABLE);
-	g_object_class_install_property (object_class, PROP_DATA_DIR, pspec);
-
 	g_type_class_add_private (klass, sizeof (GcmTablesPrivate));
 }
 
-/**
- * gcm_tables_set_default_data_dir:
- **/
 static gboolean
 gcm_tables_set_default_data_dir (GcmTables *tables)
 {
@@ -233,14 +159,10 @@ out:
 	return ret;
 }
 
-/**
- * gcm_tables_init:
- **/
 static void
 gcm_tables_init (GcmTables *tables)
 {
 	tables->priv = GCM_TABLES_GET_PRIVATE (tables);
-	tables->priv->data_dir = NULL;
 
 	/* we don't keep malloc'd data in the hash; instead we read it
 	 * out into priv->table_data and then link to it in the hash */
@@ -253,9 +175,6 @@ gcm_tables_init (GcmTables *tables)
 	gcm_tables_set_default_data_dir (tables);
 }
 
-/**
- * gcm_tables_finalize:
- **/
 static void
 gcm_tables_finalize (GObject *object)
 {
@@ -269,11 +188,6 @@ gcm_tables_finalize (GObject *object)
 	G_OBJECT_CLASS (gcm_tables_parent_class)->finalize (object);
 }
 
-/**
- * gcm_tables_new:
- *
- * Return value: a new GcmTables object.
- **/
 GcmTables *
 gcm_tables_new (void)
 {
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]