cleaning under doxygen control: un index en tête du fichier doc/Doxyfile + anomaly line 15 in latex/annotated.tex solved. 😄️

doc/Doxyfile

@@ -2,8 +2,8 @@
 
 #---------------------------------------------------------------------------
 # Configuration options related to:
-# -   51 - project definition (... PROJECT_NAME = "Gem-graph" ...)
+# -   51 - project definition and localization (... PROJECT_NAME = "Gem-graph")
-# -  534 - doc building (... EXTRACT_ALL = NO ...)
+# -  534 - parsing and documentation building (... EXTRACT_ALL = NO ...)
 # -  855 - warning and progress messages (QUIET = NO)
 # -  961 - input files (INPUT = ./)
 # - 1149 - source browsing (To get rid of source code:
@@ -47,7 +47,7 @@
 # doxygen -x_noenv [configFile]
 
 #---------------------------------------------------------------------------
-# Project related configuration options
+# Configuration options related to project definition and localization
 #---------------------------------------------------------------------------
 
 # This tag specifies the encoding used for all characters in the configuration
@@ -530,7 +530,7 @@ NUM_PROC_THREADS       = 1
 TIMESTAMP              = NO
 
 #---------------------------------------------------------------------------
-# Documentation building related configuration options
+# Configuration options related to parsing and documentation building
 #---------------------------------------------------------------------------
 
 # If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in

doc/docbook/annotated.xml

@@ -26,7 +26,7 @@ Here are the classes, structs, unions and interfaces with brief descriptions:<li
 <link linkend="_structslist">slist</link>
 <para>Phantom documentation used to test the functioning of doxygen </para>
 <link linkend="_structStack">Stack</link>
-<para>Struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct images_bff *my_list = NULL;//, *babar = NULL; static struct images_bff *alloc_images_bff () { struct images_bff *p; p = malloc (sizeof (struct images_bff)); if (p == NULL) printf (&quot;fatal: ran out of storage&quot;); p-&gt;arr[MAX_SIZE] = NULL; p-&gt;top = 0; return p; } static void add_to_mylist (int my_int) { struct images_bff *p = alloc_images_bff (); p-&gt;arr[MAX_SIZE] = NULL; // TODO p-&gt;top = my_int; my_list = p; } static void free_intlist (struct images_bff *p) { TODO } TODO free_intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) </para>
+<para>Phantom documentation used to test the functioning of doxygen </para>
 <link linkend="_structstack__index__t">stack_index_t</link>
 <para>Phantom documentation used to test the functioning of doxygen </para>
 <link linkend="_structTreeNode__t">TreeNode_t</link>

doc/docbook/d7/d07/structStack.xml

@@ -4,7 +4,7 @@
 <indexterm><primary>Stack</primary></indexterm>
 <para>
 
-<para>struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct images_bff *my_list = NULL;//, *babar = NULL; static struct images_bff *alloc_images_bff () { struct images_bff *p; p = malloc (sizeof (struct images_bff)); if (p == NULL) printf (&quot;fatal: ran out of storage&quot;); p-&gt;arr[MAX_SIZE] = NULL; p-&gt;top = 0; return p; } static void add_to_mylist (int my_int) { struct images_bff *p = alloc_images_bff (); p-&gt;arr[MAX_SIZE] = NULL; // TODO p-&gt;top = my_int; my_list = p; } static void free_intlist (struct images_bff *p) { TODO } TODO free_intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) </para>
+<para>phantom documentation used to test the functioning of doxygen </para>
  
 </para>
 <simplesect>
@@ -23,10 +23,6 @@
 <section>
 <title>Detailed Description</title>
 
-<para>struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct images_bff *my_list = NULL;//, *babar = NULL; static struct images_bff *alloc_images_bff () { struct images_bff *p; p = malloc (sizeof (struct images_bff)); if (p == NULL) printf (&quot;fatal: ran out of storage&quot;); p-&gt;arr[MAX_SIZE] = NULL; p-&gt;top = 0; return p; } static void add_to_mylist (int my_int) { struct images_bff *p = alloc_images_bff (); p-&gt;arr[MAX_SIZE] = NULL; // TODO p-&gt;top = my_int; my_list = p; } static void free_intlist (struct images_bff *p) { TODO } TODO free_intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) </para>
-
-
-
 <para>phantom documentation used to test the functioning of doxygen </para>
 <para>
 The documentation for this struct was generated from the following file:</para>

doc/latex/annotated.tex

@@ -12,7 +12,7 @@ Here are the classes, structs, unions and interfaces with brief descriptions\+:\
 \item\contentsline{section}{\mbox{\hyperlink{structpile}{pile}} \\*Phantom documentation used to test the functioning of doxygen }{\pageref{structpile}}{}
 \item\contentsline{section}{\mbox{\hyperlink{structpreferences}{preferences}} \\*Use this ? static const char \texorpdfstring{$\ast$}{*}icon\+\_\+name \mbox{[}3\mbox{]} = \{ "{}document-\/revert-\/rtl-\/symbolic"{}, "{}edit-\/undo-\/symbolic"{}, "{}view-\/refresh-\/symbolic"{} \}; }{\pageref{structpreferences}}{}
 \item\contentsline{section}{\mbox{\hyperlink{structslist}{slist}} \\*Phantom documentation used to test the functioning of doxygen }{\pageref{structslist}}{}
-\item\contentsline{section}{\mbox{\hyperlink{structStack}{Stack}} \\*Struct images\+\_\+bff \{Gtk\+Widget \texorpdfstring{$\ast$}{*}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]}; int top;\}; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}my\+\_\+list = NULL;//, \texorpdfstring{$\ast$}{*}babar = NULL; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}alloc\+\_\+images\+\_\+bff () \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p; p = malloc (sizeof (struct images\+\_\+bff)); if (p == NULL) printf ("{}fatal\+: ran out of storage"{}); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; p-\/\texorpdfstring{$>$}{>}top = 0; return p; \} static void add\+\_\+to\+\_\+mylist (int my\+\_\+int) \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p = alloc\+\_\+images\+\_\+bff (); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; // TODO p-\/\texorpdfstring{$>$}{>}top = my\+\_\+int; my\+\_\+list = p; \} static void free\+\_\+intlist (struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p) \{ TODO \} TODO free\+\_\+intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) }{\pageref{structStack}}{}
+\item\contentsline{section}{\mbox{\hyperlink{structStack}{Stack}} \\*Phantom documentation used to test the functioning of doxygen }{\pageref{structStack}}{}
 \item\contentsline{section}{\mbox{\hyperlink{structstack__index__t}{stack\+\_\+index\+\_\+t}} \\*Phantom documentation used to test the functioning of doxygen }{\pageref{structstack__index__t}}{}
 \item\contentsline{section}{\mbox{\hyperlink{structTreeNode__t}{Tree\+Node\+\_\+t}} \\*Phantom documentation used to test the functioning of doxygen }{\pageref{structTreeNode__t}}{}
 \end{DoxyCompactList}

doc/latex/d7/d07/structStack.tex

@@ -2,7 +2,7 @@
 \hypertarget{structStack}{}\label{structStack}\index{Stack@{Stack}}
 
 
-struct images\+\_\+bff \{Gtk\+Widget \texorpdfstring{$\ast$}{*}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]}; int top;\}; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}my\+\_\+list = NULL;//, \texorpdfstring{$\ast$}{*}babar = NULL; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}alloc\+\_\+images\+\_\+bff () \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p; p = malloc (sizeof (struct images\+\_\+bff)); if (p == NULL) printf ("{}fatal\+: ran out of storage"{}); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; p-\/\texorpdfstring{$>$}{>}top = 0; return p; \} static void add\+\_\+to\+\_\+mylist (int my\+\_\+int) \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p = alloc\+\_\+images\+\_\+bff (); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; // TODO p-\/\texorpdfstring{$>$}{>}top = my\+\_\+int; my\+\_\+list = p; \} static void free\+\_\+intlist (struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p) \{ TODO \} TODO free\+\_\+intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field)  
+phantom documentation used to test the functioning of doxygen  
 
 
 \doxysubsubsection*{Public Attributes}
@@ -17,8 +17,6 @@ int {\bfseries top}
 
 
 \doxysubsection{Detailed Description}
-struct images\+\_\+bff \{Gtk\+Widget \texorpdfstring{$\ast$}{*}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]}; int top;\}; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}my\+\_\+list = NULL;//, \texorpdfstring{$\ast$}{*}babar = NULL; static struct images\+\_\+bff \texorpdfstring{$\ast$}{*}alloc\+\_\+images\+\_\+bff () \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p; p = malloc (sizeof (struct images\+\_\+bff)); if (p == NULL) printf ("{}fatal\+: ran out of storage"{}); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; p-\/\texorpdfstring{$>$}{>}top = 0; return p; \} static void add\+\_\+to\+\_\+mylist (int my\+\_\+int) \{ struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p = alloc\+\_\+images\+\_\+bff (); p-\/\texorpdfstring{$>$}{>}arr\mbox{[}MAX\+\_\+\+SIZE\mbox{]} = NULL; // TODO p-\/\texorpdfstring{$>$}{>}top = my\+\_\+int; my\+\_\+list = p; \} static void free\+\_\+intlist (struct images\+\_\+bff \texorpdfstring{$\ast$}{*}p) \{ TODO \} TODO free\+\_\+intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) 
-
 phantom documentation used to test the functioning of doxygen 
 
 The documentation for this struct was generated from the following file\+:\begin{DoxyCompactItemize}

doc/rtfm/man3/Stack.3

@@ -2,7 +2,7 @@
 .ad l
 .nh
 .SH NAME
-Stack \- struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct images_bff *my_list = NULL;//, *babar = NULL; static struct images_bff *alloc_images_bff () { struct images_bff *p; p = malloc (sizeof (struct images_bff)); if (p == NULL) printf ('fatal: ran out of storage'); p->arr[MAX_SIZE] = NULL; p->top = 0; return p; } static void add_to_mylist (int my_int) { struct images_bff *p = alloc_images_bff (); p->arr[MAX_SIZE] = NULL; // TODO p->top = my_int; my_list = p; } static void free_intlist (struct images_bff *p) { TODO } TODO free_intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field)  
+Stack \- phantom documentation used to test the functioning of doxygen  
 
 .SH SYNOPSIS
 .br
@@ -21,8 +21,6 @@ Stack \- struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct i
 .in -1c
 .SH "Detailed Description"
 .PP 
-struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;}; static struct images_bff *my_list = NULL;//, *babar = NULL; static struct images_bff *alloc_images_bff () { struct images_bff *p; p = malloc (sizeof (struct images_bff)); if (p == NULL) printf ('fatal: ran out of storage'); p->arr[MAX_SIZE] = NULL; p->top = 0; return p; } static void add_to_mylist (int my_int) { struct images_bff *p = alloc_images_bff (); p->arr[MAX_SIZE] = NULL; // TODO p->top = my_int; my_list = p; } static void free_intlist (struct images_bff *p) { TODO } TODO free_intlist (mylist); TODO mylist = NULL; TODO offsetof (type, field) 
-
 phantom documentation used to test the functioning of doxygen 
 
 .SH "Author"

src/actions.c

@@ -72,6 +72,7 @@
 #define GEM_GRAPH_CLIENT_TYPE_WINDOW (gem_graph_client_window_get_type())
 
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_preferences_action(GSimpleAction *action, //  nom de type « GSimpleAction » inconnu
                            GVariant *parameter,   //  nom de type « GVariant » inconnu
                            gpointer user_data)    //  nom de type « gpointer » inconnu

src/graphics/draw.c

@@ -30,7 +30,7 @@
 #include "../../include/base.h"
 #include "../../include/graphics.h"
 
-/*
+/**
  *  Writes values to describe a vertex at (x,y,z) intoq the vertex buffer
  *
  *  @param coords GLfloat(x,y,z)
@@ -64,7 +64,7 @@ void graphics_draw_vertex (const int stack_id,
     graphics_stack->buffer_vertex_size += 3;
 }
 
-/*
+/**
  *  Writes values to describe a color (r,g,b) into the color buffer
  *
  *  @param color GLfloat(r,g,b)
@@ -90,7 +90,7 @@ void graphics_draw_color (const int stack_id,
     graphics_stack->buffer_colors_size += 3;
 }
 
-/*
+/**
  *  Writes values to describe a line from a to b into the line buffer
  *
  *  @param coords GLuint (a,b)
@@ -114,7 +114,7 @@ void graphics_draw_line (const int stack_id,
     graphics_stack->buffer_lines_size += 2;
 }
 
-/*
+/**
  *  Writes values to describe an (a,b,c) plan (triangle) into the plan buffer
  *
  *  @param coords GLuint (a,b,c)
@@ -140,7 +140,7 @@ void graphics_draw_plan (const int stack_id,
     graphics_stack->buffer_plans_size += 3;
 }
 
-/*
+/**
  * Draws the current buffer to a gl_area
  *
  * @param   gl_area, ptr to the gl_area widget

src/graphics/grid.c

@@ -27,6 +27,7 @@
 
 #include "../../include/graphics.h"
 
+/** phantom documentation used to test the functioning of doxygen */
 int graphics_draw_space_ridges_vertex (const int stack_id,
                               long offset_vertex,
                               long x,
@@ -59,6 +60,7 @@ int graphics_draw_space_ridges_vertex (const int stack_id,
     return 8;
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 int graphics_draw_space_ridges_lines (const int stack_id)
 {
     graphics_draw_line (stack_id, 0, 1); graphics_draw_line (stack_id, 7, 4);
@@ -72,6 +74,7 @@ int graphics_draw_space_ridges_lines (const int stack_id)
     return 12;
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 long graphics_draw_grids_on_space_faces_vertex (const int stack_id,
                                        long x,
                                        long y,
@@ -126,6 +129,7 @@ long graphics_draw_grids_on_space_faces_vertex (const int stack_id,
 }
 
 
+/** phantom documentation used to test the functioning of doxygen */
 long graphics_draw_grids_on_space_faces_lines (const int stack_id,
                                       long offset_vertex,
                                       long x,

src/graphics/init.c

@@ -31,12 +31,13 @@
 
 #define TEST 0
 
+/** phantom documentation used to test the functioning of doxygen */
 struct graphics_stack_t *graphics_stack = NULL;
 size_t graphics_stack_size = 0;
 int *free_stack_slot = NULL;
 size_t free_stack_slot_size = 0;
 
-/*
+/**
  * Prints verbose human-readable debug messages
  *
  * @param   source, XXX
@@ -50,6 +51,7 @@ size_t free_stack_slot_size = 0;
  * @return  void
  */
 
+/** phantom documentation used to test the functioning of doxygen */
 static void graphics_debug_callback(GLenum source, GLenum type, GLuint id,
                                     GLenum severity, GLsizei length,
                                     const GLchar *msg, const void *data)
@@ -98,7 +100,7 @@ static void graphics_debug_callback(GLenum source, GLenum type, GLuint id,
 
 /* -------------------------------------------------------------------------- */
 
-/*
+/**
  * Initializes graphical stack
  *
  * @param   gl_area, ptr to the gl_area widget
@@ -159,7 +161,7 @@ int graphics_init(void *error_buffer)
     return cur_id;
 }
 
-/*
+/**
  * Shutdowns a gl_area
  *
  * @param   gl_area, ptr to the gl_area widget
@@ -206,7 +208,7 @@ bool graphics_shutdown(const int id, void *error_buffer)
     return true;
 }
 
-/* TODO
+/** TODO
  * #pragma omp parallel schedule(static, 12)
  * void  __attribute__((optimize("no-unroll-loops"))) main_test_graphics (void) {}
  *
@@ -318,7 +320,7 @@ void graphics_model_setup (const int stack_id)
 }
 
 
-/* Initializes the buffer of a gl_area
+/** Initializes the buffer of a gl_area
  * Calls according to the user preferences
  * @param   gl_area, ptr to the gl_area widget
  * @return  void
@@ -360,7 +362,7 @@ void graphics_init_buffers(const int stack_id)
     graphics_stack->color_buffer = color_buffer;
 }
 
-/*
+/**
  * Initializes the shaders of a gl_area and link them to a program
  *
  * @param   gl_area, ptr to the gl_area widget

src/graphics/shader.frag

@@ -30,6 +30,7 @@
 in vec4 color;
 out vec4 out_frag_color;
 
+/** phantom documentation used to test the functioning of doxygen */
 void main(void)
 {
 	out_frag_color = color;

src/graphics/shader.vert

@@ -36,6 +36,7 @@ layout(location=1) in vec3 in_color;
 
 out vec4 color;
 
+/** phantom documentation used to test the functioning of doxygen */
 void main(void)
 {
     float zoom = 1.1f, chrominance = 1, luminance = 1;

src/signal.c

@@ -34,6 +34,7 @@
 #include "../include/util.h"
 
 
+/** phantom documentation used to test the functioning of doxygen */
 static void on_auto_notification (char *message)
 {
   //  message = "-(any auto notification)-"; // test
@@ -61,6 +62,7 @@ static void on_auto_notification (char *message)
 /*                                T R E E                                     */
 /******************************************************************************/
 
+/** phantom documentation used to test the functioning of doxygen */
 static void on_user_tree_expander_toggled (GtkExpander *expander,
                                            gpointer user_data)
 {
@@ -432,6 +434,7 @@ void on_toggle_state_rules_data (GtkWidget *toggled_button, gpointer widget_all_
 
 // -----------------------   S T A T I C    S W I T C H   -------------------- //
 
+/** phantom documentation used to test the functioning of doxygen */
 static void switch_state_rules_data()
 {
     switch (fsm_get_state_rules_data()) {
@@ -684,6 +687,7 @@ void on_select_rules_first (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_depends_on_one_or_two_events()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_depends_on_a_single_event (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure depends on a single event()", "");
@@ -691,6 +695,7 @@ void on_measure_depends_on_a_single_event (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_depends_on_a_single_event()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_depends_on_two_events (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure depends on two events()", "");
@@ -698,6 +703,7 @@ void on_measure_depends_on_two_events (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_select_a_second_rules_set()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_select_a_second_rules_set (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "select a second rules set()", "");
@@ -705,6 +711,7 @@ void on_select_a_second_rules_set (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_choose_an_event_type()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_select_a_second_measurement (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "select a second measurement()", "");
@@ -712,6 +719,7 @@ void on_select_a_second_measurement (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_correlate()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_skip_this_step (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "skip this step()", "");
@@ -719,6 +727,7 @@ void on_skip_this_step (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_insert_in_measurements_list ()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_something_else (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "something else()", "");
@@ -726,6 +735,7 @@ void on_something_else (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_do_end_creation_of_measurement_process()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_closing_page (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "closing page()", "");
@@ -733,6 +743,7 @@ void on_closing_page (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_get_page_synth()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_single_event_occurences_nb (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure single event occurences nb()", "");
@@ -740,6 +751,7 @@ void on_measure_single_event_occurences_nb (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_event_occurences_nb()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_single_event_occurences_dates (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure single event occurences dates()", "");
@@ -747,6 +759,7 @@ void on_measure_single_event_occurences_dates (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_event_occurences_dates()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_single_event_occurences_situations (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure single event occurences situations()", "");
@@ -754,6 +767,7 @@ void on_measure_single_event_occurences_situations (GtkWidget *btt, gpointer dat
                           GTK_WIDGET (widget_measure_event_occurences_situations()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_time_elapsed_between_two_events (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure time elapsed between two events()", "");
@@ -761,6 +775,7 @@ void on_measure_time_elapsed_between_two_events (GtkWidget *btt, gpointer data)
                           GTK_WIDGET (widget_measure_time_elapsed_between_two_events()));
 }
 
+/** phantom documentation used to test the functioning of doxygen */
 void on_measure_third_event_occurences_in_between (GtkWidget *btt, gpointer data)
 {
     fsm_journal_event (DEBUG, BUTTON, "signal", "measure third event occurences in between()", "");
@@ -773,11 +788,36 @@ void on_measure_third_event_occurences_in_between (GtkWidget *btt, gpointer data
 /*                                R U L E S                                   */
 /******************************************************************************/
 
+/**
+ * @brief
+ * @details
+ * @date
+ * @author
+ * @callgraph
+ * @see
+ * @callergraph
+ * @see
+ * @param
+ * @return
+ */
 void on_entry_name_insert_after (GtkWidget *entry, gpointer data)
 {
     fsm_journal_event (DEBUG, ENTRY, "signal", "entry name insert after()", "");
 }
 
+
+/**
+ * @brief
+ * @details
+ * @date
+ * @author
+ * @callgraph
+ * @see
+ * @callergraph
+ * @see
+ * @param
+ * @return
+ */
 void on_entry_name_delete_after (GtkWidget *entry, gpointer data)
 {
     fsm_journal_event (DEBUG, ENTRY, "signal", "entry name delete after()", "");

src/widget/all_rules/compare/interest.c

@@ -34,7 +34,7 @@
 // -----------------------------------------------------------------------------
 // Below is ^c^v from  RMS C manual  (p 77)       24 * 256 * 256 * 2 = 3 145 728
 //
-/**
+/*
 struct images_bff {GtkWidget *arr[MAX_SIZE]; int top;};
 static struct images_bff *my_list = NULL;//, *babar = NULL;
 static struct images_bff *alloc_images_bff ()
@@ -153,6 +153,8 @@ static GtkWidget *peek(Stack *stack)
 static void *push_images_onto_stack (Stack stack_b);
 static GtkWidget *do_rtfd (Stack stack_b);
 
+/** phantom documentation used to test the functioning of doxygen */
+
 void *widget_get_an_impression_of_what_a_rules_comparator_could_be(){
 
     GtkBox *compare_left = GTK_BOX (gtk_box_new (GTK_ORIENTATION_VERTICAL, 2));