From f438c7eb9a344157b95533ca871a6e7d8b4d0371 Mon Sep 17 00:00:00 2001 From: Davide Andreoli Date: Sat, 2 Aug 2008 21:48:44 +0000 Subject: [PATCH] * Fix Doxy warnings SVN revision: 35307 --- legacy/efreet/src/lib/Efreet.h | 2 ++ legacy/efreet/src/lib/Efreet_Mime.h | 17 +++++------------ legacy/efreet/src/lib/Efreet_Trash.h | 9 ++++----- legacy/efreet/src/lib/efreet_desktop.c | 2 +- legacy/efreet/src/lib/efreet_icon.c | 2 +- legacy/efreet/src/lib/efreet_menu.c | 2 ++ legacy/efreet/src/lib/efreet_mime.c | 6 +++--- 7 files changed, 18 insertions(+), 22 deletions(-) diff --git a/legacy/efreet/src/lib/Efreet.h b/legacy/efreet/src/lib/Efreet.h index c16ef6d3e9..88d74384b3 100644 --- a/legacy/efreet/src/lib/Efreet.h +++ b/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 diff --git a/legacy/efreet/src/lib/Efreet_Mime.h b/legacy/efreet/src/lib/Efreet_Mime.h index 52d7d1254a..b7a522be45 100644 --- a/legacy/efreet/src/lib/Efreet_Mime.h +++ b/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); diff --git a/legacy/efreet/src/lib/Efreet_Trash.h b/legacy/efreet/src/lib/Efreet_Trash.h index 115f459e5e..585144e1f5 100644 --- a/legacy/efreet/src/lib/Efreet_Trash.h +++ b/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 diff --git a/legacy/efreet/src/lib/efreet_desktop.c b/legacy/efreet/src/lib/efreet_desktop.c index 0d0383c0ad..19b493fa4d 100644 --- a/legacy/efreet/src/lib/efreet_desktop.c +++ b/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. */ diff --git a/legacy/efreet/src/lib/efreet_icon.c b/legacy/efreet/src/lib/efreet_icon.c index 67223a1b7a..3744ff925f 100644 --- a/legacy/efreet/src/lib/efreet_icon.c +++ b/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 diff --git a/legacy/efreet/src/lib/efreet_menu.c b/legacy/efreet/src/lib/efreet_menu.c index 2d523caa29..52ec22e49e 100644 --- a/legacy/efreet/src/lib/efreet_menu.c +++ b/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 diff --git a/legacy/efreet/src/lib/efreet_mime.c b/legacy/efreet/src/lib/efreet_mime.c index 1a9ffe8e48..830fd5b0a3 100644 --- a/legacy/efreet/src/lib/efreet_mime.c +++ b/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 */