summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZhanna Tsitkov <tsitkova@mit.edu>2013-01-11 15:40:28 -0500
committerZhanna Tsitkov <tsitkova@mit.edu>2013-01-11 15:57:51 -0500
commit4382911e52c37f0b7efd3664505a9c7263c9d79a (patch)
treee0efc0c574e76993ba9605e8cedddc8b4f649c7c
parentc3b99c255445975eeea4b93d2fa93edc449e0d87 (diff)
downloadkrb5-4382911e52c37f0b7efd3664505a9c7263c9d79a.tar.gz
krb5-4382911e52c37f0b7efd3664505a9c7263c9d79a.tar.xz
krb5-4382911e52c37f0b7efd3664505a9c7263c9d79a.zip
Better doxygen markup for RESPONDER_QUESTION_OTP
Doxygen and, consequently, Sphinx gets confused with the KRB5_RESPONDER_QUESTION_OTP comment layout. Also, mark the output parameter of krb5_responder_set_answer().
-rw-r--r--src/include/krb5/krb5.hin44
1 files changed, 23 insertions, 21 deletions
diff --git a/src/include/krb5/krb5.hin b/src/include/krb5/krb5.hin
index 68ae8887d2..8f8ef7eee4 100644
--- a/src/include/krb5/krb5.hin
+++ b/src/include/krb5/krb5.hin
@@ -6380,28 +6380,30 @@ krb5_prompter_posix(krb5_context context, void *data, const char *name,
* The OTP responder question is asked when the KDC indicates that an OTP
* value is required in order to complete the authentication. The JSON format
* of the challenge is:
- * {
- * "service": <string (optional)>,
- * "tokenInfo": [
- * {
- * "flags": <number>,
- * "vendor": <string (optional)>,
- * "challenge": <string (optional)>,
- * "length": <number (optional)>,
- * "format": <number (optional)>,
- * "tokenID": <string (optional)>,
- * "algID": <string (optional)>,
- * },
- * ...
- * ]
- * }
+ *
+ * @n {
+ * @n "service": <string (optional)>,
+ * @n "tokenInfo": [
+ * @n {
+ * @n "flags": <number>,
+ * @n "vendor": <string (optional)>,
+ * @n "challenge": <string (optional)>,
+ * @n "length": <number (optional)>,
+ * @n "format": <number (optional)>,
+ * @n "tokenID": <string (optional)>,
+ * @n "algID": <string (optional)>,
+ * @n },
+ * @n ...
+ * @n ]
+ * @n }
*
* The answer to the question MUST be JSON formatted:
- * {
- * "tokeninfo": <number>,
- * "value": <string (optional)>,
- * "pin": <string (optional)>,
- * }
+ *
+ * @n {
+ * @n "tokeninfo": <number>,
+ * @n "value": <string (optional)>,
+ * @n "pin": <string (optional)>,
+ * @n }
*
* For more detail, please see RFC 6560.
*
@@ -6472,7 +6474,7 @@ krb5_responder_get_challenge(krb5_context ctx, krb5_responder_context rctx,
* Answer a named question in the responder context.
*
* @param [in] ctx Library context
- * @param [in] rctx Responder context
+ * @param [in,out] rctx Responder context
* @param [in] question Question name
* @param [in] answer The string to set (MUST be printable UTF-8)
*