[gobject-introspection] Update annotations from glib git 2cd3c200687751c9cc26774f650b7651bffcc598
- From: Jasper St. Pierre <jstpierre src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gobject-introspection] Update annotations from glib git 2cd3c200687751c9cc26774f650b7651bffcc598
- Date: Wed, 24 Aug 2011 17:57:00 +0000 (UTC)
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]