goffice r2365 - in trunk: docs/reference/tmpl goffice/app goffice/drawing goffice/graph goffice/gtk goffice/ms-compat goffice/utils

From: jody svn gnome org
To: svn-commits-list gnome org
Subject: goffice r2365 - in trunk: docs/reference/tmpl goffice/app goffice/drawing goffice/graph goffice/gtk goffice/ms-compat goffice/utils
Date: Sun, 5 Apr 2009 22:34:44 +0000 (UTC)
Author: jody
Date: Sun Apr  5 22:34:43 2009
New Revision: 2365
URL: http://svn.gnome.org/viewvc/goffice?rev=2365&view=rev

Log:
Make gtk-doc marginally happier.
Still lots of whining going on.


Modified:
   trunk/docs/reference/tmpl/gog-object.sgml
   trunk/docs/reference/tmpl/gog-styled-object.sgml
   trunk/goffice/app/go-plugin-service.c
   trunk/goffice/drawing/god-anchor.h
   trunk/goffice/drawing/god-default-attributes.h
   trunk/goffice/drawing/god-drawing-group.h
   trunk/goffice/drawing/god-drawing-renderer-cairo.h
   trunk/goffice/drawing/god-drawing-renderer-gdk.h
   trunk/goffice/drawing/god-drawing-view.h
   trunk/goffice/drawing/god-drawing.h
   trunk/goffice/drawing/god-image-store.h
   trunk/goffice/drawing/god-image.h
   trunk/goffice/drawing/god-paragraph-attributes.h
   trunk/goffice/drawing/god-property-table.h
   trunk/goffice/drawing/god-shape.h
   trunk/goffice/drawing/god-text-model.h
   trunk/goffice/graph/gog-graph.c
   trunk/goffice/graph/gog-object.c
   trunk/goffice/gtk/go-action-combo-text.h
   trunk/goffice/gtk/go-format-sel.c
   trunk/goffice/gtk/go-format-sel.h
   trunk/goffice/gtk/go-image-sel.c
   trunk/goffice/gtk/go-rotation-sel.c
   trunk/goffice/gtk/goffice-gtk.c
   trunk/goffice/ms-compat/go-ms-parser.h
   trunk/goffice/ms-compat/god-drawing-ms-client-handler.h
   trunk/goffice/ms-compat/god-drawing-ms.h
   trunk/goffice/ms-compat/god-image-ms.h
   trunk/goffice/utils/go-file.c
   trunk/goffice/utils/go-glib-extras.c
   trunk/goffice/utils/go-path.c

Modified: trunk/docs/reference/tmpl/gog-object.sgml
==============================================================================
--- trunk/docs/reference/tmpl/gog-object.sgml	(original)
+++ trunk/docs/reference/tmpl/gog-object.sgml	Sun Apr  5 22:34:43 2009
@@ -123,74 +123,6 @@
 @pre_remove: 
 @post_remove: 
 
-<!-- ##### FUNCTION gog_object_set_arg ##### -->
-<para>
-
-</para>
-
- name: 
- val: 
- obj: 
-
-
-<!-- ##### FUNCTION go_xml_out_add_color ##### -->
-<para>
-
-</para>
-
- out: 
- id: 
- c: 
-
-
-<!-- ##### FUNCTION gog_object_write_xml_sax ##### -->
-<para>
-
-</para>
-
- obj: 
- output: 
-
-
-<!-- ##### FUNCTION gog_object_new_from_xml ##### -->
-<para>
-
-</para>
-
- parent: 
- node: 
- Returns: 
-
-
-<!-- ##### USER_FUNCTION GogObjectSaxHandler ##### -->
-<para>
-
-</para>
-
- obj: 
- user_data: 
-
-
-<!-- ##### FUNCTION gog_object_sax_push_parser ##### -->
-<para>
-
-</para>
-
- xin: 
- attrs: 
- handler: 
- user_data: 
-
-
-<!-- ##### FUNCTION gog_xml_read_state_get_obj ##### -->
-<para>
-
-</para>
-
- xin: 
- Returns: 
-
-
 <!-- ##### STRUCT GogObject ##### -->
 <para>
 
@@ -202,53 +134,37 @@
 
 </para>
 
- gogobject: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL GogObject::child-added ##### -->
-<para>
-
-</para>
-
- gogobject: the object which received the signal.
- arg1: 
+@: 
+@: 
 
 <!-- ##### SIGNAL GogObject::child-name-changed ##### -->
 <para>
 
 </para>
 
- gogobject: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL GogObject::child-removed ##### -->
-<para>
-
-</para>
-
- gogobject: the object which received the signal.
- arg1: 
+@: 
+@: 
 
 <!-- ##### SIGNAL GogObject::children-reordered ##### -->
 <para>
 
 </para>
 
- gogobject: the object which received the signal.
+@: 
 
 <!-- ##### SIGNAL GogObject::name-changed ##### -->
 <para>
 
 </para>
 
- gogobject: the object which received the signal.
+@: 
 
 <!-- ##### SIGNAL GogObject::update-editor ##### -->
 <para>
 
 </para>
 
- gogobject: the object which received the signal.
+@: 
 
 <!-- ##### ARG GogObject:alignment ##### -->
 <para>
@@ -712,3 +628,51 @@
 @doc: 
 
 
+<!-- ##### FUNCTION gog_object_write_xml_sax ##### -->
+<para>
+
+</para>
+
+ obj: 
+ output: 
+
+
+<!-- ##### FUNCTION gog_object_new_from_xml ##### -->
+<para>
+
+</para>
+
+ parent: 
+ node: 
+ Returns: 
+
+
+<!-- ##### USER_FUNCTION GogObjectSaxHandler ##### -->
+<para>
+
+</para>
+
+ obj: 
+ user_data: 
+
+
+<!-- ##### FUNCTION gog_object_sax_push_parser ##### -->
+<para>
+
+</para>
+
+ xin: 
+ attrs: 
+ handler: 
+ user_data: 
+
+
+<!-- ##### FUNCTION gog_xml_read_state_get_obj ##### -->
+<para>
+
+</para>
+
+ xin: 
+ Returns: 
+
+

Modified: trunk/docs/reference/tmpl/gog-styled-object.sgml
==============================================================================
--- trunk/docs/reference/tmpl/gog-styled-object.sgml	(original)
+++ trunk/docs/reference/tmpl/gog-styled-object.sgml	Sun Apr  5 22:34:43 2009
@@ -29,8 +29,8 @@
 
 </para>
 
- gogstyledobject: the object which received the signal.
- arg1: 
+@: 
+@: 
 
 <!-- ##### ARG GogStyledObject:style ##### -->
 <para>

Modified: trunk/goffice/app/go-plugin-service.c
==============================================================================
--- trunk/goffice/app/go-plugin-service.c	(original)
+++ trunk/goffice/app/go-plugin-service.c	Sun Apr  5 22:34:43 2009
@@ -1147,6 +1147,10 @@
 }
 
 /**
+ * plugin_service_define:
+ * @type_str :  char const *
+ * @ctor : #GOPluginServiceCreate
+ *
  * Allow the definition of new service types
  **/
 void

Modified: trunk/goffice/drawing/god-anchor.h
==============================================================================
--- trunk/goffice/drawing/god-anchor.h	(original)
+++ trunk/goffice/drawing/god-anchor.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-anchor.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_ANCHOR_H
 #define GOD_ANCHOR_H

Modified: trunk/goffice/drawing/god-default-attributes.h
==============================================================================
--- trunk/goffice/drawing/god-default-attributes.h	(original)
+++ trunk/goffice/drawing/god-default-attributes.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-default-attributes.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_DEFAULT_ATTRIBUTES_H
 #define GOD_DEFAULT_ATTRIBUTES_H
 

Modified: trunk/goffice/drawing/god-drawing-group.h
==============================================================================
--- trunk/goffice/drawing/god-drawing-group.h	(original)
+++ trunk/goffice/drawing/god-drawing-group.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-drawing-group.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_DRAWING_GROUP_H
 #define GOD_DRAWING_GROUP_H

Modified: trunk/goffice/drawing/god-drawing-renderer-cairo.h
==============================================================================
--- trunk/goffice/drawing/god-drawing-renderer-cairo.h	(original)
+++ trunk/goffice/drawing/god-drawing-renderer-cairo.h	Sun Apr  5 22:34:43 2009
@@ -2,7 +2,7 @@
 #ifndef GOD_DRAWING_RENDERER_CAIRO_H
 #define GOD_DRAWING_RENDERER_CAIRO_H
 
-/**
+/*
  * god-drawing-renderer-cairo.h: MS Office Graphic Object support
  *
  * Author:
@@ -11,7 +11,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #include <goffice/drawing/god-drawing.h>
 #include <cairo.h>

Modified: trunk/goffice/drawing/god-drawing-renderer-gdk.h
==============================================================================
--- trunk/goffice/drawing/god-drawing-renderer-gdk.h	(original)
+++ trunk/goffice/drawing/god-drawing-renderer-gdk.h	Sun Apr  5 22:34:43 2009
@@ -2,7 +2,7 @@
 #ifndef GOD_DRAWING_RENDERER_GDK_H
 #define GOD_DRAWING_RENDERER_GDK_H
 
-/**
+/*
  * god-drawing-renderer-gdk.h: MS Office Graphic Object support
  *
  * Author:
@@ -11,7 +11,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #include <glib-object.h>
 #include <glib.h>

Modified: trunk/goffice/drawing/god-drawing-view.h
==============================================================================
--- trunk/goffice/drawing/god-drawing-view.h	(original)
+++ trunk/goffice/drawing/god-drawing-view.h	Sun Apr  5 22:34:43 2009
@@ -2,7 +2,7 @@
 #ifndef GOD_DRAWING_VIEW_H
 #define GOD_DRAWING_VIEW_H
 
-/**
+/*
  * god-drawing-view.h: MS Office Graphic Object support
  *
  * Author:
@@ -11,7 +11,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #include <glib-object.h>
 #include <glib.h>

Modified: trunk/goffice/drawing/god-drawing.h
==============================================================================
--- trunk/goffice/drawing/god-drawing.h	(original)
+++ trunk/goffice/drawing/god-drawing.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-drawing.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_DRAWING_H
 #define GOD_DRAWING_H
 

Modified: trunk/goffice/drawing/god-image-store.h
==============================================================================
--- trunk/goffice/drawing/god-image-store.h	(original)
+++ trunk/goffice/drawing/god-image-store.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-image-store.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_IMAGE_STORE_H
 #define GOD_IMAGE_STORE_H
 

Modified: trunk/goffice/drawing/god-image.h
==============================================================================
--- trunk/goffice/drawing/god-image.h	(original)
+++ trunk/goffice/drawing/god-image.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-image.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_IMAGE_H
 #define GOD_IMAGE_H
 

Modified: trunk/goffice/drawing/god-paragraph-attributes.h
==============================================================================
--- trunk/goffice/drawing/god-paragraph-attributes.h	(original)
+++ trunk/goffice/drawing/god-paragraph-attributes.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-paragraph-attributes.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_PARAGRAPH_ATTRIBUTES_H
 #define GOD_PARAGRAPH_ATTRIBUTES_H
 

Modified: trunk/goffice/drawing/god-property-table.h
==============================================================================
--- trunk/goffice/drawing/god-property-table.h	(original)
+++ trunk/goffice/drawing/god-property-table.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-property-table.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_PROPERTY_TABLE_H
 #define GOD_PROPERTY_TABLE_H

Modified: trunk/goffice/drawing/god-shape.h
==============================================================================
--- trunk/goffice/drawing/god-shape.h	(original)
+++ trunk/goffice/drawing/god-shape.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-shape.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 #ifndef GOD_SHAPE_H
 #define GOD_SHAPE_H
 

Modified: trunk/goffice/drawing/god-text-model.h
==============================================================================
--- trunk/goffice/drawing/god-text-model.h	(original)
+++ trunk/goffice/drawing/god-text-model.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-text-model.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_TEXT_MODEL_H
 #define GOD_TEXT_MODEL_H

Modified: trunk/goffice/graph/gog-graph.c
==============================================================================
--- trunk/goffice/graph/gog-graph.c	(original)
+++ trunk/goffice/graph/gog-graph.c	Sun Apr  5 22:34:43 2009
@@ -304,6 +304,13 @@
 	
 	gog_object_register_roles (gog_klass, roles, G_N_ELEMENTS (roles));
 
+	/**
+	 * GogGraph::add-data:
+	 * @graph: the object on which the signal is emitted
+	 * @data: The new #GOData being added to @graph
+	 *
+	 * The ::add-data signal is emitted BEFORE @data has been added.
+	 **/
 	gog_graph_signals [GRAPH_ADD_DATA] = g_signal_new ("add-data",
 		G_TYPE_FROM_CLASS (klass),
 		G_SIGNAL_RUN_LAST,
@@ -313,6 +320,13 @@
 		G_TYPE_NONE,
 		1, G_TYPE_OBJECT);
 
+	/**
+	 * GogGraph::remove-data:
+	 * @graph: the object on which the signal is emitted
+	 * @data: The new #GOData being removed to @graph
+	 *
+	 * The ::remove-data signal is emitted BEFORE @data has been removed.
+	 **/
 	gog_graph_signals [GRAPH_REMOVE_DATA] = g_signal_new ("remove-data",
 		G_TYPE_FROM_CLASS (klass),
 		G_SIGNAL_RUN_LAST,

Modified: trunk/goffice/graph/gog-object.c
==============================================================================
--- trunk/goffice/graph/gog-object.c	(original)
+++ trunk/goffice/graph/gog-object.c	Sun Apr  5 22:34:43 2009
@@ -772,6 +772,14 @@
 			FALSE, 
 			GSF_PARAM_STATIC | G_PARAM_READWRITE | GO_PARAM_PERSISTENT));
 
+	/**
+	 * GogObject::child-added:
+	 * @object: the object on which the signal is emitted
+	 * @child: The new #GogObject whose parent is @object
+	 *
+	 * The ::child-added signal is emitted AFTER the child has been added
+	 * and AFTER the parent-changed signal has been called for it.
+	 **/
 	gog_object_signals [CHILD_ADDED] = g_signal_new ("child-added",
 		G_TYPE_FROM_CLASS (klass),
 		G_SIGNAL_RUN_LAST,
@@ -779,6 +787,14 @@
 		NULL, NULL,
 		g_cclosure_marshal_VOID__OBJECT,
 		G_TYPE_NONE,	1, G_TYPE_OBJECT);
+	/**
+	 * GogObject::child-removed:
+	 * @object: the object on which the signal is emitted
+	 * @child: The new #GogObject whose parent is @object
+	 *
+	 * The ::child-removed signal is emitted BEFORE the child has been
+	 * added and BEFORE the parent-changed signal has been called for it.
+	 **/
 	gog_object_signals [CHILD_REMOVED] = g_signal_new ("child-removed",
 		G_TYPE_FROM_CLASS (klass),
 		G_SIGNAL_RUN_LAST,

Modified: trunk/goffice/gtk/go-action-combo-text.h
==============================================================================
--- trunk/goffice/gtk/go-action-combo-text.h	(original)
+++ trunk/goffice/gtk/go-action-combo-text.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * go-action-combo-text.h: A custom GOActionCombo to handle lists of text
  *
  * Copyright (C) 2003-2005 Jody Goldberg (jody gnome org)
@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- **/
+ */
 
 #ifndef _GO_ACTION_COMBO_TEXT_H_
 #define _GO_ACTION_COMBO_TEXT_H_

Modified: trunk/goffice/gtk/go-format-sel.c
==============================================================================
--- trunk/goffice/gtk/go-format-sel.c	(original)
+++ trunk/goffice/gtk/go-format-sel.c	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * go-format-sel.c: A widget to select a format
  *
  * Copyright (C) 2006-2007 Morten Welinder (terra gnome org)
@@ -17,7 +17,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- **/
+ */
 
 #include <goffice/goffice-config.h>
 #include "go-format-sel.h"

Modified: trunk/goffice/gtk/go-format-sel.h
==============================================================================
--- trunk/goffice/gtk/go-format-sel.h	(original)
+++ trunk/goffice/gtk/go-format-sel.h	Sun Apr  5 22:34:43 2009
@@ -1,4 +1,5 @@
-/**
+/* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
+/*
  * go-format-sel.h: A widget to select a format
  *
  * This program is free software; you can redistribute it and/or modify
@@ -14,7 +15,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- **/
+ */
 
 #ifndef _GO_FORMAT_SEL_H_
 #define _GO_FORMAT_SEL_H_

Modified: trunk/goffice/gtk/go-image-sel.c
==============================================================================
--- trunk/goffice/gtk/go-image-sel.c	(original)
+++ trunk/goffice/gtk/go-image-sel.c	Sun Apr  5 22:34:43 2009
@@ -178,9 +178,8 @@
 
 /**
  * go_image_sel_new
- * @app		: The app owning the image collection
- * @image	: 
- *
+ * @doc		: The #GODoc owning the image collection
+ * @image	:  #GOImage
  * 
  * Returns: and shows new image selector.
  **/

Modified: trunk/goffice/gtk/go-rotation-sel.c
==============================================================================
--- trunk/goffice/gtk/go-rotation-sel.c	(original)
+++ trunk/goffice/gtk/go-rotation-sel.c	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * go-rotation-sel.c: A widget to select a text orientation
  *
  * This program is free software; you can redistribute it and/or modify
@@ -15,7 +15,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- **/
+ */
 #include <goffice/goffice-config.h>
 #include "go-rotation-sel.h"
 

Modified: trunk/goffice/gtk/goffice-gtk.c
==============================================================================
--- trunk/goffice/gtk/goffice-gtk.c	(original)
+++ trunk/goffice/gtk/goffice-gtk.c	Sun Apr  5 22:34:43 2009
@@ -656,7 +656,7 @@
  **/
 char *
 go_gui_get_image_save_info (GtkWindow *toplevel, GSList *supported_formats,
-			 GOImageFormat *ret_format, double *resolution)
+			    GOImageFormat *ret_format, double *resolution)
 {
 	GOImageFormat format;
 	GOImageFormatInfo const *format_info;

Modified: trunk/goffice/ms-compat/go-ms-parser.h
==============================================================================
--- trunk/goffice/ms-compat/go-ms-parser.h	(original)
+++ trunk/goffice/ms-compat/go-ms-parser.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * go-drawing-ms.h: MS Office Graphic Object I/O support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2004 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GO_MS_PARSER_H
 #define GO_MS_PARSER_H

Modified: trunk/goffice/ms-compat/god-drawing-ms-client-handler.h
==============================================================================
--- trunk/goffice/ms-compat/god-drawing-ms-client-handler.h	(original)
+++ trunk/goffice/ms-compat/god-drawing-ms-client-handler.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-drawing-ms-client-handler.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_DRAWING_MS_CLIENT_HANDLER_H
 #define GOD_DRAWING_MS_CLIENT_HANDLER_H

Modified: trunk/goffice/ms-compat/god-drawing-ms.h
==============================================================================
--- trunk/goffice/ms-compat/god-drawing-ms.h	(original)
+++ trunk/goffice/ms-compat/god-drawing-ms.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-drawing-ms.h: MS Office Graphic Object I/O support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2004 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GO_DRAWING_MS_H
 #define GO_DRAWING_MS_H

Modified: trunk/goffice/ms-compat/god-image-ms.h
==============================================================================
--- trunk/goffice/ms-compat/god-image-ms.h	(original)
+++ trunk/goffice/ms-compat/god-image-ms.h	Sun Apr  5 22:34:43 2009
@@ -1,5 +1,5 @@
 /* vim: set sw=8: -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
-/**
+/*
  * god-image-ms.h: MS Office Graphic Object support
  *
  * Author:
@@ -8,7 +8,7 @@
  *    Christopher James Lahey <clahey ximian com>
  *
  * (C) 1998-2003 Michael Meeks, Jody Goldberg, Chris Lahey
- **/
+ */
 
 #ifndef GOD_IMAGE_MS_H
 #define GOD_IMAGE_MS_H

Modified: trunk/goffice/utils/go-file.c
==============================================================================
--- trunk/goffice/utils/go-file.c	(original)
+++ trunk/goffice/utils/go-file.c	Sun Apr  5 22:34:43 2009
@@ -889,9 +889,14 @@
 
 /* ------------------------------------------------------------------------- */
 
-/*
- * go_url_decode: decode the result of go_url_encode.
- */
+/**
+ * go_url_decode:
+ * @test :
+ *
+ * Decode the result of go_url_encode.
+ *
+ * Returns: a decoded string which the caller is responsible for freeing.
+ **/
 gchar*
 go_url_decode (gchar const *text)
 {
@@ -921,8 +926,14 @@
 }
 
 /**
- * go_url_encode: url-encode a string according to RFC 2368.
- */
+ * go_url_encode:
+ * @text :
+ * @type :
+ *
+ * url-encode a string according to RFC 2368.
+ *
+ * Returns: an encoded string which the caller is responsible for freeing.
+ **/
 gchar*
 go_url_encode (gchar const *text, int type)
 {

Modified: trunk/goffice/utils/go-glib-extras.c
==============================================================================
--- trunk/goffice/utils/go-glib-extras.c	(original)
+++ trunk/goffice/utils/go-glib-extras.c	Sun Apr  5 22:34:43 2009
@@ -772,9 +772,11 @@
 
 
 /**
- * go_object_toggle: toggle a boolean object property.
+ * go_object_toggle:
  * @object : #GObject
  * @property_name : name
+ *
+ * Toggle a boolean object property.
  **/
 void
 go_object_toggle (gpointer object, const gchar *property_name)

Modified: trunk/goffice/utils/go-path.c
==============================================================================
--- trunk/goffice/utils/go-path.c	(original)
+++ trunk/goffice/utils/go-path.c	Sun Apr  5 22:34:43 2009
@@ -199,15 +199,15 @@
 }
 
 /**
- * FIXME go_path_set_sharp:
+ * go_path_set_options:
  * @path: a #GOPath
- * @sharp: TRUE for trying to keep line sharp
+ * @options: #GOPathOptions
  *
- * Sets the sharp flag for all elements of @path. If @sharp
- * is TRUE, rendering will try to keep line sharp, for example
- * by aligning straight 1 pixel width lines on half pixels.
+ * Change the rendering options for @path using
+ *	%GO_PATH_OPTIONS_SNAP_COORDINATES
+ *	%GO_PATH_OPTIONS_SNAP_WIDTH
+ *	%GO_PATH_OPTIONS_SHARP
  **/
-
 void
 go_path_set_options (GOPath *path, GOPathOptions options)
 {
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]