Je suis en train de cr=E9er un module Tk (que je souhaites mettre par la
suite sur le CPAN).
J'ai une question basique pour le connaisseur.
Pendant la cr=E9ation de la distribution (build test), j'ai un message
d'erreur :
t\pod-coverage....NOK 1/1# Failed test 'Pod coverage on
Tk::MonModule'
# at C:/Perl/site/lib/Test/Pod/Coverage.pm line 126.
# Coverage for Tk::MonModuleis 90.9%, with 1 naked subroutine:
# Populate
# Looks like you failed 1 test of 1.
t\pod-coverage....dubious
Test returned status 1 (wstat 256, 0x100)
DIED. FAILED test 1
Ceci est d=FB au fait que je n'ai pas comment=E9 dans mon pod la proc=E9dur=
e
populate. Comment faire pour que ce message d'erreur n'apparaisse
plus ? Car populate n'est pas une proc=E9dure externe pour le module.
Mes autres proc=E9dures internes sont pr=E9c=E9d=E9es d'un "_" donc, je n'a=
i
pas de soucis pour eux.
À (at) Fri, 27 Mar 2009 06:37:42 -0700 (PDT), écrivait (wrote):
je suis conscient que le principe est de tout documenter, mais comme je voyais sur le CPAN qu'il y avait des distribution tels DBI, Regexp::common, GDGraph contenant des modules sans pod, je pensais que c'était une des démarches à suivre. Par exemple, j'en ai pris un au piff http://search.cpan.org/~metzzo/XML-RDB-1.1/, on remarque qu'il y a des modules sans lien.
Bon sinon, quand je regarde le module CGI (http://search.cpan.org/~lds/ CGI.pm-3.42/) , je remarque que le créateur a tout de même fait un pod pour son module CGI::Utils (http://search.cpan.org/~lds/CGI.pm-3.42/ CGI/Util.pm), puis je faire la même chose, c'est peut être suffisant, non ?
En fait, chacun fait ce qui lui plait... À chaque fois que quelqu'un demande, les autres l'incitent à tout documenter (c'est toujours plus facile de demander aux autres que de faire soi-même ;-))).
Tout le monde (moi le premier) a déjà écrit des trucs sans documentation. Ensuite la question est : « publié-je sans doc ou rédigé-je la doc avant ? »
Libre à vous de choisir ce que vous voulez ! ;-)
-- Paul Gaborit - <http://perso.mines-albi.fr/~gaborit/> Perl en français - <http://perl.mines-albi.fr/>
À (at) Fri, 27 Mar 2009 06:37:42 -0700 (PDT),
genomart@gmail.com écrivait (wrote):
je suis conscient que le principe est de tout documenter, mais comme
je voyais sur le CPAN qu'il y avait des distribution tels DBI,
Regexp::common, GDGraph contenant des modules sans pod, je pensais
que c'était une des démarches à suivre. Par exemple, j'en ai pris un
au piff http://search.cpan.org/~metzzo/XML-RDB-1.1/, on remarque qu'il
y a des modules sans lien.
Bon sinon, quand je regarde le module CGI (http://search.cpan.org/~lds/
CGI.pm-3.42/) , je remarque que le créateur a tout de même fait un pod
pour son module CGI::Utils (http://search.cpan.org/~lds/CGI.pm-3.42/
CGI/Util.pm), puis je faire la même chose, c'est peut être suffisant,
non ?
En fait, chacun fait ce qui lui plait... À chaque fois que quelqu'un
demande, les autres l'incitent à tout documenter (c'est toujours plus
facile de demander aux autres que de faire soi-même ;-))).
Tout le monde (moi le premier) a déjà écrit des trucs sans
documentation. Ensuite la question est : « publié-je sans doc ou
rédigé-je la doc avant ? »
Libre à vous de choisir ce que vous voulez ! ;-)
--
Paul Gaborit - <http://perso.mines-albi.fr/~gaborit/>
Perl en français - <http://perl.mines-albi.fr/>
À (at) Fri, 27 Mar 2009 06:37:42 -0700 (PDT), écrivait (wrote):
je suis conscient que le principe est de tout documenter, mais comme je voyais sur le CPAN qu'il y avait des distribution tels DBI, Regexp::common, GDGraph contenant des modules sans pod, je pensais que c'était une des démarches à suivre. Par exemple, j'en ai pris un au piff http://search.cpan.org/~metzzo/XML-RDB-1.1/, on remarque qu'il y a des modules sans lien.
Bon sinon, quand je regarde le module CGI (http://search.cpan.org/~lds/ CGI.pm-3.42/) , je remarque que le créateur a tout de même fait un pod pour son module CGI::Utils (http://search.cpan.org/~lds/CGI.pm-3.42/ CGI/Util.pm), puis je faire la même chose, c'est peut être suffisant, non ?
En fait, chacun fait ce qui lui plait... À chaque fois que quelqu'un demande, les autres l'incitent à tout documenter (c'est toujours plus facile de demander aux autres que de faire soi-même ;-))).
Tout le monde (moi le premier) a déjà écrit des trucs sans documentation. Ensuite la question est : « publié-je sans doc ou rédigé-je la doc avant ? »
Libre à vous de choisir ce que vous voulez ! ;-)
-- Paul Gaborit - <http://perso.mines-albi.fr/~gaborit/> Perl en français - <http://perl.mines-albi.fr/>
