diff options
author | Zhanna Tsitkov <tsitkova@mit.edu> | 2013-01-11 15:40:28 -0500 |
---|---|---|
committer | Zhanna Tsitkov <tsitkova@mit.edu> | 2013-01-11 15:57:51 -0500 |
commit | 4382911e52c37f0b7efd3664505a9c7263c9d79a (patch) | |
tree | e0efc0c574e76993ba9605e8cedddc8b4f649c7c | |
parent | c3b99c255445975eeea4b93d2fa93edc449e0d87 (diff) | |
download | krb5-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.hin | 44 |
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) * |