*/
/**
- * @file digest.h
+ * @file yaca_digest.h
* @brief
*/
*
* @since_tizen 3.0
*
- * @param[out] ctx Newly created context (must be freed with yaca_ctx_free()).
- * @param[in] algo Digest algorithm that will be used.
+ * @param[out] ctx Newly created context (must be freed with yaca_ctx_free())
+ * @param[in] algo Digest algorithm that will be used
*
- * @return YACA_ERROR_NONE on success, negative on error.
+ * @return #YACA_ERROR_NONE on success, negative on error
+ * @retval #YACA_ERROR_NONE Succesful
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
+ * incorrect algo)
+ * @retval #YACA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #YACA_ERROR_INTERNAL Internal error
*
* @see #yaca_digest_algo_e
* @see yaca_digest_update()
*
* @since_tizen 3.0
*
- * @param[in,out] ctx Context created by yaca_digest_init().
- * @param[in] data Data from which the digest is to be calculated.
- * @param[in] data_len Length of the data.
+ * @param[in,out] ctx Context created by yaca_digest_init()
+ * @param[in] data Data from which the digest is to be calculated
+ * @param[in] data_len Length of the data
*
- * @return YACA_ERROR_NONE on success, negative on error.
+ * @return #YACA_ERROR_NONE on success, negative on error
+ * @retval #YACA_ERROR_NONE Succesful
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL, 0,
+ * incorrect context)
+ * @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_digest_init()
* @see yaca_digest_final()
*
* @since_tizen 3.0
*
- * @param[in,out] ctx A valid digest context.
- * @param[out] digest Buffer for the message digest (must be allocated by client,
- * see yaca_get_digest_length()).
- * @param[out] digest_len Length of the digest, actual number of bytes written will be returned here.
- *
- * @return YACA_ERROR_NONE on success, negative on error.
+ * @param[in,out] ctx A valid digest context
+ * @param[out] digest Buffer for the message digest
+ * (must be allocated by client, see yaca_get_digest_length())
+ * @param[out] digest_len Length of the digest,
+ * actual number of bytes written will be returned here
+ *
+ * @return #YACA_ERROR_NONE on success, negative on error
+ * @retval #YACA_ERROR_NONE Succesful
+ * @retval #YACA_ERROR_INVALID_ARGUMENT Required parameters have bogus values (NULL,
+ * incorrect context)
+ * @retval #YACA_ERROR_INTERNAL Internal error
*
* @see yaca_digest_init()
* @see yaca_digest_update()