moare doc...

Jouets.md

@@ -0,0 +1,78 @@
+# Les jouets
+
+Comme pour la plupart de mes projets informatiques, je suis parti
+sur une vague idée (dont je n'ai aucun souvenir) et ensuite, je
+rajoute de multiples itérations de
+[rache](https://la-rache.com/certificat.html#tTh%20des%20Bourtoulots),
+alors forcément le code n'est pas très clair tout comme mes intentions
+de pseudo-créateur.
+
+Alors, je vais écrire des choses vaguement inutiles afin de vous aider
+à ne pas comprendre grand-chose au bouzin. Un peu de technique,
+un peu de pensées diverses, un peu d'imaginaire, tout ce qui
+fait la vie du poviste néo-rural.
+
+La plupart des choses dont je cause sont dans des fichiers
+placés dans le répertoire [incs](./incs/) et vraiment très
+mal commentés.
+
+
+## constantes
+
+*Un peu de sérieux !* Dans ce [fichier](./incs/constantes.inc), on
+trouve, pour le moment, essentiellement deux choses :
+
+* Des valeurs numériques pour la géométrie des choses, l'écartement
+  des rails, la taille des roues...
+* Les textures qui servent à donner de pinpantes couleurs à
+  toutes ces choses plus ou moins bien formées.
+
+
+## benne
+
+## citerne
+
+## corail
+
+## decor
+
+## electric
+
+## enseigne
+
+Comme nous sommes dans un univers ferriovaire, nous devons clairement
+afficher des choses, sur le coté de nos wagons, aux frontons de nos
+gares, et sur les dispositifs qui règlent nos vies.
+
+## galerie
+
+## gare
+
+## grue
+
+*Une cinématique extrèmement complexe basé sur une hiérachie de
+transformées imbriquées dans une cascade indécente de composants
+complexes imbriqués dans un assemblage de ...*
+
+
+## instruments
+
+Chaque machine a besoin d'un tachymetre, d'un presostat, et d'un
+petit affichage qui frétille.
+
+## locomotive
+
+## poteaux
+
+## rails
+
+## ridelles
+
+## rotonde
+
+Il faut bien un endroit où garer ces jolies voitures.
+
+## train
+
+## voiture
+

README.md

@@ -1,12 +1,21 @@
 # PovJouets
 
-Un très très vieux projet POVray qui revient dans le triste
-monde de 2021.
-Et qui revient en forme pour attaquer **2025** ?
+C'est un très très vieux
+[projet](http://maison.tth.netlib.re/pov/jouets.html) en POVray qui
+revient dans le triste
+monde de 2021, un monde que nous essayons de ranger dans un recoin
+de nos mémoires, à la rubrique *never again*.
+Un projet qui reviendrait en forme pour attaquer la deuxième canicule de
+**2026** ?
 
-https://git.tetalab.org/tTh/PovJouets
+Coté code, tout est bien en place dans le
+[tetagit](https://git.tetalab.org/tTh/PovJouets) pour que vous 
+puissiez intégrer ces [jouets](./Jouets.md) dans vos univers
+abscons. *Fork and enjoy.*
 
 ## TODO
 
 - bien revoir la hiérarchie des includes
 - définir un jeu de textures cohérent
+- trouver les maths pour faire tourner les roues
+-