Simple doxygen description for files in src directory.

Mostly \file and \brief tag added.

Signed-off-by: Mikhail S. Pobolovets <styx.mp@gmail.com>

src/achown.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file achown.c
+ *  \brief Source: Contains functions for advanced chowning
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/achown.h

@@ -1,3 +1,8 @@
+
+/** \file achown.h
+ *  \brief Header: Contains functions for advanced chowning
+ */
+
 #ifndef MC_ACHOWN_H
 #define MC_ACHOWN_H
 

src/background.c

@@ -22,6 +22,10 @@
 
 /* }}} */
 
+/** \file background.c
+ *  \brief Source: Background support
+ */
+
 #include <config.h>
 
 #ifdef WITH_BACKGROUND

src/background.h

@@ -1,3 +1,8 @@
+
+/** \file background.h
+ *  \brief Header: Background support
+ */
+
 #ifndef MC_BACKGROUND_H
 #define MC_BACKGROUND_H
 

src/boxes.c

@@ -20,6 +20,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file boxes.c
+ *  \brief Source: Some misc dialog boxes for the program
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/boxes.h

@@ -1,3 +1,8 @@
+
+/** \file boxes.h
+ *  \brief Header: Some misc dialog boxes for the program
+ */
+
 #ifndef MC_BOXES_H
 #define MC_BOXES_H
 

src/charsets.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+/** \file charsets.c
+ *  \brief Source: Text conversion from one charset to another
+ */
+
 #include <config.h>
 
 #ifdef HAVE_CHARSET

src/charsets.h

@@ -1,3 +1,8 @@
+
+/** \file charsets.h
+ *  \brief Header: Text conversion from one charset to another
+ */
+
 #ifndef MC_CHARSETS_H
 #define MC_CHARSETS_H
 

src/chmod.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file chmod.c
+ *  \brief Source: chmod command
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/chmod.h

@@ -1,3 +1,8 @@
+
+/** \file chmod.h
+ *  \brief Header: chmod command
+ */
+
 #ifndef MC_CHMOD_H
 #define MC_CHMOD_H
 

src/chown.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file chown.c
+ *  \brief Source: chown command
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/chown.h

@@ -1,3 +1,8 @@
+
+/** \file chown.h
+ *  \brief Header: chown command
+ */
+
 #ifndef MC_CHOWN_H
 #define MC_CHOWN_H
 

src/cmd.c

@@ -18,6 +18,12 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file cmd.c
+ *  \brief Source: routines invoked by a function key
+ *
+ *  They normally operate on the current panel.
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/cmd.h

@@ -1,3 +1,10 @@
+
+/** \file cmd.h
+ *  \brief Header: routines invoked by a function key
+ *
+ *  They normally operate on the current panel.
+ */
+
 #ifndef MC_CMD_H
 #define MC_CMD_H
 

src/color.c

@@ -16,6 +16,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file color.c
+ *  \brief Source: color setup
+ */
+
 #include <config.h>
 
 #include <stdio.h>

src/color.h

@@ -1,3 +1,8 @@
+
+/** \file color.h
+ *  \brief Header: color setup
+ */
+
 #ifndef MC_COLOR_H
 #define MC_COLOR_H
 

src/command.c

@@ -22,6 +22,10 @@
 
 */
 
+/** \file command.c
+ *  \brief Source: command line widget
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/command.h

@@ -1,3 +1,8 @@
+
+/** \file command.h
+ *  \brief Header: command line widget
+ */
+
 #ifndef MC_COMMAND_H
 #define MC_COMMAND_H
 

src/complete.c

@@ -20,6 +20,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file complete.c
+ *  \brief Source: Input line filename/username/hostname/variable/command completion
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/cons.handler.c

@@ -16,6 +16,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file cons.handler.c
+ *  \brief Source: client interface for General purpose Linux console save/restore server
+ */
+
 #include <config.h>
 
 #include <signal.h>

src/cons.saver.c

@@ -32,6 +32,17 @@
    Seeing other peoples consoles is bad thing, but believe me, full
    root is even worse. */
 
+/** \file cons.handler.c
+ *  \brief Source: general purpose Linux console screen save/restore server
+ *
+ *  This code does _not_ need to be setuid root. However, it needs
+ *  read/write access to /dev/vcsa* (which is priviledged
+ *  operation). You should create user vcsa, make cons.saver setuid
+ *  user vcsa, and make all vcsa's owned by user vcsa.
+ *  Seeing other peoples consoles is bad thing, but believe me, full
+ *  root is even worse.
+ */
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
 #endif

src/cons.saver.h

@@ -1,3 +1,15 @@
+
+/** \file cons.saver.h
+ *  \brief Header: general purpose Linux console screen save/restore server
+ *
+ *  This code does _not_ need to be setuid root. However, it needs
+ *  read/write access to /dev/vcsa* (which is priviledged
+ *  operation). You should create user vcsa, make cons.saver setuid
+ *  user vcsa, and make all vcsa's owned by user vcsa.
+ *  Seeing other peoples consoles is bad thing, but believe me, full
+ *  root is even worse.
+ */
+
 #ifndef MC_CONS_SAVER_H
 #define MC_CONS_SAVER_H
 

src/dialog.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+/** \file dialog.c
+ *  \brief Source: dialog box features module
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/dialog.h

@@ -16,6 +16,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+/** \file dialog.h
+ *  \brief Header: dialog box features module
+ */
+
 #ifndef MC_DLG_H
 #define MC_DLG_H
 

src/dir.c

@@ -16,6 +16,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file dir.c
+ *  \brief Source: directory routines
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/dir.h

@@ -1,3 +1,8 @@
+
+/** \file dir.h
+ *  \brief Header: directory routines
+ */
+
 #ifndef MC_DIR_H
 #define MC_DIR_H
 

src/ecs-test.c

@@ -22,6 +22,10 @@
    MA 02110-1301, USA.
  */
 
+/** \file  ecs-test.c
+ *  \brief Source: testsuite for basic support for extended character sets
+ */
+
 #include <config.h>
 
 #undef NDEBUG

src/ecs.c

@@ -22,6 +22,10 @@
    MA 02110-1301, USA.
  */
 
+/** \file  ecs.c
+ *  \brief Source: basic support for extended character sets
+ */
+
 #include <config.h>
 
 #include <assert.h>

src/ecs.h

@@ -22,6 +22,10 @@
    MA 02110-1301, USA.
  */
 
+/** \file  ecs.h
+ *  \brief Header: basic support for extended character sets
+ */
+
 #ifndef MC_ECS_H
 #define MC_ECS_H
 

src/eregex.h

@@ -19,6 +19,10 @@
    Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
    02110-1301 USA.  */
 
+/** \file  eregex.h
+ *  \brief Header: data structures and routines for the regular expression library
+ */
+
 #ifndef USE_INCLUDED_REGEX
 #include <regex.h>
 #else

src/execute.c

@@ -15,6 +15,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file  execute.c
+ *  \brief Source: execution routines
+ */
+
 #include <config.h>
 
 #include <signal.h>

src/execute.h

@@ -1,3 +1,8 @@
+
+/** \file  execute.h
+ *  \brief Header: execution routines
+ */
+
 #ifndef MC_EXECUTE_H
 #define MC_EXECUTE_H
 

src/ext.c

@@ -19,6 +19,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file  ext.c
+ *  \brief Source: extension dependent execution
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/ext.h

@@ -1,3 +1,8 @@
+
+/** \file  ext.h
+ *  \brief Header: extension dependent execution
+ */
+
 #ifndef MC_EXT_H
 #define MC_EXT_H
 

src/file.c

@@ -37,6 +37,10 @@
  * operations.
  */
 
+/** \file  file.c
+ *  \brief Source: file management
+ */
+
 /* {{{ Include files */
 
 #include <config.h>

src/file.h

@@ -1,3 +1,8 @@
+
+/** \file  file.h
+ *  \brief Header: file management
+ */
+
 #ifndef MC_FILE_H
 #define MC_FILE_H
 

src/filegui.c

@@ -39,6 +39,9 @@
  * operations.
  */
 
+/** \file  filegui.c
+ *  \brief Source: file management GUI for the text mode edition
+ */
 
 /* {{{ Include files */
 

src/filegui.h

@@ -1,3 +1,8 @@
+
+/** \file  filegui.h
+ *  \brief Header: file management GUI for the text mode edition
+ */
+
 #ifndef MC_FILEGUI_H
 #define MC_FILEGUI_H
 

src/fileloc.h

@@ -1,16 +1,19 @@
+
+/** \file  fileloc.h
+ *  \brief Header: config files list
+ *
+ *  This file defines the locations of the various user specific
+ *  configuration files of the Midnight Commander. Historically the
+ *  system wide and the user specific file names have not always been
+ *  the same, so don't use these names for finding system wide
+ *  configuration files.
+ *
+ *  \todo This inconsistency should disappear in the one of the next versions (5.0?)
+ */
+
 #ifndef MC_FILELOC_H
 #define MC_FILELOC_H
 
-/*
-    This file defines the locations of the various user specific
-    configuration files of the Midnight Commander. Historically the
-    system wide and the user specific file names have not always been
-    the same, so don't use these names for finding system wide
-    configuration files.
-
-    TODO: This inconsistency should disappear in version 5.0.
-*/
-
 #define MC_USERCONF_DIR		".mc"
 
 #define MC_BASHRC_FILE		"bashrc"

src/filenot.c

@@ -22,6 +22,13 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+
+/** \file  filenot.c
+ *  \brief Source: wrapper for routines to notify the
+ *  tree about the changes made to the directory
+ *  structure.
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/fileopctx.c

@@ -21,6 +21,13 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+/** \file fileopctx.c
+ *  \brief Source: file operation contexts
+ *  \date 1998-2007
+ *  \author Federico Mena <federico@nuclecu.unam.mx>
+ *  \author Miguel de Icaza <miguel@nuclecu.unam.mx>
+ */
+
 #include <config.h>
 
 #include <unistd.h>
@@ -31,12 +38,12 @@
 
 /**
  * file_op_context_new:
- * 
+ *
  * Creates a new file operation context with the default values.  If you later want
  * to have a user interface for this, call #file_op_context_create_ui().
- * 
+ *
  * Return value: The newly-created context, filled with the default file mask values.
- **/
+ */
 FileOpContext *
 file_op_context_new (FileOperation op)
 {
@@ -61,10 +68,10 @@ file_op_context_new (FileOperation op)
 /**
  * file_op_context_destroy:
  * @ctx: The file operation context to destroy.
- * 
+ *
  * Destroys the specified file operation context and its associated UI data, if
  * it exists.
- **/
+ */
 void
 file_op_context_destroy (FileOpContext *ctx)
 {

src/fileopctx.h

@@ -1,9 +1,15 @@
+
+/** \file fileopctx.h
+ *  \brief Header: file operation contexts
+ *  \date 1998
+ *  \author Federico Mena <federico@nuclecu.unam.mx>
+ *  \author Miguel de Icaza <miguel@nuclecu.unam.mx>
+ */
+
 /* File operation contexts for the Midnight Commander
  *
  * Copyright (C) 1998 Free Software Foundation, Inc.
  *
- * Authors: Federico Mena <federico@nuclecu.unam.mx>
- *          Miguel de Icaza <miguel@nuclecu.unam.mx>
  */
 
 #ifndef FILEOPCTX_H

src/find.c

@@ -19,6 +19,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file find.c
+ *  \brief Source: Find file command
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/find.h

@@ -1,3 +1,8 @@
+
+/** \file find.h
+ *  \brief Header: Find file command
+ */
+
 #ifndef MC_FIND_H
 #define MC_FIND_H
 

src/findme.c

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from 
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file findme.c
+ *  \brief Source: findProgramPath function
+ */
+
 #include <config.h>
 
 #include "poptalloca.h"

src/findme.h

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file findme.h
+ *  \brief Header: findProgramPath function
+ */
+
 #ifndef MC_FINDME_H
 #define MC_FINDME_H
 

src/fs.h

@@ -1,3 +1,8 @@
+
+/** \file fs.h
+ *  \brief Header: fs compatibility definitions
+ */
+
 /* Include file to use opendir/closedir/readdir */
 
 #ifndef MC_FS_H

src/fsusage.c

@@ -17,6 +17,12 @@
    along with this program; if not, write to the Free Software Foundation,
    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file fsusage.c
+ *  \brief Source: return space usage of mounted file systems
+ *
+ *  Space usage statistics for a file system.  Blocks are 512-byte
+ */
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
 #endif

src/fsusage.h

@@ -19,6 +19,13 @@
 
 /* Space usage statistics for a file system.  Blocks are 512-byte. */
 
+/** \file fsusage.h
+ *  \brief Header: return space usage of mounted file systems
+ *
+ *  Space usage statistics for a file system.  Blocks are 512-byte
+ */
+
+
 #if !defined MC_FSUSAGE_H
 # define MC_FSUSAGE_H
 

src/glibcompat.c

@@ -17,9 +17,11 @@
  * Boston, MA 02110-1301, USA.
  */
 
-/*
- * Following code was copied from glib to GNU Midnight Commander to
- * provide compatibility with older versions of glib.
+/** \file glibcompat.c
+ *  \brief Source: old glib compatibility
+ *
+ *  Following code was copied from glib to GNU Midnight Commander to
+ *  provide compatibility with older versions of glib.
  */
 
 #include <config.h>

src/glibcompat.h

@@ -15,6 +15,13 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file glibcompat.h
+ *  \brief Header: old glib compatibility
+ *
+ *  Following code was copied from glib to GNU Midnight Commander to
+ *  provide compatibility with older versions of glib.
+ */
+
 #ifndef MC_GLIBCOMPAT_H
 #define MC_GLIBCOMPAT_H
 

src/global.h

@@ -1,8 +1,11 @@
-/*
- * This file should be included after all system includes and before
- * all local includes.
+
+/** \file global.h
+ *  \brief Header: global definitions for compatibility
+ *
+ *  This file should be included after all system includes and before all local includes.
  */
 
+
 #ifndef MC_GLOBAL_H
 #define MC_GLOBAL_H
 

src/help.c

@@ -17,29 +17,32 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */
 
-/*
-   Implements the hypertext file viewer.
-   The hypertext file is a file that may have one or more nodes.  Each
-   node ends with a ^D character and starts with a bracket, then the
-   name of the node and then a closing bracket. Right after the closing
-   bracket a newline is placed. This newline is not to be displayed by
-   the help viewer and must be skipped - its sole purpose is to faciliate
-   the work of the people managing the help file template (xnc.hlp) .
 
-   Links in the hypertext file are specified like this: the text that
-   will be highlighted should have a leading ^A, then it comes the
-   text, then a ^B indicating that highlighting is done, then the name
-   of the node you want to link to and then a ^C.
+/** \file help.c
+ *  \brief Source: hypertext file browser
+ *
+ *  Implements the hypertext file viewer.
+ *  The hypertext file is a file that may have one or more nodes.  Each
+ *  node ends with a ^D character and starts with a bracket, then the
+ *  name of the node and then a closing bracket. Right after the closing
+ *  bracket a newline is placed. This newline is not to be displayed by
+ *  the help viewer and must be skipped - its sole purpose is to faciliate
+ *  the work of the people managing the help file template (xnc.hlp) .
+ *
+ *  Links in the hypertext file are specified like this: the text that
+ *  will be highlighted should have a leading ^A, then it comes the
+ *  text, then a ^B indicating that highlighting is done, then the name
+ *  of the node you want to link to and then a ^C.
+ *
+ *  The file must contain a ^D at the beginning and at the end of the
+ *  file or the program will not be able to detect the end of file.
+ *
+ *  Lazyness/widgeting attack: This file does use the dialog manager
+ *  and uses mainly the dialog to achieve the help work.  there is only
+ *  one specialized widget and it's only used to forward the mouse messages
+ *  to the appropiate routine.
+ */
 
-   The file must contain a ^D at the beginning and at the end of the
-   file or the program will not be able to detect the end of file.
-
-   Lazyness/widgeting attack: This file does use the dialog manager
-   and uses mainly the dialog to achieve the help work.  there is only
-   one specialized widget and it's only used to forward the mouse messages
-   to the appropiate routine.
-   
-*/
 
 #include <config.h>
 

src/help.h

@@ -1,8 +1,34 @@
+
+/** \file help.h
+ *  \brief Header: hypertext file browser
+ *
+ *  Implements the hypertext file viewer.
+ *  The hypertext file is a file that may have one or more nodes.  Each
+ *  node ends with a ^D character and starts with a bracket, then the
+ *  name of the node and then a closing bracket. Right after the closing
+ *  bracket a newline is placed. This newline is not to be displayed by
+ *  the help viewer and must be skipped - its sole purpose is to faciliate
+ *  the work of the people managing the help file template (xnc.hlp) .
+ *
+ *  Links in the hypertext file are specified like this: the text that
+ *  will be highlighted should have a leading ^A, then it comes the
+ *  text, then a ^B indicating that highlighting is done, then the name
+ *  of the node you want to link to and then a ^C.
+ *
+ *  The file must contain a ^D at the beginning and at the end of the
+ *  file or the program will not be able to detect the end of file.
+ *
+ *  Lazyness/widgeting attack: This file does use the dialog manager
+ *  and uses mainly the dialog to achieve the help work.  there is only
+ *  one specialized widget and it's only used to forward the mouse messages
+ *  to the appropiate routine.
+ *
+ *  This file is included by help.c and man2hlp.c
+ */
+
 #ifndef MC_HELP_H
 #define MC_HELP_H
 
-/* This file is included by help.c and man2hlp.c */
-
 #define HELP_TEXT_WIDTH 58
 
 /* Markers used in the help files */

src/history.h

@@ -1,3 +1,8 @@
+
+/** \file history.h
+ *  \brief Header: defines history section names
+ */
+
 #ifndef __MC_HISTORY_H
 #define __MC_HISTORY_H
 

src/hotlist.c

@@ -27,6 +27,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file hotlist.c
+ *  \brief Source: directory hotlist
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/hotlist.h

@@ -1,3 +1,8 @@
+
+/** \file hotlist.h
+ *  \brief Header: directory hotlist
+ */
+
 #ifndef MC_HOTLIST_H
 #define MC_HOTLIST_H
 

src/info.c

@@ -16,6 +16,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file info.c
+ *  \brief Source: panel managing
+ */
+
 #include <config.h>
 
 #include <stdio.h>

src/info.h

@@ -1,3 +1,8 @@
+
+/** \file info.h
+ *  \brief Header: panel managing
+ */
+
 #ifndef MC_INFO_H
 #define MC_INFO_H
 

src/key.c

@@ -22,6 +22,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file key.c
+ *  \brief Source: keyboard support routines
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/key.h

@@ -1,3 +1,8 @@
+
+/** \file key.h
+ *  \brief Header: keyboard support routines
+ */
+
 #ifndef MC_KEY_H
 #define MC_KEY_H
 

src/keyxdef.c

@@ -22,21 +22,23 @@
 
 /* }}} */
 
-/*
+/** \file keyxdef.c
+ *  \brief Source: additional keyboard support routines
+ *
  * PURPOSE:
- * 
  *   We would like to support the direct ALT-?/META-? and some other 'extra'
  *   keyboard functionality provided by some terminals under some OSes (and
  *   not supported by the 'learn keys...' facility of 'mc'.
  *   (First target platform: QNX.)
- * 
+ *
  * REMARK:
- * 
+ *
  *   Implementation strategy: we don't want to rely on a specific terminal
  *   information database management API (termcap,terminfo,SLang,...), so we
  *   try to define a superset of the possible key identifiers here.
  *
  */
+
 #include <config.h>
 
 #include "global.h"

src/layout.c

@@ -20,6 +20,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file layout.c
+ *  \brief Source: panel layout module
+ */
+
 #include <config.h>
 
 #include <signal.h>

src/layout.h

@@ -1,3 +1,8 @@
+
+/** \file layout.h
+ *  \brief Header: panel layout module
+ */
+
 #ifndef MC_LAYOUT_H
 #define MC_LAYOUT_H
 

src/learn.c

@@ -19,6 +19,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file learn.c
+ *  \brief Source: learn keys module
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/learn.h

@@ -1,3 +1,8 @@
+
+/** \file learn.h
+ *  \brief Header: learn keys module
+ */
+
 #ifndef MC_LEARN_H
 #define MC_LEARN_H
 

src/listmode.c

@@ -20,6 +20,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file listmod.c
+ *  \brief Source: directory panel listing format editor
+ */
+
 #include <config.h>
 
 #ifdef LISTMODE_EDITOR

src/listmode.h

@@ -1,3 +1,8 @@
+
+/** \file listmod.h
+ *  \brief Header: directory panel listing format editor
+ */
+
 #ifndef MC_LISTMODE_H
 #define MC_LISTMODE_H
 

src/logging.c

@@ -21,6 +21,10 @@
    MA 02110-1301, USA.
  */
 
+/** \file logging.c
+ *  \brief Source: provides a log file to ease tracing the program
+ */
+
 #include <config.h>
 
 #include <stdarg.h>

src/logging.h

@@ -1,3 +1,8 @@
+
+/** \file logging.h
+ *  \brief Header: provides a log file to ease tracing the program
+ */
+
 #ifndef MC_LOGGING_H
 #define MC_LOGGING_H
 

src/main-widgets.h

@@ -1,3 +1,8 @@
+
+/** \file main-widgets.h
+ *  \brief Header: provides definitions for some widgets
+ */
+
 #ifndef MC_MAIN_WIDGETS_H
 #define MC_MAIN_WIDGETS_H
 

src/main.c

@@ -20,6 +20,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file main.c
+ *  \brief Source: this is a main module
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/main.h

@@ -1,3 +1,8 @@
+
+/** \file main.h
+ *  \brief Header: this is a main module header
+ */
+
 #ifndef MC_MAIN_H
 #define MC_MAIN_H
 

src/man2hlp.c

@@ -18,6 +18,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file man2hlp.c
+ *  \brief Source: man page to help file converter
+ */
+
 #include <config.h>
 
 #include <stdarg.h>

src/menu.c

@@ -16,6 +16,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file menu.c
+ *  \brief Source: pulldown menu code
+ */
+
 #include <config.h>
 
 #include <ctype.h>

src/menu.h

@@ -1,3 +1,8 @@
+
+/** \file menu.h
+ *  \brief Header: pulldown menu code
+ */
+
 #ifndef MC_MENU_H
 #define MC_MENU_H
 

src/mfmt.c

@@ -16,6 +16,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
+/** \file mfmt.c
+ *  \brief Source: sets bold and underline for mail files
+ */
+
 #include <stdio.h>
 
 enum states {

src/mountlist.c

@@ -15,6 +15,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file mountlist.c
+ *  \brief Source: list of mounted filesystems
+ */
+
 #include <config.h>
 
 #include <stdio.h>

src/mountlist.h

@@ -15,6 +15,10 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
+/** \file mountlist.h
+ *  \brief Header: list of mounted filesystems
+ */
+
 #ifndef MC_MOUNTLIST_H
 #define MC_MOUNTLIST_H
 

src/mouse.c

@@ -16,8 +16,11 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
-/* Events received by clients of this library have their coordinates 0 */
-/* based */
+/** \file mouse.c
+ *  \brief Source: mouse managing
+ *
+ *  Events received by clients of this library have their coordinates 0 based
+ */
 
 #include <config.h>
 

src/mouse.h

@@ -1,3 +1,10 @@
+
+/** \file mouse.h
+ *  \brief Header: mouse managing
+ *
+ *  Events received by clients of this library have their coordinates 0 based
+ */
+
 #ifndef MC_MOUSE_H
 #define MC_MOUSE_H
 

src/myslang.h

@@ -1,3 +1,8 @@
+
+/** \file myslang.h
+ *  \brief Header: slang wrapper module
+ */
+
 #ifndef MC_MYSLANG_H
 #define MC_MYSLANG_H
 

src/option.c

@@ -17,6 +17,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file option.c
+ *  \brief Source: configure box module
+ */
+
 #include <config.h>
 
 #include <stdio.h>

src/option.h

@@ -1,3 +1,8 @@
+
+/** \file option.h
+ *  \brief Header: configure box module
+ */
+
 #ifndef MC_OPTION_H
 #define MC_OPTION_H
 

src/panel.h

@@ -1,3 +1,8 @@
+
+/** \file panel.h
+ *  \brief Header: defines WPanel structure
+ */
+
 #ifndef MC_PANEL_H
 #define MC_PANEL_H
 

src/panelize.c

@@ -20,6 +20,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file panelize.c
+ *  \brief Source: External panelization module
+ */
+
 #include <config.h>
 
 #include <errno.h>

src/panelize.h

@@ -1,3 +1,8 @@
+
+/** \file panelize.h
+ *  \brief Header: External panelization module
+ */
+
 #ifndef MC_PANELIZE_H
 #define MC_PANELIZE_H
 

src/pipethrough.c

@@ -16,6 +16,14 @@
     Roland Illig <roland.illig@gmx.de>, 2004.
 */
 
+
+/** \file pipethrough.c
+ *  \brief Source: a module for piping
+ *
+ *  Pipe a buffer through a child command and receive two containing
+ *  the stdout and stderr output of the child process.
+ */
+
 #ifdef HAVE_CONFIG_H
 #  include <config.h>
 #endif

src/pipethrough.h

@@ -1,3 +1,11 @@
+
+/** \file pipethrough.h
+ *  \brief Header: a module for piping
+ *
+ *  Pipe a buffer through a child command and receive two containing
+ *  the stdout and stderr output of the child process.
+ */
+
 #ifndef PIPETHROUGH_H
 #define PIPETHROUGH_H
 

src/popt.c

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from 
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file popt.c
+ *  \brief Source: a module for parsing command line options
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

src/popt.h

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file popt.h
+ *  \brief Header: a module for parsing command line options
+ */
+
 #ifndef MC_POPT_H
 #define MC_POPT_H
 

src/poptalloca.h

@@ -1,13 +1,17 @@
-/* Definitions for alloca (mostly extracted from AC_FUNC_ALLOCA). According
-   to the autoconf manual in dome versions of AIX the declaration of alloca
-   has to precede everything else execept comments and prepocessor directives,
-   i.e. including this file has to preceed anything else.
 
-   NOTE: alloca is redefined as malloc on systems which fail to support alloca.
-   Don't include this header if you frequently use alloca in order to avoid an
-   unlimited amount of memory leaks.
-   popt uses alloca only during program startup, i.e. the memory leaks caused
-   by this redefinition are limited.
+/** \file poptalloca.h
+ *  \brief Header: definitions for alloca for popt
+ *
+ *  Definitions for alloca (mostly extracted from AC_FUNC_ALLOCA). According
+ *  to the autoconf manual in dome versions of AIX the declaration of alloca
+ *  has to precede everything else execept comments and prepocessor directives,
+ *  i.e. including this file has to preceed anything else.
+ *
+ *  NOTE: alloca is redefined as malloc on systems which fail to support alloca.
+ *  Don't include this header if you frequently use alloca in order to avoid an
+ *  unlimited amount of memory leaks.
+ *  popt uses alloca only during program startup, i.e. the memory leaks caused
+ *  by this redefinition are limited.
  */
 
 #ifndef MC_POPTALLOCA_H

src/poptconfig.c

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from 
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file poptconfig.c
+ *  \brief Source: a module for configuring popt
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

src/popthelp.c

@@ -4,6 +4,10 @@
    file accompanying popt source distributions, available from 
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file popthelp.c
+ *  \brief Source: popt helper module
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

src/poptint.h

@@ -2,6 +2,10 @@
    file accompanying popt source distributions, available from
    ftp://ftp.redhat.com/pub/code/popt */
 
+/** \file poptint.h
+ *  \brief Header: a module (internal?) for popt
+ */
+
 #ifndef MC_POPTINT_H
 #define MC_POPTINT_H
 

src/poptparse.c

@@ -2,6 +2,11 @@
    file accompanying popt source distributions, available from 
    ftp://ftp.redhat.com/pub/code/popt */
 
+
+/** \file poptparse.c
+ *  \brief Source: popt parser
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif

src/profile.c

@@ -21,6 +21,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. 
  */
 
+/** \file profile.c
+ *  \brief Source: Initialization-files(ini) functions.
+ */
+
 #include <config.h>
 
 #include <stdio.h>

src/profile.h

@@ -1,3 +1,8 @@
+
+/** \file profile.h
+ *  \brief Header: Initialization-files(ini) functions.
+ */
+
 #ifndef MC_PROFILE_H
 #define MC_PROFILE_H
 

src/regex.c

@@ -20,6 +20,11 @@
    Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
    02110-1301 USA.  */
 
+/** \file regex.c
+ *  \brief Source: extended regular expression matching and search library
+ *  \version 0.12
+ */
+
 /* AIX requires this to be the first thing in the file. */
 #if defined _AIX && !defined REGEX_MALLOC
   #pragma alloca

src/rxvt.c

@@ -16,6 +16,10 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
+/** \file rxvt.c
+ *  \brief Source: gives output lines on rxvt with a special rxvt patch
+ */
+
 #include <config.h>
 
 #include <stdio.h>