[PATCH 2/3] doc: fix warnings about unknown links Signed-off-by: Brad Hards <address@hidden>

[Brad Hards]

---
 lib/src/callback.c |    8 ++++----
 lib/src/error.c    |    2 +-
 lib/src/mechname.c |    2 +-
 lib/src/obsolete.c |   24 ++++++++++++------------
 lib/src/property.c |    4 ++--
 lib/src/suggest.c  |    2 +-
 lib/src/version.c  |    6 +++---
 7 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/lib/src/callback.c b/lib/src/callback.c
index c9e7ea2..43f1801 100644
--- a/lib/src/callback.c
+++ b/lib/src/callback.c
@@ -48,7 +48,7 @@ gsasl_callback_set (Gsasl * ctx, Gsasl_callback_function cb)
 
 /**
  * gsasl_callback:
- * @ctx: handle received from gsasl_init(), may be %NULL to derive it
+ * @ctx: handle received from gsasl_init(), may be NULL to derive it
  *   from @sctx.
  * @sctx: session handle.
  * @prop: enumerated value of Gsasl_property type.
@@ -66,7 +66,7 @@ gsasl_callback_set (Gsasl * ctx, Gsasl_callback_function cb)
  * translate the old callback interface into the new.  This interface
  * should be sufficient to invoke all callbacks, both new and old.
  *
- * Return value: Returns whatever the application callback return, or
+ * Return value: Returns whatever the application callback returns, or
  *   %GSASL_NO_CALLBACK if no application was known.
  *
  * Since: 0.2.0
@@ -120,7 +120,7 @@ gsasl_callback_hook_set (Gsasl * ctx, void *hook)
  * is normally used by the application to maintain a global state
  * between the main program and callbacks.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Since: 0.2.0
  **/
@@ -160,7 +160,7 @@ gsasl_session_hook_set (Gsasl_session * sctx, void *hook)
  * is normally used by the application to maintain a per-session state
  * between the main program and callbacks.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Since: 0.2.14
  **/
diff --git a/lib/src/error.c b/lib/src/error.c
index 38b119e..6aeb4aa 100644
--- a/lib/src/error.c
+++ b/lib/src/error.c
@@ -251,7 +251,7 @@ gsasl_strerror (int err)
  * a successful call to gsasl_init().
  *
  * Return value: Returns a pointer to a statically allocated string
- *   containing a string version of the error code @err, or %NULL if
+ *   containing a string version of the error code @err, or NULL if
  *   the error code is not known.
  *
  * Since: 0.2.29
diff --git a/lib/src/mechname.c b/lib/src/mechname.c
index ff4f097..f00d49b 100644
--- a/lib/src/mechname.c
+++ b/lib/src/mechname.c
@@ -30,7 +30,7 @@
  * session.
  *
  * Return value: Returns a zero terminated character array with the
- *   name of the SASL mechanism, or %NULL if not known.
+ *   name of the SASL mechanism, or NULL if not known.
  *
  * Since: 0.2.28
  **/
diff --git a/lib/src/obsolete.c b/lib/src/obsolete.c
index c2dfefb..c5d0e8c 100644
--- a/lib/src/obsolete.c
+++ b/lib/src/obsolete.c
@@ -35,7 +35,7 @@
  *
  * Write SASL names, separated by space, of mechanisms supported by
  * the libgsasl client to the output array.  To find out how large the
- * output array must be, call this function with a %NULL @out
+ * output array must be, call this function with a NULL @out
  * parameter.
  *
  * Return value: Returns %GSASL_OK if successful, or error code.
@@ -78,7 +78,7 @@ gsasl_client_listmech (Gsasl * ctx, char *out, size_t * 
outlen)
  *
  * Write SASL names, separated by space, of mechanisms supported by
  * the libgsasl server to the output array.  To find out how large the
- * output array must be, call this function with a %NULL @out
+ * output array must be, call this function with a NULL @out
  * parameter.
  *
  * Return value: Returns %GSASL_OK if successful, or error code.
@@ -347,7 +347,7 @@ gsasl_client_application_data_set (Gsasl_session * sctx,
  * It is normally used by the application to maintain state between
  * the main program and the callback.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Deprecated: Use gsasl_callback_hook_get() or
  * gsasl_session_hook_get() instead.
@@ -404,7 +404,7 @@ gsasl_server_application_data_set (Gsasl_session * sctx,
  * It is normally used by the application to maintain state between
  * the main program and the callback.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Deprecated: Use gsasl_callback_hook_get() or
  * gsasl_session_hook_get() instead.
@@ -560,7 +560,7 @@ gsasl_application_data_set (Gsasl * ctx, void *appdata)
  * normally used by the application to maintain state between the main
  * program and the callback.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Deprecated: Use gsasl_callback_hook_get() instead.
  **/
@@ -598,7 +598,7 @@ gsasl_appinfo_set (Gsasl_session * sctx, void *appdata)
  * is normally used by the application to maintain state between the
  * main program and the callback.
  *
- * Return value: Returns the application specific data, or %NULL.
+ * Return value: Returns the application specific data, or NULL.
  *
  * Deprecated: Use gsasl_callback_hook_get() instead.
  **/
@@ -1547,7 +1547,7 @@ gsasl_server_callback_securid_get (Gsasl * ctx)
  *
  * Specify the callback function to use in the server for checking if
  * a GSSAPI user is authorized for username (by, e.g., calling
- * krb5_userok()).  The function should return GSASL_OK if the user
+ * krb5_kuserok).  The function should return GSASL_OK if the user
  * should be permitted access, or an error code such as
  * GSASL_AUTHENTICATION_ERROR on failure.  The function can be later
  * retrieved using gsasl_server_callback_gssapi_get().
@@ -1653,7 +1653,7 @@ gsasl_server_callback_service_get (Gsasl * ctx)
  * composed forms rather than a maximally decomposed form.
  *
  * Return value: Return a newly allocated string, that is the NFKC
- *   normalized form of @str, o %NULL on error.
+ *   normalized form of @str, or NULL on error.
  *
  * Deprecated: No replacement functionality in GNU SASL, use GNU
  * Libidn instead.  Note that in SASL, you most likely want to use
@@ -1675,7 +1675,7 @@ gsasl_stringprep_nfkc (const char *in, ssize_t len)
  * gsasl_stringprep_saslprep:
  * @in: input ASCII or UTF-8 string with data to prepare according to SASLprep.
  * @stringprep_rc: pointer to output variable with stringprep error code,
- *   or %NULL to indicate that you don't care about it.
+ *   or NULL to indicate that you don't care about it.
  *
  * Process a Unicode string for comparison, according to the
  * "SASLprep" stringprep profile.  This function is intended to be
@@ -1684,7 +1684,7 @@ gsasl_stringprep_nfkc (const char *in, ssize_t len)
  * protocols exchanging user names and/or passwords.
  *
  * Return value: Return a newly allocated string that is the
- *   "SASLprep" processed form of the input string, or %NULL on error,
+ *   "SASLprep" processed form of the input string, or NULL on error,
  *   in which case @stringprep_rc contain the stringprep library error
  *   code.
  *
@@ -1711,14 +1711,14 @@ gsasl_stringprep_saslprep (const char *in, int 
*stringprep_rc)
  * gsasl_stringprep_trace:
  * @in: input ASCII or UTF-8 string with data to prepare according to "trace".
  * @stringprep_rc: pointer to output variable with stringprep error code,
- *   or %NULL to indicate that you don't care about it.
+ *   or NULL to indicate that you don't care about it.
  *
  * Process a Unicode string for use as trace information, according to
  * the "trace" stringprep profile.  The profile is designed for use
  * with the SASL ANONYMOUS Mechanism.
  *
  * Return value: Return a newly allocated string that is the "trace"
- *   processed form of the input string, or %NULL on error, in which
+ *   processed form of the input string, or NULL on error, in which
  *   case @stringprep_rc contain the stringprep library error code.
  *
  * Deprecated: No replacement functionality in GNU SASL, use GNU
diff --git a/lib/src/property.c b/lib/src/property.c
index 4342a19..6a31646 100644
--- a/lib/src/property.c
+++ b/lib/src/property.c
@@ -189,7 +189,7 @@ gsasl_property_set_raw (Gsasl_session * sctx, 
Gsasl_property prop,
  *
  * This function will not invoke the application callback.
  *
- * Return value: Return property value, if known, or %NULL if no value
+ * Return value: Return property value, if known, or NULL if no value
  *   known.
  *
  * Since: 0.2.0
@@ -227,7 +227,7 @@ gsasl_property_fast (Gsasl_session * sctx, Gsasl_property 
prop)
  * 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.
+ * Return value: Return data for property, or NULL if no value known.
  *
  * Since: 0.2.0
  **/
diff --git a/lib/src/suggest.c b/lib/src/suggest.c
index cb19253..46c9dc1 100644
--- a/lib/src/suggest.c
+++ b/lib/src/suggest.c
@@ -32,7 +32,7 @@
  *
  * Return value: Returns name of "best" SASL mechanism supported by
  *   the libgsasl client which is present in the input string, or
- *   %NULL if no supported mechanism is found.
+ *   NULL if no supported mechanism is found.
  **/
 const char *
 gsasl_client_suggest_mechanism (Gsasl * ctx, const char *mechlist)
diff --git a/lib/src/version.c b/lib/src/version.c
index ed932eb..7c7a721 100644
--- a/lib/src/version.c
+++ b/lib/src/version.c
@@ -26,7 +26,7 @@
 
 /**
  * gsasl_check_version:
- * @req_version: version string to compare with, or %NULL.
+ * @req_version: version string to compare with, or NULL.
  *
  * Check GNU SASL Library version.
  *
@@ -37,8 +37,8 @@
  *
  * Return value: Check that the version of the library is at
  *   minimum the one given as a string in @req_version and return the
- *   actual version string of the library; return %NULL if the
- *   condition is not met.  If %NULL is passed to this function no
+ *   actual version string of the library; return NULL if the
+ *   condition is not met.  If NULL is passed to this function no
  *   check is done and only the version string is returned.
  **/
 const char *
-- 
1.7.4.1