[gobject-introspection] Update annotations from glib git 2cd3c200687751c9cc26774f650b7651bffcc598



commit 40cb3d360ee799a88b7f2994ddbf685126c3420c
Author: Jasper St. Pierre <jstpierre mecheye net>
Date:   Wed Aug 24 13:29:04 2011 -0400

    Update annotations from glib git 2cd3c200687751c9cc26774f650b7651bffcc598

 gir/gio-2.0.c  |   10 +++++-----
 gir/glib-2.0.c |   35 +++++++++++++++++++----------------
 2 files changed, 24 insertions(+), 21 deletions(-)
---
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c
index 4722914..5fadde1 100644
--- a/gir/gio-2.0.c
+++ b/gir/gio-2.0.c
@@ -27545,7 +27545,7 @@
  * If @type has already been registered as an extension for this
  * extension point, the existing #GIOExtension object is returned.
  *
- * Returns: a #GIOExtension object for #GType
+ * Returns: (transfer none): a #GIOExtension object for #GType
  */
 
 
@@ -27555,9 +27555,9 @@
  *
  * Looks up an existing extension point.
  *
- * registered extension point with the given name
+ * is no registered extension point with the given name.
  *
- * Returns: the #GIOExtensionPoint, or %NULL if there is no
+ * Returns: (transfer none): the #GIOExtensionPoint, or %NULL if there
  */
 
 
@@ -27567,9 +27567,9 @@
  *
  * Registers an extension point.
  *
- * and should not be freed
+ * owned by GIO and should not be freed.
  *
- * Returns: the new #GIOExtensionPoint. This object is owned by GIO
+ * Returns: (transfer none): the new #GIOExtensionPoint. This object is
  */
 
 
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c
index ac7fc91..15610c8 100644
--- a/gir/glib-2.0.c
+++ b/gir/glib-2.0.c
@@ -14343,8 +14343,7 @@
 
 /**
  * g_dir_make_tmp:
- * @tmpl: Template for directory name, as in g_mkdtemp(), basename only, or %NULL, to a default template
- * @name_used: location to store actual name used, or %NULL
+ * @tmpl: (type filename) (allow-none): Template for directory name, as in g_mkdtemp(), basename only, or %NULL for a default template
  * @error: return location for a #GError
  *
  * Creates a subdirectory in the preferred directory for temporary
@@ -14359,11 +14358,11 @@
  * Note that in contrast to g_mkdtemp() (and mkdtemp()) @tmpl is not
  * modified, and might thus be a read-only literal string.
  *
- * with g_free() when not needed any longer and is is in the GLib
- * file name encoding.  In case of errors, %NULL is returned
- * and @error will be set.
+ * should be freed with g_free() when not needed any longer and is
+ * is in the GLib file name encoding. In case of errors, %NULL is
+ * returned and @error will be set.
  *
- * Returns: The actual name used. This string should be freed
+ * Returns: (type filename): The actual name used. This string
  * Since: 2.30
  */
 
@@ -14665,8 +14664,8 @@
 
 /**
  * g_file_open_tmp:
- * @tmpl: Template for file name, as in g_mkstemp(), basename only, or %NULL, to a default template
- * @name_used: location to store actual name used, or %NULL
+ * @tmpl: (type filename) (allow-none): Template for file name, as in g_mkstemp(), basename only, or %NULL for a default template
+ * @name_used: (out) (type filename): location to store actual name used, or %NULL
  * @error: return location for a #GError
  *
  * Opens a file for writing in the preferred directory for temporary
@@ -20167,7 +20166,7 @@
 
 /**
  * g_mkdtemp:
- * @tmpl: template directory name
+ * @tmpl: (type filename): template directory name
  *
  * Creates a temporary directory. See the mkdtemp() documentation
  * on most UNIX-like systems.
@@ -20181,7 +20180,8 @@
  * The string should be in the GLib file name encoding. Most importantly,
  * on Windows it should be in UTF-8.
  *
- * to hold the directory name.  In case of errors, NULL is returned.
+ * to hold the directory name.  In case of errors, %NULL is
+ * returned and %errno will be set.
  *
  * Returns: A pointer to @tmpl, which has been modified
  * Since: 2.26
@@ -20190,7 +20190,7 @@
 
 /**
  * g_mkdtemp_full:
- * @tmpl: template directory name
+ * @tmpl: (type filename): template directory name
  * @mode: permissions to create the temporary directory with
  *
  * Creates a temporary directory. See the mkdtemp() documentation
@@ -20205,7 +20205,8 @@
  * in the GLib file name encoding. Most importantly, on Windows it
  * should be in UTF-8.
  *
- * to hold the directory name. In case of errors, %NULL is returned.
+ * to hold the directory name. In case of errors, %NULL is
+ * returned, and %errno will be set.
  *
  * Returns: A pointer to @tmpl, which has been modified
  * Since: 2.26
@@ -20214,7 +20215,7 @@
 
 /**
  * g_mkstemp:
- * @tmpl: template filename
+ * @tmpl: (type filename): template filename
  *
  * Opens a temporary file. See the mkstemp() documentation
  * on most UNIX-like systems.
@@ -20229,7 +20230,8 @@
  *
  * opened for reading and writing. The file is opened in binary
  * mode on platforms where there is a difference. The file handle
- * should be closed with close(). In case of errors, -1 is returned.
+ * should be closed with close(). In case of errors, -1 is
+ * returned and %errno will be set.
  *
  * Returns: A file handle (as from open()) to the file
  */
@@ -20237,7 +20239,7 @@
 
 /**
  * g_mkstemp_full:
- * @tmpl: template filename
+ * @tmpl: (type filename): template filename
  * @flags: flags to pass to an open() call in addition to O_EXCL and O_CREAT, which are passed automatically
  * @mode: permissions to create the temporary file with
  *
@@ -20254,7 +20256,8 @@
  * on Windows it should be in UTF-8.
  *
  * opened for reading and writing. The file handle should be
- * closed with close(). In case of errors, -1 is returned.
+ * closed with close(). In case of errors, -1 is returned
+ * and %errno will be set.
  *
  * Returns: A file handle (as from open()) to the file
  * Since: 2.22



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