El cómo usar los módulos es algo difícil de encontrar. La documentación de cada módulo le acompaña y se puede consultar con man y con perldoc (en caso de Linux) y en el índice de módulos instalados en la página de ActivePerl que ActiveState instala en tu ordenador y mantiene el PPM (en caso de estar en Windows).
Depende de cada módulo si muestra más o menos información, y si trae alguna carpeta de ejemplos. En el 90% de los casos, a mí me vale con el ejemplo que aparece en la sinopsis. Muchas veces, aunque tengo el módulo instalado, me es igual de cómodo consultar la documentación en
http://search.cpan.org porque en ese momento estoy comparando módulos y saber cuál es el que voy a instalar, o porque es más fácil de navegar entre las carpetas de ejemplos.
Pero ejemplos de módulos es difícil de encontrar. Para ello uso Google, sobre todo CodeSearch:
http://www.google.com/codesearch .
En el ejemplo que pones he hecho lo siguiente:
* he entrado en
http://search.cpan.org (bueno, en realidad uso un motor de búsqueda en mi Firefox, por lo que es mucho más rápido), y he puesto para buscar "CGI".
* eso me lleva a la página del módulo CGI.pm escrito por Lincoln D. Stein.
* usando el sistema de búsqueda incremental de Firefox, pongo la palabra "FatalsToBrowser"
* sólo me aparece en un ejemplo, y además, no como parte de CGI, sino de CGI::Carp.
Bueno, pues la respuesta es que la función "FatalsToBrowser" es del módulo CGI::Carp, no de CGI.
En cuanto a cómo saber la lista de funciones, eso también depende de cómo esté organizada la documentación del módulo. Algunos sí que mantienen una lista de funciones y métodos, que localizas muy fácilmente al principio de la página, y de allí, saltas a la sección suya. En el resto de casos, sólo queda leer la documentación, sección por sección.
Creo recordar que había un método o módulo para sacar las funciones que tenía otro módulo, pero ahora no recuerdo su nombre. Además, hay técnicas en Perl que permiten hacer aparecer funciones solo en el momento en que se necesitan (a diferencia de los otros pobres lenguajes de programación), por lo que no sería efectivo analizar su código. Sólo quedaría leer su página de documentación.
En cuanto al IO::Socket, por este foro hay algunas referencias a ese módulo. Usa el sistema de búsqueda. Pon IO::Socket y que busque por todas las palabras.
Y, naturalmente, el primer sitio a consultar sobre IO::Socket es el fantástico artículo
Network Programming with Perl de la Linux Magazine de 1999.
