Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FAppPkgIPackageInstallationResponseListener.h
old mode 100644 (file)
new mode 100755 (executable)
index 5fd46d6..b4d203c
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
 //
 
 /**
- * @if VISPARTNER-OPERATOR
  * @file       FAppPkgIPackageInstallationResponseListener.h
  * @brief      This is the header file for the %IPackageInstallationResponseListener interface.
  *
  * This header file contains the declarations of the %IPackageInstallationResponseListener interface.
  *
- * @endif
  */
 #ifndef _FAPP_PKG_IPACKAGE_INSTALLATION_RESPONSE_LISTENER_H_
 #define _FAPP_PKG_IPACKAGE_INSTALLATION_RESPONSE_LISTENER_H_
@@ -35,60 +32,50 @@ namespace Tizen { namespace App { namespace Package
 {
 
 /**
- * @if VISPARTNER-OPERATOR
  * @interface  IPackageInstallationResponseListener
  * @brief              This interface defines a listener for the asynchronous package installation operation.
  *
  * @since      2.0
- * @visibility partner-operator
  *
- * The %IPackageInstallationResponseListener interface defines a listener for the asynchronous package installation operation.
- *
- * @endif
+ * The %IPackageInstallationResponseListener interface defines a listener that is notified about events related to the installation of a target package.
+ * The events include the installation result and the installation progress information.
+ * Generally, applications such as the Tizen Store use this listener in a package installation step.
+ * @see PackageManager::InstallPackage()
  */
 class _OSP_EXPORT_ IPackageInstallationResponseListener
        : virtual public Tizen::Base::Runtime::IEventListener
 {
 public:
        /**
-     * @if VISPARTNER-OPERATOR
-     * This polymorphic destructor should be overridden if required.
-     * This way, the destructors of the derived classes are called when the destructor of this interface is called.
-     *
-     * @since  2.0
-     * @visibility  partner-operator\r
-     *\r
-     * @endif
-     */
+       * This polymorphic destructor should be overridden if required. @n
+       * This way, the destructors of the derived classes are called when the destructor of this interface is called.
+       *
+       * @since        2.0
+       *
+       */
        virtual ~IPackageInstallationResponseListener(void) {}
 
        /**
-     * @if VISPARTNER-OPERATOR
-     * Called when a package installation is completed. @n
+       * Called when a package installation is completed. @n
         * The value of @c installationResult is @c PACKAGE_INSTALLATION_RESULT_SUCCESS if the installation is successful.
-     *
-     * @since  2.0
-     * @visibility  partner-operator
-     *
-     * @param[in]      packageId                       The package ID
-     * @param[in]      installationResult              The installation result
-     *\r
-     * @endif
-     */
+       *
+       * @since        2.0
+       *
+       * @param[in]    packageId                               The package ID
+       * @param[in]    installationResult              The installation result
+       *
+       */
        virtual void OnPackageInstallationResponseReceived(const PackageId& packageId, PackageInstallationResult installationResult) = 0;
 
        /**
-     * @if VISPARTNER-OPERATOR
-     * Called when a package installation is in progress.
-     *
-     * @since  2.0
-     * @visibility  partner-operator
-     *
-     * @param[in]      packageId                       The package ID
-     * @param[in]      progress                The progress of an installation in percentage
-     *\r
-     * @endif
-     */
+       * Called when a package installation is in progress.
+       *
+       * @since        2.0
+       *
+       * @param[in]    packageId                       The package ID
+       * @param[in]    progress                        The progress of the installation in percentage
+       *
+       */
        virtual void OnPackageInstallationInProgressResponseReceived(const PackageId& packageId, int progress) = 0;
 
 
@@ -97,7 +84,7 @@ protected:
        // This method is for internal use only.
        // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
        //
-       // The following methods are reserved and the name of the methods can be changed at any time without prior notice.
+       // This method is reserved and may change its name at any time without prior notice.
        //
        // @since       2.0
        //
@@ -107,7 +94,7 @@ protected:
        // This method is for internal use only.
        // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
        //
-       // The following methods are reserved and the name of the methods can be changed at any time without prior notice.
+       // This method is reserved and may change its name at any time without prior notice.
        //
        // @since       2.0
        //
@@ -117,7 +104,7 @@ protected:
        // This method is for internal use only.
        // Using this method can cause behavioral, security-related, and consistency-related issues in the application.
        //
-       // The following methods are reserved and the name of the methods can be changed at any time without prior notice.
+       // This method is reserved and may change its name at any time without prior notice.
        //
        // @since       2.0
        //