Perl viene con mucha documentación pero toma un tiempo aprender a usarla. En esta parte del Tutorial de Perl explicaré como entender la documentación.

perldoc en la web

La mejor manera de acceder a la documentación del núcleo de Perl es visitar el sitio web de perldoc.

Contiene una versión HTML de la documentación de Perl, el lenguaje y los módulos que vienen con el núcleo de Perl.

No contiene documentación de los módulos CPAN. Hay una superposición, sin embargo, ya que hay algunos módulos que están disponibles en CPAN y que también vienen incluidos en la distribución estándar de Perl (a menudo referidos como de doble vida o dual-lifed).

Puedes usar la opción de búsqueda en la esquina superior derecha. Por ejemplo, puedes escribir split y obtendrás la documentación para split.

Desafortunadamente, esta opción no sabe como comportarse con while, ni con $_ o @_. Para obtener información sobre ellos tendrás que hojear la documentación.

Una de las páginas más importante es perlvar, en donde puedes encontrar información acerca de variables tales como $_ y @_.

perlsyn explica la sintáxis de Perl, incluyendo el bucle while.

perldoc en la línea de comandos

La misma documentación viene con el código fuente de Perl, pero no todas las distribuciones de Linux la traen instalada por defecto. En algunos casos viene en un paquete separado. Por ejemplo, en Debian y Ubuntu está en el paquete perl-doc. Para acceder a ella debes instalar el paquete con el comando sudo aptitude install perl-doc.

Una vez que la tienes instalada, puedes escribir perldoc perl en la línea de comandos y obtendrás algunas explicaciones junto con una lista de los capítulos de la documentación de Perl.

Puedes salir de ella usando la tecla q y luego escribir el nombre de alguno de los capítulos. Por ejemplo: perldoc perlsyn.

Esto funciona tanto en Linux como en Windows, aunque el paginador de este último deja mucho que desear, así que no lo recomiendo. En Linux se utiliza el lector habitual de las páginas man, por lo que ya deberías estar familiarizado con su uso.

Documentación de módulos CPAN

Todo módulo en CPAN viene con documentación y ejemplos. La calidad de dicha documentación varía bastante entre autores, e incluso un solo autor puede tener módulos muy bien documentados y otros no tanto.

Después de instalar un módulo llamado Modulo::Nombre, puedes acceder a su documentación escribiendo perldoc Modulo::Nombre.

Aunque existe una manera más conveniente que ni siquiera necesita que el módulo en cuestión esté instalado. Hay varias interfaces web para CPAN. Las principales son Meta CPAN y search CPAN.

Ambos están basados en la misma documentación pero proporcionan una experiencia ligeramente distinta.

Búsqueda por palabra clave en Perl Maven

En este sitio puedes usar la búsqueda por palabra clave que está en el menú de la barra superior. De a poco encontrarás explicaciones para más y más partes de Perl. En algún punto se incluirán la documentación del núcleo de Perl y los módulos CPAN.

Si no encuentras algo, solo deja un comentario con las palabras clave que buscas y tendrás una buena oportunidad que tu solicitud sea considerada.