[gedit] Fix gedit_commands_load_location/s annotations.



commit 336903b05c184aed22c0ef5a0ae6d745e2c2ddb8
Author: Ignacio Casal Quinteiro <icq gnome org>
Date:   Sun Dec 12 00:31:59 2010 +0100

    Fix gedit_commands_load_location/s annotations.

 gedit/gedit-commands-file.c |   28 +++++++++++++---------------
 1 files changed, 13 insertions(+), 15 deletions(-)
---
diff --git a/gedit/gedit-commands-file.c b/gedit/gedit-commands-file.c
index 41827f6..1b6e23c 100644
--- a/gedit/gedit-commands-file.c
+++ b/gedit/gedit-commands-file.c
@@ -292,15 +292,13 @@ load_file_list (GeditWindow         *window,
 
 /**
  * gedit_commands_load_location:
- * @window:
- * @location:
- * @encoding: (allow-none):
- * @line_pos:
- * @column_pos:
+ * @window: a #GeditWindow
+ * @location: a #GFile to be loaded
+ * @encoding: (allow-none): the #GeditEncoding of @location
+ * @line_pos: the line position to place the cursor when @location is loaded
+ * @column_pos: the line column to place the cursor when @location is loaded
  *
- * Ignore non-existing locations
- *
- * Returns: (transfer container):
+ * Loads @location. Ignores non-existing locations
  */
 void
 gedit_commands_load_location (GeditWindow         *window,
@@ -331,15 +329,15 @@ gedit_commands_load_location (GeditWindow         *window,
 
 /**
  * gedit_commands_load_locations:
- * @window:
- * @locations: (element-type GLib.File) (transfer none):
- * @encoding: (allow-none):
- * @line_pos:
- * @column_pos:
+ * @window: a #GeditWindow
+ * @locations: (element-type Gio.File): the locations to be loaded
+ * @encoding: (allow-none): the #GeditEncoding of @location
+ * @line_pos: the line position to place the cursor when @location is loaded
+ * @column_pos: the line column to place the cursor when @location is loaded
  *
- * Ignore non-existing locations
+ * Loads @locations. Ignore non-existing locations
  *
- * Returns: (element-type Gedit.Document) (transfer container):
+ * Returns: (element-type Gedit.Document) (transfer container): the locations that were loaded
  */
 GSList *
 gedit_commands_load_locations (GeditWindow         *window,



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