Merge "remove unnecessary implementations" into tizen_2.1

[platform/framework/native/appfw.git] / inc / FAppAppManager.h

diff --git a/inc/FAppAppManager.h b/inc/FAppAppManager.h
index fd1efca..95432f5 100755 (executable)
--- a/inc/FAppAppManager.h
+++ b/inc/FAppAppManager.h
@@ -61,7 +61,7 @@ class MapDataControl;
  * The application manager supports normal and conditional application launch, and application control search and launch.
  * It looks up the specific application control from the application control registry and creates an application control instance.
  * @n
- * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a>, <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
+ * For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/app/launching_other_apps_within_apps.htm">Launching Other Applications</a> and <a href="../org.tizen.native.appprogramming/html/guide/app/registering_launch_condition.htm">Registering a Launch Condition</a>, and <a href="../org.tizen.native.appprogramming/html/guide/app/app_controls.htm">Application Controls</a>.
  */
 class _OSP_EXPORT_ AppManager
        : public Tizen::Base::Object
@@ -139,7 +139,7 @@ public:
        static Tizen::Base::Collection::IList* FindAppControlsN(const Tizen::Base::String* pOperationId, const Tizen::Base::String* pCategory, const Tizen::Base::String* pDataType, const Tizen::Base::String* pUriPattern);
 
        /**
-         * @if OSPDEPREC
+     * @if OSPDEPREC
         * Starts the application control if there is only one application control that matches the specified URI, operation ID, and data type. @n
         * If there are more than one application controls, the one that the user selects is started.
         *
@@ -148,7 +148,7 @@ public:
         *                              Instead of using this method, use AppControl::FindAndStart().
         * @since               2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return      An error code
         * @param[in]   uriData                 The URI that has a maximum size of @c 1024 bytes
@@ -175,7 +175,7 @@ public:
         * String operationId = L"http://tizen.org/appcontrol/operation/call";
         * StartAppControl(L"tel:1234567890", &operationId, null, null);
         * @endcode
-         * @endif
+     * @endif
         */
        static result StartAppControl(const Tizen::Base::String& uriData, const Tizen::Base::String* pOperationId, const Tizen::Base::String* pDataType, IAppControlListener* pListener);
 
@@ -189,7 +189,7 @@ public:
         *                              Instead of using this method, use AppControl::FindAndStart().
         * @since               2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return      An error code
         * @param[in]   pOperationId    The operation ID
@@ -227,7 +227,7 @@ public:
         * @param[in]   providerId                      The provider ID
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_OBJ_NOT_FOUND         The data control specified with the @c providerId is not found.
-        * @exception   E_ILLEGAL_ACCESS        The access is denied due to insufficient permission.
+        * @exception   E_ILLEGAL_ACCESS        Access is denied due to insufficient permission.
         * @exception   E_OUT_OF_MEMORY         The memory is insufficient.
         * @exception   E_SYSTEM                        A system error has occurred.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
@@ -245,7 +245,7 @@ public:
         * @param[in]   providerId                      The provider ID
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_OBJ_NOT_FOUND         The data control specified with the @c providerId is not found.
-        * @exception   E_ILLEGAL_ACCESS        The access is denied due to insufficient permission.
+        * @exception   E_ILLEGAL_ACCESS        Access is denied due to insufficient permission.
         * @exception   E_OUT_OF_MEMORY         The memory is insufficient.
         * @exception   E_SYSTEM                        A system error has occurred.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
@@ -279,7 +279,7 @@ public:
 
        /**
         * @if OSPDEPREC
-        * Launches the default application with given @c appId. @n
+        * Launches the default application with the given @c appId. @n
         * The launch arguments are given as App::OnUserEventReceivedN() or can be obtained by
         * invoking App::GetAppArgumentListN(), especially within App::OnAppInitializing().
         *
@@ -288,7 +288,7 @@ public:
         *                              Instead of using this method, use %LaunchApplication() without launch arguments or AppControl::Start().
         * @since       2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return      An error code
         * @param[in]   appId                           The application's ID to execute
@@ -307,11 +307,11 @@ public:
        result LaunchApplication(const AppId& appId, const Tizen::Base::Collection::IList* pArguments, LaunchOption option = LAUNCH_OPTION_DEFAULT);
 
        /**
-        * Launches the default application with given @c appId.
+        * Launches the default application with the given @c appId.
         *
         * @since       2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return      An error code
         * @param[in]   appId                           The application's ID to execute
@@ -329,13 +329,13 @@ public:
         *
         * @since       2.0
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/application.kill
+        * @privilege   %http://tizen.org/privilege/application.kill
         *
         * @return      An error code
         * @param[in]   appId                           The application's ID to execute
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_SYSTEM                        A system error has occurred.
-        * @exception   E_OBJ_NOT_FOUND         The application is not installed or not running.
+        * @exception   E_OBJ_NOT_FOUND         The application is either not installed or is not running.
         * @exception   E_PRIVILEGE_DENIED  The application does not have the privilege to call this method.
         */
        result TerminateApplication(const AppId& appId);
@@ -372,7 +372,7 @@ public:
         *
         * @since       2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return              An error code
         * @param[in]   condition         The launch condition for the application @n
@@ -410,7 +410,7 @@ public:
         * @remarks             Registering the same launch condition overwrites the previous launch argument without throwing an exception.
         * @remarks             The launch period requires more consideration because an inappropriate short period value may lead
         *                              to an adverse effect on the device battery.
-        * @remarks             For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+        * @remarks             For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
         * @see                 UnregisterAppLaunch()
         * @see                 IsAppLaunchRegistered()
         * @see                 LaunchApplication()
@@ -440,7 +440,7 @@ public:
         *
         * @since       2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return              An error code
         * @exception   E_SUCCESS                       The method is successful.
@@ -457,7 +457,7 @@ public:
         *
         * @since               2.0
         * @privlevel   public
-        * @privilege   http://tizen.org/privilege/application.launch
+        * @privilege   %http://tizen.org/privilege/application.launch
         *
         * @return              An error code
         * @param[in]   condition                       The launch condition for the application
@@ -494,7 +494,7 @@ public:
         *
         * @since               2.0
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appmanager.launch
+        * @privilege   %http://tizen.org/privilege/appmanager.launch
         *
         * @return     An error code
         * @param[in]  appId          The ID of the application registered for launch
@@ -527,11 +527,11 @@ public:
         * @exception  E_PRIVILEGE_DENIED       The application does not have the privilege to call this method.
         *
         * @remarks    When the registered application is about to be launched, the registered launch condition and arguments are given as parameters to IAppLaunchConditionEventListener::OnAppLaunchConditionMetN().
-        * @remarks    The newly introduced launch condition does not work on the previous SDK version and the E_INVALID_CONDITION exception is returned.
+        * @remarks    The newly introduced launch condition does not work on the previous SDK version and the @c E_INVALID_CONDITION exception is returned.
         * @remarks    Registering the same launch condition overwrites the previous launch argument without throwing an exception.
         * @remarks    The launch period requires more consideration because an inappropriate short period value may lead
         *             to an adverse effect on the device battery.
-        * @remarks    For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
+        * @remarks    For the NFC launch condition, the detected NDEF message can be acquired using the @c pExtraData parameter of the %IAppLaunchConditionEventListener::OnAppLaunchConditionMetN() method.
         * @see        UnregisterAppLaunch()
         * @see        IsAppLaunchRegistered()
         * @see        LaunchApplication()
@@ -546,7 +546,7 @@ public:
         *
         * @since               2.0
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appmanager.launch
+        * @privilege   %http://tizen.org/privilege/appmanager.launch
         *
         * @return     An error code
         * @param[in]  appId          The application ID
@@ -569,7 +569,7 @@ public:
         *
         * @since               2.0
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appmanager.launch
+        * @privilege   %http://tizen.org/privilege/appmanager.launch
         *
         * @return     @c true if a condition is already registered to the specified application with the specified condition, @n
         *             else @c false
@@ -651,7 +651,7 @@ public:
         * @since       2.0
         *
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appusage
+        * @privilege   %http://tizen.org/privilege/appusage
         *
         * @return              An error code
         * @param[in]   listener                                The event listener
@@ -673,7 +673,7 @@ public:
         * @since       2.0
         *
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appusage
+        * @privilege   %http://tizen.org/privilege/appusage
         *
         * @return              An error code
         * @param[in]   listener                                The event listener
@@ -693,7 +693,7 @@ public:
         * @since       2.0
         *
         * @privlevel   partner
-        * @privilege   http://tizen.org/privilege/appusage
+        * @privilege   %http://tizen.org/privilege/appusage
         *
         * @return              An error code
         * @param[out]  appId                                   The AppId of the active application