perlutil - Utilidades incluidas en la distribución de Perl
ADVERTENCIA: ESTE DOCUMENTO NO ESTÁ REVISADO. Se incluye en la distribución como borrador útil e informativo, pero su lectura puede resultar dura para las almas con mayor sensibilidad lingüística.
Además del intérprete de Perl, la distribución de Perl incluye varias utilidades que se instalan en el sistema; algunas de ellas se usan durante el proceso de instalación de la distribución. Este documento contiene una descripción de las utilidades y referencias a la documentación de cada módulo (si existe).
Como ya sabe, la interfaz principal de la documentación de Perl es perldoc. perldoc extrae y aplica formato a la documentación de cualquier archivo del directorio actual, cualquier módulo Perl instalado en el sistema o cualquiera de las páginas de documentación estándar, como ésta. Para obtener información sobre cualquiera de las utilidades descritas en este documento, use perldoc <nombre>.
perldoc
perldoc <nombre>
Cuando se ejecuta desde un terminal, normalmente perldoc llama a pod2man para convertir el formato POD (Plain Old Documentation; consulte perlpod para ver una descripción) en una página de manual, y después ejecuta man para mostrarla; si man no está disponible, se usa pod2text y el resultado se canaliza a través de su paginador favorito.
Además de estos dos conversores, hay otro más: pod2html genera páginas HTML a partir de POD.
Si sólo quiere saber cómo se usan las utilidades aquí descritas, pod2usage solo extraerá la sección "USAGE" (USO); algunas de estas utilidades llamarán automáticamente a pod2usage si las llama con el modificador -help.
-help
pod2usage es un caso especial de podselect, una utilidad que permite extraer secciones con nombre de documentos escritos en formato POD. Por ejemplo, a diferencia de las utilidades que tienen secciones "USAGE", los módulos Perl generalmente tienen secciones "SYNOPSIS" (SINOPSIS): podselect -s "SYNOPSIS" ... extrae la sección correspondiente de un archivo especificado.
podselect -s "SYNOPSIS" ...
Al redactar documentación POD puede usar la utilidad podchecker para detectar errores de marcas POD.
splain es una interfaz de perldiag; si le pasa un mensaje de error mostrará una descripción más completa.
roffitall
La utilidad roffitall no se instala en el sistema, pero puede encontrarla en el directorio pod/ del kit de código fuente de Perl. Esta utilidad convierte toda la documentación de la distribución al formato *roff y a partir de esto genera código fuente PostScript o un archivo de texto.
Para convertir programas antiguos a Perl más moderno puede utilizar la utilidad pl2pm, que le ayudará a convertir bibliotecas antiguas de Perl 4 a módulos de Perl 5 modernos.
Para mostrar y modificar la configuración de libnet, ejecute el comando libnetcfg.
El programa perlivp se configura en tiempo de compilación del código fuente de Perl para comprobar la versión de Perl con la que se generó. Se puede usar después de ejecutar make install (o el procedimiento equivalente para su plataforma) para comprobar que perl y sus bibliotecas se han instalado correctamente.
make install
A continuación se describe un conjunto de utilidades que ayudan a desarrollar programas Perl y, en particular, a extender Perl con código C.
La manera recomendada de notificar errores del intérprete perl o de cualquier módulo de la biblioteca estándar a sus programadores es usar perlbug; pero antes de usar perlbug debe leer con atención su documentación.
Este programa proporciona una manera sencilla de enviar un mensaje de agradecimiento a las personas que se encargan de desarrollar y mantener perl. No es más que perlbug instalado con otro nombre.
Mucho antes de que existiera en Perl el sistema XS para conectar bibliotecas C, los programadores tenían que leer los archivos de encabezado de C para obtener las constantes de biblioteca. Es posible que se encuentre código en el que se usa require 'syscall.ph' o algo similar; para crear el archivo .ph se debe ejecutar h2ph en el archivo .h correspondiente. Consulte la documentación de h2ph para obtener más información sobre la manera de convertir varios archivos de encabezado a la vez.
require 'syscall.ph'
c2ph y pstruct son en realidad el mismo programa, pero se comportan de manera distinta en función de cómo se invoquen. Proporcionan otra manera de incorporar código C en Perl: convierten declaraciones de estructuras y uniones de C en código Perl. Han quedado obsoletos desde que surgió h2xs.
h2xs convierte archivos de encabezado de C en módulos XS y agrega gran parte del código necesario para la comunicación entre bibliotecas C y módulos Perl. También resulta muy útil para crear la estructura inicial de módulos Perl puros.
enc2xs genera una extensión Perl para Encode a partir de archivos de asignación de caracteres Unicode (.ucm) o de archivos de codificación Tcl (.enc). enc2xs se usa internamente durante el proceso de compilación del módulo Encode; también lo puede usar para agregar su propia codificación a perl. Para ello no tiene que saber cómo funciona XS.
xsubpp es un compilador que permite convertir código XS de Perl en código C. Lo suelen ejecutar los archivos makefile generados por ExtUtils::MakeMaker.
xsubpp compila el código XS y genera código C; para ello, incrusta las construcciones necesarias para que las funciones C puedan manipular valores Perl y agregar el código necesario para que Perl pueda acceder a esas funciones.
prove es una interfaz de línea de comandos de la funcionalidad de ejecución de pruebas de Test::Harness. Es una alternativa a make test.
make test
Este front-end de línea de comandos de Module::CoreList permite consultar la lista de módulos incluidos en versiones específicas de perl.
Module::CoreList
También se distribuyen con perl algunas herramientas de propósito general, básicamente porque forman parte de módulos incluidos en la distribución de perl.
piconv es una versión Perl de iconv, un conversor de codificaciones de caracteres de uso muy extendido en el mundo Unix. Este script era principalmente una demostración de tecnología en Perl v5.8.0, pero puede usar piconv en lugar de iconv prácticamente en todos los casos.
ptar es un programa tar escrito en código Perl puro.
ptardiff es una pequeña utilidad que genera las diferencias entre un archivo de almacenamiento extraído y uno sin extraer. (Tenga en cuenta que esta utilidad requiere el módulo Text::Diff para funcionar correctamente; este módulo no se distribuye con perl, pero está disponible en CPAN).
Text::Diff
ptargrep es una utilidad que aplica detección de patrones al contenido de un archivo de almacenamiento tar.
Esta utilidad, que se incluye con el módulo Digest::SHA, se usa para imprimir o comprobar sumas de control SHA.
Digest::SHA
zipdetails muestra información sobre la estructura de registros interna de un archivo zip. No muestra detalles sobre los datos comprimidos que se encuentran almacenados en dicho archivo zip.
Estas utilidades ayudan a administrar módulos Perl adicionales que no se incluyen en la distribución de perl.
cpan es una interfaz de línea de comandos de CPAN.pm. Permite hacer muchas cosas, como instalar módulos o distribuciones de CPAN, o simplemente obtener información sobre ellas. Es similar al modo de línea de comandos del módulo CPAN,
perl -MCPAN -e shell
Esta utilidad ofrece una interfaz sencilla de ExtUtils::Installed, que permite examinar módulos instalados, validar las listas de paquetes e incluso crear un archivo de almacenamiento tar a partir de un módulo instalado.
perldoc, pod2man, perlpod, pod2html, pod2usage, podselect, podchecker, splain, perldiag, roffitall|roffitall, File::Find, pl2pm, perlbug, h2ph, c2ph, h2xs, enc2xs, xsubpp, cpan, instmodsh, piconv, prove, corelist, ptar, ptardiff, shasum, zipdetails
roffitall|roffitall
Joaquín Ferrero (Tech Lead)
Enrique Nell (Language Lead)
To install POD2::ES, copy and paste the appropriate command in to your terminal.
cpanm
cpanm POD2::ES
CPAN shell
perl -MCPAN -e shell install POD2::ES
For more information on module installation, please visit the detailed CPAN module installation guide.