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 ?
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") :

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.
Quelles sont les conventions utilisées pour les liens externes ?
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).