| perlwin32faq3 - Documentation et Support |
perlwin32faq3 - Documentation et Support
ActivePerl Documentation et Support
La documentation pour ActivePerl est fournie au format HTML dans le répertoire Html de votre répertoire perl. Cela comprend la documentation standard Perl, et celle pour les extensions spécifiques Win32. Pour plus d'information sur les extensions spécifiques Win32, voir Quels modules accompagnent la distribution Win32 de Perl ?.
Notez que la documentation de la distribution standard de Perl (perl*.htm) contient des informations spécifiques à UNIX, et liste des fonctions/capacités qui ne fonctionneront pas avec la version Windows d'ActivePerl. Les pages perlwin32 et perlport discutent des problèmes de portabilité pour les plates-formes Win32.
Vous pouvez également consulter la documentation avec la commande perldoc. Au prompt, tapez perldoc suivi du nom du document que vous souhaitez lire, comme :
perldoc perlwin32
perldoc perlfaq
La documentation est fournie avec la distribution binaire (elle est créée durant l'installation), et elle peut être créée par l'installation ou construite avec «make installhtml» dans la distribution source.
ActivePerl est livré avec la documentation du Perl standard, et les ajouts spécifiques à Win32.
Un support est disponible depuis les listes de diffusion Perl en rapport hébergées par ActiveState. Vous pouvez trouver plus d'information sur ces listes de diffusion à http://www.ActiveState.com/support/
Pour un support critique, merci de consulter la Clinique Perl à http://www.PerlClinic.com
La Clinique Perl propose un support payant pour tous vos problèmes Perl.
PerlDirect ( http://www.ActiveState.com/Products/PerlDirect/index.html ) offre des solutions de support d'entreprises pour Perl. PerlDirect fournit le support complet dont une entreprise a besoin pour déployer Perl.
Il existe plusieurs pages web dédiées à ActivePerl. Voici une courte liste :
(NdT : Ces pages étant en anglais, leurs titres et descriptions ne sont pas traduits.)
ActiveState héberge une variété de listes de diffusion pour la communauté ActivePerl. Plus d'informations sont disponibles sur : http://www.ActiveState.com/support/mailing_lists.htm
Les archives des listes de diffusion sont également disponibles sur le site web d'ActiveState.
Vous pouvez consulter les archives ou une FAQ comme celle-ci (voir Existe-t-il une FAQ pour ActivePerl ? avant de poser une question à la liste de diffusion. Les membres de la liste sont pour la plupart des administrateurs et programmeurs surchargés comme vous-même. Donc, pour de meilleurs résultats, soyez courtois, précis, et montrez que vous avez essayé de résoudre le problème par vous-même.
Pas encore. Vous pouvez utiliser comp.lang.perl.misc pour des questions diverses sur Perl, mais les membres de la majorité des groupes de discussion Perl tendent à se concentrer sur les plates-formes UNIX.
Essayez la liste de diffusion perl-win32-users (voir Existe-t-il une liste de diffusion sur ActivePerl ou Perl pour ISAPI ? pour des informations plus spécifiques à Win32.
Pour la configuration de serveurs Web et la programmation CGI essayez l'un des trois groupes de discussion suivants :
comp.infosystems.www.servers.ms-windows
comp.infosystems.www.authoring.cgi
comp.infosystems.www.authoring.misc
Pour les francophones, le groupe de discussion sur Perl en général est
fr.comp.lang.perl
Les discussions sur l'utilisation de Perl pour les scripts CGI se déroulent dans
fr.comp.infosystemes.www.auteurs
Vous êtes en train d'en lire une. De plus, Perl est accompagné de la FAQ Perl principale dans le système d'aide, qui fait plus d'une centaine de pages, et est découpée en plusieurs parties.
La page de Robin Chatterjee sur Perl pour Win32 contient des questions fréquentes et une copie de leurs réponses tirées de la liste de diffusion perl-win32-users :
http://www.geocities.com/SiliconValley/Park/8312/
Le système pour les rapports de bug d'ActiveState est sur http://bugs.ActiveState.com
Avant de signaler un bug à cet endroit, vous devez faire plusieurs choses :
Voir aussi Puis-je poser une question ? ... ou ... Comment poser une question ?
Vous devriez consulter la liste des bugs pour voir si votre bug a déjà été signalé ou corrigé. Vous devez pouvoir reproduire le bug. Si cela arrive juste une fois, ce n'est pas un bug. Ceci a besoin d'être bien clair : si cela ne peut pas être reproduit alors ce n'est pas un bug. Créez un script simple et court en exemple du bug. N'envoyez pas le source original comme exemple - faites votre possible pour réduire l'exemple au minimum. Ce processus est connu comme permettant de révéler des erreurs se faisant passer pour des bugs. Il ne doit pas être nécessaire aux testeurs de bugs d'ActiveState de faire beaucoup de configuration pour reproduire le bug. Si une installation ou des fichiers de données exemples sont nécessaires, préparez des instructions simples. Une fois que tout est prêt, vous pouvez envoyer votre rapport de bug à ActiveState, en précisant clairement la nature du bug, comment le reproduire, et quels plate-forme, système d'exploitation, et version de Perl cause le problème. Souvenez-vous que votre but est de donner suffisamment d'information à ActiveState pour reproduire le bug. Si cela n'est pas reproductible, cela ne peut être considéré comme un bug. Vous devriez recevoir un message à propos du statut de votre bug au fur et à mesure de son avancement dans le processus de vérification et correction. Ne soumettez pas le même bug plus d'une fois.Soumettez les bugs ici : http://bugs.activestate.com/
L'étiquette pour poser une question est à peu près la même que vous utilisiez les listes de diffusion, les groupes de discussion, les salons de dialogues, ou les chaînes IRC. Voici quelques conseils pour obtenir une réponse à vos questions.
Pour UNIX ou des discussions plus générales sur Perl,
vous pouvez essayer #perl sur EFNet (le grand) et UnderNet.
Attention avec EFNet #perl cependant. Un certain nombre de sujets
ne sont pas tolérés : les problèmes
spécifiques à ActivePerl, questions sans rapport
avec la programmation (e.g., Je viens juste de
télécharger ce script - comment je le fais marcher ?),
et la programmation CGI/WWW. EFNet #perl, cependant, est un bon
endroit pour trouver de très bons codeurs Perl, comme Tom
Christiansen (tchrist) et Randall Schwartz (q[merlyn]). Je n'y ai jamais
vu Larry, mais il paraît qu'il passe quelques fois.
Sur n'importe lequel de ces canaux IRC, vous devez faire votre travail, et essayez de résoudre vos problèmes. N'espérez pas que quelqu'un va se pencher sur le dernier script que vous avez téléchargé et va le faire fonctionner pour vous parce que «vous voulez qu'il fonctionne et vous n'avez pas le temps d'apprendre Perl». Cette manière de procéder est très sûre pour se faire bannir du canal. Les membres de ces canaux sont des programmeurs surchargés peu tolérants pour ceux qui veulent faire faire leur travail par quelqu'un d'autre...
Après avoir posé votre question, vous pouvez rester un peu et discuter. C'est poli, et c'est un bon moyen d'apprendre «le style perl», ou comment pensent les codeurs à propos des choses de tous les jours.
Cette FAQ a été à l'origine assemblée et maintenue par Evangelo Prodromou. Elle a été révisée et mise à jour par Brian Jepson de O'Reilly and Associates, et David Grove et David Dmytryshyn d'ActiveState.
Cette FAQ est dans le domaine public. Si vous l'utilisez, cependant, vérifiez, s'il vous plaît, que vous donniez le crédit aux auteurs originaux.
Cette traduction française correspond à la version anglaise distribuée avec perl 5.8.0. Pour en savoir plus concernant ces traductions, consultez http://www.enstimac.fr/Perl/ .
Fabien Martinet <ho.fmartinet@cma-cgm.com>
Jean-Louis Morel <jl_morel@bribes.org> (mise à jour perl 5.8.0)
| perlwin32faq3 - Documentation et Support |