summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorhyun lee <hyunn.lee@samsung.com>2014-10-20 16:05:07 +0900
committerhyun lee <hyunn.lee@samsung.com>2014-10-20 16:05:07 +0900
commitdc1d7e0273cff31756f3df8da2f948c0f59dfbcd (patch)
tree52cc1933a0bed57d60008a504c31e63b939cdcb4 /doc
parent2730f8382790b40295dcb9527c9372e70b5bb869 (diff)
downloadshortcut-dc1d7e0273cff31756f3df8da2f948c0f59dfbcd.tar.gz
shortcut-dc1d7e0273cff31756f3df8da2f948c0f59dfbcd.tar.bz2
shortcut-dc1d7e0273cff31756f3df8da2f948c0f59dfbcd.zip
Update doxygen from LB
Change-Id: I54dcf1ca8a7db0deb7d77a47fc52e9f08f1fe5a0 Signed-off-by: hyun lee <hyunn.lee@samsung.com>
Diffstat (limited to 'doc')
-rwxr-xr-xdoc/shortcut_doc.h52
1 files changed, 26 insertions, 26 deletions
diff --git a/doc/shortcut_doc.h b/doc/shortcut_doc.h
index 21fcac1..3b5107c 100755
--- a/doc/shortcut_doc.h
+++ b/doc/shortcut_doc.h
@@ -20,54 +20,54 @@
/**
* @defgroup SHORTCUT_MODULE Shortcut
- * @brief To enhance the Add to home feature. Two types of API set are supported.
+ * @brief To enhance the Add to home feature. Two types of API sets are supported.
* - One for the homescreen developers.
- * - The others for the application developers who should implement the Add to home feature.
+ * - The other for the application developers who should implement the Add to home feature.
* @ingroup CAPI_APPLICATION_FRAMEWORK
* @section SHORTCUT_MODULE_HEADER Required Header
* \#include <shortcut.h>
* @section SHORTCUT_MODULE_OVERVIEW Overview
<H1>1. Shortcut</H1>
Tizen is supporting the "add shortcut or add to home" for various applications.
-Developers may use the shortcut library (libshortcut) to implement features sending (applications) and receiving (possibly home screen) shortcuts.
+Developers may use the shortcut library (libshortcut) to implement features like sending (applications) and receiving (possibly home screen) shortcuts.
If home screen implements the shortcut service using the library, the applications are good to go for adding their shortcuts to the home screen(, and vice versa.)
<H1>2. How to add a new shortcut to the home screen</H1>
<H2>2.1 Add to home (From the app to home)</H2>
-The followings are two separate APIs to support "add to home" feature.
+The following are two separate APIs to support the "add to home" feature.
\code
typedef int (*result_cb_t)(int ret, int pid, void *data)
-extern int add_to_home_shortcut(const char *pkgname, const char *name, int type, const char *content_info, const char *icon, result_cb_t result_cb, void *data)
+extern int shortcut_add_shortcut(const char *pkgname, const char *name, int type, const char *content_info, const char *icon, result_cb_t result_cb, void *data)
-extern int add_to_home_dynamicbox(const char *pkgname, const char *name, int type, const char *content, const char *icon, double period, result_cb_t result_cb, void *data)
+extern int shortcut_add_dynamicbox(const char *pkgname, const char *name, int type, const char *content, const char *icon, double period, result_cb_t result_cb, void *data)
\endcode
Currently, our home screen can contain two different types of contents (that are pure shortcuts and dynamicboxes).
-To add a pure shortcut i.e., simply for launching an app, developers can use "add_to_home_shortcut" API to deliver their shortcuts to a home screen.
+To add a pure shortcut i.e., simply for launching an app, developers can use the "shortcut_add_shortcut" API to deliver their shortcuts to a home screen.
-If your application supports our dynamicbox service and implments dynamicbox type shortcut, then you can use "add_to_home_dynamicbox" API to have a home screen add the dynamicbox on its screen.
+If your application supports our dynamicbox service and implements a dynamicbox type shortcut, then you can use the "shortcut_add_dynamicbox" API to have a home screen add the dynamicbox on its screen.
<TABLE>
<TR><TH>Parameters</TH><TH>Comment</TH></TR>
<TR><TD>pkgname</TD><TD>Package name</TD></TR>
-<TR><TD>name</TD><TD>Application name wich will be displayed on the screen</TD></TR>
+<TR><TD>name</TD><TD>Application name which will be displayed on the screen</TD></TR>
<TR><TD>type</TD><TD>Basically it describes launching options whether to use a package name or URI. LAUNCH_BY_PACKAGE or LAUNCH_BY_URI</TD></TR>
<TR><TD>content</TD><TD>
Application data used for creating a pure shortcut or creating a dynamicbox
Shortcut
-1. if the type is Launch by package: None
+1. If the type is Launch by package: None
-2. if the type is Launch by URI: put the URI in the content
+2. If the type is Launch by URI: Put the URI in the content
- Dynamicbox: any data necessary to create a dynamicbox. Basically, it will passed to the dynamicbox plug-in's create function.
+ Dynamicbox: any data necessary to create a dynamicbox. Basically, it will be passed to the dynamicbox plug-in's create function.
</TD></TR>
-<TR><TD>icon</TD><TD>Absolute path to the icon file, If you set this "NULL", the home screen will use the deafult icon file (but it is depends on the homescreen implementations)</TD></TR>
+<TR><TD>icon</TD><TD>Absolute path to the icon file, If you set this to "NULL", the home screen will use the deafult icon file (but it is depends on the homescreen implementations)</TD></TR>
<TR><TD>period</TD><TD>&lt;Only for dynamicbox> Update period. The period must be greater than 0.0f</TD></TR>
<TR><TD>result_cb</TD><TD>Result callback. The callback will be called after a shortcut or dynamicbox has been added. Don't forget to check the return value.</TD></TR>
<TR><TD>data</TD><TD>Callback data</TD></TR>
@@ -76,17 +76,17 @@ Application data used for creating a pure shortcut or creating a dynamicbox
<H3>2.1.1 Supported types</H3>
shortcut.h Enumeration values for type of shortcuts
-<H2>2.2 Add shortcut (Home screen retrieves shortcuts from app)</H2>
+<H2>2.2 Add shortcut (Home screen retrieves shortcuts from the app)</H2>
"Add shortcut " service enables home screen to retrieve all shortcuts that applications promised to support and request an app to send their shortcuts to home directly, as opposed to "add to home".
-It is initiated by home screen as opposed to "add to home" which is initiated by an application."Add shortcut " service enables home screen to retrieve all shortcuts that applications promised to support and request an app to send their shortcuts to home directly, as opposed to "add to home".
+It is initiated by the home screen as opposed to "add to home" which is initiated by an application.The "Add shortcut" service enables the home screen to retrieve all shortcuts that applications promised to support and request an app to send their shortcuts to home directly, as opposed to "add to home".
-It is initiated by home screen as opposed to "add to home" which is initiated by an application.
+It is initiated by the home screen as opposed to "add to home" which is initiated by an application.
<H3>2.2.1 Build the shortcut list DB</H3>
\image html BuildShortcutList.png
-To recognize how many and what kinds of shortcuts have been registerred, each application who wants to support "add shortcut" service needs to install the XML file that defines "shortcut" information.
+To recognize how many and what kinds of shortcuts have been registered, each application who wants to support the "add shortcut" service needs to install the XML file that defines "shortcut" information.
The following table describes the format and information necessary to define the shortcuts application can support.
Then, the information will be shown and used in home screen when a user selects "add shortcut" service.
@@ -132,18 +132,18 @@ Then, the information will be shown and used in home screen when a user selects
</TABLE>
Install this XML file to /opt/share/packages/YOUR_PKGNAME.xml (Note: After manifest has been applied to the binary, simply copy the content to your manifest file.)
-Shortcut listing application will list up these items on its screen and each item will be displayed using the string in label field.
+The shortcut listing application will list up these items on its screen and each item will be displayed using the string in the label field.
When selected, it will launch the selected app using app service with "appid" and a bundle holding data in the pair of extra_key and extra-data fields.
Obviously, icon will be used to display visual information for given shortcut type.(that said the icon could be other than the application's default icon)
<H3>2.2.2 Jump to the APP</H3>
\image html JumpToApp.png
-Shortcut listing application will launch your application using app-svc with package name and param attributes.
+The shortcut listing application will launch your application using app-svc with package name and param attributes.
It will use the pkgname and param attrbute to launch your application.
-Shortcut list view will launch your "[App] Shortcut list" using followed code.
+The shortcut list view will launch your "[App] Shortcut list" using the following code.
-When your app is launched, the app should send a selected item as a shortcut or dynamicbox to the home screen using "add_to_home" series functions mentioned above.
+When your app is launched, the app should send a selected item as a shortcut or dynamicbox to the home screen using "shortcut_add" series functions mentioned above.
<H3>2.2.3 What each app has to do</H3>
You can implement your shortcut list view using App or UG.
@@ -159,7 +159,7 @@ Who is going to handle the shortcut
</LI>
</UL>
-In your shortcut list view, you just call the "add_to_home_shortcut" or "add_to_home_dynamicbox" which are described in the section 2.1
+In your shortcut list view, you just call the "shortcut_add_shortcut" or "shortcut_add_dynamicbox" which are described in the section 2.1
<H4>2.2.3.1 Handled by App</H4>
\image html ShortcutApp.png
@@ -175,7 +175,7 @@ In this case, the Shortcut List application will launch your UG as a process.
When you receive PAUSE event, or need to change to other view (not in the same UG), you should destroy current UG.
If you didn't destroy it, it will be reside on the process list. and it will not be destroyed automatically.
-Currently, UG container process only supporting the multiple instance for a process.
+Currently, the UG container process only supports multiple instance for a process.
So if the user tries to add a new shortcut again from the shortcut list application, your UG will be launched again if you didn't
terminate previous UG process (when you got PAUSE event).
@@ -197,7 +197,7 @@ extern int shortcut_set_request_cb(request_cb_t request_cb, void *data)
<TR><TD>data</TD><TD>Callback data</TD></TR>
</TABLE>
-<H1>4. To list up shortcuts registred in the device</H1>
+<H1>4. To list up shortcuts registered in the device</H1>
<TABLE>
<TR><TH>shortcut-list viewer will launch your app by this way</TH></TR>
<TR><TD>
@@ -207,13 +207,13 @@ int shortcut_get_list(const char *pkgname, int (*cb)(const char *pkgname, const
</TD></TR>
</TABLE>
-If you specified the "pkgname", this API will only gathering the given Package's shortcut list.
+If you specified the "pkgname", this API will only gather the given Package's shortcut list.
If you set is to NULL, this API will gathering all shortcuts.
Every shortcut item will be passed via "cb" callback function. so it will be invoked N times if the number of registered shortcut item is N.
pkgname and name and param is described in the XML file of each application package.
It will returns the number of shortcut items, or return <0 as an error value.
--EIO : failed to access shortcut list DB
+-EIO : failed to access the shortcut list DB
> 0 : Number of shortcut items (count of callback function calling)
*
*/