Try to fix some doxygen warnings.

src/filesel.c

@@ -1258,6 +1258,7 @@ void Print_filename_in_fileselector(void)
 {
   char filename[32];
   strncpy(filename, Selector_filename, sizeof(filename));
+  printf("%d %s %ls\n", __LINE__, Selector_filename, Selector_filename_unicode);
 #ifdef ENABLE_FILENAMES_ICONV
   {
     char * input = (char *)Selector_filename;
@@ -2003,6 +2004,7 @@ byte Button_Load_or_Save(T_Selector_settings *settings, byte load, T_IO_Context
             if(Directory_exists(Selector_filename)) Selected_type = 1;
             else Selected_type = 0;
           }
+  		  printf("%d %s %ls\n", __LINE__, Selector_filename, Selector_filename_unicode);
 
           // Now load immediately, but only if the user exited readline by pressing ENTER
           if (Mouse_K == 0) has_clicked_ok = 1;

src/keyboard.h

@@ -44,41 +44,46 @@
 #endif
 
 
-/*!
-  Convert an SDL keysym to an ANSI/ASCII character.
-  This is used to type text and numeric values in input boxes.
-  @param keysym SDL symbol to convert
-*/
 #if defined(USE_SDL)
+/*! Convert an SDL keysym to an ANSI/ASCII character.
+
+  This is used to type text and numeric values in input boxes.
+
+  @param[in] keysym SDL symbol to convert
+*/
 word Keysym_to_ANSI(SDL_keysym keysym);
 #elif defined(USE_SDL2)
 word Keysym_to_ANSI(SDL_Keysym keysym);
 #endif
 
-/*!
-  Convert an SDL keysym to an internal keycode number.
-  This is needed because SDL tends to split the information across the unicode sym, the regular sym, and the raw keycode.
-  We also need to differenciate 1 (keypad) and 1 (regular keyboard), and some other things.
-  See the notice at the beginning of keyboard.h for the format of a keycode.
-  @param keysym SDL symbol to convert
-*/
 #if defined(USE_SDL)
+/*! Convert an SDL keysym to an internal keycode number.
+
+  This is needed because SDL tends to split the information across the unicode
+  sym, the regular sym, and the raw keycode. We also need to differenciate
+  1 (keypad) and 1 (regular keyboard), and some other things. See the notice
+  at the beginning of keyboard.h for the format of a keycode.
+
+  @param[in] keysym SDL symbol to convert
+  @return internal keycode value
+*/
 word Keysym_to_keycode(SDL_keysym keysym);
 #elif defined(USE_SDL2)
 word Keysym_to_keycode(SDL_Keysym keysym);
 #endif
 
-/*!
-    Helper function to convert between SDL system and the old coding for PC keycodes.
-    This is only used to convert configuration files from the DOS version of 
+/*! Helper function to convert between SDL system and the old coding for PC keycodes.
+    This is only used to convert configuration files from the DOS version of
     Grafx2, where keyboard codes are in in the IBM PC AT form.
   @param scancode Scancode to convert
 */
 word Key_for_scancode(word scancode);
 
-/*!
-    Returns key name in a string. Used to display them in the helpscreens and in the keymapper window.
-  @param key keycode of the key to translate, including modifiers
+/*! Returns key name in a string.
+	
+	Used to display them in the helpscreens and in the keymapper window.
+
+    @param[in] key keycode of the key to translate, including modifiers
 */
 const char * Key_name(word key);
 

src/pages.h

@@ -42,7 +42,10 @@ extern byte * FX_feedback_screen;
 
 /// The pixels of visible layers, flattened copy, used for no-feedback effects.
 extern T_Bitmap Main_visible_image_backup;
-/// The index of visible pixels from ::Main.visible_image. Points to the right layer.
+/** The index of visible pixels Main page ::T_Document.visible_image.
+ *
+ * Points to the right layer.
+ */
 extern T_Bitmap Main_visible_image_depth_buffer;
 
 ///

tools/Doxyfile

@@ -2314,7 +2314,7 @@ DOT_GRAPH_MAX_NODES    = 50
 # Minimum value: 0, maximum value: 1000, default value: 0.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
-MAX_DOT_GRAPH_DEPTH    = 0
+MAX_DOT_GRAPH_DEPTH    = 2
 
 # Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
 # background. This is disabled by default, because dot on Windows does not seem