J'ai tendance à faire presque toute la doc utilisateur en POD… Il y a bien sur un wiki mais c'est en plus. J'intègre si possible la doc POD dans le fichier source (possible en Perl bien sur mais aussi avec bash, Fortran…) et une petite règle dans un Makefile me mouline tout cela en des fichiers man et même temps que la compilation !
Je trouve que pour beaucoup de chose, la doc au format man est bien pratique. C'est souvent bien pratique d'avoir tout sur sa machine et qui ne prennent pas 3Go de disque ni dix milliard de cycles CPU lors de l'utilisation !
Exemple à ne pas suivre, les dernières version du compilateur intel prennent plus de 2Go d'espace disque juste pour pouvoir faire icc ou ifort… Tout cela car il y a un bordel de doc et de java complètement inutile mais placé dans une arborescence digne d'Adobe ;-)
[^] # Re: help2man
Posté par Sytoka Modon (site web personnel) . En réponse au journal Publication de petits projets. Évalué à 2.
J'ai tendance à faire presque toute la doc utilisateur en POD… Il y a bien sur un wiki mais c'est en plus. J'intègre si possible la doc POD dans le fichier source (possible en Perl bien sur mais aussi avec bash, Fortran…) et une petite règle dans un Makefile me mouline tout cela en des fichiers man et même temps que la compilation !
Je trouve que pour beaucoup de chose, la doc au format man est bien pratique. C'est souvent bien pratique d'avoir tout sur sa machine et qui ne prennent pas 3Go de disque ni dix milliard de cycles CPU lors de l'utilisation !
Exemple à ne pas suivre, les dernières version du compilateur intel prennent plus de 2Go d'espace disque juste pour pouvoir faire icc ou ifort… Tout cela car il y a un bordel de doc et de java complètement inutile mais placé dans une arborescence digne d'Adobe ;-)