From f9b6e40f362ec823fa26b799959499edbbd63cbb Mon Sep 17 00:00:00 2001
From: Adrien Destugues <pulkomandy@pulkomandy.tk>
Date: Thu, 21 May 2020 13:03:10 +0200
Subject: [PATCH] Fix doxygen warnings.

---
 src/cpcformats.c |  2 +-
 src/giformat.c   |  2 +-
 src/loadsave.c   |  5 +----
 src/loadsave.h   |  3 ++-
 src/msxformats.c |  2 +-
 src/stformats.c  |  2 +-
 tools/Doxyfile   | 15 ---------------
 7 files changed, 7 insertions(+), 24 deletions(-)

diff --git a/src/cpcformats.c b/src/cpcformats.c
index f5c78d41..6449175b 100644
--- a/src/cpcformats.c
+++ b/src/cpcformats.c
@@ -1812,4 +1812,4 @@ void Save_PPH(T_IO_Context* context)
     // B1: find the 16 colors used in a line? Or assume they are in-order already?
 }
 
-/* @} */
+/** @} */
diff --git a/src/giformat.c b/src/giformat.c
index c1aa8475..487a075d 100644
--- a/src/giformat.c
+++ b/src/giformat.c
@@ -1375,4 +1375,4 @@ void Save_GIF(T_IO_Context * context)
 
 }
 
-/* @} */
+/** @} */
diff --git a/src/loadsave.c b/src/loadsave.c
index 3c8c464e..b747c1a6 100644
--- a/src/loadsave.c
+++ b/src/loadsave.c
@@ -1191,10 +1191,7 @@ void Load_SDL_Image(T_IO_Context *context)
 }
 #endif
 
-///
-/// Load an arbitrary Surface.
-/// @param full_name Full (absolute) path of the file to load.
-/// @param gradients Pass the address of a target T_Gradient_array if you want the gradients, NULL otherwise
+
 T_GFX2_Surface * Load_surface(const char *full_name, T_Gradient_array *gradients)
 {
   T_GFX2_Surface * bmp=NULL;
diff --git a/src/loadsave.h b/src/loadsave.h
index dedaa766..35858ab3 100644
--- a/src/loadsave.h
+++ b/src/loadsave.h
@@ -189,7 +189,8 @@ extern const T_Format File_formats[];
 void Image_emergency_backup(void);
 
 ///
-/// Load an arbitrary GFX2_Surface.
+/// Load an arbitrary Surface.
+/// @param full_name Full (absolute) path of the file to load.
 /// @param gradients Pass the address of a target T_Gradient_array if you want the gradients, NULL otherwise
 T_GFX2_Surface * Load_surface(const char *full_name, T_Gradient_array *gradients);
 
diff --git a/src/msxformats.c b/src/msxformats.c
index 5259fb1c..449a1ea4 100644
--- a/src/msxformats.c
+++ b/src/msxformats.c
@@ -266,4 +266,4 @@ void Save_MSX(T_IO_Context * context)
     File_error = 0;
   fclose(file);
 }
-/* @} */
+/** @} */
diff --git a/src/stformats.c b/src/stformats.c
index 38adc161..93704d31 100644
--- a/src/stformats.c
+++ b/src/stformats.c
@@ -1884,4 +1884,4 @@ void Save_CA1(T_IO_Context * context)
   free(buffer);
 }
 
-/* @} */
+/** @} */
diff --git a/tools/Doxyfile b/tools/Doxyfile
index 0f7d1fe6..17970f61 100644
--- a/tools/Doxyfile
+++ b/tools/Doxyfile
@@ -2040,12 +2040,6 @@ EXTERNAL_GROUPS        = YES
 
 EXTERNAL_PAGES         = YES
 
-# The PERL_PATH should be the absolute path and name of the perl script
-# interpreter (i.e. the result of 'which perl').
-# The default file (with absolute path) is: /usr/bin/perl.
-
-PERL_PATH              = /usr/bin/perl
-
 #---------------------------------------------------------------------------
 # Configuration options related to the dot tool
 #---------------------------------------------------------------------------
@@ -2059,15 +2053,6 @@ PERL_PATH              = /usr/bin/perl
 
 CLASS_DIAGRAMS         = NO
 
-# You can define message sequence charts within doxygen comments using the \msc
-# command. Doxygen will then run the mscgen tool (see:
-# http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the
-# documentation. The MSCGEN_PATH tag allows you to specify the directory where
-# the mscgen tool resides. If left empty the tool is assumed to be found in the
-# default search path.
-
-MSCGEN_PATH            =
-
 # You can include diagrams made with dia in doxygen documentation. Doxygen will
 # then run dia to produce the diagram and insert it in the documentation. The
 # DIA_PATH tag allows you to specify the directory where the dia binary resides.