diff --git a/src/cons.handler.c b/src/cons.handler.c
index da0cda9b4..1574e7e0c 100644
--- a/src/cons.handler.c
+++ b/src/cons.handler.c
@@ -17,7 +17,7 @@
    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
+ *  \brief Source: client %interface for General purpose Linux console save/restore server
  */
 
 #include <config.h>
diff --git a/src/cons.saver.c b/src/cons.saver.c
index 8c2577802..72bb3eeff 100644
--- a/src/cons.saver.c
+++ b/src/cons.saver.c
@@ -32,7 +32,7 @@
    Seeing other peoples consoles is bad thing, but believe me, full
    root is even worse. */
 
-/** \file cons.handler.c
+/** \file cons.saver.c
  *  \brief Source: general purpose Linux console screen save/restore server
  *
  *  This code does _not_ need to be setuid root. However, it needs
diff --git a/src/global.h b/src/global.h
index 04e01954a..a4fd4d28e 100644
--- a/src/global.h
+++ b/src/global.h
@@ -1,6 +1,6 @@
 
 /** \file global.h
- *  \brief Header: global definitions for compatibility
+ *  \brief Header: %global definitions for compatibility
  *
  *  This file should be included after all system includes and before all local includes.
  */
diff --git a/src/listmode.c b/src/listmode.c
index 7581a958a..dff24845b 100644
--- a/src/listmode.c
+++ b/src/listmode.c
@@ -20,7 +20,7 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  
  */
 
-/** \file listmod.c
+/** \file listmode.c
  *  \brief Source: directory panel listing format editor
  */
 
diff --git a/src/listmode.h b/src/listmode.h
index 1405c42f0..d6b5e9df7 100644
--- a/src/listmode.h
+++ b/src/listmode.h
@@ -1,5 +1,5 @@
 
-/** \file listmod.h
+/** \file listmode.h
  *  \brief Header: directory panel listing format editor
  */
 
diff --git a/src/selcodepage.c b/src/selcodepage.c
index b44d313bf..753c9c19a 100644
--- a/src/selcodepage.c
+++ b/src/selcodepage.c
@@ -18,7 +18,7 @@
  */
 
 /** \file selcodepage.c
- *  \brief Source: user interface for charset selection
+ *  \brief Source: user %interface for charset %selection
  */
 
 #include <config.h>
diff --git a/src/selcodepage.h b/src/selcodepage.h
index 067f72d0d..f36aefad7 100644
--- a/src/selcodepage.h
+++ b/src/selcodepage.h
@@ -1,6 +1,6 @@
 
 /** \file selcodepage.h
- *  \brief Header: user interface for charset selection
+ *  \brief Header: user %interface for charset %selection
  */
 
 #ifndef MC_SELCODEPAGE_H
diff --git a/src/slint.c b/src/slint.c
index 16763b037..c296164a9 100644
--- a/src/slint.c
+++ b/src/slint.c
@@ -22,7 +22,7 @@
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
 /** \file slint.c
- *  \brief Source: slang interface to the Midnight Commander
+ *  \brief Source: slang %interface to the Midnight Commander
  *  \warning This module will be removed soon
  */
 
diff --git a/src/tty.c b/src/tty.c
index 4dcd182bb..0ac09ecf9 100644
--- a/src/tty.c
+++ b/src/tty.c
@@ -25,7 +25,7 @@
  */
 
 /** \file tty.c
- *  \brief Source: interface to the terminal controlling library
+ *  \brief Source: %interface to the terminal controlling library
  */
 
 #include <config.h>
diff --git a/src/tty.h b/src/tty.h
index f6579c28b..6bd3aec00 100644
--- a/src/tty.h
+++ b/src/tty.h
@@ -1,17 +1,16 @@
 
 /** \file tty.h
- *  \brief Header: interface to the terminal controlling library
+ *  \brief Header: %interface to the terminal controlling library
+ *
+ *  This file is the %interface to the terminal controlling library:
+ *  ncurses, slang or the built-in slang. It provides an additional
+ *  layer of abstraction above the "real" libraries to keep the number
+ *  of ifdefs in the other files small.
  */
 
 #ifndef MC_TTY_H
 #define MC_TTY_H
 
-/*
-    This file is the interface to the terminal controlling library---
-    ncurses, slang or the built-in slang. It provides an additional
-    layer of abstraction above the "real" libraries to keep the number
-    of ifdefs in the other files small.
- */
 
 #ifdef HAVE_SLANG
 #   include "myslang.h"
diff --git a/src/util.c b/src/util.c
index 4b69be5f1..cb3068ab1 100644
--- a/src/util.c
+++ b/src/util.c
@@ -22,7 +22,7 @@
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
 
-/** \file util.c
+/** \file
  *  \brief Source: various utilities
  */