[nautilus-actions] BaseBuilder: fix comments



commit 90746d4576047d2a5f924cd5c1872bfdf70028a0
Author: Pierre Wieser <pwieser trychlos org>
Date:   Sun Jan 8 14:29:51 2012 +0100

    BaseBuilder: fix comments

 ChangeLog               |    3 +++
 src/nact/base-builder.c |   10 +++++-----
 src/nact/base-builder.h |   11 ++++++-----
 3 files changed, 14 insertions(+), 10 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index da5c196..6e26fde 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2012-01-08 Pierre Wieser <pwieser trychlos org>
 
+	* src/nact/base-builder.c:
+	* src/nact/base-builder.h: Fix comments.
+
 	* src/nact/nact-tree-view.c (nact_tree_view_get_type):
 	Register the interface after the type so that the interface is able to
 	require the type.
diff --git a/src/nact/base-builder.c b/src/nact/base-builder.c
index b09362a..d533792 100644
--- a/src/nact/base-builder.c
+++ b/src/nact/base-builder.c
@@ -217,12 +217,12 @@ base_builder_new( void )
  * base_builder_add_from_file:
  * @builder: this #BaseBuilder object.
  * @filename: the filename to load.
- * @error: a #GError whilch will be allocated if an error occurs.
+ * @error: a #GError which will be allocated if an error occurs.
  *
  * Loads the file into the GtkBuilder, taking care of not loading it
  * twice.
  *
- * Returns: %TRUE if filename has been successfully loaded, or were
+ * Returns: %TRUE if filename has been successfully loaded, or was
  * already loaded, %FALSE else.
  */
 gboolean
@@ -272,10 +272,10 @@ already_loaded( BaseBuilder *builder, const gchar *filename )
  * @builder: this #BaseBuilder object.
  * @name: the name of the searched toplevel window.
  *
- * This function provides a pointer to the toplevel dialog associated
- * with the specified #BaseWindow.
+ * This function provides a pointer to the toplevel window associated
+ * with the specified @name.
  *
- * Returns: a pointer to the named dialog, or NULL.
+ * Returns: a pointer to the named window, or %NULL.
  * This pointer is owned by GtkBuilder instance, and must not be
  * g_free() nor g_object_unref() by the caller.
  */
diff --git a/src/nact/base-builder.h b/src/nact/base-builder.h
index 28d5a1f..5df298c 100644
--- a/src/nact/base-builder.h
+++ b/src/nact/base-builder.h
@@ -39,8 +39,9 @@
  * This class is derived from GtkBuilder class. It adds to it a list
  * of already loaded files to be sure to not load them twice.
  *
- * #Basebuilder class is embedded as a convenience object in
- * #BaseApplication and, possibly, in #BaseWindow instances.
+ * A common #Basebuilder object is instanciated at #BaseWindow class level.
+ * Each #Basewindow -derived object may later use this common #BaseBuilder
+ * object, or allocate its own.
  */
 
 #include <gtk/gtk.h>
@@ -72,11 +73,11 @@ typedef struct {
 }
 	BaseBuilderClass;
 
-GType        base_builder_get_type( void );
+GType        base_builder_get_type            ( void );
 
-BaseBuilder *base_builder_new( void );
+BaseBuilder *base_builder_new                 ( void );
 
-gboolean     base_builder_add_from_file( BaseBuilder *builder, const gchar *filename, GError **error );
+gboolean     base_builder_add_from_file       ( BaseBuilder *builder, const gchar *filename, GError **error );
 
 GtkWindow   *base_builder_get_toplevel_by_name( const BaseBuilder *builder, const gchar *name );
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]