From f7279883ecdee1300b5ed5a174aa61e523ffac21 Mon Sep 17 00:00:00 2001 From: Jean Sirmai Date: Sun, 12 Jan 2025 10:08:46 +0100 Subject: [PATCH] Texinfo Manual Temporary Interruption of the Redaction cf. lines 1196, 1371 A plan is drawn up. The text is organised. The difficulties are made clear. --- docs/rtfm/gem-graph.texi | 142 +++++++++++++++++++++++++++++++++++++-- 1 file changed, 135 insertions(+), 7 deletions(-) diff --git a/docs/rtfm/gem-graph.texi b/docs/rtfm/gem-graph.texi index 91bc2c3..d001c5c 100644 --- a/docs/rtfm/gem-graph.texi +++ b/docs/rtfm/gem-graph.texi @@ -1,11 +1,9 @@ \input texinfo -@c https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.pdf +@c https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.pdf -@c @paragraphindent 0 - -@c @fonttextsize 10 (instead of 11) enable to see the intro in one page. - -@c from: Appendix B Tips and Hints p 242: +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c +@c G O O D P R A C T I C E S @C +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c "Write in the present tense, not in the past or the future." @c "Write actively! For example, write “We recommend that . . .” @@ -13,6 +11,10 @@ @c "Use 70 or 72 as your fill column. Longer lines are hard to read." <<< @c "Include a copyright notice and copying permissions." @c "Design your manual so that it can be read sequentially, as far as possible." +@c (from: Appendix B Tips and Hints p 242) + +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c + @setfilename gem-graph.texinfo @settitle Gem-Graph manual @@ -1187,6 +1189,37 @@ The opposite of this trend, the aim of this chapter is to help you familiarise yourself with the simplest models that comply with gem-graph basic standards. These are the tools that enable complexity to be analysed and mastered. +________________________________________________________________________________ +@sp 5 +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c + +2025-01-12 - (line 1196) + +La première version de ma rédaction s'arrête ici (voir aussi ligne 1371). +Pour aller plus loin, il me faut choisir entre plusieurs formats qui expriment +des intentions contradictoires +(il me faudra probablement en présenter plusieurs en expliquant mes choix). + +Pour chaque format, plusieurs options sont possibles. +Les "verbatim" suivants ne résolvent pas ces contradictions +et ne les mettent même pas toutes en évidence. + +@itemize +@item +didactique +@item +minimal +@item +complet +@item +historique +@end itemize + +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c +@sp 5 +________________________________________________________________________________ + + @subsection Minimal XML @verbatim @@ -1330,7 +1363,102 @@ These are the tools that enable complexity to be analysed and mastered. @node sirmai_testimony @section From Cellular Automata to Gem-graph I describe here the steps that led me to the actual conception of gem-graph. -@sp 0 +@sp 5 +________________________________________________________________________________ +@sp 5 +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c + +2025-01-12 - (line 1371) + +Ici aussi un arrêt dans la rédaction de cette première version (cf. ligne 1196). +@sp 1 +Pour aller plus loin, il me faut à la fois choisir une forme d'expression et, +sur le fond, faire un tri entre plusieurs intentions contradictoires. + +Concernant la forme, séparer ce que j'ai à dire en deux textes me permet +de parler ici à la première personne : +puisqu'il s'agit de mon "testimony" (mon témoignage) sur l'histoire +(inachevée et pour l'instant inaboutie) de cette invention, +je n'ai qu'à raconter librement ce que j'ai vécu. + +La première partie (ligne 935 History) me permet auparavant de me citer +brièvement en même temps que je cite Sébastien et Adrien (qui sont, jusqu'ici, +les deux seuls autres contributeurs). + +Cette première partie est conforme à la forme utilisée par Richard dans +le manuel de Texinfo (1.6 History) et donne au lecteur l'information minimale +qu'il peut souhaiter trouver. +Elle permet de faire un lien vers cette section annexe dont l'intérêt est de +garder en mémoire l'histoire du chemin parcouru. +@sp 1 +Cette histoire est très difficile à retracer et j'interromps ma rédaction +pour ne pas y passer trop de temps et continuer à coder +(j'ai entrepris cette première rédaction sous Texinfo fin novembre 2024; +cela fait donc - en tenant compte des fêtes de fin d'année - un mois et demi). +@sp 1 +Les difficultés sont : + +@itemize +@item +Le niveau de détail, en particulier losqu'il s'agit du contexte. + +Il serait inexact (et injuste) de ne pas citer les travaux de von Neumann, +Conway, McMullin, Varela, Buckley, Sayama, Nehaniv, etc. +Mais où m'arrêter ? +Quels sont les innovations qui ont compté dans ma démarche ? +Quelles sont celles qui seront les plus significatives dans quelques années ?! + +@item +L'ordre des innovations qui est très difficile à établir ! + +Ai-je toujours modifié la forme des règles de transition en même temps que +je modifiais celle des états ? +Combien de modifications successives y a-t-il eu (et de retours en arrière, +d'hésitations) ? +Dans quel ordre ? +Quelles contraintes ai-je choisi ou évacuées et pouquoi, quand ?! + +@item +Mon premier journal est incomplet. + +Je ne savais pas, à l'époque qu'il aurait pu être aussi important et utile +pour cette rédaction (si j'avais su, je l'aurais mieux tenu) ! +Mais, tel qu'il est, il est utilisable. +Cependant il faudra du travail pour l'analyser. +Et il y a plus urgent à faire: nous ne savons toujours pas quand nous +atteindrons une "version zéro". + +@item +La mise en forme est seulement ébauchée. Ex : + +Overfull \hbox (32.02371pt too wide) in paragraph at lines 1299--1299 [][][] | + +etc. TODO +@end itemize +@sp 1 +J'interromps donc cette rédaction pour ne pas disperser davantage mon travail. +@sp 1 +Il était raisonnable de débuter une première version d'un manuel. + +Nous avons choisi un outil de rédaction et j'ai commencé à apprendre +à l'utiliser. + +Un plan est ébauché. Le texte est organisé. Les difficultés sont explicitées. + +Ce qui a été fait devrait être suffisant pour reprendre le travail sans +gaspiller trop de temps à se relire. +La partie "RAW MATERIAL" devrait disparaitre à terme, +lorsque son contenu aura été trié et (pour les parties utile) +reformulé et incorporé dans le texte. +@sp 1 +... Et un peu de recul ne fera pas de mal... + + +@c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c @c +@sp 5 +________________________________________________________________________________ + +@sp 5 @subsection Context. In the 1950s-1970s, a new frontier of knowledge was emerging: nobody knew how to use the power of computers to better understand biology.