* \#include <iotcon.h>
*
* @section CAPI_IOT_CONNECTIVITY_MODULE_OVERVIEW Overview
- * The Iotcon API provides to register resources, discover resources and access them via
- * RESTful API.\n\n
+ * The iotcon module provides various features based on Iotivity project.\n
+ * The IoTivity project is sponsored by the Open Interconnect Consortium
+ * a group of industry leaders who will be developing a standard specification and
+ * certification program to address these challenges.\n
+ * See http://iotivity.org and http://openinterconnect.org for more information.
*
* @subsection CAPI_IOT_CONNECTIVITY_MODULE_RESOURCE Resource
* A Resource is a component in a server that can be viewed and conrolled by another client.\n
void iotcon_observers_destroy(iotcon_observers_h observers);
/**
- * @brief Sets a observer id into the observers handle
+ * @brief Adds a observer id into the observers handle
*
* @since_tizen 3.0
*
/**
* @brief Gets resource interfaces of the remote resource
+ * @details @a ifaces can contain multiple interfaces like
+ * IOTCON_INTERFACE_LINK | IOTCON_INTERFACE_BATCH.
*
* @since_tizen 3.0
*
/**
* @brief Gets resource interfaces from the representation.
+ * @details @a ifaces can contain multiple interfaces like
+ * IOTCON_INTERFACE_LINK | IOTCON_INTERFACE_BATCH.
*
* @since_tizen 3.0
*
*
* @section CAPI_IOT_CONNECTIVITY_COMMON_RESOURCE_TYPES_MODULE_OVERVIEW Overview
* The iotcon resource types API provides methods for managing handle and add, remove resource types.
+ * A resource type indicates a class or category of resources.
*
* Example :
* @code
* Duplicate strings are not allowed.
*
* @param[in] types The handle of the resource types
- * @param[in] type The string data to insert into the resource types
+ * @param[in] type The string data to insert into the resource types (e.g. "org.tizen.light")
*
* @return 0 on success, otherwise a negative error value.
* @retval #IOTCON_ERROR_NONE Successful
* @a ifaces can contain multiple interfaces like
* IOTCON_INTERFACE_LINK | IOTCON_INTERFACE_BATCH.\n
* @a properties also can contain multiple properties like
- * IOTCON_RESOURCE_ACTIVE | IOTCON_RESOURCE_DISCOVERABLE.\n
+ * IOTCON_RESOURCE_DISCOVERABLE | IOTCON_RESOURCE_OBSERVABLE.\n
* iotcon_request_handler_cb() will be called when receive CRUD request to the registered
* resource.
*
/**
* @brief Gets the interfaces of the resource
+ * @a ifaces can contain multiple interfaces like
+ * IOTCON_INTERFACE_LINK | IOTCON_INTERFACE_BATCH.
*
* @since_tizen 3.0
*
int iotcon_resource_get_interfaces(iotcon_resource_h resource, int *ifaces);
/**
- * @brief Checks whether the resource is observable or not.
+ * @brief Gets the properties in the resource
+ * @details @a properties can contain multiple properties like
+ * IOTCON_RESOURCE_DISCOVERABLE | IOTCON_RESOURCE_OBSERVABLE.
*
* @since_tizen 3.0
*
/**
* @brief Adds a callback to Iotcon
* @details When Iotcon connection status is changed with unexpected reason, registered
- * callbacks will be called in turn. The handles are validate no more after broken connection.
+ * callbacks will be called in turn. The handles(e.g. iotcon_resource_h,
+ * iotcon_remote_resource_h, ...) are validate no more after broken connection.
* The handles must creates again when connection recovered.
*
* @since_tizen 3.0