Previous Next Table of Contents

3. Où trouver de la documentation ?

3.1 En ligne

Accès

Depuis la version 5 de perl un effort particulier a été porté sur la documentation en ligne. L'unique page de manuel perl a été réécrite et séparée en plusieurs fichiers, afin de faciliter sa consultation. Pour voir les différentes pages disponibles, il suffit de rentrer la commande

% man perl

ou encore, si les pages de manuel n'ont pas été installées correctement sur votre système

% perldoc perl

Organisation

Si l'on a l'intention de lire l'ensemble des pages (ce qui se fait très bien), il est conseillé de les lire dans l'ordre proposé. Si l'on cherche la syntaxe d'une commande particulière, il faut consulter le document perlfunc. Pour une référence complète sur les expressions régulières, consulter le document perlre

Documentation des modules

POD, un nouveau format de documentation a été introduit dans perl5. Il signifie Plain Old Documentation et sa syntaxe est décrite dans le document perlpod.

C'est un format très simple, ne disposant pas de grandes possibilités mais largement suffisant pour écrire des pages de manuel. De nombreux convertisseurs existent pour le convertir ensuite dans d'autres formats: texte, nroff, LaTeX, html. On dispose ainsi d'une documentation unique et facilement consultable quel que soit le moyen dont on dispose.

Un autre de ses avantages est qu'il est prévu pour être directement intégré dans du code perl. Ainsi, la plupart des modules contiennent leur propre documentation. Pour accéder à la documentation du module File::Copy par exemple, il suffit d'exécuter la commande

% perldoc File::Copy

Il est possible d'appliquer les convertisseurs du format POD (pod2txt, pod2html, pod2man, pod2html) directement sur les modules ou les scripts, afin d'en extraire cette documentation.

3.2 Sur le WWW

J'ai déjà parlé du site http://www.perl.com/, qui contient des pointeurs vers de la documentation en ligne ou vers divers livres consacrés à perl.

De nombreux tutoriaux, le plus souvent en anglais, sont également disponibles. Il suffit de rentrer les termes de recherche perl et tutorial dans un moteur de recherche pour les obtenir. Je ne peux pas vraiment en conseiller un, étant donné que la documentation standard de perl m'a toujours suffi.

3.3 De vrais livres

De nombreux livres existent, du livre de référence au simple tutorial. La liste la plus à jour de ces ouvrages est disponible sur le site WWW http://www.perl.com/, à l'URL http://www.perl.com/perl/info/books.html.

Les ouvrages de référence, car écrits par Larry Wall, l'auteur du langage, et d'autres spécialistes (Tom Christiansen, Randal L. Schwartz), sont:

Programming Perl

aussi appelé le Camel Book à cause de l'image de dromadaire présente sur sa couverture. C'est l'ouvrage de référence pour perl. Une version est en cours de réécriture pour intégrer les nouvelles fonctionnalités de perl5. Sa date de sortie est prévue pour septembre 1996.

Learning Perl

C'est un tutorial, couvrant uniquement les possibilités de perl4. Une traduction française est disponible.

(Attention, pub) J'ai également écrit un document d'introduction à perl en français, dont les versions Postscript et dvi sont disponibles à l'adresse http://www-eleves.enst-bretagne.fr/~aubert/perl/.


Previous Next Table of Contents