Réécriture en français simple des commentaires ajoutés en #12 et #14 has been fixed.
See more details at : https://github.com/pdulvp/pdcartes-rami/issues/15
- commentaires, docstrings et en-têtes de tools/make-icon.py,
data/links.ini, src/Links.h.in, data/pdcartes-rami.rc.in et des blocs
correspondants de CMakeLists.txt, src/main.cpp et
src/SettingsDialog.{h,cpp} réécrits en français standard et descriptif
- style imagé, formules et tournures fautives remplacés par des phrases
décrivant ce que fait le code
- aucune modification de code : le diff ne porte que sur des commentaires, et
les fichiers assets/icon/ régénérés sont identiques hormis une ligne de
commentaire du SVG
- périmètre limité aux commentaires ajoutés par les commits #12 et #14 ; le
reste du dépôt n'est pas touché
Réécriture en français simple des commentaires que j'ai écrits
<sub>2026-10-25-0940-reecriture-de-mes-commentaires-en-francais-simple.md — 2026-10-25 09:40</sub>
Les commentaires ajoutés aux commits #12 et #14 sont écrits dans un style
imagé : métaphores, formules, phrases construites pour l'effet plutôt que
pour l'information. Plusieurs sont aussi fautifs — sujet omis, verbe mal
choisi, tournures non idiomatiques.
Il s'agit de les réécrire en français standard et descriptif. Le code ne
change pas.
Décisions
- Seuls mes commentaires sont touchés. Le reste du dépôt est écrit dans
le style de l'auteur ; ce n'est pas le sujet et il n'est pas modifié. La
limite est donnée par les commits #12 et #14, et par les fichiers qu'ils
ont créés.
- Aucune modification de code. Seuls changent les commentaires, les
chaînes de documentation et les lignes de commentaire des fichiers de
configuration. Les binaires produits doivent être inchangés.
- Le commentaire du SVG passe par le script. assets/icon/pdcartes-rami.svg
est produit par tools/make-icon.py : la ligne se corrige dans le script,
puis les fichiers sont régénérés.
- Les plans archivés ne sont pas touchés. docs/plans/README.md indique
que les fichiers datés sont des archives que l'on ne modifie plus.
Règles appliquées
- décrire ce que fait le code, sans métaphore ;
- une idée par phrase, pas de formule finale ;
- sujet explicite, accords et prépositions corrects ;
- espace avant : et guillemets « ».
Étapes
- [x] tools/make-icon.py — docstring et commentaires ; corriger la ligne
émise dans le SVG, puis régénérer assets/icon/.
- [x] data/links.ini et src/Links.h.in.
- [x] data/pdcartes-rami.rc.in.
- [x] CMakeLists.txt — seulement les blocs ajoutés par #12 et #14.
- [x] src/main.cpp et src/SettingsDialog.{h,cpp} — seulement mes blocs.
- [x] Bâtir en série des deux côtés ; vérifier qu'aucun code n'a changé.
Vérifié
Les deux arbres reconfigurés et bâtis en série, sans erreur ni avertissement.
Aucune ligne de code n'a changé : le diff des fichiers C++, CMake et .rc.in
ne contient que des lignes de commentaire. Dans tools/make-icon.py, les
corps de docstring et deux messages de sys.exit ont également été réécrits ;
ces messages sont ceux d'un outil de développement, sans effet sur
l'application.
Les fichiers de assets/icon/ ont été régénérés : seul le SVG diffère, par sa
ligne de commentaire. Les sept PNG et le fichier ICO sont identiques octet
pour octet, ce que confirme git status.
L'exécutable Windows reconstruit porte toujours FILEVERSION 1.2.8.0, la
description accentuée, PDCartes Rami et la mention de copyright.
Links.h est régénéré avec l'adresse attendue.
<sub>Filed by prel from the completed plans at commit time.</sub>