Doxygen improvements

src/const.h

@@ -153,7 +153,7 @@ enum FILE_FORMATS
   FORMAT_FLI,  ///< Autodesk Animator FLI/FLC
   FORMAT_MOTO, ///< Thomson MO/TO computers pictures
   FORMAT_HGR,  ///< Apple II HGR and DHGR
-  FORMAT_MISC, ///< Must be last of enum: others formats recognized by SDL_image
+  FORMAT_MISC, ///< Must be last of enum: others formats recognized by SDL_image (or recoil)
 };
 
 /// Default format for 'save as'

src/gfx2log.h

@@ -26,6 +26,7 @@
 
 /**
  * @defgroup log error and debugging logs
+ * Functions to log error and debugging messages.
  * @{
  */
 

src/loadsave.h

@@ -168,7 +168,7 @@ void Delete_safety_backups(void);
 
 /// Data for an image file format.
 typedef struct {
-  byte Identifier;         ///< Identifier for this format in enum :FILE_FORMATS
+  enum FILE_FORMATS Identifier; ///< Identifier for this format
   const char *Label;       ///< Five-letter label
   Func_IO_Test Test;       ///< Function which tests if the file is of this format
   Func_IO Load;            ///< Function which loads an image of this format

src/oldies.h

@@ -194,6 +194,8 @@ int DECB_Check_binary_file(FILE * f);
 /** @}*/
 
 /** @defgroup moto Thomson MO/TO
+ * Thomson MO/TO computer range
+ *
  * The Thomson MO/TO computer range was based on a Motorola 6809 CPU
  * and equiped with Microsoft Basic called Basic 1.0 for the first
  * versions and then Basic 128 or Basic 512 which included a DOS

src/windows.h

@@ -77,6 +77,7 @@ void Print_filename(void);
 void Print_counter(short x,short y,const char * str,byte text_color,byte background_color);
 
 /** @defgroup dialog Dialog windows
+ * Popups that show or ask an information to the user
  * @{ */
 byte Confirmation_box(const char * message);
 void Warning_message(const char * message);