=head1 NOM perlwin32faq3 - Documentation et Support =head1 DESCRIPTION ActivePerl Documentation et Support =head2 Où trouver de la documentation sur ActivePerl ? La documentation pour ActivePerl est fournie au format HTML dans le répertoire I de votre répertoire I. 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 L. Notez que la documentation de la distribution standard de Perl (I) 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. =head2 Quelle documentation est livrée avec ActivePerl ? ActivePerl est livré avec la documentation du Perl standard, et les ajouts spécifiques à Win32. =head2 Existe-t-il un support formel sur ActivePerl ou PerlIS ? 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. =head2 Existe-t-il des sources d'information disponibles sur ActivePerl sur le World Wide Web ? 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.) =over =item * http://www.ActiveState.com/ - The ActivePerl home page. =item * http://www.ActiveState.com/support - Introductory information, FAQs, mailing lists, and more. =item * http://dada.perl.it/ - Aldo Calpini's page, which includes many links, modules for Win32, and more. =item * http://www.geocities.com/SiliconValley/Park/8312/ - Robin Chatterjee's Perl for Win32 page, which includes FAQs, links, etc. =item * http://www.northbound-train.com/perlwin32.html - Joe's Perl for Win32 Page, which has general information, pointers to modules, etc. =back =head2 Existe-t-il une liste de diffusion sur ActivePerl ou Perl pour ISAPI ? 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 L 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. =head2 Existe-t-il un groupe de discussion dédié à ActivePerl ? 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 L 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 =head2 Existe-t-il une FAQ pour ActivePerl ? 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/ =head2 Comment signaler un bug dans ActivePerl ? 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 : =over =item * Vérifiez que c'est bien un bug, et non pas une erreur de logique dans votre programme. =item * Vérifiez que c'est bien un bug, et non pas une incompréhension sur le fonctionnement de Perl. Consulter les archives de la liste de diffusion et les FAQs pour voir si quelqu'un a rencontré le même problème. TOUJOURS suivre ces étapes pour commencer, même si vous êtes plus que certain que c'est un bug . La plupart des bugs rapportés à ActiveState ne sont pas des bugs et peuvent être résolus en consultant les FAQs et les archives des listes. =item * Vous pouvez aussi utiliser http://groups.google.com/ pour chercher dans comp.lang.perl.misc. Si c'est un problème qui a été discuté dans le groupe de discussion, votre réponse est peut-être là. Après avoir épuisé toutes ces possibilités, vous pouvez vouloir poster sur l'une des listes de diffusion pour voir si quelqu'un a la solution. Voir aussi L =item * Vous devriez consulter la liste des bugs pour voir si votre bug a déjà été signalé ou corrigé. =item * 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. =item * 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. =item * 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. =item * 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. =item * 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. =item * Ne soumettez pas le même bug plus d'une fois. =back Soumettez les bugs ici : http://bugs.activestate.com/ =head2 Puis-je poser une question ? ... ou ... Comment poser une question ? 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. =over =item * Cherchez avant de poser une question. Achetez un livre (ou plus d'un...O'Reilly a beaucoup de choix), lisez l'aide en ligne, et cherchez sur le web. Si vous n'avez pas le temps de chercher par vous-même, les gens n'auront pas le temps de chercher pour vous. =item * Consultez la FAQ d'abord - si la question a été abordée dans la FAQ, vous pourriez ne pas avoir de réponse dans un forum public. =item * Ne demandez jamais, "puis-je poser une question ?", parce que c'est un signe certain que vous êtes un débutant. Les gens sur IRC et sur les groupes de discussion sont fatigués des débutants parce qu'ils semblent toujours demander sans chercher d'abord. =item * Suivez les conversations sur les listes de diffusion ou les groupes de discussion pendant un certain temps avant de poser une question. Si vous avez une question urgente, et que vous n'avez jamais lu le groupe ou la liste, consultez les archives ou http://groups.google.com/ pour voir les anciens messages. Cela vous familiarisera avec le ton de cette liste ou de ce groupe particulier. Si votre question a déjà été posée, il y a de fortes chances qu'elle ait obtenu une réponse et les archives vous la donneront si vous cherchez bien. =item * Posez votre question directement. Pensez la bien, et posez-la. Cela peut sembler brutal de poser une question abruptement, mais c'est la méthode. =back =head2 Existe-t-il des discussions en direct à propos de Perl ? Pour UNIX ou des discussions plus générales sur Perl, vous pouvez essayer C<#perl> sur EFNet (le grand) et UnderNet. Attention avec EFNet C<#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 C<#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. =head1 AUTEUR ET COPYRIGHT 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. =head1 VERSION FRANÇAISE 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/ . =head1 TRADUCTION EN FRANÇAIS Fabien Martinet Jean-Louis Morel (mise à jour perl 5.8.0) =cut