Enable build with iniparser v 3.1
[platform/framework/native/appfw.git] / inc / FAppPkgPackageInfo.h
old mode 100644 (file)
new mode 100755 (executable)
index ab2c978..42a11c8
@@ -1,5 +1,4 @@
 //
-// Open Service Platform
 // Copyright (c) 2012 Samsung Electronics Co., Ltd.
 //
 // Licensed under the Apache License, Version 2.0 (the License);
@@ -55,11 +54,11 @@ public:
        virtual ~PackageInfo(void);
 
        /**
-        * Gets a package ID.
+        * Gets the package ID.
         *
         * @since       2.0
         *
-        * @return A package ID
+        * @return      The package ID
         */
        PackageId GetId(void) const;
 
@@ -68,7 +67,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The version of a package
+        * @return      The version of the package
         */
        Tizen::Base::String GetVersion(void) const;
 
@@ -77,7 +76,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The display name of a package
+        * @return      The display name of the package
         */
        Tizen::Base::String GetDisplayName(void) const;
 
@@ -86,7 +85,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The description of a package, @n
+        * @return      The description of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetDescription(void) const;
@@ -96,7 +95,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The author of a package, @n
+        * @return      The author of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetAuthor(void) const;
@@ -106,56 +105,56 @@ public:
         *
         * @since       2.0
         *
-        * @return      The URL of a package, @n
+        * @return      The URL of the package, @n
         *          else an empty string is returned if there is no value
         */
        Tizen::Base::String GetUrl(void) const;
 
        /**
-        * Gets the date and time when a package is installed.
+        * Gets the date and the time when a package is installed.
         *
         * @since       2.0
         *
-        * @return      An instance of Tizen::Base::DateTime when a package is installed
+        * @return      An instance of Tizen::Base::DateTime which contains the package installation details
         */
        Tizen::Base::DateTime GetInstallationTime(void) const;
 
        /**
-        * Checks whether a package is installed in the external storage.
+        * Checks if a package is installed in the external storage.
         *
         * @since       2.0
         *
-        * @return      @c true if a package is installed in the external storage, @n
+        * @return      @c true if the package is installed in the external storage, @n
         *                      else @c false
         */
        bool IsInstalledInExternalStorage(void) const;
 
        /**
-        * Checks whether it is possible to uninstall a package.
+        * Checks if it is possible to uninstall a package.
         *
         * @since       2.0
         *
-        * @return      @c true if it is possible to uninstall a package, @n
+        * @return      @c true if it is possible to uninstall the package, @n
         *                      else @c false
         */
        bool IsUninstallable(void) const;
 
        /**
-        * Checks whether it is possible to move a package to either internal or external storage.
+        * Checks if it is possible to move a package to either the internal or the external storage.
         *
         * @since       2.0
         *
-        * @return      @c true if it is possible to move a package to either internal or external storage, @n
+        * @return      @c true if it is possible to move the package to either the internal or the external storage, @n
         *                      else @c false
         */
        bool IsMovable(void) const;
 
        /**
-        * Checks whether a package is downloaded.
+        * Checks if a package is downloaded.
         *
         * @since       2.0
         *
-        * @return      @c true if a package is downloaded, @n
+        * @return      @c true if the package is downloaded, @n
         *                      else @c false
         */
        bool IsDownloaded(void) const;
@@ -165,7 +164,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The size of a package
+        * @return      The size of the package
         */
        long long GetSize(void) const;
 
@@ -174,7 +173,7 @@ public:
         *
         * @since       2.0
         *
-        * @return      The data size of a package
+        * @return      The data size of the package
         */
        long long GetDataSize(void) const;
 
@@ -213,11 +212,11 @@ public:
         *
         * @since       2.0
         *
-        * @return              A pointer to PackageAppInfo
+        * @return              A pointer to the PackageAppInfo instance
         * @param[in]   appId                           The application ID
         * @exception   E_SUCCESS                       The method is successful.
         * @exception   E_INVALID_ARG           The specified input parameter is invalid.
-        * @exception   E_OBJ_NOT_FOUND         The application information is not found.
+        * @exception   E_OBJ_NOT_FOUND         The application information has not been found.
         * @exception   E_SYSTEM                        The method cannot proceed due to a severe system error.
         * @remarks             The specific error code can be accessed using the GetLastResult() method.
         */
@@ -226,11 +225,12 @@ public:
        /**
         * Gets the type of a package.
         *
-        * @since       2.0
+        * @since               2.0
         * @privlevel   platform
-        * @privilege   %http://tizen.org/privilege/packagemanager.setting
+        * @privilege   %http://tizen.org/privilege/packagemanager.setting @n
+        *              (%http://tizen.org/privilege/packagesetting is deprecated.)
         *
-        * @return The package type
+        * @return              The package type
         */
        PackageType GetType(void) const;
 
@@ -239,10 +239,10 @@ public:
        *
        * @since         2.1
        *
-       * @return        A pointer to the list of Tizen::Security::PrivilegeInfo instances, @n
+       * @return        A pointer to the list of the Tizen::Security::PrivilegeInfo instances, @n
        *                else @c null if it fails
-       * @exception            E_SUCCESS             The method is successful.
-       * @exception            E_SYSTEM            The method cannot proceed due to a severe system error.
+       * @exception     E_SUCCESS            The method is successful.
+       * @exception     E_SYSTEM             The method cannot proceed due to a severe system error.
        * @remarks      The specific error code can be accessed using the GetLastResult() method.
        */
        Tizen::Base::Collection::IList* GetPrivilegeListN(void) const;
@@ -269,6 +269,7 @@ private:
 
        friend class _PackageInfoImpl;
        friend class _PackageManagerImpl;
+       friend class _PackageManagerServer;
 
 }; // PackageInfo