Merge "[2.2.1][P130807-00904] Fail to get the host of the uri which has only ? charac...
[platform/framework/native/appfw.git] / inc / FAppPkgIPackageInstallationResponseListener.h
index 12cbedc..da8e6df 100755 (executable)
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -38,43 +37,45 @@ namespace Tizen { namespace App { namespace Package
  *
  * @since      2.0
  *
- * The %IPackageInstallationResponseListener interface defines a listener for the asynchronous package installation operation.
- *
+ * The %IPackageInstallationResponseListener interface defines a listener that is notified for events related to installation of a target package.
+ * The events include installation result and installation progress information.
+ * Generally, applications such as %Tizen Store use this listener in a package installation step.
+ * @see PackageManager::InstallPackage()
  */
 class _OSP_EXPORT_ IPackageInstallationResponseListener
        : virtual public Tizen::Base::Runtime::IEventListener
 {
 public:
        /**
-     * 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
-     *
-     */
+       * 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
+       *
+       */
        virtual ~IPackageInstallationResponseListener(void) {}
 
        /**
-     * 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
-     *
-     * @param[in]      packageId                       The package ID
-     * @param[in]      installationResult              The installation result
-     *
-     */
+       *
+       * @since        2.0
+       *
+       * @param[in]    packageId                       The package ID
+       * @param[in]    installationResult              The installation result
+       *
+       */
        virtual void OnPackageInstallationResponseReceived(const PackageId& packageId, PackageInstallationResult installationResult) = 0;
 
        /**
-     * Called when a package installation is in progress.
-     *
-     * @since  2.0
-     *
-     * @param[in]      packageId                       The package ID
-     * @param[in]      progress                The progress of an installation in percentage
-     *
-     */
+       * Called when a package installation is in progress.
+       *
+       * @since        2.0
+       *
+       * @param[in]    packageId                       The package ID
+       * @param[in]    progress                The progress of an installation in percentage
+       *
+       */
        virtual void OnPackageInstallationInProgressResponseReceived(const PackageId& packageId, int progress) = 0;