fix api document error

Change-Id: I5acf1d9f13fb7b540b764db5a5f778e95235cd4c
Signed-off-by: jkjo92 <jkjo92@samsung.com>

diff --git a/include/oauth2.h b/include/oauth2.h
old mode 100644 (file)
new mode 100755 (executable)
index 9b90eb8..cb7429d
--- a/include/oauth2.h
+++ b/include/oauth2.h
@@ -18,15 +18,19 @@
 #ifndef _OAUTH2_H_
 #define _OAUTH2_H_
 
-#include "oauth2_manager.h"
-#include "oauth2_request.h"
-#include "oauth2_response.h"
-#include "oauth2_error.h"
-#include "oauth2_types.h"
+#include <oauth2_manager.h>
+#include <oauth2_request.h>
+#include <oauth2_response.h>
+#include <oauth2_error.h>
+#include <oauth2_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * Tizen OAuth 2.0 Authorization Framework.
- * Refer to http://tools.ietf.org/html/rfc6749 about OAuth 2.0. Also service provider document needs to be referred for using end points and additional parameters.
+ * Refer to <a href="http://tools.ietf.org/html/rfc6749">rfc6749</a> about OAuth 2.0. Also service provider document needs to be referred for using end points and additional parameters.
  */
 
 /**
@@ -34,9 +38,12 @@
  * @{
  */
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif // _OAUTH2_H_

diff --git a/include/oauth2_error.h b/include/oauth2_error.h
index c4d4563c91186c6ccea5ad4f567dfdb8066e57e7..c547fcc54df2480bf8848ff01d89ed5fb8a2b8ca 100755 (executable)
--- a/include/oauth2_error.h
+++ b/include/oauth2_error.h
@@ -18,9 +18,13 @@
 #ifndef OAUTH2_ERROR_H_
 #define OAUTH2_ERROR_H_
 
-#include "oauth2_types.h"
-#include <bundle.h>
 #include <tizen_error.h>
+#include <bundle.h>
+#include <oauth2_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * @file oauth2_error.h
@@ -36,19 +40,17 @@
 /**
  * @brief The structure type for OAuth 2.0 Error handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
-
  */
 typedef struct oauth2_error_s *oauth2_error_h;
 
 /**
  * @brief Gets error code.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free server_error_code and platform_error_code
- * @param[in] handle The error handle.
- * @param [out] server_error_code Error code (if any) returned by the server.
- * @param [out] platform_error_code Tizen platform related error code (if any), value is of type oauth2_error_e
+ * @remarks You must not release @a server_error_code and @a platform_error_code using free().
+ * @param[in] handle The error handle
+ * @param[out] server_error_code Error code (if any) returned by the server
+ * @param[out] platform_error_code Tizen platform related error code (if any), value is of type #oauth2_error_e
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -62,11 +64,10 @@ OAUTH2_API int oauth2_error_get_code(oauth2_error_h handle, int *server_error_co
 /**
  * @brief Gets error description.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free description
- * @param[in] handle The error handle.
- * @param[out] description The Error description.
+ * @remarks You must not release @a description using free().
+ * @param[in] handle The error handle
+ * @param[out] description The Error description
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -80,11 +81,10 @@ OAUTH2_API int oauth2_error_get_description(oauth2_error_h handle, char **descri
 /**
  * @brief Gets error uri.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free uri
- * @param[in] handle The error handle.
- * @param[out] uri The Error URI.
+ * @remarks You must not release @a uri using free().
+ * @param[in] handle The error handle
+ * @param[out] uri The Error URI
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -98,12 +98,11 @@ OAUTH2_API int oauth2_error_get_uri(oauth2_error_h handle, char **uri);
 /**
  * @brief Gets the custom data.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free custom_value
- * @param[in] handle The error handle.
- * @param[in] custom_key The custom key.
- * @param[out] custom_value The custom value.
+ * @remarks You must not release @a custom_value using free().
+ * @param[in] handle The error handle
+ * @param[in] custom_key The custom key
+ * @param[out] custom_value The custom value
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -114,9 +113,12 @@ OAUTH2_API int oauth2_error_get_uri(oauth2_error_h handle, char **uri);
  */
 OAUTH2_API int oauth2_error_get_custom_data(oauth2_error_h handle, const char *custom_key, char **custom_value);
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* OAUTH2_ERROR_H_ */

diff --git a/include/oauth2_manager.h b/include/oauth2_manager.h
index c796ddb7479e74730f10b3f60d87b929387faded..ba0240cfbf2a6a61ac4500788b42e61375d1ec35 100755 (executable)
--- a/include/oauth2_manager.h
+++ b/include/oauth2_manager.h
@@ -20,10 +20,14 @@
 
 #include <stdbool.h>
 
-#include "oauth2_request.h"
-#include "oauth2_response.h"
-#include "oauth2_error.h"
-#include "oauth2_types.h"
+#include <oauth2_request.h>
+#include <oauth2_response.h>
+#include <oauth2_error.h>
+#include <oauth2_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * @file oauth2_manager.h
@@ -49,9 +53,8 @@ typedef struct oauth2_manager_s *oauth2_manager_h;
 
 /**
  * @brief Creates oauth2_manager_h handle.
- * @remarks It must be freed using oauth2_manager_destroy().
+ * @remarks The @a handle must be released using oauth2_manager_destroy().
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
  * @param[out]  handle  The created handle
  * @return     @c 0 on success,
@@ -67,9 +70,8 @@ OAUTH2_API int oauth2_manager_create(oauth2_manager_h *handle);
 /**
  * @brief Destroys oauth2_manager_h handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The oauth2_manager handle.
+ * @param[in] handle The oauth2 manager handle
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -81,9 +83,10 @@ OAUTH2_API int oauth2_manager_destroy(oauth2_manager_h handle);
 /**
  * @brief Called when the oauth2_manager_request_token() resopnse comes.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @remarks The @a response must be released using oauth2_response_destroy().
  *
- * param[in] response The response. The response must be released using oauth2_response_destroy().
- * param[in] user_data The user data passed from the callback function.
+ * @param[in] response The response
+ * @param[in] user_data The user data passed from the callback function
  *
  * @pre oauth2_manager_request_token() must be called to get this callback invoked.
  * @see oauth2_manager_request_token()
@@ -93,16 +96,18 @@ typedef void (*oauth2_token_cb)(oauth2_response_h response, void *user_data);
 /**
  * @brief Request OAuth 2.0 access token.
  * @details The response is delivered via oauth2_token_cb().
- * "internet" privilege is required to call this API. Note, only one pending request is allowed.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
+ * @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed.
  *
- * @param[in] handle   The oauth2_manager_handle.
+ * @param[in] handle   The oauth2 manager handle.
  * @param[in] request  The request handle.
  * @param[in] callback The callback to receive response.
- * @param[in]  user_data  The user data to be passed to the callback function.
+ * @param[in] user_data  The user data to be passed to the callback function.
  *
+ * @return     @c 0 on success,
+ *             otherwise a negative error value
  * @retval     #OAUTH2_ERROR_NONE               Successful
  * @retval     #OAUTH2_ERROR_OUT_OF_MEMORY Out of memory.
  * @retval     #OAUTH2_ERROR_INVALID_PARAMETER Invalid input parameter(s) passed.
@@ -123,8 +128,8 @@ OAUTH2_API int oauth2_manager_request_token(oauth2_manager_h handle, oauth2_requ
  * @brief Called when oauth2_manager_request_authorization_grant() response comes.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @param[in] response The response. The response must be released using oauth2_response_destroy().
- * param[in] user_data The user data passed from the callback function.
+ * @param[in] response The response. The @a response must be released using oauth2_response_destroy().
+ * @param[in] user_data The user data passed from the callback function.
  *
  * @pre oauth2_manager_request_authorization_grant() must be called to get this callback invoked.
  * @see oauth2_manager_request_authorization_grant()
@@ -134,16 +139,18 @@ typedef void (*oauth2_auth_grant_cb)(oauth2_response_h response, void *user_data
 /**
  * @brief Request authorization grant.
  * @details The response is delivered via oauth2_auth_grant_cb().
- * "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
+ * @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  *
  * @param[in] handle   The oauth2_manager handle.
  * @param[in] request  The request handle.
  * @param[in] callback The application callback.
- * @param[in]  user_data  The user data to be passed to the callback function.
+ * @param[in] user_data  The user data to be passed to the callback function.
  *
+ * @return     @c 0 on success,
+ *             otherwise a negative error value
  * @retval     #OAUTH2_ERROR_NONE               Successful
  * @retval     #OAUTH2_ERROR_OUT_OF_MEMORY Out of memory.
  * @retval     #OAUTH2_ERROR_INVALID_PARAMETER Invalid input parameter(s) passed.
@@ -165,7 +172,7 @@ OAUTH2_API int oauth2_manager_request_authorization_grant(oauth2_manager_h handl
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  * @param[in] response The response. The response must be released using oauth2_response_destroy().
- * param[in] user_data The user data passed from the callback function.
+ * @param[in] user_data The user data passed from the callback function.
  *
  * @pre oauth2_manager_request_access_token() must be called to get this callback invoked.
  * @see oauth2_manager_request_access_token()
@@ -175,16 +182,18 @@ typedef void (*oauth2_access_token_cb)(oauth2_response_h response, void *user_da
 /**
  * @brief Requests an access token.
  * @details The response is delivered via oauth2_access_token_cb() callback.
- * "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
+ * @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  *
  * @param[in] handle   The oauth2_manager handle.
  * @param[in] request  The request handle.
  * @param[in] callback The application callback.
- * @param[in]  user_data  The user data to be passed to the callback function.
+ * @param[in] user_data  The user data to be passed to the callback function.
  *
+ * @return     @c 0 on success,
+ *             otherwise a negative error value
  * @retval     #OAUTH2_ERROR_NONE               Successful
  * @retval     #OAUTH2_ERROR_OUT_OF_MEMORY Out of memory.
  * @retval     #OAUTH2_ERROR_INVALID_PARAMETER Invalid input parameter(s) passed.
@@ -205,8 +214,8 @@ OAUTH2_API int oauth2_manager_request_access_token(oauth2_manager_h handle, oaut
  * @brief Called when oauth2_manager_refresh_access_token() response comes.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @param[in] response The response. The response must be released using oauth2_response_destroy().
- * param[in] user_data The user data passed from the callback function.
+ * @param[in] response The response. The @a response must be released using oauth2_response_destroy().
+ * @param[in] user_data The user data passed from the callback function.
  *
  * @pre oauth2_manager_refresh_access_token() must be called to get this callback invoked.
  * @see oauth2_manager_refresh_access_token().
@@ -216,16 +225,18 @@ typedef void (*oauth2_refresh_token_cb)(oauth2_response_h response, void *user_d
 /**
  * @brief Requests a refresh token.
  * @details The response is delivered via oauth2_refresh_token_cb() callback.
- * "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
+ * @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
  *
- * @param[in] handle   The oauth2_manager handle.
+ * @param[in] handle   The oauth2 manager handle.
  * @param[in] request  The request handle.
  * @param[in] callback The application callback.
  * @param[in]  user_data  The user data to be passed to the callback function.
  *
+ * @return     @c 0 on success,
+ *             otherwise a negative error value
  * @retval     #OAUTH2_ERROR_NONE               Successful
  * @retval     #OAUTH2_ERROR_OUT_OF_MEMORY Out of memory.
  * @retval     #OAUTH2_ERROR_INVALID_PARAMETER Invalid input parameter(s) passed.
@@ -246,7 +257,7 @@ OAUTH2_API int oauth2_manager_refresh_access_token(oauth2_manager_h handle, oaut
  * @brief Returns whether oauth2_manager related request is pending.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
- * @param[in] handle The auth2_manager handle.
+ * @param[in] handle The auth2 manager handle.
  * @retval     false No pending request
  * @retval     true There is pending request.
  */
@@ -258,7 +269,7 @@ OAUTH2_API bool oauth2_manager_is_request_in_progress(oauth2_manager_h handle);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
  *
- * @param[in] handle The oauth2_manager handle.
+ * @param[in] handle The oauth2 manager handle.
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -276,7 +287,7 @@ OAUTH2_API int oauth2_manager_clear_cookies(oauth2_manager_h handle);
  * @privlevel public
  * @privilege %http://tizen.org/privilege/internet
  *
- * @param[in] handle The oauth2_manager handle.
+ * @param[in] handle The oauth2 manager handle.
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -288,9 +299,12 @@ OAUTH2_API int oauth2_manager_clear_cookies(oauth2_manager_h handle);
  */
 OAUTH2_API int oauth2_manager_clear_cache(oauth2_manager_h handle);
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* OAUTH2_MANAGER_H_ */

diff --git a/include/oauth2_request.h b/include/oauth2_request.h
index b0131b091e079a5697619f1e641609be87b0785f..719114c082bd1dedad733aa145e71816458e7a90 100755 (executable)
--- a/include/oauth2_request.h
+++ b/include/oauth2_request.h
@@ -20,7 +20,11 @@
 
 #include <bundle.h>
 #include <curl/curl.h>
-#include "oauth2_types.h"
+#include <oauth2_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * @file oauth2_request.h
@@ -43,9 +47,8 @@ typedef struct oauth2_request_s *oauth2_request_h;
  * @brief Creates oauth2_request_h handle.
  * @details The handle must be freed via oauth2_request_destroy().
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[out] handle The created oauth2_request handle, else NULL for error cases.
+ * @param[out] handle The created oauth2_request handle, else NULL for error cases
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -58,9 +61,8 @@ OAUTH2_API int oauth2_request_create(oauth2_request_h *handle);
 /**
  * @brief Destroys oauth2_request_h handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The oauth2_request handle to destory.
+ * @param[in] handle The oauth2_request handle to destory
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -72,10 +74,9 @@ OAUTH2_API int oauth2_request_destroy(oauth2_request_h handle);
 /**
  * @brief Sets authorization end point URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] url The url.
+ * @param[in] handle The request handle
+ * @param[in] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -88,10 +89,9 @@ OAUTH2_API int oauth2_request_set_auth_end_point_url(oauth2_request_h handle, co
 /**
  * @brief Sets access token end point URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] url The url.
+ * @param[in] handle The request handle
+ * @param[in] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -104,10 +104,9 @@ OAUTH2_API int oauth2_request_set_token_end_point_url(oauth2_request_h handle, c
 /**
  * @brief Sets redirection URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] url The url.
+ * @param[in] handle The request handle
+ * @param[in] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -120,10 +119,9 @@ OAUTH2_API int oauth2_request_set_redirection_url(oauth2_request_h handle, const
 /**
  * @brief Sets refresh token end point URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] url The url.
+ * @param[in] handle The request handle
+ * @param[in] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -136,10 +134,9 @@ OAUTH2_API int oauth2_request_set_refresh_token_url(oauth2_request_h handle, con
 /**
  * @brief Sets refresh token. Used mostly while using oauth2_manager_refresh_access_token().
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] refresh_token The refresh token string.
+ * @param[in] handle The request handle
+ * @param[in] refresh_token The refresh token string
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -152,10 +149,9 @@ OAUTH2_API int oauth2_request_set_refresh_token(oauth2_request_h handle, char *r
 /**
  * @brief Sets response type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] response_type The response type.
+ * @param[in] handle The request handle
+ * @param[in] response_type The response type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -168,10 +164,9 @@ OAUTH2_API int oauth2_request_set_response_type(oauth2_request_h handle, oauth2_
 /**
  * @brief Sets client id.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] client_id The client id.
+ * @param[in] handle The request handle
+ * @param[in] client_id The client id
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -184,10 +179,9 @@ OAUTH2_API int oauth2_request_set_client_id(oauth2_request_h handle, const char
 /**
  * @brief Sets client secret.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] client_secret The secret.
+ * @param[in] handle The request handle
+ * @param[in] client_secret The secret
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -200,29 +194,27 @@ OAUTH2_API int oauth2_request_set_client_secret(oauth2_request_h handle, const c
 /**
  * @brief Sets client authentication type. Default is OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] client_auth_type The client authentication type.
+ * @remarks Facebook and Google does not support HTTP Basic Authentication, instead they require client credentials to be sent via request body.\n
+ * So application must set #OAUTH2_CLIENT_AUTHENTICATION_TYPE_REQUEST_BODY for them.
+ *
+ * @param[in] handle The request handle
+ * @param[in] client_auth_type The client authentication type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
  * @retval     #OAUTH2_ERROR_NONE               Successful
  * @retval     #OAUTH2_ERROR_OUT_OF_MEMORY      Out of Memory
  * @retval     #OAUTH2_ERROR_INVALID_PARAMETER  Invalid parameter
- *
- * @remarks Facebook and Google does not support HTTP Basic Authentication, instead they require client credentials to be sent via request body.\n
- * So application must set OAUTH2_CLIENT_AUTHENTICATION_TYPE_REQUEST_BODY for them.
  */
 OAUTH2_API int oauth2_request_set_client_authentication_type(oauth2_request_h handle, oauth2_client_authentication_type_e client_auth_type);
 
 /**
  * @brief Sets scope.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] scope The scope.
+ * @param[in] handle The request handle
+ * @param[in] scope The scope
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -235,10 +227,9 @@ OAUTH2_API int oauth2_request_set_scope(oauth2_request_h handle, const char *sco
 /**
  * @brief Sets state.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] state The state.
+ * @param[in] handle The request handle
+ * @param[in] state The state
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -251,10 +242,9 @@ OAUTH2_API int oauth2_request_set_state(oauth2_request_h handle, const char *sta
 /**
  * @brief Sets grant type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] grant_type The grant type.
+ * @param[in] handle The request handle
+ * @param[in] grant_type The grant type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -267,10 +257,9 @@ OAUTH2_API int oauth2_request_set_grant_type(oauth2_request_h handle, oauth2_gra
 /**
  * @brief Sets authorization code.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] code The authorization code.
+ * @param[in] handle The request handle
+ * @param[in] code The authorization code
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -285,10 +274,9 @@ OAUTH2_API int oauth2_request_set_authorization_code(oauth2_request_h handle, co
 /**
  * @brief Sets user name.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] user_name The user name.
+ * @param[in] handle The request handle
+ * @param[in] user_name The user name
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -301,10 +289,9 @@ OAUTH2_API int oauth2_request_set_user_name(oauth2_request_h handle, const char
 /**
  * @brief Sets password.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] password The password.
+ * @param[in] handle The request handle
+ * @param[in] password The password
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -317,11 +304,10 @@ OAUTH2_API int oauth2_request_set_password(oauth2_request_h handle, const char *
 /**
  * @brief Adds custom key-value pair to the request.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The request handle.
- * @param[in] key The key.
- * @param[in] value The value.
+ * @param[in] handle The request handle
+ * @param[in] key The key
+ * @param[in] value The value
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -336,11 +322,10 @@ OAUTH2_API int oauth2_request_add_custom_data(oauth2_request_h handle, const cha
 /**
  * @brief Gets authorization end point URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free url
- * @param[in] handle The request handle.
- * @param[out] url The url.
+ * @remarks You must not release @a url using free().
+ * @param[in] handle The request handle
+ * @param[out] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -354,11 +339,10 @@ OAUTH2_API int oauth2_request_get_auth_end_point_url(oauth2_request_h handle, ch
 /**
  * @brief Gets access token end point URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free url
- * @param[in] handle The request handle.
- * @param[out] url The url.
+ * @remarks You must not release @a url using free().
+ * @param[in] handle The request handle
+ * @param[out] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -372,11 +356,10 @@ OAUTH2_API int oauth2_request_get_token_end_point_url(oauth2_request_h handle, c
 /**
  * @brief Gets redirection URL.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free url
- * @param[in] handle The request handle.
- * @param[out] url The url.
+ * @remarks You must not release @a url using free().
+ * @param[in] handle The request handle
+ * @param[out] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -392,9 +375,9 @@ OAUTH2_API int oauth2_request_get_redirection_url(oauth2_request_h handle, char
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @privlevel public
  *
- * @remarks            You must not free url
- * @param[in] handle The request handle.
- * @param[out] url The url.
+ * @remarks You must not release @a url using free().
+ * @param[in] handle The request handle
+ * @param[out] url The url
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -408,11 +391,10 @@ OAUTH2_API int oauth2_request_get_refresh_token_url(oauth2_request_h handle, cha
 /**
  * @brief Gets refresh token.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free refresh_token
- * @param[in] handle The request handle.
- * @param[out] refresh_token The refresh token.
+ * @remarks You must not release @a refresh_token using free().
+ * @param[in] handle The request handle
+ * @param[out] refresh_token The refresh token
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -426,11 +408,10 @@ OAUTH2_API int oauth2_request_get_refresh_token(oauth2_request_h handle, char **
 /**
  * @brief Gets response type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
  * @remarks            You must not free response_type
- * @param[in] handle The request handle.
- * @param[out] response_type The respose type.
+ * @param[in] handle The request handle
+ * @param[out] response_type The respose type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -444,11 +425,10 @@ OAUTH2_API int oauth2_request_get_response_type(oauth2_request_h handle, oauth2_
 /**
  * @brief Gets client id.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free client_id
- * @param[in] handle The request handle.
- * @param[out] client_id The client id.
+ * @remarks You must not release @a client_id using free().
+ * @param[in] handle The request handle
+ * @param[out] client_id The client id
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -462,11 +442,10 @@ OAUTH2_API int oauth2_request_get_client_id(oauth2_request_h handle, char **clie
 /**
  * @brief Gets client secret.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free client_secret
- * @param[in] handle The request handle.
- * @param[out] client_secret The client_secret.
+ * @remarks You must not release @a client_secret using free().
+ * @param[in] handle The request handle
+ * @param[out] client_secret The client_secret
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -480,11 +459,10 @@ OAUTH2_API int oauth2_request_get_client_secret(oauth2_request_h handle, char **
 /**
  * @brief Gets scope.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free scope
- * @param[in] handle The request handle.
- * @param[out] scope The scope.
+ * @remarks You must not release @a scope using free().
+ * @param[in] handle The request handle
+ * @param[out] scope The scope
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -498,11 +476,10 @@ OAUTH2_API int oauth2_request_get_scope(oauth2_request_h handle, char **scope);
 /**
  * @brief Gets state.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free state
- * @param[in] handle The request handle.
- * @param[out] state The state.
+ * @remarks You must not release @a state using free().
+ * @param[in] handle The request handle
+ * @param[out] state The state
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -516,11 +493,10 @@ OAUTH2_API int oauth2_request_get_state(oauth2_request_h handle, char **state);
 /**
  * @brief Gets grant type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free grant_type
- * @param[in] handle The request handle.
- * @param[out] grant_type The grant type.
+ * @remarks You must not release @a grant_type using free().
+ * @param[in] handle The request handle
+ * @param[out] grant_type The grant type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -534,9 +510,8 @@ OAUTH2_API int oauth2_request_get_grant_type(oauth2_request_h handle, oauth2_gra
 /**
  * @brief Gets authorization code.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free code
+ * @remarks You must not release @a code using free().
  * @param[in] handle The request handle.
  * @param[out] code The code.
  *
@@ -552,11 +527,10 @@ OAUTH2_API int oauth2_request_get_authorization_code(oauth2_request_h handle, ch
 /**
  * @brief Gets user name.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free user_name
- * @param[in] handle The request handle.
- * @param[out] user_name The user name.
+ * @remarks You must not release @a user_name using free().
+ * @param[in] handle The request handle
+ * @param[out] user_name The user name
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -570,11 +544,10 @@ OAUTH2_API int oauth2_request_get_user_name(oauth2_request_h handle, char **user
 /**
  * @brief Gets password.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free password
- * @param[in] handle The request handle.
- * @param[out] password The password.
+ * @remarks You must not release @a password using free().
+ * @param[in] handle The request handle
+ * @param[out] password The password
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -588,12 +561,11 @@ OAUTH2_API int oauth2_request_get_password(oauth2_request_h handle, char **passw
 /**
  * @brief Gets the custom value.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free custom_value
- * @param[in] handle The request handle.
- * @param[in] custom_key The custom key.
- * @param[out] custom_value The custom value.
+ * @remarks You must not release @a custom_value using free().
+ * @param[in] handle The request handle
+ * @param[in] custom_key The custom key
+ * @param[out] custom_value The custom value
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -604,9 +576,12 @@ OAUTH2_API int oauth2_request_get_password(oauth2_request_h handle, char **passw
  */
 OAUTH2_API int oauth2_request_get_custom_data(oauth2_request_h handle, const char *custom_key, char **custom_value);
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* OAUTH2_REQUEST_H_ */

diff --git a/include/oauth2_response.h b/include/oauth2_response.h
index d51df7de3f39315b3995fb1bb3328be16f55f6c0..c1ac206ece160848d91befd268e2f4e484673308 100755 (executable)
--- a/include/oauth2_response.h
+++ b/include/oauth2_response.h
@@ -19,8 +19,12 @@
 #define OAUTH2_RESPONSE_H_
 
 #include <bundle.h>
-#include "oauth2_types.h"
-#include "oauth2_error.h"
+#include <oauth2_types.h>
+#include <oauth2_error.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 /**
  * @file oauth2_response.h
@@ -40,11 +44,10 @@
 typedef struct oauth2_response_s *oauth2_response_h;
 
 /**
- * @brief Destroys the received oauth2_response_h handle.
+ * @brief Destroys the received handle.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @param[in] handle The response handle.
+ * @param[in] handle The response handle
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -56,10 +59,9 @@ OAUTH2_API int oauth2_response_destroy(oauth2_response_h handle);
 /**
  * @brief Gets the authorization code.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free code
- * @param[in] handle The response handle.
+ * @remarks You must not release @a code using free().
+ * @param[in] handle The response handle
  * @param[out] code The code.
  *
  * @return     @c 0 on success,
@@ -76,10 +78,9 @@ OAUTH2_API int oauth2_response_get_authorization_code(oauth2_response_h handle,
 /**
  * @brief Gets state.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free state
- * @param[in] handle The response handle.
+ * @remarks You must not release @a state using free().
+ * @param[in] handle The response handle
  * @param[out] state The state.
  *
  * @return     @c 0 on success,
@@ -94,11 +95,10 @@ OAUTH2_API int oauth2_response_get_state(oauth2_response_h handle, char **state)
 /**
  * @brief Gets access token.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free access_token
- * @param[in] handle The response handle.
- * @param[out] access_token The access token.
+ * @remarks You must not release @a access_token using free().
+ * @param[in] handle The response handle
+ * @param[out] access_token The access token
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -112,11 +112,10 @@ OAUTH2_API int oauth2_response_get_access_token(oauth2_response_h handle, char *
 /**
  * @brief Gets token type.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free token_type
- * @param[in] handle The response handle.
- * @param[out] token_type The token type.
+ * @remarks You must not release @a token_type using free().
+ * @param[in] handle The response handle
+ * @param[out] token_type The token type
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -130,11 +129,10 @@ OAUTH2_API int oauth2_response_get_token_type(oauth2_response_h handle, char **t
 /**
  * @brief Gets expiry time.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free expires_in
- * @param[in] handle The response handle.
- * @param[out] expires_in Expiry value.
+ * @remarks You must not release @a expires_in using free().
+ * @param[in] handle The response handle
+ * @param[out] expires_in Expiry value
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -148,11 +146,10 @@ OAUTH2_API int oauth2_response_get_expires_in(oauth2_response_h handle, long lon
 /**
  * @brief Gets refresh token.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free refresh_token
- * @param[in] handle The response handle.
- * @param[out] refresh_token The refresh token.
+ * @remarks You must not release @a refresh_token using free().
+ * @param[in] handle The response handle
+ * @param[out] refresh_token The refresh token
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -166,11 +163,10 @@ OAUTH2_API int oauth2_response_get_refresh_token(oauth2_response_h handle, char
 /**
  * @brief Gets scope.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free scope
- * @param[in] handle The response handle.
- * @param[out] scope The scope.
+ * @remarks You must not release @a scope using free().
+ * @param[in] handle The response handle
+ * @param[out] scope The scope
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -184,11 +180,10 @@ OAUTH2_API int oauth2_response_get_scope(oauth2_response_h handle, char **scope)
 /**
  * @brief Gets error.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free error
- * @param[in] handle The response handle.
- * @param[out] error The error structure.
+ * @remarks You must not release @a error using free().
+ * @param[in] handle The response handle
+ * @param[out] error The error structure
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -198,7 +193,6 @@ OAUTH2_API int oauth2_response_get_scope(oauth2_response_h handle, char **scope)
  * @retval     #OAUTH2_ERROR_VALUE_NOT_FOUND    Value not found
  *
  * @see oauth2_error_h
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  */
 OAUTH2_API int oauth2_response_get_error(oauth2_response_h handle, oauth2_error_h *error);
 
@@ -206,12 +200,11 @@ OAUTH2_API int oauth2_response_get_error(oauth2_response_h handle, oauth2_error_
  * @brief Gets the custom data.
  * @details Some service providers send additional keys not specified in OAuth 2.0 RFC. To get those additional fields this API needs to be used.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- * @privlevel public
  *
- * @remarks            You must not free custom_value
- * @param[in] handle The response handle.
- * @param[in] custom_key The custom key.
- * @param[out] custom_value The custom value.
+ * @remarks You must not release @a custom_value using free().
+ * @param[in] handle The response handle
+ * @param[in] custom_key The custom key
+ * @param[out] custom_value The custom value
  *
  * @return     @c 0 on success,
  *             otherwise a negative error value
@@ -222,9 +215,12 @@ OAUTH2_API int oauth2_response_get_error(oauth2_response_h handle, oauth2_error_
  */
 OAUTH2_API int oauth2_response_get_custom_data(oauth2_response_h handle, const char *custom_key, char **custom_value);
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* OAUTH2_RESPONSE_H_ */

diff --git a/include/oauth2_types.h b/include/oauth2_types.h
index 2a20ebf48de786fce024713c114c9776ec2009e2..b15a6498b004276ac6fa817a14c907449b106f8f 100755 (executable)
--- a/include/oauth2_types.h
+++ b/include/oauth2_types.h
@@ -20,6 +20,10 @@
 
 #include <tizen_error.h>
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 /**
  * @file     oauth2_types.h
  * @brief    This file defines common types and enums of OAuth 2.0.
@@ -38,14 +42,14 @@
  * @brief Enumerations for Client authentication scheme, used to sign client id and client secret accordingly.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  * @remarks Facebook and Google does not support HTTP Basic Authentication, instead they require client credentials to be sent via request body.
- * Default is OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC (http://tools.ietf.org/html/rfc2617#section-2)
+ * Default is #OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC (<a href="http://tools.ietf.org/html/rfc2617#section-2">rfc2617#section-2</a>)
  *
  * @see oauth2_request_set_client_authentication_type()
  */
 typedef enum {
-       OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC,/**< HTTP Basic Authentication for client authentication.**/
-       OAUTH2_CLIENT_AUTHENTICATION_TYPE_DIGEST,/**< HTTP Digest Authentication for client authentication.**/
-       OAUTH2_CLIENT_AUTHENTICATION_TYPE_REQUEST_BODY/**< Client credentials are sent via request body**/
+       OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC,/**< HTTP Basic Authentication for client authentication. */
+       OAUTH2_CLIENT_AUTHENTICATION_TYPE_DIGEST,/**< HTTP Digest Authentication for client authentication. */
+       OAUTH2_CLIENT_AUTHENTICATION_TYPE_REQUEST_BODY/**< Client credentials are sent via request body */
 }oauth2_client_authentication_type_e;
 
 /**
@@ -55,10 +59,10 @@ typedef enum {
  * @see oauth2_request_set_grant_type()
  */
 typedef enum {
-       OAUTH2_GRANT_TYPE_AUTH_CODE, /**< Access Token Request for Authorization Code Grant type.**/
-       OAUTH2_GRANT_TYPE_PASSWORD, /**< Access Token Request for Resource Owner Password Credentials Grant type.**/
-       OAUTH2_GRANT_TYPE_CLIENT_CREDENTIALS, /**< Access Token Request for Client Credentials Grant type.**/
-       OAUTH2_GRANT_TYPE_REFRESH /**< Refresh Token Request.**/
+       OAUTH2_GRANT_TYPE_AUTH_CODE, /**< Access Token Request for Authorization Code Grant type. */
+       OAUTH2_GRANT_TYPE_PASSWORD, /**< Access Token Request for Resource Owner Password Credentials Grant type. */
+       OAUTH2_GRANT_TYPE_CLIENT_CREDENTIALS, /**< Access Token Request for Client Credentials Grant type. */
+       OAUTH2_GRANT_TYPE_REFRESH /**< Refresh Token Request. */
 }oauth2_grant_type_e;
 
 /**
@@ -68,19 +72,18 @@ typedef enum {
  * @see oauth2_request_set_response_type()
  */
 typedef enum {
-       OAUTH2_RESPONSE_TYPE_CODE,/**< Requesting an authorization code as response type.**/
-       OAUTH2_RESPONSE_TYPE_TOKEN/**< Requesting an access token(implicit grant) as response type.**/
+       OAUTH2_RESPONSE_TYPE_CODE,/**< Requesting an authorization code as response type. */
+       OAUTH2_RESPONSE_TYPE_TOKEN/**< Requesting an access token(implicit grant) as response type. */
 }oauth2_response_type_e;
 
 /**
- *  @brief    Enumerations of error codes for oauth2 APIs.
- *  @since_tizen  @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *  @brief Enumerations of error codes for oauth2 APIs.
+ *  @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  */
 typedef enum {
     OAUTH2_ERROR_NONE                   = TIZEN_ERROR_NONE,                   /**< Successful */
     OAUTH2_ERROR_OUT_OF_MEMORY             = TIZEN_ERROR_OUT_OF_MEMORY,              /**< Out of memory */
     OAUTH2_ERROR_INVALID_PARAMETER         = TIZEN_ERROR_INVALID_PARAMETER,        /**< Invalid parameter */
-
     OAUTH2_ERROR_ALREADY_IN_PROGRESS = TIZEN_ERROR_ALREADY_IN_PROGRESS, /**< Operation already in progress */
     OAUTH2_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< Operation not supported */
     OAUTH2_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
@@ -88,14 +91,16 @@ typedef enum {
     OAUTH2_ERROR_NETWORK_ERROR = TIZEN_ERROR_ACCOUNT_OAUTH | 0x02, /**< Network error */
     OAUTH2_ERROR_SERVER = TIZEN_ERROR_ACCOUNT_OAUTH | 0x03, /**< Server error */
     OAUTH2_ERROR_USER_CANCELLED = TIZEN_ERROR_ACCOUNT_OAUTH | 0x04, /**< User cancelled the operation  */
-
     OAUTH2_ERROR_VALUE_NOT_FOUND = TIZEN_ERROR_ACCOUNT_OAUTH | 0x05,    /**< Value not found */
     OAUTH2_ERROR_UNKNOWN = TIZEN_ERROR_UNKNOWN /**< Unknown error */
 }oauth2_error_e;
 
-/* End of OAuth 2.0 APIs */
 /**
  * @}
  */
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* OAUTH2_TYPES_H_ */