e/docs: do bare documentation for e.

Just some groups and basic description for modules. I'm NOT going back
to this anytime soon, but would be VERY happy if people could do some
screenshots and put the images for each module in docs/img/ folder,
linking to them from each e_mod_main.h



SVN revision: 67362

doc/Doxyfile.in

@@ -1,7 +1,7 @@
 PROJECT_NAME           = Enlightenment
 PROJECT_NUMBER         =
 OUTPUT_DIRECTORY       = .
-INPUT                  = @builddir@/e.dox @top_srcdir@/src/bin
+INPUT                  = @builddir@/e.dox @top_srcdir@/src
 IMAGE_PATH             = @srcdir@/img
 OUTPUT_LANGUAGE        = English
 GENERATE_HTML          = YES
@@ -23,9 +23,9 @@ EXTRACT_ALL            = NO
 EXTRACT_PRIVATE        = NO
 EXTRACT_STATIC         = NO
 EXTRACT_LOCAL_CLASSES  = NO
-HIDE_UNDOC_MEMBERS     = YES
-HIDE_UNDOC_CLASSES     = YES
-HIDE_FRIEND_COMPOUNDS  = YES
+HIDE_UNDOC_MEMBERS     = NO
+HIDE_UNDOC_CLASSES     = NO
+HIDE_FRIEND_COMPOUNDS  = NO
 BRIEF_MEMBER_DESC      = YES
 REPEAT_BRIEF           = YES
 ALWAYS_DETAILED_SEC    = NO
@@ -76,7 +76,7 @@ REFERENCED_BY_RELATION = YES
 REFERENCES_RELATION    = YES
 ALPHABETICAL_INDEX     = YES
 COLS_IN_ALPHA_INDEX    = 2
-IGNORE_PREFIX          = 
+IGNORE_PREFIX          = E_ _E_ e_ _e_
 GENERATE_TREEVIEW      = NO
 TREEVIEW_WIDTH         = 250
 GENERATE_LATEX         = YES

doc/e.dox.in

@@ -5,14 +5,89 @@
 @image html  e.png
 
 @version @PACKAGE_VERSION@
-@date 2000-2010
+@date 2000-2012
+
+Please see the @ref authors page for contact details.
 
 @section intro Introduction
 
-@section compiling How to compile using Enlightenment?
+The Enlightenment Window Manager is a lean, fast, modular and very
+extensible window manager for X11 and Linux. It is classed as a
+"desktop shell" providing the things you need to operate your desktop
+(or laptop), but is not a whole application suite. This covered
+launching applications, managing their windows and doing other system
+tasks like suspending, reboots, managing files etc.
+
+
+@section compiling How to compile modules?
+
+pkgconfig (.pc) files are installed for enlightenment. To compile a
+module you can use something like the following:
+
+@verbatim
+gcc module.c $(pkg-config enlightenment --cflags --libs)
+@endverbatim
+
+Note that modules are installed to $HOME (~/.e/e/modules) or
+system. One can know the system directory with the command:
+
+@verbatim
+pkg-config --variable=modules enlightenment
+@endverbatim
 
 @section install How is it installed?
 
+Just use the traditional autotools steps, the options will be
+autodetected. Note that it depend on EFL (Enlightenment Foundation
+Libraries): eina, eet, evas, ecore, e_dbus, embryo, edje, efreet and
+eeze.
+
+@verbatim
+./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var
+make
+sudo make install
+@endverbatim
+
 @todo (0.17) Document API
 
 */
+
+/**
+
+@page authors Authors
+
+@author The Rasterman (Carsten Haitzler) <raster@rasterman.com>
+@author Ibukun Olumuyiwa <ibukun@computer.org>
+@author Sebastian Dransfeld <sd@tango.flipp.net>
+@author HandyAndE (Andrew Williams) <andy@handyande.co.uk>
+@author CodeWarrior (Hisham Mardam Bey) <hisham@hisham.cc>
+@author dj2 (Dan Sinclair) <dj2@everburning.com>
+@author Tilman Sauerbeck <tilman@@code-monkey.de>
+@author Aleksej Struk <astruk@gmail.com>
+@author Brian Mattern <rephorm@rephorm.com>
+@author devilhorns (Christopher Michael) <devilhorns@comcast.net>
+@author /dev/urandom (Viktor Kojouharov) <vkojouharov@gmail.com>
+@author ilLogict (Chidambar Zinnoury) <illogict@online.fr>
+@author Stafford Horne <shorne@softhome.net>
+@author Cedric Bail <cedric.bail@free.fr>
+@author onefang (David Seikel) <onefang@gmail.com>
+@author okra (Stephen Houston) <smhouston88@gmail.com>
+@author Byron Hillis <metrics@score5.org>
+@author Ravenlock (Eric Schuele) <e.schuele@computer.org>
+@author ManoWarrior (Luchezar Petkov) <luchezar.petkov@gmail.com>
+@author morlenxus (Brian Miculcy) <morlenxus@gmx.net>
+@author Toma- (Tom Haste) <tomhaste@gmail.com>
+@author k-s (Gustavo Sverzut Barbieri) <barbieri@profusion.mobi>
+@author Peter van de Werken <pwerken-e@a-eskwadraat.nl>
+@author Florian Hackenberger <florian@hackenberger.at>
+@author Hannes Janetzek <hannes.janetzek@gmail.com>
+@author Mike Blumenkrantz (discomfitor/zmike) <michael.blumenkrantz@gmail.com>
+@author Leif Middelschulte <leif.middelschulte@gmail.com>
+@author yoz (Michael Bouchaud) <michael.bouchaud@gmail.com>
+@author billiob (Boris Faure) <billiob@gmail.com>
+@author Jihoon Kim <jihoon48.kim@samsung.com>
+@author Sthitha <iamsthitha@gmail>
+@author Doyoun Kang <doyoun.kang@samsung.com>
+@author Gwanglim Lee <gl77.lee@samsung.com>
+
+*/

src/bin/e.h

@@ -1,6 +1,15 @@
 #ifndef E_H
 # define E_H
 
+/**
+ * @defgroup API Enlightenment API
+ *
+ * Application programming interface to be used by modules to extend
+ * Enlightenment.
+ *
+ * @{
+ */
+
 # ifdef HAVE_CONFIG_H
 #  include "config.h"
 # endif
@@ -249,4 +258,25 @@ extern EAPI unsigned long e_alert_composite_win;
 #define SMARTERRNR() return
 #define SMARTERR(x) return x
 
+/**
+ * @}
+ */
+
+/**
+ * @defgroup Optional_Modules Optional Modules
+ * @{
+ *
+ * @defgroup Optional_Conf Configurations
+ * @defgroup Optional_Control Controls
+ * @defgroup Optional_Devices Devices & Hardware
+ * @defgroup Optional_Fileman File Managers
+ * @defgroup Optional_Gadgets Gadgets
+ * @defgroup Optional_Launcher Launchers
+ * @defgroup Optional_Layouts Layout Managers
+ * @defgroup Optional_Look Look & Feel
+ * @defgroup Optional_Monitors Monitors & Notifications
+ * @defgroup Optional_Mobile Mobile Specific Extensions
+ * @}
+ */
+
 #endif

src/modules/backlight/e_mod_main.h

@@ -7,4 +7,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Devices
+ * @{
+ *
+ * @defgroup Module_Backlight Backlight
+ *
+ * Controls backlights such as laptop LCD.
+ *
+ * @}
+ */
+
 #endif

src/modules/battery/e_mod_main.h

@@ -153,4 +153,16 @@ E_Config_Dialog *e_int_config_battery_module(E_Container *con, const char *param
 void _battery_config_updated(void);
 extern Config *battery_config;
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Battery Battery
+ *
+ * Shows battery level and current status, may do actions given some
+ * thresholds.
+ *
+ * @}
+ */
+
 #endif

src/modules/bluez/e_mod_main.h

@@ -141,4 +141,17 @@ _bluez_operation_error_show(const char *msg)
                       msg);
 }
 
+
+/**
+ * @addtogroup Optional_Devices
+ * @{
+ *
+ * @defgroup Module_Bluez BlueZ (Bluetooth)
+ *
+ * Controls bluetooth visibility, scan and pair devices.
+ *
+ * @see http://www.bluez.org/
+ * @}
+ */
+
 #endif

src/modules/clock/e_mod_main.h

@@ -37,4 +37,16 @@ void e_int_clock_instances_redo(void);
 
 extern Config *clock_config;
 
+
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Clock Clock
+ *
+ * Shows current time and date.
+ *
+ * @}
+ */
+
 #endif

src/modules/comp/e_mod_main.h

@@ -31,4 +31,18 @@ void       _e_mod_config_free(E_Module *m);
 #define ENGINE_SW 1
 #define ENGINE_GL 2
 
+
+/**
+ * @addtogroup Optional_Look
+ * @{
+ *
+ * @defgroup Module_Comp Comp (Composite Manager)
+ *
+ * Implements the X11 Composite Manager to support alpha blend,
+ * semi-transparent windows and drop shadow. Does support animations
+ * and effects such as coloring unfocused windows.
+ *
+ * @}
+ */
+
 #endif

src/modules/conf/e_mod_main.h

@@ -33,4 +33,16 @@ void e_mod_config_menu_add(void *data, E_Menu *m);
 
 extern Config *conf;
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf Main Configuration Dialog
+ *
+ * Show the main configuration dialog used to access other
+ * configuration.
+ *
+ * @}
+ */
+
 #endif

src/modules/conf_applications/e_mod_main.h

@@ -19,4 +19,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Applications Applications Configuration
+ *
+ * Configure application icons (launchers ".desktop"), which
+ * applications to use on start or restart of Enlightenment.
+ *
+ * @}
+ */
 #endif

src/modules/conf_dialogs/e_mod_main.h

@@ -15,4 +15,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Dialogs Configuration Dialogs
+ *
+ * Controls how configuration dialogs behave (basic or advanced), as
+ * well as the configuration profile in use.
+ *
+ * @}
+ */
 #endif

src/modules/conf_display/e_mod_main.h

@@ -25,4 +25,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Display Display Configuration
+ *
+ * Configures the physical and virtual display, including screen
+ * saver, screen lock and power saving settings (DPMS).
+ *
+ * @}
+ */
 #endif

src/modules/conf_edgebindings/e_mod_main.h

@@ -13,4 +13,16 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_EdgeBindings Edge Bindings Configuration
+ *
+ * Controls action on screen edges and corners.
+ *
+ * @see Module_Conf_MouseBindings
+ * @see Module_Conf_KeyBindings
+ * @}
+ */
 #endif

src/modules/conf_interaction/e_mod_main.h

@@ -15,4 +15,14 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Interaction Interaction Configuration
+ *
+ * Configure mouse and touch screen behavior.
+ *
+ * @}
+ */
 #endif

src/modules/conf_intl/e_mod_main.h

@@ -15,4 +15,14 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Intl Internationalization Configurations
+ *
+ * Configure language and input method (e.g. Asian languages)
+ *
+ * @}
+ */
 #endif

src/modules/conf_keybindings/e_mod_main.h

@@ -17,4 +17,16 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_KeyBinding Key Bindings (Shortcuts) Configuration
+ *
+ * Configure global keyboard shortcuts.
+ *
+ * @see Module_Conf_MouseBinding
+ * @see Module_Conf_EdgeBinding
+ * @}
+ */
 #endif

src/modules/conf_menus/e_mod_main.h

@@ -13,4 +13,14 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Menus Menu Configuration
+ *
+ * Configures Enlightenment menus.
+ *
+ * @}
+ */
 #endif

src/modules/conf_paths/e_mod_main.h

@@ -15,4 +15,18 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Paths Paths & Environment Configuration
+ *
+ * Configures where to search for fonts, icons, images, themes,
+ * walpapers and others.
+ *
+ * Can also configure environment variables used and propagated by
+ * Enlightenment to child process and applications.
+ *
+ * @}
+ */
 #endif

src/modules/conf_performance/e_mod_main.h

@@ -15,4 +15,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Performance Performance Configuration
+ *
+ * Configures the frame rate, graphics engine and other performance
+ * switches.
+ *
+ * @}
+ */
 #endif

src/modules/conf_randr/e_mod_main.h

@@ -16,4 +16,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_RandR RandR (Screen Resize, Rotate and Mirror)
+ *
+ * Configures size, rotation and mirroring of screen. Uses the X11
+ * RandR protocol (does not work with NVidia proprietary drivers).
+ *
+ * @}
+ */
 #endif

src/modules/conf_shelves/e_mod_main.h

@@ -13,4 +13,16 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Shelves Shelves (Panels) Configuration
+ *
+ * Configure shelves (panels) that exist on screen. They may be
+ * horizontal or vertical, exist on top of below windows and usually
+ * contain sequence of @ref Optional_Gadgets.
+ *
+ * @}
+ */
 #endif

src/modules/conf_theme/e_mod_main.h

@@ -41,4 +41,14 @@ EAPI int   e_modapi_save     (E_Module *m);
 
 E_Config_Dialog *e_int_config_xsettings(E_Container *con, const char *params __UNUSED__);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Theme Theme Configuration
+ *
+ * Changes the graphical user interface theme and wallpaper.
+ *
+ * @}
+ */
 #endif

src/modules/conf_wallpaper2/e_mod_main.h

@@ -12,4 +12,18 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Wallpaper2 Wallpaper2 (Alternative Selector)
+ *
+ * More graphically appealing wallpaper selector. It is targeted at
+ * mobile devices.
+ *
+ * @note under development and not recommended for use yet.
+ *
+ * @see Module_Conf_Theme
+ * @}
+ */
 #endif

src/modules/conf_window_manipulation/e_mod_main.h

@@ -19,4 +19,16 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Window_Manipulation Window Manipulation Configuration
+ *
+ * Configures how windows are placed, maximized, focused, stacked and
+ * so on.
+ *
+ * @see Module_Conf_Window_Remembers
+ * @}
+ */
 #endif

src/modules/conf_window_remembers/e_mod_main.h

@@ -12,4 +12,15 @@ EAPI void *e_modapi_init(E_Module *m);
 EAPI int e_modapi_shutdown(E_Module *m);
 EAPI int e_modapi_save(E_Module *m);
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Conf_Window_Remembers Window Remembers Configuration
+ *
+ * Choose which windows and properties to remember, such as size,
+ * stacking, virtual desktop, position and so on.
+ *
+ * @}
+ */
 #endif

src/modules/connman/e_mod_main.h

@@ -181,4 +181,17 @@ _connman_ctxt_technology_find_stringshare(const E_Connman_Module_Context *ctxt,
    return NULL;
 }
 
+/**
+ * @addtogroup Optional_Devices
+ * @{
+ *
+ * @defgroup Module_Connman ConnMan (Connection Manager)
+ *
+ * Controls network connections for ethernet, wifi, 3G, GSM and
+ * bluetooth (PAN).
+ *
+ * @see http://connman.net/
+ * @}
+ */
+
 #endif

src/modules/cpufreq/e_mod_main.h

@@ -48,4 +48,17 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_CPUFreq CPU Frequency Monitor
+ *
+ * Monitors CPU frequency and may do actions given some thresholds.
+ *
+ * @see Module_Temperature
+ * @see Module_Battery
+ * @}
+ */
 #endif

src/modules/dropshadow/e_mod_main.h

@@ -109,4 +109,16 @@ EAPI int   e_modapi_info     (E_Module *m);
 
 void  _dropshadow_cb_config_updated(void *data);
 
+
+/**
+ * @addtogroup Optional_Look
+ * @{
+ *
+ * @defgroup Module_Dropshadow Drop Shadow
+ *
+ * Drops shadow on desktop for visible windows. This is a poor's man
+ * solution for people that do not have @ref Module_Comp.
+ *
+ * @}
+ */
 #endif

src/modules/everything/e_mod_main.h

@@ -371,4 +371,18 @@ extern Eina_List *_refd;
 extern double _evry_time;
 #endif
 
+
+/**
+ * @addtogroup Optional_Launcher
+ * @{
+ *
+ * @defgroup Module_Everything Everything Launcher
+ *
+ * Flexible launcher with plugins. Can do search as you type
+ * filtering, browse directories, view pictures, simple math, spell
+ * checking and of course: launching programs and executing commands.
+ *
+ * @}
+ */
+
 #endif

src/modules/fileman/e_mod_main.h

@@ -87,4 +87,17 @@ EAPI int   e_modapi_save     (E_Module *m);
 
 extern Config *fileman_config;
 
+/**
+ * @addtogroup Optional_Fileman
+ * @{
+ *
+ * @defgroup Module_Fileman File Manager
+ *
+ * Basic file manager with list and grid view, shows thumbnails, can
+ * copy, cut, paste, delete and rename files.
+ *
+ * @see Module_Fileman_Opinfo
+ * @}
+ */
+
 #endif

src/modules/fileman_opinfo/e_mod_main.h

@@ -7,4 +7,16 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Fileman
+ * @{
+ *
+ * @defgroup Module_Fileman_Opinfo File Manager Operation Information
+ *
+ * Shows information about file manager operations such as copy, move
+ * and delete.
+ *
+ * @}
+ */
+
 #endif

src/modules/gadman/e_mod_main.h

@@ -7,4 +7,15 @@ EAPI void *e_modapi_init(E_Module *m);
 EAPI int e_modapi_shutdown(E_Module *m);
 EAPI int e_modapi_save(E_Module *m);
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Gadman Gadman (Gadget Manager)
+ *
+ * Manages @ref Optional_Gadgets on desktop or overlay.
+ *
+ * @}
+ */
+
 #endif

src/modules/ibar/e_mod_main.h

@@ -34,4 +34,15 @@ void _ibar_config_update(Config_Item *ci);
 void _config_ibar_module(Config_Item *ci);
 extern Config *ibar_config;
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_IBar IBar (Icon Launch Bar)
+ *
+ * Launches applications from an icon bar, usually placed on shelves.
+ *
+ * @}
+ */
+
 #endif

src/modules/ibox/e_mod_main.h

@@ -34,4 +34,15 @@ void _ibox_config_update(Config_Item *ci);
 void _config_ibox_module(Config_Item *ci);
 extern Config *ibox_config;
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_IBox IBox (Box of Iconified Windows)
+ *
+ * Keeps iconified (minimized) windows in a box, showing their icon
+ * and title.
+ *
+ * @}
+ */
 #endif

src/modules/illume2/doc/illume.dox.in

@@ -6,7 +6,7 @@
 
 @author Carsten Haitzler <raster\@rasterman.com>
 @author Christopher Michael <devilhorns\@comcast.net>
-@date 2000-2010
+@date 2000-2012
 
 @section intro Introduction
 
@@ -47,6 +47,11 @@ screens in more than one way using either xinerama or multi-head.
 
 // GROUP DEFINITIONS
 
+/**
+@addtogroup Module_Illume2
+@{
+*/
+
 /**
 @defgroup E_Illume_Keyboard_Group Illume Keyboard Information
 
@@ -77,3 +82,7 @@ The following group defines information pertaining to Illume Configuration.
 
 The following group defines information pertaining to Illume Quickpanels.
 */
+
+/**
+ @}
+*/

src/modules/illume2/e_illume.c

@@ -2,6 +2,9 @@
 #include "e_mod_config.h"
 
 /**
+ * @addtogroup Module_Illume2
+ * @{
+ *
  * @defgroup E_Illume_Main_Group Illume API Information
  * 
  * The following group defines variables, structures, and functions available 
@@ -1004,3 +1007,7 @@ e_illume_quickpanel_hide(E_Zone *zone)
    ecore_x_e_illume_quickpanel_state_send(zone->black_win, 
                                           ECORE_X_ILLUME_QUICKPANEL_STATE_OFF);
 }
+
+/**
+ * @}
+ */

src/modules/illume2/e_mod_main.h

@@ -7,4 +7,16 @@ EAPI void *e_modapi_init(E_Module *m);
 EAPI int e_modapi_shutdown(E_Module *m);
 EAPI int e_modapi_save(E_Module *m);
 
+/**
+ * @addtogroup Optional_Mobile
+ * @{
+ *
+ * @defgroup Module_Illume2 Illume2
+ *
+ * Second generation of Illume mobile environment for Enlightenment.
+ *
+ * @see @ref Illume_Main_Page
+ *
+ * @}
+ */
 #endif

src/modules/layout/e_mod_main.h

@@ -7,4 +7,14 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Layouts
+ * @{
+ *
+ * @defgroup Module_Layout Layout Policy Enforcement
+ *
+ * Enforces window layout policies.
+ *
+ * @}
+ */
 #endif

src/modules/mixer/e_mod_main.h

@@ -126,4 +126,19 @@ extern E_Mixer_Cb e_mod_mixer_card_name_get;
 extern E_Mixer_Cb e_mod_mixer_cards_get;
 extern E_Mixer_Cb e_mod_mixer_cards_free;
 extern E_Mixer_Cb e_mod_mixer_card_default_get;
+
+/**
+ * @addtogroup Optional_Devices
+ * @{
+ *
+ * @defgroup Module_Mixer Audio Mixer (Volume Control)
+ *
+ * Controls the audio volume and mute status for both playback
+ * (output) and record (input) devices.
+ *
+ * Can work with ALSA (http://www.alsa-project.org/) or PulseAudio
+ * (http://www.pulseaudio.org/).
+ *
+ * @}
+ */
 #endif

src/modules/msgbus/e_mod_main.h

@@ -14,4 +14,17 @@ void msgbus_lang_init(Eina_Array *ifaces);
 void msgbus_desktop_init(Eina_Array *ifaces);
 void msgbus_audit_init(Eina_Array *ifaces);
 
+/**
+ * @addtogroup Optional_Control
+ * @{
+ *
+ * @defgroup Module_Msgbus MsgBus (DBus Remote Control)
+ *
+ * Allows Enlightenment to be controlled by DBus IPC (Inter Process
+ * Communication) protocol.
+ *
+ * @see http://www.freedesktop.org/wiki/Software/dbus
+ * @}
+ */
+
 #endif

src/modules/notification/e_mod_main.h

@@ -151,4 +151,18 @@ extern E_Module *notification_mod;
 extern Config   *notification_cfg;
 extern const E_Gadcon_Client_Class _gc_class;
 
+/**
+ * @addtogroup Optional_Monitors
+ * @{
+ *
+ * @defgroup Module_Notification Notification (Notify-OSD)
+ *
+ * Presents notifications on screen as an unobtrusive popup. It
+ * implements the Notify-OSD and FreeDesktop.org standards.
+ *
+ * @see http://www.galago-project.org/specs/notification/0.9/
+ * @see https://wiki.ubuntu.com/NotifyOSD
+ * @}
+ */
+
 #endif

src/modules/ofono/e_mod_main.h

@@ -113,4 +113,19 @@ _ofono_operation_error_show(const char *msg)
                       msg);
 }
 
+/**
+ * @addtogroup Optional_Devices
+ * @{
+ *
+ * @defgroup Module_OFono oFono (Telephony)
+ *
+ * oFono is the Linux Telephony stack and can be used to monitor
+ * network signal, send and receive SMS, connect to GPRS/Edge/3G/4G.
+ *
+ * @note The plugin is barebones and can just show devices, no SMS
+ *       management done yet.
+ *
+ * @see http://ofono.org/
+ * @}
+ */
 #endif

src/modules/pager/e_mod_main.h

@@ -49,4 +49,15 @@ void _pager_cb_config_updated(void);
 void _config_pager_module(Config_Item *ci);
 extern Config *pager_config;
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Pager Virtual Desktop Pager
+ *
+ * Shows the grid of virtual desktops and allows changing between
+ * them.
+ *
+ * @}
+ */
 #endif

src/modules/shot/e_mod_main.h

@@ -7,4 +7,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Look
+ * @{
+ *
+ * @defgroup Module_Shot Screenshot
+ *
+ * Takes screen shots and can submit them to http://enlightenment.org
+ *
+ * @}
+ */
+
 #endif

src/modules/start/e_mod_main.h

@@ -7,4 +7,14 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Start Start Button
+ *
+ * Shows a "start here" button or icon.
+ *
+ * @}
+ */
 #endif

src/modules/syscon/e_mod_main.h

@@ -15,4 +15,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Control
+ * @{
+ *
+ * @defgroup Module_Syscon SysCon (System Control)
+ *
+ * Controls your system actions such as shutdown, reboot, hibernate or
+ * suspend.
+ *
+ * @}
+ */
 #endif

src/modules/systray/e_mod_main.h

@@ -7,4 +7,17 @@ EAPI void *e_modapi_init(E_Module *m);
 EAPI int e_modapi_shutdown(E_Module *m);
 EAPI int e_modapi_save(E_Module *m);
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Systray Systray (System Icons Tray)
+ *
+ * Shows system icons in a box.
+ *
+ * The icons come from the FreeDesktop.Org systray specification.
+ *
+ * @see http://standards.freedesktop.org/systemtray-spec/systemtray-spec-latest.html
+ * @}
+ */
 #endif

src/modules/tasks/e_mod_main.h

@@ -32,4 +32,16 @@ void _config_tasks_module(Config_Item *ci);
 void _tasks_config_updated(Config_Item *ci);
 extern Config *tasks_config;
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Tasks Tasks (Task Bar)
+ *
+ * Shows windows as buttons in a box.
+ *
+ * @see Module_IBox
+ *
+ * @}
+ */
 #endif

src/modules/temperature/e_mod_main.h

@@ -82,4 +82,16 @@ void config_temperature_module(Config_Face *inst);
 void temperature_face_update_config(Config_Face *inst);
 Eina_List *temperature_get_bus_files(const char* bus);
 
+/**
+ * @addtogroup Optional_Gadgets
+ * @{
+ *
+ * @defgroup Module_Temperature Temperature
+ *
+ * Monitors computer temperature sensors and may do actions given some
+ * thresholds.
+ *
+ * @see Module_CPUFreq
+ * @}
+ */
 #endif

src/modules/winlist/e_mod_main.h

@@ -15,4 +15,15 @@ EAPI void *e_modapi_init     (E_Module *m);
 EAPI int   e_modapi_shutdown (E_Module *m);
 EAPI int   e_modapi_save     (E_Module *m);
 
+/**
+ * @addtogroup Optional_Control
+ * @{
+ *
+ * @defgroup Module_Winlist WinList (Windows Listing)
+ *
+ * Lists and switch windows, usually with "Alt-Tab" or "Alt-Shift-Tab"
+ * keyboard shortcuts. Can show a popup during the action.
+ *
+ * @}
+ */
 #endif

src/modules/wizard/e_mod_main.h

@@ -16,4 +16,18 @@ EAPI int   e_modapi_save     (E_Module *m);
 
 extern E_Module *wiz_module;
 
+/**
+ * @addtogroup Optional_Conf
+ * @{
+ *
+ * @defgroup Module_Wizard Wizard
+ *
+ * Configures the whole Enlightenment in a nice walk-through wizard.
+ *
+ * Usually is presented on the first run of Enlightenment. The wizard
+ * pages are configurable and should be extended by distributions that
+ * want to ship Enlightenment as the default window manager.
+ *
+ * @}
+ */
 #endif