- * @details This function requests to scan a media folder to media server with given completed callback fucntion.
- * #media_scan_completed_cb() function will be called when the scanning is finished.
- * The sub folders are also scanned, if there are sub folder in that folder. \n
- * If you want that the any folders are not scanned, you have to create a blank file ".scan_ignore" in that folder.
+ * @details This function requests to scan a media folder to the media server with given completed callback function.
+ * media_scan_completed_cb() function will be called when the scanning is finished.
+ * The sub folders are also scanned, if there are sub folders in that folder. \n
+ * If any folder must not be scanned, a blank file ".scan_ignore" has to be created in that folder.
+ * After adding or removing a folder from the filesystem, call this function on its source location
+ * (this will add or remove an entry from the database). \n
+ * After moving or renaming a folder in the filesystem, call this function on its source location
+ * (this will remove an entry from the database) and call this function again on its destination location
+ * (this will add a new entry to the database).\n
+ * Alternatively, you can call this function on any parent of source location and on any parent of destination location.\n
+ * You can also call the function once, on a folder which is a parent of both source and destination.\n
+ *
+ * @since_tizen 2.3
+ *
+ * @privlevel public
+ * @privilege %http://tizen.org/privilege/content.write \n
+ * %http://tizen.org/privilege/mediastorage \n
+ * %http://tizen.org/privilege/externalstorage
+ *
+ * @remarks You must add privilege %http://tizen.org/privilege/content.write. And You add more privilege depending on your choice of contents path. \n
+ * If you want to access only internal storage by using this function, you should add privilege %http://tizen.org/privilege/mediastorage. \n
+ * Or if you want to access only external storage by using this function, you should add privilege %http://tizen.org/privilege/externalstorage. \n
+ * If you can access both storage, you must add all privilege. \n
+ * Since 4.0, This function does not allow a symbolic link.
+ *