<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="/htdocs/style.css" type="text/css">
<title>FAQ de CPAN Search</title>
</head>
<body>
<br>
<div class="t5">
Foire aux questions
</div>
<ol>
<li><a href="#01">Sur quel matériel ce site fonctionne-t-il ?</a></li>
<li><a href="#02">Pourquoi le module "X" n'apparaît-il pas ?</a></li>
<li><a href="#03">Pourquoi le module "X" n'apparaît-il pas, alors qu'il se trouve sur
search.cpan.org ?</a></li>
<li><a href="#04">Pourquoi la documentation du module "X" est-elle introuvable ?</a></li>
<li><a href="#05">Pourquoi manque-t-il certains modules prérequis du paquetage ?</a></li>
<li><a href="#06">Quelle est la syntaxe des requêtes ?</a></li>
<li><a href="#07">Comment utiliser les référentiels de PPM pour Win32 ?</a></li>
<li><a href="#08">Existe-t-il d'autres moteurs de recherche pour CPAN ?</a></li>
<li><a href="#09">Quelles sont les conventions utilisées pour les liens
externes ?</a></li>
<li><a href="#10">J'ai trouvé un problème, qui dois-je contacter ?</a></li>
<li><a href="#11">Le code source de ce site est-il disponible ?</a></li>
</ol>
<hr>
<dl class="faq">
<dt><a class="t5" name="01">Sur quel matériel ce site fonctionne-t-il ?</a></dt>
<dd>
<p>La machine de base est une machine <a href="http://www.linux.org/">Linux</a>. Les
logiciels utilisés comprennent <a href="http://www.mysql.com/">MySQL</a>, <a href=
"http://www.apache.org/">Apache</a> avec <a href="http://perl.apache.org/">mod_perl</a>,
<a href="http://www.template-toolkit.org/">Template-Toolkit</a>, et bien sûr <a href=
"http://www.perl.com/">Perl</a>. Le multiplexeur utilisé pour rediriger les téléchargements
vers le miroir CPAN le plus proche est basé sur <a href="http://www.maxmind.com/">GeoIP</a>.
La connexion réseau est fournie par <a href="http://www.uwinnipeg.ca/">l'université de
Winnipeg</a>.</p>
</dd>
<dt><a class="t5" name="02">Pourquoi le module "X" n'apparaît-il pas ?</a></dt>
<dd>
<p>En supposant qu'il ait été indexé sur <a href="http://www.cpan.org/">CPAN</a> et que
suffisamment de temps se soit écoulé pour que le miroir local l'ait récupéré, c'est peut-être
à cause de la structure non conventionnelle du module. En particulier, ce site s'attend à ce
que la distribution soit décompactée dans un répertoire dont le nom dérive du nom de la
distribution. En outre, le nom et la version de la distribution doivent pouvoir être extraits
avec le module <a href=
"http://cpan.uwinnipeg.ca/~gbarr/CPAN-DistnameInfo">CPAN-DistnameInfo</a> de Graham Barr.</p>
</dd>
<dt><a class="t5" name="03">Pourquoi le module "X" n'apparaît-il pas, alors qu'il se trouve sur
search.cpan.org ?</a></dt>
<dd>
<p>L'indexation utilisée repose sur les listes CPAN, plus restrictives que celles utilisées
sur <a href="http://search.cpan.org/">search.cpan.org</a>. Ainsi, si un module n'est pas
présent ici, il y a de fortes chances pour qu'il ne puisse pas être installé par des
utilitaires tels que <code>CPAN/CPANPLUS</code>. Il peut y avoir plusieurs raisons à
cela : c'est peut-être une version de développement, signalée par un caractère de
soulignement ("<i>underscore</i>") dans le numéro de version ; le module n'a peut-être
pas été enregistré dans le système <a href="http://pause.perl.org/">PAUSE</a> ; ou
encore ce module possède un identifiant CPAN différent. Notez également que la base de
données ne garde que les versions les plus récentes de chaque distribution, en supprimant les
versions plus anciennes.</p>
</dd>
<dt><a class="t5" name="04">Pourquoi la documentation du module "X" est-elle
introuvable ?</a></dt>
<dd>
<p>Peut-être qu'un problème est survenu lors de l'extraction du POD et/ou de sa
transformation en HTML. Ou alors la documentation ne respecte pas la convention qui veut que
le nom du module soit spécifié dans la section <code>NAME</code> du POD. Enfin, la
documentation est peut-être présente, mais pas à un emplacement standard - vous pouvez
consulter <a href=
"http://cpan.uwinnipeg.ca/htdocs/libnet/">http://cpan.uwinnipeg.ca/htdocs/libnet/</a> pour la
liste complète des documents associés à une distribution (libnet, dans le cas présent).</p>
</dd>
<dt><a class="t5" name="05">Pourquoi manque-t-il certains modules prérequis du
paquetage ?</a></dt>
<dd>
<p>Les informations sur les modules prérequis sont extraites du fichier <code>META.yml</code>
contenu dans la distribution. Toutes les distributions ne disposent pas de ce fichier car il
n'est généré qu'avec des versions relativement récentes de <code>ExtUtils::MakeMaker</code>
ou <code>Module::Build</code>.</p>
</dd>
<dt><a class="t5" name="06">Quelle est la syntaxe des requêtes ?</a></dt>
<dd>
<ul>
<li>Lors d'une requête simple telle que <code>foo bar</code>, la recherche s'effectue,
selon le type de recherche sélectionné, parmi les noms ou descriptions des modules ou des
distributions, ou bien parmi les identifiants CPAN et les noms complets des auteurs des
modules. Les résultats retournés comprennent <i>tous</i> les termes de la requête. Lors de
la recherche parmi les descriptions des modules, seuls les termes de plus de deux lettres
sont utilisés.</li>
<li>Si vous voulez exclure un terme des résultats de la recherche, précédez ce terme d'un
signe moins (par exemple, <code>foo -bar</code> pour exclure le terme
<code>bar</code>).</li>
<li>La recherche peut aussi s'effectuer avec des des <a href=
"http://www.mysql.com/documentation/mysql/bychapter/manual_Regexp.html#Regexp">expressions
rationnelles</a> - celles-ci sont reconnues lorsque la requête contient l'un des caractères
suivants : <code>^, $, *, +, ?, |</code>.</li>
</ul>
</dd>
<dt><a class="t5" name="07">Comment utiliser les référentiels de PPM pour Win32 ?</a></dt>
<dd>
<p>Consultez la documentation livrée avec la distribution <a href=
"http://www.activestate.com/">ActivePerl</a> pour un aperçu de l'utilisation de PPM. Les
paquetages PPM présents ici peuvent être installés grâce à l'utilitaire <code>ppm</code>.
Pour les paquetages ActivePerl, vous pouvez normalement les installer avec la commande
<code>install Nom-De-Paquetage</code> depuis la commande ppm ; pour les autres
paquetages, il vous faudra peut-être ajouter l'un des emplacements suivants à la liste des
référentiels ("<i>repositories</i>") :</p>
<ul>
<li><b>http://www.bribes.org/perl/ppm</b>, pour le <i>référentiel
bribes Perl 5.6/5.8</i></li>
<li><b>http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer</b>, pour le
<i>référentiel uwinnipeg Perl 5.6</i></li>
<li><b>http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58</b> (ActivePerl Builds < 819) /
<b>http://theoryx5.uwinnipeg.ca/ppms/</b> (ActivePerl Builds >= 819),
pour le
<i>référentiel uwinnipeg Perl 5.8</i></li>
</ul>
<p>Assurez-vous d'utiliser le référentiel correspondant à votre version de Perl (à savoir les
référentiels 5.6 pour les version de <i>build</i> 6xx d'ActivePerl, et les référentiels 5.8
pour les versions de <i>build</i> 8xx d'ActivePerl). Notez également que le nom du paquetage
qui apparaît ici, basé sur le nom de la distribution CPAN, est celui que vous devez utiliser
pour installer le paquetage ; c'est souvent, mais pas toujours, le nom du module
principal du paquetage.</p>
<p>Si vous maintenez un référentiel PPM que vous souhaitez voir inclus dans notre base de
données, assurez-vous qu'il existe un fichier <i>summary.ppm</i> listant les paquetages PPM
disponibles dans votre référentiel. Les instructions pour générer ce fichier sont décrites
dans un script disponible dans la distribution <i>PPM</i> sur <a href=
"http://www.cpan.org/authors/id/M/MU/MURRAY/">CPAN</a>. Après avoir généré ce fichier,
veuillez contacter <a href="mailto:randy@theoryx5.uwinnipeg.ca">Randy Kobes</a> avec les
détails concernant votre référentiel.</p>
</dd>
<dt><a class="t5" name="08">Existe-t-il d'autres moteurs de recherche pour CPAN ?</a></dt>
<dd>
Oui.
<ul>
<li><a href="http://search.cpan.org/">search.cpan.org</a>.</li>
<li><a href="http://www.perldoc.com/">www.perldoc.com</a>.</li>
<li><a href="http://wait.cpan.org/">wait.cpan.org</a>.</li>
</ul>
</dd>
<dt><a class="t5" name="09">Quelles sont les conventions utilisées pour les liens
externes ?</a></dt>
<dd>
<ul>
<li>Un lien tel que <a href=
"http://cpan.uwinnipeg.ca/~gbarr">http://cpan.uwinnipeg.ca/~gbarr</a> pointe vers les
informations de l'auteur CPAN dont l'identifiant est <code>GBARR</code>.</li>
<li>Pour accéder aux informations concernant une distribution ou un module, le lien sera du
type <a href=
"http://cpan.uwinnipeg.ca/dist/libnet">http://cpan.uwinnipeg.ca/dist/libnet</a> (pour les
distributions) ou <a href=
"http://cpan.uwinnipeg.ca/module/Net::FTP">http://cpan.uwinnipeg.ca/module/Net::FTP</a>
(pour les modules). Dans le cas d'une distribution, un lien du type <a href=
"http://cpan.uwinnipeg.ca/~gbarr/libnet">http://cpan.uwinnipeg.ca/~gbarr/libnet</a> pourra
également être utilisé, si vous connaissez l'identifiant CPAN de l'auteur.</li>
<li>Pour un index alphabétique des distributions ou des modules, utilisez <a href=
"http://cpan.uwinnipeg.ca/dist/A/">http://cpan.uwinnipeg.ca/dist/A/</a> ou <a href=
"http://cpan.uwinnipeg.ca/module/A/">http://cpan.uwinnipeg.ca/module/A/</a> pour afficher
les distributions ou les modules commençant par une certaine lettre. Utilisez <a href=
"http://cpan.uwinnipeg.ca/dist/Apache/">http://cpan.uwinnipeg.ca/dist/Apache/</a> ou
<a href=
"http://cpan.uwinnipeg.ca/module/Apache/">http://cpan.uwinnipeg.ca/module/Apache/</a> pour
afficher les distributions correspondant à <code>Apache-*</code> ou les modules
correspondant à <code>Apache::*</code>. Notez la barre oblique à la fin de ces liens.</li>
<li>Pour afficher la liste des catégories, vous pouvez utiliser un lien du type <a href=
"http://cpan.uwinnipeg.ca/chapter">http://cpan.uwinnipeg.ca/chapter</a> pour la liste
principale, <a href=
"http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI">http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI</a>
pour une catégorie particulière et <a href=
"http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI/Apache">http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI/Apache</a>
pour une sous-catégorie.</li>
<li>Vous pouvez faire des liens vers la documentation des modules, par exemple <a href=
"http://cpan.uwinnipeg.ca/htdocs/libnet/Net/FTP.html">http://cpan.uwinnipeg.ca/htdocs/libnet/Net/FTP.html</a>,
pour afficher la documentation du module <code>Net::FTP</code> dans la distribution
<code>libnet</code>. Vous pouvez également utiliser <a href=
"http://cpan.uwinnipeg.ca/perldoc?Net::FTP">http://cpan.uwinnipeg.ca/perldoc?Net::FTP</a>.
Cela fonctionne aussi pour la documentation de base de Perl - ainsi, <a href=
"http://cpan.uwinnipeg.ca/perldoc?perlfaq">http://cpan.uwinnipeg.ca/perldoc?perlfaq</a>
affichera la documentation de <i>perlfaq</i>. Notez que ces liens vers la documentation
peuvent ne pas marcher pour tous les modules, en raison de problèmes de forme dans la
documentation POD ou dans les conventions utilisées pour les listes CPAN.</li>
</ul>
</dd>
<dt><a class="t5" name="10">J'ai trouvé un problème, qui dois-je contacter ?</a></dt>
<dd>
<p>Veuillez envoyer un e-mail à <a href="mailto:randy@theoryx5.uwinnipeg.ca">Randy Kobes</a>
si vous rencontrez un problème, que ce soit une documentation erronée, un lien défaillant ou
des erreurs dans la traduction. Merci d'inclure des détails (et des liens) sur ce que vous
faisiez lorsque le problème est survenu.</p>
</dd>
<dt><a class="t5" name="11">Le code source de ce site est-il disponible ?</a></dt>
<dd>
<p>Oui. Consultez le projet <i>CPAN-Search-Lite</i> sur <a href=
"http://sourceforge.net/projects/cpan-search/">SourceForge</a>. Une liste de diffusion est à
votre disposition pour vos questions concernant l'installation, les bogues, les améliorations
proposées et les fonctionnalités. Notez que ce projet n'a pas pour ambition de rivaliser avec
le (fabuleux) site <a href="http://search.cpan.org/">search.cpan.org</a>, qui contient bien
plus de fonctionnalités qu'ici (versions précédentes des distributions, possibilité de
<code>grep</code> et <code>diff</code>, etc…). Par contre, ce projet-ci prend en
charge des services autres que ceux du Web (par exemple, les outils basés sur le protocole
SOAP).</p>
</dd>
</dl>
<hr>
</body>
</html>