Change the category of API reference

- System - Battery - Battery Monitor
- This doc header file also define System - Battery category

Change-Id: I3f1198241b123792d00228857856042f5966b12c
Signed-off-by: Kichan Kwon <k_c.kwon@samsung.com>

diff --git a/doc/battery_doc.h b/doc/battery_doc.h
new file mode 100755 (executable)
index 0000000..a8a0740
--- /dev/null
+++ b/doc/battery_doc.h
@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2019 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef __TIZEN_SYSTEM_BATTERY_DOC_H__
+#define __TIZEN_SYSTEM_BATTERY_DOC_H__
+
+/**
+ * @ingroup  CAPI_SYSTEM_FRAMEWORK
+ * @defgroup CAPI_SYSTEM_BATTERY_MODULE Battery
+ *
+ * @brief    The Battery API provides functions to get status of battery.
+ *
+ */
+
+/**
+ * @ingroup  CAPI_SYSTEM_BATTERY_MODULE
+ * @defgroup CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE Battery Monitor
+ *
+ * @brief    The API's provide per resource battery consumption by the application.
+ *
+ * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_HEADER Required Header
+ * \#include <battery_monitor.h>
+ *
+ * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_OVERVIEW Overview
+ * Battery consumption by a device does not only comprises power consumed by CPU,
+ * but it also includes power consumed by other components like - WiFi, Bt, Display, Mobile radio etc.
+ * The user is normally unaware of power consumed by these components & hence when battery drains out,
+ * user treats it as abnormal behaviour of device.
+ *
+ * Under these circumstances, user takes immediate action like killing all power hungry applications,
+ * use minimal display brightness, enable night mode in day time, shutting down some sensors, disabling
+ * background data for applications to restrict power usage & in the worst case - uninstall the application.
+ *
+ * User's decision making at such time is greatly influenced by the accuracy of battery consumption estimation
+ * and statistics provided to him.
+ *
+ * With this battery-monitor framework, power consumed by each & every application is determined along with the
+ * power consumed by individual resources which are used by the application at the time of running.
+ *
+ * The API's provide the following functionality:
+ * - battery consumption in percent for specific resource from available data.
+ * - battery consumption in percent for all resources used by app_id.
+ * - battery consumption in percent by an app-id for a specific resource.
+ * - total battery usage in percent by an app-id for certain time duration.
+ * - battery consumption in percent usage by a resource for certain time duration.
+ *
+ * @section CAPI_SYSTEM_BATTERY_BATTERY_MONITOR_MODULE_FEATURE Related Features
+ * The API's defined are related with the following features:\n
+ * - http://tizen.org/feature/battery\n
+ *
+ * It is recommended to design applications with regard to features, for reliability.\n
+ *
+ * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
+ *
+ * More details on using features in your application can be found in the <a href="https://developer.tizen.org/development/getting-started/native-application/understanding-tizen-programming/application-filtering"><b>Feature List</b>.</a>
+ *
+ */
+
+#endif /* __TIZEN_SYSTEM_BATTERY_DOC_H__ */
+

diff --git a/doc/battery_monitor_doc.h b/doc/battery_monitor_doc.h
deleted file mode 100755 (executable)
index a237c30..0000000
--- a/doc/battery_monitor_doc.h
+++ /dev/null
@@ -1,65 +0,0 @@
-/*
- * Copyright (c) 2019 Samsung Electronics Co., Ltd All Rights Reserved
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__
-#define __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__
-
-/**
- * @ingroup  CAPI_SERVICE_FRAMEWORK
- * @defgroup CAPI_SERVICE_BATTERY_MONITOR_MODULE Battery Monitor
- *
- * @brief    The API's provide per resource battery consumption by the application.
- *
- * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_HEADER Required Header
- * \#include <battery_monitor.h>
- *
- * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_OVERVIEW Overview
- * Battery consumption by a device does not only comprises power consumed by CPU,
- * but it also includes power consumed by other components like - WiFi, Bt, Display, Mobile radio etc.
- * The user is normally unaware of power consumed by these components & hence when battery drains out,
- * user treats it as abnormal behaviour of device.
- *
- * Under these circumstances, user takes immediate action like killing all power hungry applications,
- * use minimal display brightness, enable night mode in day time, shutting down some sensors, disabling
- * background data for applications to restrict power usage & in the worst case - uninstall the application.
- *
- * User's decision making at such time is greatly influenced by the accuracy of battery consumption estimation
- * and statistics provided to him.
- *
- * With this battery-monitor framework, power consumed by each & every application is determined along with the
- * power consumed by individual resources which are used by the application at the time of running.
- *
- * The API's provide the following functionality:
- * - battery consumption in percent for specific resource from available data.
- * - battery consumption in percent for all resources used by app_id.
- * - battery consumption in percent by an app-id for a specific resource.
- * - total battery usage in percent by an app-id for certain time duration.
- * - battery consumption in percent usage by a resource for certain time duration.
- *
- * @section CAPI_SERVICE_BATTERY_MONITOR_MODULE_FEATURE Related Features
- * The API's defined are related with the following features:\n
- * - http://tizen.org/feature/battery\n
- *
- * It is recommended to design applications with regard to features, for reliability.\n
- *
- * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- *
- * More details on using features in your application can be found in the <a href="https://developer.tizen.org/development/getting-started/native-application/understanding-tizen-programming/application-filtering"><b>Feature List</b>.</a>
- *
- */
-
-#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_DOC_H__ */
-

diff --git a/include/battery_monitor.h b/include/battery_monitor.h
index 8ff32c6ce61d69bdedec222de6a3d4ce58ab2c28..fca285ca8aafa441bc7bcf36d9de70668c595a0c 100644 (file)
--- a/include/battery_monitor.h
+++ b/include/battery_monitor.h
@@ -15,8 +15,8 @@
  *
  */
 
-#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_H__
-#define __TIZEN_SERVICE_BATTERY_MONITOR_H__
+#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_H__
+#define __TIZEN_SYSTEM_BATTERY_MONITOR_H__
 
 #include <tizen.h>
 
@@ -242,4 +242,4 @@ int battery_monitor_get_total_usage_by_resource_id(battery_monitor_resource_id_e
 }
 #endif
 
-#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_H__ */
+#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_H__ */

diff --git a/include/battery_monitor_dbg.h b/include/battery_monitor_dbg.h
index 21ecc0a7576cb7601985077f49f98d6922688cdb..a988d9c09e5afa3f2c51e4fdc24c64003e816a4b 100644 (file)
--- a/include/battery_monitor_dbg.h
+++ b/include/battery_monitor_dbg.h
@@ -15,8 +15,8 @@
  *
  */
 
-#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__
-#define __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__
+#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__
+#define __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__
 
 #include <tizen.h>
 #include <dlog.h>
@@ -54,4 +54,4 @@ extern "C" {
 }
 #endif
 
-#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_DBG_H__ */
+#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_DBG_H__ */

diff --git a/include/battery_monitor_internal.h b/include/battery_monitor_internal.h
index d8020cf410dbd11e73597b73bf9bbed8e5c1f5e0..910b31176140b1147c3e2c3fadd76b5414b9badf 100644 (file)
--- a/include/battery_monitor_internal.h
+++ b/include/battery_monitor_internal.h
@@ -15,8 +15,8 @@
  *
  */
 
-#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__
-#define __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__
+#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__
+#define __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__
 
 
 #ifdef __cplusplus
@@ -43,4 +43,4 @@ struct battery_monitor_total_consumption_s {
 }
 #endif
 
-#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_INTERNAL_H__ */
+#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_INTERNAL_H__ */

diff --git a/include/battery_monitor_util.h b/include/battery_monitor_util.h
index 3161edc8a355bf1b3d12457c13285071e47d89bd..e12b039b2454b62260d9d05db10494725b0152d4 100644 (file)
--- a/include/battery_monitor_util.h
+++ b/include/battery_monitor_util.h
@@ -15,8 +15,8 @@
  *
  */
 
-#ifndef __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__
-#define __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__
+#ifndef __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__
+#define __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__
 
 #include <stdlib.h>
 #include <stdbool.h>
@@ -146,4 +146,4 @@ void unmarshal_serialized_data(GVariant *handle, battery_monitor_h data_handle);
 }
 #endif
 
-#endif /* __TIZEN_SERVICE_BATTERY_MONITOR_UTIL_H__ */
+#endif /* __TIZEN_SYSTEM_BATTERY_MONITOR_UTIL_H__ */