X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gio%2Fginitable.c;h=23d6069f3b3efd5a41a1d4c531cd1f1fad549ea8;hb=627b49b39039d43a784fa9890f473d1ca8d52417;hp=10770f8cbeb193ef33082b83dbd56d289de1869f;hpb=0104c62f3fda9016658809d79cf395d78611e35a;p=platform%2Fupstream%2Fglib.git
diff --git a/gio/ginitable.c b/gio/ginitable.c
index 10770f8..23d6069 100644
--- a/gio/ginitable.c
+++ b/gio/ginitable.c
@@ -13,9 +13,7 @@
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
- * Public License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
- * Boston, MA 02111-1307, USA.
+ * Public License along with this library; if not, see .
*
* Author: Alexander Larsson
*/
@@ -87,8 +85,7 @@ g_initable_default_init (GInitableInterface *iface)
* If the object is not initialized, or initialization returns with an
* error, then all operations on the object except g_object_ref() and
* g_object_unref() are considered to be invalid, and have undefined
- * behaviour. See the section introduction
- * for more details.
+ * behaviour. See the [introduction][ginitable] for more details.
*
* Implementations of this method must be idempotent, i.e. multiple calls
* to this function with the same argument should return the same results.
@@ -121,16 +118,17 @@ g_initable_init (GInitable *initable,
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError location to store the error occurring, or %NULL to
* ignore.
- * @first_property_name: the name of the first property, or %NULL if no
+ * @first_property_name: (allow-none): the name of the first property, or %NULL if no
* properties
* @...: the value if the first property, followed by and other property
* value pairs, and ended by %NULL.
*
- * Helper function for constructing #GInitiable object. This is
+ * Helper function for constructing #GInitable object. This is
* similar to g_object_new() but also initializes the object
* and returns %NULL, setting an error on failure.
*
- * Return value: (transfer full): a newly allocated #GObject, or %NULL on error
+ * Returns: (type GObject.Object) (transfer full): a newly allocated
+ * #GObject, or %NULL on error
*
* Since: 2.22
*/
@@ -157,16 +155,17 @@ g_initable_new (GType object_type,
* g_initable_newv:
* @object_type: a #GType supporting #GInitable.
* @n_parameters: the number of parameters in @parameters
- * @parameters: the parameters to use to construct the object
+ * @parameters: (array length=n_parameters): the parameters to use to construct the object
* @cancellable: optional #GCancellable object, %NULL to ignore.
* @error: a #GError location to store the error occurring, or %NULL to
* ignore.
*
- * Helper function for constructing #GInitiable object. This is
+ * Helper function for constructing #GInitable object. This is
* similar to g_object_newv() but also initializes the object
* and returns %NULL, setting an error on failure.
*
- * Return value: (transfer full): a newly allocated #GObject, or %NULL on error
+ * Returns: (type GObject.Object) (transfer full): a newly allocated
+ * #GObject, or %NULL on error
*
* Since: 2.22
*/
@@ -202,11 +201,12 @@ g_initable_newv (GType object_type,
* @error: a #GError location to store the error occurring, or %NULL to
* ignore.
*
- * Helper function for constructing #GInitiable object. This is
+ * Helper function for constructing #GInitable object. This is
* similar to g_object_new_valist() but also initializes the object
* and returns %NULL, setting an error on failure.
*
- * Return value: (transfer full): a newly allocated #GObject, or %NULL on error
+ * Returns: (type GObject.Object) (transfer full): a newly allocated
+ * #GObject, or %NULL on error
*
* Since: 2.22
*/