From 56fad4b1044336dc78c89d8addfc4fb9737d6ce0 Mon Sep 17 00:00:00 2001
From: Jean Sirmai <jean@a-lec.org>
Date: Sat, 6 Jul 2024 23:50:43 +0200
Subject: [PATCH] Documentation organisation d'ensemble (dans main.c) suite

---
 src/main.c          | 26 +++++++++++++++++---------
 src/widget.c/tree.c |  2 +-
 2 files changed, 18 insertions(+), 10 deletions(-)

diff --git a/src/main.c b/src/main.c
index 995d6b9..8768d0e 100644
--- a/src/main.c
+++ b/src/main.c
@@ -59,23 +59,31 @@
  * deviendront des dossiers et les widgets qu'ils contiennent
  * des fichiers (ou des dossiers si besoin) et ainsi de suite...
  *
- * Dans cette logique, l'actuel ficher 'tree.c' doit être
+ * Dans cette logique,
+ * sauf s'il y a d'autres arbres que l'arbre des utilisateurs,
+ * l'actuel ficher 'tree.c' devrait être
  * soit inclus dans le fichier 'rules.c'
- * (puisque l'arbre des utilisateurs est dans le widget (= la page) 'rules')
- * ou, s'il est trop volumineux, et pour faciliter la lisibilité,
+ * (puisque cet arbre est dans la page (le widget) 'rules')
+ * soit, s'il est trop volumineux, et pour faciliter la lisibilité,
  * dans un dossier 'rules.c' (ou 'rules' ?)
  * qui regroupera les différents widgets du widget 'rules'.
- * (NB labo.c disparaitra, bien sûr !)
+ *
+ * NB  Il est possible qu'il y ait besoin d'autres structures d'arbres:
+ * dans 'rules', par exemple, il est important de pouvoir visualiser
+ * l'utilisation (l'activité) des différentes règles
+ * ou de différents groupes de règles.
+ * Et donc de disposer d'un ou de plusieurs index vers ces règles.
  *
  * Les fonctions 'transversales' comme celles de
- * 'graph' 'parse' ou - surtout - 'automat',
- * qui doivent pouvoir être accédées par un grand nombre
- * de widgets ou de callbacks restent à la racine 'src/'
+ * 'graph' 'parse', possiblement 'tree' mais - surtout - 'automat',
+ * qui doivent pouvoir être accédées par plusieurs widgets ou callbacks
+ * restent à la racine: 'src/'
  *
  * Pour l'instant, le 'include' de 'automat' est dans 'base.h'.
  * C'est une erreur (tolérable tant qu'automat est à l'état embryonnaire).
- * À terme, il y aura un fichier 'automat.h' dans le dossier 'include' */
-
+ * À terme, il y aura un fichier 'automat.h' dans le dossier 'include'
+ *
+ * (NB labo.c disparaitra, bien sûr !) */
 
 int main (int argc, char **argv)
 {
diff --git a/src/widget.c/tree.c b/src/widget.c/tree.c
index 5f0bbda..3a053d0 100644
--- a/src/widget.c/tree.c
+++ b/src/widget.c/tree.c
@@ -65,7 +65,7 @@ static GListModel* get_user_tree_model_child (struct TreeNode_t *parent){
     return G_LIST_MODEL(list);
 }
 
-GListModel* get_user_tree_model (GObject *item, gpointer root){
+static GListModel* get_user_tree_model (GObject *item, gpointer root){
     struct TreeNode_t *cur = (struct TreeNode_t *)root;
     struct TreeNode_t *parent = root;
     const gchar *string =  gtk_string_object_get_string (GTK_STRING_OBJECT (item));