Comment faire pour modifier l'entête de la page de manuel ?

La page est créée avec pod2man... donc c'est un peu normal.
POD est la structure standard de documentation de perl.
Je ne trouve pas ça gênant.

ok pas de problème

Donc tout le monde est d'accord que tous les man produits par cette team prétendent être à propos d'un script perl…
Moi je comprends pas c'est vraiment pas beau et tout simplement faux !

POD a été choisi (on peut changer) comme format pour la documentation car:
- l'export vers man/html est facile (pod2man, pod2html)
- l'extraction pour le usage est facile (pod2usage) et flexible (différent niveau verbosité du usage) et puissant
- le formatage est simple
- il peut être intégré au script (dans le même fichier, ce qui facilite la maintenance de la doc)

Maintenant ya une petite en-tete ou ya écrit Perl. so what ?

Si tu as un format qui répond a toutes ces specs je suis preneur.

Dans tous les cas le POD est une proposition.
Dans ton script tu peux toujours:
- écrire ton man a la main
- écrire ton html a la main
- écrire ton usage a la main
Personne ne t'en empêchera ;-)

Matthias Hawran a écrit :
> POD a été choisi (on peut changer) comme format pour la documentation car:
> - l'export vers man/html est facile (pod2man, pod2html)
> - l'extraction pour le usage est facile (pod2usage) et flexible (différent niveau verbosité du usage) et puissant
> - le formatage est simple
> - il peut être intégré au script (dans le même fichier, ce qui facilite la maintenance de la doc)

C'est très bien tout ça.

>
> Maintenant ya une petite en-tete ou ya écrit Perl. so what ?
>
> Si tu as un format qui répond a toutes ces specs je suis preneur.

Bin non :-'

>
> Dans tous les cas le POD est une proposition.
> Dans ton script tu peux toujours:
> - écrire ton man a la main
> - écrire ton html a la main
> - écrire ton usage a la main
> Personne ne t'en empêchera ;-)
>

Très mauvais vu que l'idée de faire tout un projet repose sur l'envie
d'uniformiser un tant soit peu pour permettre une évolution efficace, il me
semble ?!

Bon j'aurais pas dû râler trop tôt, hier j'ai un peu cherché mais là j'ai trouvé
: il suffit de donner --center string à pod2man pour changer ça. Le problème
c'est que ce doit être donné à l'appel de pod2man et pas dans le fichier pod…
c'est dommage.

> il suffit de donner --center string à pod2man pour changer ça. Le problème
c'est que ce doit être donné à l'appel de pod2man et pas dans le fichier pod…
c'est dommage.

Ça me parait raisonnable comme solution, vu que de toute façon l'appel est fait dans le makefile.

On bouge cette question dans ufrs-toolbox
et on fait un bug report pour ne pas oublier de l'implémenter ?