CONVENTIONS ET RÈGLES DE NOMMAGE 2024 + ./instanced_cubes 🙂️

alphabetic_index.all

@@ -21,6 +21,57 @@
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.       *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 
+
+
+
+
+/*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
+*
+*   C O N V E N T I O N S   E T   R È G L E S   D E   N O M M A G E  -  2 0 2 4
+*
+*        Toute fonction qui peut être appelée à partir d'un autre module
+*                         doit indiquer, par son nom:
+*
+*                 - le lieu (le fichier) où elle est définie,
+*                 - le type d'action qu'elle exécute et
+*                 - l'objet ou les objets modifié.s par cette action.
+*
+*                              -    -    -
+*
+*      Ces informations sont encodées au moyen de "préfixes" standardisés et
+*   le nom de chaque fonction est une combinaison/concaténation de ces préfixes.
+*     En octobre 2024, la première version de cet index classe en trois listes
+*             l'ensemble des préfixes préférentiellement utilisés.
+*
+*                  Ces listes sont en cours d'élaboration.
+*                  Elles ne sont ni limitatives ni ordonnées.
+*
+*                              -    -    -
+*
+*   Les fichiers sont définis par leur adresse dans la hiérarchie "src":
+*   ex: /graphics/draw/
+*       /fsm/measures/manager/
+*       /util/draw/gl/
+*       /widget/one_rule/algebra/assign/
+*
+*   Liste des préfixes indiquant la fonction:
+*        get, set, reset, read, write, print, edit, concat, design,
+*        init, create, add, remove, trigger, draw, erase, restore, push
+*        setup, shutdown, update, list, sort, seek, select, fix, debug,
+*        render, realize, unrealize, activate, exec, stop, signal,
+*
+*   Liste des objets sur lesquels agissent les fonctions:
+*        number, string, view, window, list, tree, stack,
+*        state, rules, data, results, image, stock,
+*        widget, button, slider, color,
+*        glarea, shader, file, buffer,
+*        point, line, plan, space_unit, site, arrow, slot, vertex, ridge,
+*        callback, signal,
+*
+*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  */
+
+
+
 concat                                          util/strings_op
 create_axis_slider                              util/draw/gl   223
 free_stack_slot                                 graphics/init   36

src/main.c

@@ -33,28 +33,18 @@
  *   https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel
  *   https://en.wikipedia.org/wiki/Multitier_architecture
  *
- * Le nom de toute fonction qui peut être appelée d'un autre module doit comporter :
- *   - 1) le nom du module auquel elle appartient (widget, graphics, parse,...)
- *   - 2) une indication sur son action (get, set, rec, fix, create, add,...)
- *   - 3) une indication sur l'objet de cette action (state, rules, stock,...)
- *
- *   ex: on_save_current_model()
- *       model_get_dim_value()
- *
- * Le fichier 'state.c' est devenu un dossier contenant
- * les fichiers 'top.c', 'middle.c', 'bottom.c' et 'distrib.c'  (2024-08)
- *
- * 'middle.c' deviendra, s'il est trop volumineux, un dossier 'middle'
- * contenant, par exemple, les fichiers 'camera.c' ou 'contrasts.c' et d'autres
- * et ainsi de suite ...
- *
- * Une fonction comme : get_zoom_box()
- * devra alors être renommé : state_camera_get_zoom_box()  (par exemple)
- *
- *                           _________________
  *
  *
- * ORGANISATION ACTUELLE
+ * gcc `pkg-config --cflags --libs gtk4 epoxy glib-2.0` -lm -o instanced_cubes instanced_cubes.c
+ *  ./instanced_cubes
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * ORGANISATION ACTUELLE   (Octobre 2024)
  *
  * 1) Les structures hiérarchiques.
  * --------------------------------