* Fix Doxy warnings

SVN revision: 35307

legacy/efreet/src/lib/Efreet.h

@@ -22,6 +22,8 @@
  * @li Icon Theme Specification
  * @li Desktop Entry Specification
  * @li Desktop Menu Specification
+ * @li Shared Mime Info Specification
+ * @li Trash Specification
  */
 
 #ifdef EAPI

legacy/efreet/src/lib/Efreet_Mime.h

@@ -5,19 +5,15 @@
 /**
  * @file Efreet_Mime.h
  * @brief The file that must be included by any project wishing to use
- * Efreet_Mime. Efreet_Mime.h provides all of the necessary headers and
- * includes to work with Efreet_Mime.
- */
-
-/**
- * @mainpage The Efreet Mime Library
- *
- * @section intro Introduction
- *
+ * @addtogroup Efreet_Mime Efreet_Mime: The XDG Shared Mime Info standard
  * Efreet Mime is a library designed to help apps work with the
  * Freedesktop.org Shared Mime Info standard.
+ * Efreet_Mime.h provides all of the necessary headers and
+ * includes to work with Efreet_Mime.
+ * @{
  */
 
+
 #ifdef EAPI
 #undef EAPI
 #endif
@@ -43,9 +39,6 @@
 extern "C" {
 #endif
 
-/**
- * @{
- */
 
 EAPI int         efreet_mime_init(void);
 EAPI void        efreet_mime_shutdown(void);

legacy/efreet/src/lib/Efreet_Trash.h

@@ -3,10 +3,11 @@
 #define EFREET_TRASH_H
 
 /**
- * @file efreet_trash.h
+ * @file Efreet_Trash.h
  * @brief Contains the methods used to support the FDO trash specification.
  * @addtogroup Efreet_Trash Efreet_Trash: The XDG Trash Specification
- * Some better explanation here...
+ * Efreet_Trash.h provides all of the necessary headers and includes to
+ * work with Efreet_Trash.
  * @{
  */
 
@@ -35,9 +36,7 @@
 extern "C" {
 #endif
 
-/**
- * @{
- */
+
 
 /**
  * Efreet_Uri

legacy/efreet/src/lib/efreet_desktop.c

@@ -510,7 +510,7 @@ efreet_desktop_free(Efreet_Desktop *desktop)
 /**
  * @param desktop: The desktop file to work with
  * @param files: The files to be substituted into the exec line
- * @aparam data: The data pointer to pass
+ * @param data: The data pointer to pass
  * @return Returns the Ecore_Exce for @a desktop
  * @brief Parses the @a desktop exec line and returns an Ecore_Exe.
  */

legacy/efreet/src/lib/efreet_icon.c

@@ -389,7 +389,7 @@ efreet_icon_path_find(const char *theme_name, const char *icon, const char *size
 
 /**
  * @param theme_name: The icon theme to look for
- * @param icon: List of icons to look for
+ * @param icons: List of icons to look for
  * @param size; The icon size to look for
  * @return Returns the path representing first found icon or
  * NULL if none of the icons are found

legacy/efreet/src/lib/efreet_menu.c

@@ -799,6 +799,7 @@ efreet_menu_save_indent(FILE *f, int indent)
 /**
  * @param menu: The menu to work with
  * @param desktop: The desktop to insert
+ * @param pos: The position to place the new desktop
  * @return Returns 1 on success, 0 on failure
  * @brief Insert a desktop element in a menu structure. Only accepts desktop files
  * in default directories.
@@ -838,6 +839,7 @@ efreet_menu_desktop_insert(Efreet_Menu *menu, Efreet_Desktop *desktop, int pos)
 }
 
 /**
+ * @param menu: The menu to work with
  * @param desktop: The desktop to remove
  * @return Returns 1 on success, 0 on failure
  * @brief Remove a desktop element in a menu structure. Only accepts desktop files

legacy/efreet/src/lib/efreet_mime.c

@@ -174,7 +174,9 @@ efreet_mime_type_get(const char *file)
 }
 
 /**
- * @param file: The file to find the mime type icon
+ * @param mime: The name of the mime type
+ * @param theme: The name of the theme to search icons in
+ * @param size: The wanted size of the icon
  * @return Returns mime type icon path as a string
  * @brief Retreive the mime type icon for a file
  */
@@ -306,7 +308,6 @@ efreet_mime_globs_type_get(const char *file)
 
 /**
  * @param file: The file to check the mime type
- * @param methods: The methods to use, see Efreet_Mime_Method structure
  * @return Returns mime type as a string
  * @brief Retreive the special mime type of a file
  */
@@ -318,7 +319,6 @@ efreet_mime_special_type_get(const char *file)
 
 /**
  * @param file: The file to check the mime type
- * @param methods: The methods to use, see Efreet_Mime_Method structure
  * @return Returns mime type as a string
  * @brief Retreive the fallback mime type of a file
  */