Updated change-logs and descriptions of APIs

Change-Id: I36bdd9448cc4ec0ee6ba7adafd6f286e28701d01

diff --git a/capi-maps-service.changes b/capi-maps-service.changes
index 81c35e7..14649ea 100644 (file)
--- a/capi-maps-service.changes
+++ b/capi-maps-service.changes
@@ -1,18 +1,60 @@
 [Version]   capi-maps-service_0.6.0
 [Date]      18 April 2016
 [Title]     ACR about Maps-View APIs
-[Developer]    Jongmun Woo <jongmun.woo@samsung.com>
+[Developer] Jongmun Woo <jongmun.woo@samsung.com>
+
+[Version]   capi-maps-service_0.6.0
+[Date]      29 Febrary 2016
+[Title]     Added Map View API
+[Developer] Alexey Shulga <a.shulga@samsung.com>
+            Young-Ae Kang <youngae.kang@samsung.com>
+            Seechan Kim <cbible.kim@samsung.com>
+
+[Version]   capi-maps-service_0.5.5
+[Date]      11 Febrary 2016
+[Title]     Added some APIs for marker resizing and z-ordering.
+[Developer] Seechan Kim <cbible.kim@samsung.com>
+
+[Version]   capi-maps-service_0.5.4
+[Date]      25 Febrary 2016
+[Title]     Reduced useless memory duplications.
+[Developer] Young-Ae Kang <youngae.kang@samsung.com>
+
+[Version]   capi-maps-service_0.5.4
+[Date]      19 October 2015
+[Title]     Renamed maps_view_marker_type_e to map_marker_type_e.
+[Developer] Alexey Shulga <a.shulga@samsung.com>
 
 [Version]   capi-maps-service_0.5.3
 [Date]      22 January 2016
 [Title]     Added place list API.
-[Developer]    Kyoungjun Sung <kj7.sung@samsung.com>
+[Developer] Kyoungjun Sung <kj7.sung@samsung.com>
+
+[Version]   capi-maps-service_0.5.3
+[Date]      14 October 2015
+[Title]     Added map_object_create_group API.
+[Developer] Alexey Shulga <a.shulga@samsung.com>
+
+[Version]   capi-maps-service_0.5.2
+[Date]      13 October 2015
+[Title]     Made more clear API for setting Map View event callback and reaction on User Gesture.
+[Developer] Alexey Shulga <a.shulga@samsung.com>
+
+[Version]   capi-maps-service_0.5.1
+[Date]      06 October 2015
+[Title]     Adopted recommended Map Object Life Cycle: create - set/get - add to view; optimized API names.
+[Developer] Alexey Shulga <a.shulga@samsung.com>
 
 [Version]   capi-maps-service_0.5.0
 [Date]      21 October 2015
 [Title]     Added coordinates address list API.
 [Developer] Young-Ae Kang <youngae.kang@samsung.com>
 
+[Version]   capi-maps-service_0.5.0
+[Date]      23 September 2015
+[Title]     Added Mapping API.
+[Developer] Alexey Shulga <a.shulga@samsung.com>
+
 [Version]   capi-maps-service_0.4.6
 [Date]      16 September 2015
 [Title]     Added -fvisibility=hidden to make EXPORT_API useful.
@@ -45,7 +87,7 @@
 
 [Version]   capi-maps-service_0.4.0
 [Date]      14 July 2015
-[Title]    [ACR-309] [2.4][capi-maps-service][Modify] Visibility of some APIs of Maps was changed
+[Title]     [ACR-309][2.4][capi-maps-service][Modify] Visibility of some APIs of Maps was changed
 [Developer] Young-Ae Kang <youngae.kang@samsung.com>
 
 [Version]   capi-maps-service_0.3.2

diff --git a/include/maps_plugin.h b/include/maps_plugin.h
index 4b1f256..f147160 100755 (executable)
--- a/include/maps_plugin.h
+++ b/include/maps_plugin.h
@@ -183,14 +183,13 @@ int maps_plugin_get_preference(maps_item_hashtable_h *preference);
 
 /**
  * @brief      Checks if the Maps Plugin supports a request.
- * @details This function checks if the Maps Plugin supports a specified
- * request.
+ * @details This function checks if the Maps Plugin supports a specified request.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  * @param[in]  service         The service to be checked
  * @param[out] supported       Is the service supported
  * @return     0 on success, otherwise a negative error value
- * @retval     #MAPS_ERROR_NONE Successful, the service is supported
+ * @retval     #MAPS_ERROR_NONE Successful
  * @retval     #MAPS_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval     #MAPS_ERROR_INVALID_OPERATION Invalid operation
  *
@@ -198,19 +197,17 @@ int maps_plugin_get_preference(maps_item_hashtable_h *preference);
  *
  * @see maps_service_create()
  */
-int maps_plugin_is_service_supported(maps_service_e service,
-                                    bool *supported);
+int maps_plugin_is_service_supported(maps_service_e service, bool *supported);
 
 /**
  * @brief      Checks if the Maps Plugin supports a data feature.
- * @details This function checks if the Maps Plugin supports a specified data
- * feature.
+ * @details This function checks if the Maps Plugin supports a specified data feature.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  * @param[in]  data            The data feature to be checked
  * @param[out] supported       Is the data feature supported
  * @return     0 on success, otherwise a negative error value
- * @retval     #MAPS_ERROR_NONE Successful, the data feature is supported
+ * @retval     #MAPS_ERROR_NONE Successful
  * @retval     #MAPS_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval     #MAPS_ERROR_INVALID_OPERATION Invalid operation
  *

diff --git a/include/maps_service.h b/include/maps_service.h
index 36ead91..7629b56 100644 (file)
--- a/include/maps_service.h
+++ b/include/maps_service.h
@@ -319,7 +319,7 @@ int maps_service_get_preference(maps_service_h maps,
  * @param[in]  service         The service to be checked
  * @param[out] supported       Is the service supported
  * @return     0 on success, otherwise a negative error value
- * @retval     #MAPS_ERROR_NONE Successful, the service is supported
+ * @retval     #MAPS_ERROR_NONE Successful
  * @retval     #MAPS_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval     #MAPS_ERROR_SERVICE_NOT_AVAILABLE Service not available
  *
@@ -343,7 +343,7 @@ int maps_service_provider_is_service_supported(const maps_service_h maps,
  * @param[in]  data            The data feature to be checked
  * @param[out] supported       Is the data feature supported
  * @return     0 on success, otherwise a negative error value
- * @retval     #MAPS_ERROR_NONE Successful, the data feature is supported
+ * @retval     #MAPS_ERROR_NONE Successful
  * @retval     #MAPS_ERROR_INVALID_PARAMETER Invalid parameter
  * @retval     #MAPS_ERROR_SERVICE_NOT_AVAILABLE Service not available
  *

diff --git a/include/maps_view.h b/include/maps_view.h
index 93c7869..a429cbf 100644 (file)
--- a/include/maps_view.h
+++ b/include/maps_view.h
@@ -32,7 +32,7 @@
  *
  * @addtogroup CAPI_MAPS_VIEW_MODULE
  * @{
- * @brief This provides APIs related to operations used in View
+ * @brief This provides APIs related to operations, used in View.
  * @details Supported View API features include:
  *  * Creating and destroying the View port, moving and resizing it
  *  * Changing zoom, and orientation
@@ -129,8 +129,7 @@ typedef void(*maps_view_on_event_cb) (maps_view_event_type_e type, maps_view_eve
  * zoom level and rotation angle use maps_view_set_center(),
  * maps_view_set_zoom_level() and maps_view_set_orientation() respectively.
  * \n To change View theme, size and visibility properties use
- * maps_view_set_type() and maps_view_set_visibility()
- * respectively.
+ * maps_view_set_type() and maps_view_set_visibility() respectively.
  * @since_tizen 3.0
  * @privlevel public
  * @privilege %http://tizen.org/privilege/mapservice

diff --git a/include/maps_view_event_data.h b/include/maps_view_event_data.h
index 76f6f44..e725af9 100644 (file)
--- a/include/maps_view_event_data.h
+++ b/include/maps_view_event_data.h
@@ -20,7 +20,7 @@
 
 /**
  *
- * @ingroup    CAPI_MAPS_SERVICE_MODULE
+ * @ingroup    CAPI_MAPS_VIEW_MODULE
  * @defgroup   CAPI_MAPS_VIEW_EVENT_DATA_MODULE View Event Data
  *
  * @file maps_view_event_data.h
@@ -28,7 +28,7 @@
  *
  * @addtogroup CAPI_MAPS_VIEW_EVENT_DATA_MODULE
  * @{
- * @brief This provides APIs related to operations with View Event Data
+ * @brief This provides APIs related to operations, used in View Event Data.
  * @details Supported Event types are following:
  *  * User gesture over the Map
  *  * Map action, such as zooming or rotation
@@ -38,8 +38,8 @@
  * @par Features available by Event Type
  * The correspondence between the type of event and available event data
  * is following:
- * | Feature/Event Type                  | Gesture | Action | Object | Ready |
- * | :---------------------------------- | :-----: | :----: | :----: | :---: |
+ * | Feature/Event Type                        | Gesture | Action | Object | Ready |
+ * | :---------------------------------------- | :-----: | :----: | :----: | :---: |
  * | #maps_view_event_type_e                   | +       | +      | +      | +     |
  * | #maps_view_gesture_e                      | +       |        | +      |       |
  * | #maps_view_action_e                       |         | +      |        |       |

diff --git a/include/maps_view_object.h b/include/maps_view_object.h
index db11033..c8a05c9 100644 (file)
--- a/include/maps_view_object.h
+++ b/include/maps_view_object.h
@@ -21,7 +21,7 @@
 #include <maps_coordinates.h>
 
 /**
- * @ingroup    CAPI_MAPS_SERVICE_MODULE
+ * @ingroup    CAPI_MAPS_VIEW_MODULE
  * @defgroup   CAPI_MAPS_VIEW_OBJECT_MODULE View Object
  *
  * @file maps_view_object.h
@@ -29,7 +29,7 @@
  *
  * @addtogroup CAPI_MAPS_VIEW_OBJECT_MODULE
  * @{
- * @brief This file contains the functions related to View Objects
+ * @brief This provides APIs related to operations, used in View Object.
  * @details Supported Object types are following:
  *  * Markers
  *  * Polygons
@@ -762,4 +762,4 @@ int maps_view_object_marker_get_z_order(const maps_view_object_h marker, int *z_
 /**
  * @}
  */
-#endif                         /* __MAP_OBJECT_H__*/
+#endif                         /* __MAPS_VIEW_OBJECT_H__ */

diff --git a/include/maps_view_object_plugin.h b/include/maps_view_object_plugin.h
index 7d7e19d..7115e93 100644 (file)
--- a/include/maps_view_object_plugin.h
+++ b/include/maps_view_object_plugin.h
@@ -20,15 +20,15 @@
 #include <maps_view_object.h>
 
 /**
- * @ingroup    CAPI_MAP_VIEW_MODULE
- * @defgroup   CAPI_MAP_OBJECTS_MODULE Maps View Objects
+ * @ingroup    CAPI_MAPS_VIEW_MODULE
+ * @defgroup   CAPI_MAPS_VIEW_OBJECT_MODULE View Objects
  *
  * @file map_object.h
- * @brief This file contains the functions of Map Object API
+ * @brief This file contains the functions of View Object API
  *
- * @addtogroup CAPI_MAP_OBJECTS_MODULE
+ * @addtogroup CAPI_MAPS_VIEW_OBJECT_MODULE
  * @{
- * @brief This file contains the functions related to Map View Objects
+ * @brief This provides APIs related to operations, used in View Object.
  * @details Supported Object types are following:
  *  * Markers
  *  * Polygons

diff --git a/include/maps_view_plugin.h b/include/maps_view_plugin.h
index 058a806..752d9a2 100644 (file)
--- a/include/maps_view_plugin.h
+++ b/include/maps_view_plugin.h
@@ -20,13 +20,13 @@
 #include <maps_view.h>
 
 /**
- * @ingroup    CAPI_MAP_VIEW_MODULE
- * @defgroup   CAPI_MAP_VIEW_MODULE Maps View
+ * @ingroup    CAPI_MAPS_VIEW_MODULE
+ * @defgroup   CAPI_MAPS_VIEW_MODULE View
  *
  * @file map_object.h
  * @brief This file contains the functions of Map View API
  *
- * @addtogroup CAPI_MAP_OBJECTS_MODULE
+ * @addtogroup CAPI_MAPS_VIEW_MODULE
  * @{
  * @brief This file contains the functions related to Map View
  */
@@ -70,7 +70,7 @@ int maps_view_set_zoom_factor(maps_view_h view, double zoom_factor);
  * @details This function gets the current zoom factor of View.
  * @since_tizen 3.0
  * @remarks zoom @a factor can be obtained also in maps_view_on_event_cb()
- * callback, assigned using map_view_set_event_cb() with the event
+ * callback, assigned using maps_view_set_event_cb() with the event
  * type #MAPS_VIEW_EVENT_ACTION specified.
  *
  * @param[in]  view            The view handle