Generando Formatos con perldoc

La utilidad perldoc dispone de opciones para llamar a un conversor y producir automáticamente el formato deseado (si los correspondientes módulos están instalados):

• -o output-formatname

  especifica el formato de salida. -oman. Usar -oformatname hace que se carge un módulo para ese formato.

• -M module-name

  Especifica el módulo que queremos usar para formatear el pod . La clase debe proporcionar un método parse_from_file . Por ejemplo perldoc -MPod::Perldoc::ToChecker.

  Se pueden especificar varias clases separándolas por comas o punto y coma: -MTk::SuperPod;Tk::Pod.

• -w option:value o -w option

  Especifica opciones en la llamada al formateador utilizado. Por ejemplo -w textsize:15 llamará al objeto formateador $formatter->textsize(15) antes de que se use para formatear. La forma -w optionname es una abreviación para -w optionname:TRUE.

Véase un ejemplo que produce formato L^ATEX.

$ perldoc -oLaTeX -wAddPreamble:1 -f require > /tmp/require.tex

La opción AddPreamble indica al objeto formateador que se desea generar un documento completo y no una sección de un documento completo. Después de generar el fichero LaTeX podemos compilarlo con alguno de los compiladores de latex para producir un dvi o un pdf. Como L^ATEXno está instalado en las máquinas de las salas copiamos el fichero a uno de los servidores y compilamos con pdflatex :

casiano@tonga:~$ scp millo:/tmp/require.tex .
require.tex                          100% 6534     6.4KB/s   00:00
casiano@tonga:~$ pdflatex require.tex
This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4)
entering extended mode
....
Output written on require.pdf (4 pages, 62447 bytes).
Transcript written on require.log.

Una vez generado el .pdf podemos visualizarlo con kpdf e imprimirlo:

casiano@tonga:/tmp$
casiano@tonga:/tmp$ kpdf require.pdf &

Puede que encuentre útil usar la hoja de referencia rápida sobre Perl que se encuentra en http://johnbokma.com/perl/perl-quick-reference-card.pdf