FAQ de CPAN Search

Foire aux questions

1. Sur quel matériel ce site fonctionne-t-il ?
2. Pourquoi le module "X" n'apparaît-il pas ?
3. Pourquoi le module "X" n'apparaît-il pas, alors qu'il se trouve sur search.cpan.org ?
4. Pourquoi la documentation du module "X" est-elle introuvable ?
5. Pourquoi manque-t-il certains modules prérequis du paquetage ?
6. Quelle est la syntaxe des requêtes ?
7. Comment utiliser les référentiels de PPM pour Win32 ?
8. Existe-t-il d'autres moteurs de recherche pour CPAN ?
9. Quelles sont les conventions utilisées pour les liens externes ?
10. J'ai trouvé un problème, qui dois-je contacter ?
11. Le code source de ce site est-il disponible ?

Sur quel matériel ce site fonctionne-t-il ?

  La machine de base est une machine Linux. Les logiciels utilisés comprennent MySQL, Apache avec mod_perl, Template-Toolkit, et bien sûr Perl. Le multiplexeur utilisé pour rediriger les téléchargements vers le miroir CPAN le plus proche est basé sur GeoIP. La connexion réseau est fournie par l'université de Winnipeg.

Pourquoi le module "X" n'apparaît-il pas ?

  En supposant qu'il ait été indexé sur CPAN 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 CPAN-DistnameInfo de Graham Barr.

Pourquoi le module "X" n'apparaît-il pas, alors qu'il se trouve sur search.cpan.org ?

  L'indexation utilisée repose sur les listes CPAN, plus restrictives que celles utilisées sur search.cpan.org. 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 `CPAN/CPANPLUS`. Il peut y avoir plusieurs raisons à cela : c'est peut-être une version de développement, signalée par un caractère de soulignement ("underscore") dans le numéro de version ; le module n'a peut-être pas été enregistré dans le système PAUSE ; 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.

Pourquoi la documentation du module "X" est-elle introuvable ?

  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 `NAME` du POD. Enfin, la documentation est peut-être présente, mais pas à un emplacement standard - vous pouvez consulter http://cpan.uwinnipeg.ca/htdocs/libnet/ pour la liste complète des documents associés à une distribution (libnet, dans le cas présent).

Pourquoi manque-t-il certains modules prérequis du paquetage ?

  Les informations sur les modules prérequis sont extraites du fichier `META.yml` 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 `ExtUtils::MakeMaker` ou `Module::Build`.

Quelle est la syntaxe des requêtes ?
  - Lors d'une requête simple telle que `foo bar`, 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 tous 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.
  - Si vous voulez exclure un terme des résultats de la recherche, précédez ce terme d'un signe moins (par exemple, `foo -bar` pour exclure le terme `bar`).
  - La recherche peut aussi s'effectuer avec des des expressions rationnelles - celles-ci sont reconnues lorsque la requête contient l'un des caractères suivants : `^, $, *, +, ?, |`.
Comment utiliser les référentiels de PPM pour Win32 ?

  Consultez la documentation livrée avec la distribution ActivePerl pour un aperçu de l'utilisation de PPM. Les paquetages PPM présents ici peuvent être installés grâce à l'utilitaire `ppm`. Pour les paquetages ActivePerl, vous pouvez normalement les installer avec la commande `install Nom-De-Paquetage` 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 ("repositories") :

  - http://www.bribes.org/perl/ppm, pour le référentiel bribes Perl 5.6/5.8
  - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer, pour le référentiel uwinnipeg Perl 5.6
  - http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58 (ActivePerl Builds < 819) / http://theoryx5.uwinnipeg.ca/ppms/ (ActivePerl Builds >= 819), pour le référentiel uwinnipeg Perl 5.8

  Assurez-vous d'utiliser le référentiel correspondant à votre version de Perl (à savoir les référentiels 5.6 pour les version de build 6xx d'ActivePerl, et les référentiels 5.8 pour les versions de build 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.

  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 summary.ppm 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 PPM sur CPAN. Après avoir généré ce fichier, veuillez contacter Randy Kobes avec les détails concernant votre référentiel.

Existe-t-il d'autres moteurs de recherche pour CPAN ?
  Oui.
  - search.cpan.org.
  - www.perldoc.com.
  - wait.cpan.org.
Quelles sont les conventions utilisées pour les liens externes ?
  - Un lien tel que http://cpan.uwinnipeg.ca/~gbarr pointe vers les informations de l'auteur CPAN dont l'identifiant est `GBARR`.
  - Pour accéder aux informations concernant une distribution ou un module, le lien sera du type http://cpan.uwinnipeg.ca/dist/libnet (pour les distributions) ou http://cpan.uwinnipeg.ca/module/Net::FTP (pour les modules). Dans le cas d'une distribution, un lien du type http://cpan.uwinnipeg.ca/~gbarr/libnet pourra également être utilisé, si vous connaissez l'identifiant CPAN de l'auteur.
  - Pour un index alphabétique des distributions ou des modules, utilisez http://cpan.uwinnipeg.ca/dist/A/ ou http://cpan.uwinnipeg.ca/module/A/ pour afficher les distributions ou les modules commençant par une certaine lettre. Utilisez http://cpan.uwinnipeg.ca/dist/Apache/ ou http://cpan.uwinnipeg.ca/module/Apache/ pour afficher les distributions correspondant à `Apache-*` ou les modules correspondant à `Apache::*`. Notez la barre oblique à la fin de ces liens.
  - Pour afficher la liste des catégories, vous pouvez utiliser un lien du type http://cpan.uwinnipeg.ca/chapter pour la liste principale, http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI pour une catégorie particulière et http://cpan.uwinnipeg.ca/chapter/World_Wide_Web_HTML_HTTP_CGI/Apache pour une sous-catégorie.
  - Vous pouvez faire des liens vers la documentation des modules, par exemple http://cpan.uwinnipeg.ca/htdocs/libnet/Net/FTP.html, pour afficher la documentation du module `Net::FTP` dans la distribution `libnet`. Vous pouvez également utiliser http://cpan.uwinnipeg.ca/perldoc?Net::FTP. Cela fonctionne aussi pour la documentation de base de Perl - ainsi, http://cpan.uwinnipeg.ca/perldoc?perlfaq affichera la documentation de perlfaq. 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.
J'ai trouvé un problème, qui dois-je contacter ?

  Veuillez envoyer un e-mail à Randy Kobes 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.

Le code source de ce site est-il disponible ?

  Oui. Consultez le projet CPAN-Search-Lite sur SourceForge. 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 search.cpan.org, qui contient bien plus de fonctionnalités qu'ici (versions précédentes des distributions, possibilité de `grep` et `diff`, 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).