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 LATEX.
$ perldoc -oLaTeX -wAddPreamble:1 -f require > /tmp/require.texLa 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 LATEXno 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
Casiano Rodríguez León