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.
+/*! 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