Lionel Debroux (./12) :
le "our" des formulations "Maximum/minimum value of our <...> type." me paraît très bizarre: pourquoi pas "the" à la place de "our" ?? C'est le standard C99 qui définit le type, pas "nous" projet TIGCC.
"Notre" type uint_least16_t par opposition à celui de GNU/Linux par exemple.
C99 spécifie qu'il doit y avoir un tel type, mais le type concret est à nous.
La doc de Conrad mentionne C99 de façon inconsistante (certains .hsf l'ont en Description, pas d'autres). Dans TIGCC-fork, la spécification C99 est mentionnée dans le .hsh et dans la section Explanation des .hsf, mais jamais dans la section Description des .hsf.
Ça ne me dérange pas vraiment, mais ça peut se changer. (Mais il me faudra des propositions de quoi changer exactement.)
question de goût: la formulation de stdint.h (et inttypes.h, d'ailleurs) de TIGCC-fork est proche de la formulation qu'on peut trouver dans C99+TC1+TC2. Ce sont donc des définitions plus précises et moins accessibles que celles de Conrad.
Et les droits d'auteur dans tout ça? (Le standard n'est pas libre de droits ni libre au sens du logiciel libre, on ne peut pas le copier mot pour mot.)
De plus, le "standardese" n'a jamais été ce qu'il y a de plus lisible.
Qu'est-ce qui n'est pas clair dans les descriptions de Conrad à ton avis?
Voir http://lionel.debroux.free.fr/pub/.stdint.html .
Je vais dire ce qui ne me va pas dans cette documentation:
* Description est trop longue. Ça doit être une description courte, donc des formulations comme "Integer constant expression having the value specified by its argument and ..." sont trop longues pour Description. À la limite pour Explanation, mais c'est quand-même du "standardese", cf. plus haut.
* Explanation est trop courte, souvent plus courte que Description, il manque des détails que la version de Conrad apporte.
* Explanation est du copier-coller scripté "Definition mandated by the C99 standard." qui n'apporte aucune information (tout le header est spécifié par C99).
* Dans la documentation de (par exemple) INT16_C, il y a "Integer constant expression having the value specified by its argument and the type int_least16_t.", mais il n'y a pas de lien pour
int_least16_t. (C'était comme ça aussi dans la première version de Conrad, je lui ai demandé de corriger ça et il l'a fait rapidement avec un petit script.)
Quant à
inttypes.h, je ne vois pas l'intérêt de proposer ce header non-standard.