[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
CVS gsasl/lib/src
From: |
gsasl-commit |
Subject: |
CVS gsasl/lib/src |
Date: |
Sun, 07 Nov 2004 17:15:35 +0100 |
Update of /home/cvs/gsasl/lib/src
In directory dopio:/tmp/cvs-serv9039
Modified Files:
property.c
Log Message:
Doc fix.
--- /home/cvs/gsasl/lib/src/property.c 2004/10/31 19:48:22 1.17
+++ /home/cvs/gsasl/lib/src/property.c 2004/11/07 16:15:35 1.18
@@ -86,9 +86,10 @@
* @data: zero terminated character string to store.
*
* Make a copy of @data and store it in the session handle for the
- * indicated property @prop. You can immediately deallocate @data
- * after calling this function, without affecting the data stored in
- * the session handle.
+ * indicated property @prop.
+ *
+ * You can immediately deallocate @data after calling this function,
+ * without affecting the data stored in the session handle.
*
* Since: 0.2.0
**/
@@ -108,8 +109,9 @@
* @len: length of character string to store.
*
* Make a copy of @len sized @data and store a zero terminated version
- * of it in the session handle for the indicated property @prop. You
- * can immediately deallocate @data after calling this function,
+ * of it in the session handle for the indicated property @prop.
+ *
+ * You can immediately deallocate @data after calling this function,
* without affecting the data stored in the session handle.
*
* Except for the length indicator, this function is identical to
@@ -145,13 +147,15 @@
* type of data in @data.
*
* Retrieve the data stored in the session handle for given property
- * @prop. The pointer is to live data, and must not be deallocated or
+ * @prop.
+ *
+ * The pointer is to live data, and must not be deallocated or
* modified in any way.
*
- * This function will not invoke the application callback if a value
- * is not already known.
+ * This function will not invoke the application callback.
*
- * Return value: Return data for property, or NULL if no value known.
+ * Return value: Return property value, if known, or %NULL if no value
+ * known.
*
* Since: 0.2.0
**/
@@ -174,18 +178,19 @@
*
* Retrieve the data stored in the session handle for given property
* @prop, possibly invoking the application callback to get the value.
+ *
* The pointer is to live data, and must not be deallocated or
* modified in any way.
*
* This function will invoke the application callback, using
- * gsasl_callback(), if a value is not already known.
+ * gsasl_callback(), when a property value is not known.
*
* If no value is known, and no callback is specified or if the
- * callback fail to return data, and if the obsolete callback
- * interface has been used by the application, this function will
- * translate the old callback interface into the new. This interface
- * should be sufficient to get data from all callbacks, both new and
- * old.
+ * callback fail to return data, and if any obsolete callback
+ * functions has been set by the application, this function will try
+ * to call these obsolete callbacks, and store the returned data as
+ * the corresponding property. This behaviour of this function will
+ * be removed when the obsolete callback interfaces are removed.
*
* Return value: Return data for property, or NULL if no value known.
*
- CVS gsasl/lib/src,
gsasl-commit <=
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/18
- CVS gsasl/lib/src, gsasl-commit, 2004/11/26
- CVS gsasl/lib/src, gsasl-commit, 2004/11/26