Doxygenization and junk purging that was missed by my script.

60 files changed, 37 insertions, 307 deletions

diff --git a/crawl-ref/source/branch-data.h b/crawl-ref/source/branch-data.h
index 17b0247a74..95361d4207 100644
--- a/crawl-ref/source/branch-data.h
+++ b/crawl-ref/source/branch-data.h
@@ -1,7 +1,3 @@
-/*
- *  File:       branch-data.h
- */
-
 #ifndef BRANCHDATA_H
 #define BRANCHDATA_H
 
diff --git a/crawl-ref/source/branch.cc b/crawl-ref/source/branch.cc
index 1beefab011..2f08704dec 100644
--- a/crawl-ref/source/branch.cc
+++ b/crawl-ref/source/branch.cc
@@ -1,8 +1,3 @@
-/*
- *  File:       branch.cc
- *  Created by: haranp on Wed Dec 20 20:08:15 2006 UTC
- */
-
 #include "AppHdr.h"
 
 #include "branch.h"
diff --git a/crawl-ref/source/clua.cc b/crawl-ref/source/clua.cc
index d1fbb02b41..d8e9197a68 100644
--- a/crawl-ref/source/clua.cc
+++ b/crawl-ref/source/clua.cc
@@ -1,8 +1,3 @@
-/*
- *  File:       clua.cc
- *  Created by: dshaligram on Wed Aug 2 12:54:15 2006 UTC
- */
-
 #include "AppHdr.h"
 
 #include "clua.h"
diff --git a/crawl-ref/source/clua.h b/crawl-ref/source/clua.h
index c788b4f3d6..3099461fa2 100644
--- a/crawl-ref/source/clua.h
+++ b/crawl-ref/source/clua.h
@@ -1,9 +1,3 @@
-/*
- *  File:       clua.h
- *  Created by: dshaligram on Wed Aug 2 12:54:15 2006 UTC
- */
-
-
 #ifndef __CLUA_H__
 #define __CLUA_H__
 
diff --git a/crawl-ref/source/describe.h b/crawl-ref/source/describe.h
index 0dd471a1c3..bdcaa42b74 100644
--- a/crawl-ref/source/describe.h
+++ b/crawl-ref/source/describe.h
@@ -1,9 +1,7 @@
-
-/*
- *  File:       describe.h
- *  Summary:    Functions used to print information about various game objects.
- *  Written by: Linley Henzell
- */
+/**
+ * @file
+ * @brief Functions used to print information about various game objects.
+**/
 
 #ifndef DESCRIBE_H
 #define DESCRIBE_H
diff --git a/crawl-ref/source/format.cc b/crawl-ref/source/format.cc
index b726fa2005..73d4d9120e 100644
--- a/crawl-ref/source/format.cc
+++ b/crawl-ref/source/format.cc
@@ -1,8 +1,3 @@
-/*
- *  File:       format.cc
- *  Created by: haranp on Sat Feb 17 13:35:54 2007 UTC
- */
-
 #include <limits.h>
 
 #include "AppHdr.h"
diff --git a/crawl-ref/source/format.h b/crawl-ref/source/format.h
index cb3ad0a7ac..74cb73a9f0 100644
--- a/crawl-ref/source/format.h
+++ b/crawl-ref/source/format.h
@@ -1,8 +1,3 @@
-/*
- *  File:       format.h
- *  Created by: haranp on Sat Feb 17 13:35:54 2007 UTC
- */
-
 #ifndef __FORMAT_H__
 #define __FORMAT_H__
 
diff --git a/crawl-ref/source/libunix.h b/crawl-ref/source/libunix.h
index 30442d9967..63f9c06f43 100644
--- a/crawl-ref/source/libunix.h
+++ b/crawl-ref/source/libunix.h
@@ -1,7 +1,3 @@
-/*
- *  File:       libunix.h
- */
-
 #ifndef LIBUNIX_H
 #define LIBUNIX_H
 
diff --git a/crawl-ref/source/libw32c.cc b/crawl-ref/source/libw32c.cc
index d5dba389c6..5f0d252652 100644
--- a/crawl-ref/source/libw32c.cc
+++ b/crawl-ref/source/libw32c.cc
@@ -1,17 +1,15 @@
+/**
+ * @file
+ * @brief Functions for windows32 console mode support.
+**/
+
 #include "AppHdr.h"
 
 #if defined(TARGET_OS_WINDOWS) && !defined(USE_TILE)
 
-/*
- *  File:       libw32c.cc
- *  Summary:    Functions for windows32 console mode support.
- *              Needed by makefile.mgw.
- *  Written by: Gordon Lipford
- */
-
 // WINDOWS INCLUDES GO HERE
 /*
- * Exclude parts of WINDOWS.H that are not needed
+ * Exclude parts of windows.h that are not needed
  */
 #define NOCOMM            /* Comm driver APIs and definitions */
 #define NOLOGERROR        /* LogError() and related definitions */
@@ -38,7 +36,7 @@
 #define NOCTLMGR          /* Control management and controls */
 #define NOHELP            /* Help support */
 /*
- * Exclude parts of WINDOWS.H that are not needed (Win32)
+ * Exclude parts of windows.h that are not needed (Win32)
  */
 #define WIN32_LEAN_AND_MEAN
 #define NONLS             /* All NLS defines and routines */
diff --git a/crawl-ref/source/mapdef.cc b/crawl-ref/source/mapdef.cc
index 87c6506214..35429f0adf 100644
--- a/crawl-ref/source/mapdef.cc
+++ b/crawl-ref/source/mapdef.cc
@@ -1,9 +1,6 @@
 /**
  * @file
- * @section DESCRIPTION
- *
- *  File:       mapdef.cc
- *  Summary:    Support code for Crawl des files.
+ * @brief Support code for Crawl des files.
 **/
 
 #include "AppHdr.h"
diff --git a/crawl-ref/source/mislead.cc b/crawl-ref/source/mislead.cc
index b247bbafe2..d981861eba 100644
--- a/crawl-ref/source/mislead.cc
+++ b/crawl-ref/source/mislead.cc
@@ -1,6 +1,7 @@
-/*  File:       mislead.cc
- *  Summary:    Handling of Mara's Mislead spell and stats, plus fakes.
- */
+/**
+ * @file
+ * @brief Handling of Mara's Mislead spell and stats, plus fakes.
+**/
 
 #include "AppHdr.h"
 #include "mislead.h"
diff --git a/crawl-ref/source/mislead.h b/crawl-ref/source/mislead.h
index 3734d299a4..4afc03a5f0 100644
--- a/crawl-ref/source/mislead.h
+++ b/crawl-ref/source/mislead.h
@@ -1,6 +1,7 @@
-/*  File:       mislead.h
- *  Summary:    Handling of Mara's Mislead spell and stats, plus fakes.
- */
+/**
+ * @file
+ * @brief Handling of Mara's Mislead spell and stats, plus fakes.
+**/
 
 bool unsuitable_misled_monster(monster_type mons);
 monster_type get_misled_monster (monster* mons);
diff --git a/crawl-ref/source/mon-cast.cc b/crawl-ref/source/mon-cast.cc
index 4e55561f07..c8002550e4 100644
--- a/crawl-ref/source/mon-cast.cc
+++ b/crawl-ref/source/mon-cast.cc
@@ -1,7 +1,7 @@
-/*  File:       mon-cast.cc
- *  Summary:    Monster spell casting.
- *  Written by: Linley Henzell
- */
+/**
+ * @file
+ * @brief Monster spell casting.
+**/
 
 #include "AppHdr.h"
 #include "mon-cast.h"
diff --git a/crawl-ref/source/mon-clone.cc b/crawl-ref/source/mon-clone.cc
index af5f87d393..d51f8d6e6b 100644
--- a/crawl-ref/source/mon-clone.cc
+++ b/crawl-ref/source/mon-clone.cc
@@ -1,6 +1,7 @@
-/*  File:       mon-clone.cc
- *  Summary:    Code to clone existing monsters and to create player illusions.
- */
+/**
+ * @file
+ * @brief Code to clone existing monsters and to create player illusions.
+**/
 
 #include "AppHdr.h"
 
diff --git a/crawl-ref/source/mon-data.h b/crawl-ref/source/mon-data.h
index b145c2e4b5..81c3731027 100644
--- a/crawl-ref/source/mon-data.h
+++ b/crawl-ref/source/mon-data.h
@@ -1,7 +1,3 @@
-/*
- *  File:       mon-data.h
- */
-
 #ifndef MONDATA_H
 #define MONDATA_H
 
@@ -9,9 +5,6 @@
 
 #include "enum.h"
 
-// This whole file was very generously condensed from its initial ugly form
-// by Wladimir van der Laan ($pellbinder).
-
 /* ******************************************************************
 
    (see "mon-util.h" for the gory details)
diff --git a/crawl-ref/source/mon-death.cc b/crawl-ref/source/mon-death.cc
index 01868448bc..cc27548dff 100644
--- a/crawl-ref/source/mon-death.cc
+++ b/crawl-ref/source/mon-death.cc
@@ -1,10 +1,7 @@
 /**
  * @file
- * @section DESCRIPTION
- *
- * File: mon-death.cc.
- * Summary: Contains monster death functionality, including Dowan and Duvessa,
- *          Kirke, Pikel, shedu and spirits.
+ * @brief Contains monster death functionality, including Dowan and Duvessa,
+ *        Kirke, Pikel, shedu and spirits.
 **/
 
 #include "AppHdr.h"
diff --git a/crawl-ref/source/orb.cc b/crawl-ref/source/orb.cc
index 8069d37775..b527cc28d2 100644
--- a/crawl-ref/source/orb.cc
+++ b/crawl-ref/source/orb.cc
@@ -1,9 +1,6 @@
 /**
  * @file
- * @section DESCRIPTION
- *
- * File:      orb.cc
- * Summary:   Orb-related functionality.
+ * @brief Orb-related functionality.
 **/
 
 #include "AppHdr.h"
diff --git a/crawl-ref/source/show.cc b/crawl-ref/source/show.cc
index fbcddd00f0..427bc07cb0 100644
--- a/crawl-ref/source/show.cc
+++ b/crawl-ref/source/show.cc
@@ -1,9 +1,6 @@
 /**
  * @file
- * @section DESCRIPTION
- *
- * Filename: show.cc
- * Summary: updates the screen via map_knowledge.
+ * @brief Updates the screen via map_knowledge.
 **/
 
 #include "AppHdr.h"
diff --git a/crawl-ref/source/tilebuf.h b/crawl-ref/source/tilebuf.h
index 20633704d0..b415be04bb 100644
--- a/crawl-ref/source/tilebuf.h
+++ b/crawl-ref/source/tilebuf.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilebuf.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifndef TILEBUF_H
 #define TILEBUF_H
 
diff --git a/crawl-ref/source/tiledgnbuf.cc b/crawl-ref/source/tiledgnbuf.cc
index 54ceeb023d..d18a20bae7 100644
--- a/crawl-ref/source/tiledgnbuf.cc
+++ b/crawl-ref/source/tiledgnbuf.cc
@@ -1,7 +1,3 @@
-/*
- *  File:       tiledgnbuf.cc
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tiledgnbuf.h b/crawl-ref/source/tiledgnbuf.h
index f7072dd646..6f5777c0a8 100644
--- a/crawl-ref/source/tiledgnbuf.h
+++ b/crawl-ref/source/tiledgnbuf.h
@@ -1,7 +1,3 @@
-/*
- *  File:       tiledgnbuf.h
- */
-
 #ifdef USE_TILE
 #ifndef TILEDGNBUF_H
 #define TILEDGNBUF_H
diff --git a/crawl-ref/source/tiledoll.h b/crawl-ref/source/tiledoll.h
index e0ba5ffb0d..4d3655b0ac 100644
--- a/crawl-ref/source/tiledoll.h
+++ b/crawl-ref/source/tiledoll.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tiledoll.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEDOLL_H
 #define TILEDOLL_H
diff --git a/crawl-ref/source/tilefont.h b/crawl-ref/source/tilefont.h
index 581ae3b810..101a80a4ab 100644
--- a/crawl-ref/source/tilefont.h
+++ b/crawl-ref/source/tilefont.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilefont.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifndef TILEFONT_H
 #define TILEFONT_H
 
diff --git a/crawl-ref/source/tilepick.cc b/crawl-ref/source/tilepick.cc
index 9f41e890d8..42343915d1 100644
--- a/crawl-ref/source/tilepick.cc
+++ b/crawl-ref/source/tilepick.cc
@@ -1,8 +1,3 @@
-/*
- *  File:       tilepick.cc
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-cmd.cc b/crawl-ref/source/tilereg-cmd.cc
index 30a3cf143b..8708aa71bd 100644
--- a/crawl-ref/source/tilereg-cmd.cc
+++ b/crawl-ref/source/tilereg-cmd.cc
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg-cmd.cc
- *  Created by: jpeg on Sat, Dec 27 2010
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-cmd.h b/crawl-ref/source/tilereg-cmd.h
index 681f2eac07..64a67a95ea 100644
--- a/crawl-ref/source/tilereg-cmd.h
+++ b/crawl-ref/source/tilereg-cmd.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_cmd.h
- *  Created by: jpeg on Sat, Dec 27 2010
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_CMD_H
 #define TILEREG_CMD_H
diff --git a/crawl-ref/source/tilereg-crt.cc b/crawl-ref/source/tilereg-crt.cc
index 7106ee8158..6c4e9d7711 100644
--- a/crawl-ref/source/tilereg-crt.cc
+++ b/crawl-ref/source/tilereg-crt.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-crt.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-crt.h b/crawl-ref/source/tilereg-crt.h
index 7ad716b57a..a1861db615 100644
--- a/crawl-ref/source/tilereg-crt.h
+++ b/crawl-ref/source/tilereg-crt.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_CRT_H
 #define TILEREG_CRT_H
diff --git a/crawl-ref/source/tilereg-dgn.cc b/crawl-ref/source/tilereg-dgn.cc
index 41dbbcbe3e..a22b090c88 100644
--- a/crawl-ref/source/tilereg-dgn.cc
+++ b/crawl-ref/source/tilereg-dgn.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-dgn.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-dgn.h b/crawl-ref/source/tilereg-dgn.h
index 51fc21d82a..459928a94c 100644
--- a/crawl-ref/source/tilereg-dgn.h
+++ b/crawl-ref/source/tilereg-dgn.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_dgn.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_DGN_H
 #define TILEREG_DGN_H
diff --git a/crawl-ref/source/tilereg-doll.cc b/crawl-ref/source/tilereg-doll.cc
index 94c1cd9f79..81467aed36 100644
--- a/crawl-ref/source/tilereg-doll.cc
+++ b/crawl-ref/source/tilereg-doll.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-doll.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-doll.h b/crawl-ref/source/tilereg-doll.h
index 156ceffdfe..2a64047a4a 100644
--- a/crawl-ref/source/tilereg-doll.h
+++ b/crawl-ref/source/tilereg-doll.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_doll.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_DOLL_H
 #define TILEREG_DOLL_H
diff --git a/crawl-ref/source/tilereg-grid.cc b/crawl-ref/source/tilereg-grid.cc
index d0c45562cc..18b9d23916 100644
--- a/crawl-ref/source/tilereg-grid.cc
+++ b/crawl-ref/source/tilereg-grid.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-grid.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-grid.h b/crawl-ref/source/tilereg-grid.h
index afe0a8719d..017401ec76 100644
--- a/crawl-ref/source/tilereg-grid.h
+++ b/crawl-ref/source/tilereg-grid.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_grid.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_GRID_H
 #define TILEREG_GRID_H
diff --git a/crawl-ref/source/tilereg-inv.cc b/crawl-ref/source/tilereg-inv.cc
index 91cdbb2d5f..199f6e375b 100644
--- a/crawl-ref/source/tilereg-inv.cc
+++ b/crawl-ref/source/tilereg-inv.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-inv.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-inv.h b/crawl-ref/source/tilereg-inv.h
index 2c3f22b1b5..39c3fba71c 100644
--- a/crawl-ref/source/tilereg-inv.h
+++ b/crawl-ref/source/tilereg-inv.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_inv.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_INV_H
 #define TILEREG_INV_H
diff --git a/crawl-ref/source/tilereg-map.cc b/crawl-ref/source/tilereg-map.cc
index acbb244cfe..61443de0cf 100644
--- a/crawl-ref/source/tilereg-map.cc
+++ b/crawl-ref/source/tilereg-map.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-map.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-map.h b/crawl-ref/source/tilereg-map.h
index c971cbd146..2155701bca 100644
--- a/crawl-ref/source/tilereg-map.h
+++ b/crawl-ref/source/tilereg-map.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_map.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_MAP_H
 #define TILEREG_MAP_H
diff --git a/crawl-ref/source/tilereg-mem.cc b/crawl-ref/source/tilereg-mem.cc
index 2ab14bfe10..e7b517e36a 100644
--- a/crawl-ref/source/tilereg-mem.cc
+++ b/crawl-ref/source/tilereg-mem.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-mem.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-mem.h b/crawl-ref/source/tilereg-mem.h
index daf9206bcf..e53e11f191 100644
--- a/crawl-ref/source/tilereg-mem.h
+++ b/crawl-ref/source/tilereg-mem.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_mem.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_MEM_H
 #define TILEREG_MEM_H
diff --git a/crawl-ref/source/tilereg-menu.cc b/crawl-ref/source/tilereg-menu.cc
index 16cf407b27..48a1978ca9 100644
--- a/crawl-ref/source/tilereg-menu.cc
+++ b/crawl-ref/source/tilereg-menu.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-menu.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-menu.h b/crawl-ref/source/tilereg-menu.h
index 83c1f6c6a0..f7a370c33e 100644
--- a/crawl-ref/source/tilereg-menu.h
+++ b/crawl-ref/source/tilereg-menu.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_menu.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_MENU_H
 #define TILEREG_MENU_H
diff --git a/crawl-ref/source/tilereg-mon.cc b/crawl-ref/source/tilereg-mon.cc
index 5654b3f085..8a5bbabe2b 100644
--- a/crawl-ref/source/tilereg-mon.cc
+++ b/crawl-ref/source/tilereg-mon.cc
@@ -1,7 +1,3 @@
-/*
- *  File:       tilereg-mon.cc
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-mon.h b/crawl-ref/source/tilereg-mon.h
index 2dc438b7ba..733fe747b5 100644
--- a/crawl-ref/source/tilereg-mon.h
+++ b/crawl-ref/source/tilereg-mon.h
@@ -1,7 +1,3 @@
-/*
- *  File:       tilereg-mon.h
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_MON_H
 #define TILEREG_MON_H
diff --git a/crawl-ref/source/tilereg-msg.cc b/crawl-ref/source/tilereg-msg.cc
index 7ac6d1ed63..852740f134 100644
--- a/crawl-ref/source/tilereg-msg.cc
+++ b/crawl-ref/source/tilereg-msg.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-msg.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-msg.h b/crawl-ref/source/tilereg-msg.h
index 29af5143d3..3c5e0b8d6f 100644
--- a/crawl-ref/source/tilereg-msg.h
+++ b/crawl-ref/source/tilereg-msg.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_msg.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_MSG_H
 #define TILEREG_MSG_H
diff --git a/crawl-ref/source/tilereg-skl.cc b/crawl-ref/source/tilereg-skl.cc
index ddc9c8dfb6..633c8e6307 100644
--- a/crawl-ref/source/tilereg-skl.cc
+++ b/crawl-ref/source/tilereg-skl.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-skl.cc
- *
- *  Created by: jpeg on Sat, Nov 27 2010
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-skl.h b/crawl-ref/source/tilereg-skl.h
index d1b65feec5..ac825fff86 100644
--- a/crawl-ref/source/tilereg-skl.h
+++ b/crawl-ref/source/tilereg-skl.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_skl.h
- *  Created by: jpeg on Sat, Nov 27 2010
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_SKL_H
 #define TILEREG_SKL_H
diff --git a/crawl-ref/source/tilereg-spl.cc b/crawl-ref/source/tilereg-spl.cc
index 5fae61f03c..b8827b9960 100644
--- a/crawl-ref/source/tilereg-spl.cc
+++ b/crawl-ref/source/tilereg-spl.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-spl.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-spl.h b/crawl-ref/source/tilereg-spl.h
index d5dedab5f9..d1e9acec36 100644
--- a/crawl-ref/source/tilereg-spl.h
+++ b/crawl-ref/source/tilereg-spl.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_spl.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_SPL_H
 #define TILEREG_SPL_H
diff --git a/crawl-ref/source/tilereg-stat.cc b/crawl-ref/source/tilereg-stat.cc
index a11a9b4042..434b15fd18 100644
--- a/crawl-ref/source/tilereg-stat.cc
+++ b/crawl-ref/source/tilereg-stat.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-stat.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-stat.h b/crawl-ref/source/tilereg-stat.h
index c1bae458fc..bc0349cdfa 100644
--- a/crawl-ref/source/tilereg-stat.h
+++ b/crawl-ref/source/tilereg-stat.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_stat.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_STAT_H
 #define TILEREG_STAT_H
diff --git a/crawl-ref/source/tilereg-tab.cc b/crawl-ref/source/tilereg-tab.cc
index 689483cf9f..efac46ca87 100644
--- a/crawl-ref/source/tilereg-tab.cc
+++ b/crawl-ref/source/tilereg-tab.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-tab.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-tab.h b/crawl-ref/source/tilereg-tab.h
index 44aa3e951a..9491a374a5 100644
--- a/crawl-ref/source/tilereg-tab.h
+++ b/crawl-ref/source/tilereg-tab.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_tab.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_TAB_H
 #define TILEREG_TAB_H
diff --git a/crawl-ref/source/tilereg-text.cc b/crawl-ref/source/tilereg-text.cc
index 76fb02b52e..0bc05d16cd 100644
--- a/crawl-ref/source/tilereg-text.cc
+++ b/crawl-ref/source/tilereg-text.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-text.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-text.h b/crawl-ref/source/tilereg-text.h
index f36ed18b20..1aed788de9 100644
--- a/crawl-ref/source/tilereg-text.h
+++ b/crawl-ref/source/tilereg-text.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_text.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_TEXT_H
 #define TILEREG_TEXT_H
diff --git a/crawl-ref/source/tilereg-title.cc b/crawl-ref/source/tilereg-title.cc
index 9f23e5f179..2a69e8c153 100644
--- a/crawl-ref/source/tilereg-title.cc
+++ b/crawl-ref/source/tilereg-title.cc
@@ -1,9 +1,3 @@
-/*
- *  File:       tilereg-title.cc
- *
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #include "AppHdr.h"
 
 #ifdef USE_TILE
diff --git a/crawl-ref/source/tilereg-title.h b/crawl-ref/source/tilereg-title.h
index 38ed108ff4..418daae01b 100644
--- a/crawl-ref/source/tilereg-title.h
+++ b/crawl-ref/source/tilereg-title.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg_title.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_TITLE_H
 #define TILEREG_TITLE_H
diff --git a/crawl-ref/source/tilereg.h b/crawl-ref/source/tilereg.h
index 2b78d14285..822395d9ee 100644
--- a/crawl-ref/source/tilereg.h
+++ b/crawl-ref/source/tilereg.h
@@ -1,8 +1,3 @@
-/*
- *  File:       tilereg.h
- *  Created by: ennewalker on Sat Jan 5 01:33:53 2008 UTC
- */
-
 #ifdef USE_TILE
 #ifndef TILEREG_H
 #define TILEREG_H
diff --git a/crawl-ref/source/tileview.h b/crawl-ref/source/tileview.h
index 18f96a28cc..6a6c896c6f 100644
--- a/crawl-ref/source/tileview.h
+++ b/crawl-ref/source/tileview.h
@@ -1,8 +1,8 @@
-/*
- *  File:       tileview.h
- *  Summary:    Tile functions that modify the tiles or flavours in
-                the crawl_environment that are shown to the player.
- */
+/**
+ * @file
+ * @brief Tile functions that modify the tiles or flavours in
+ *        the crawl_environment that are shown to the player.
+**/
 
 #ifndef TILEDRAW_H
 #define TILEDRAW_H