pafp - Online en la nube

PROGRAMA:

NOMBRE

paf - Filtro abstracto de vaina. Transforma los documentos de Pod desde la línea de comando.

SINOPSIS

sh $>
resumen de paf / usr / bin / paf
paf add_podcmds AlgúnModulo.pm
paf sort -heading = METHODS Pod / Abstract / Node.pm # METHODS es el predeterminado
resumen de clasificación paf Pod / Abstract / Node.pm

# Ver Pod :: Resumen :: Filtro :: superposición
paf superposición ordenar cortar clear_podcmds SomeClass.pm

# -p emitirá una fuente de pod, en lugar de generar perldoc.
paf -p sort Pod :: Resumen :: Nodo
paf -p find hoist Pod :: Resumen :: Nodo

DESCRIPCIÓN

Paf es una herramienta de transformación y filtro Pod modular pequeña pero potente. Permite completo
transformación de ida y vuelta de documentos Pod utilizando la biblioteca Pod :: Abstract, con múltiples
filtrar cadenas sin tener que serializar / volver a analizar el documento en cada paso.

Paf viene con un pequeño conjunto de filtros útiles, pero se puede ampliar simplemente escribiendo nuevos
clases en el espacio de nombres "Pod :: Abstract :: Filter".

FILTROS

agregar_podcmds
Agregue comandos explícitos = pod al final de cada sección de corte, de modo que todas las secciones del pod estén
comenzó con un comando = pod.

clear_podcmds
Eliminar todos los comandos = pod que no terminan en bloques de corte. Esto limpiará los documentos que
también se han reducido utilizando el filtro de "corte".

cut
Retire todos los nodos cortados, de modo que solo quede la vaina.

superposición
superposición de paf Source.pm

Para que la superposición funcione, debe haber una sección "begin: overlay / end: overlay" en la fuente.
archivo, con definiciones de "= módulo de SECCIÓN superpuesto" dentro. El efecto neto es que cualquier
los subtítulos que faltan en la SECCIÓN se agregan de la misma sección en los Módulos especificados.

Tenga en cuenta que esto superpondrá todo el subtítulo, INCLUYENDO LOS NODOS CORTADOS, para que pueda agregar código
al documento fuente. Utilice "cortar" si no quiere esto.

Cada sección superpuesta incluirá un marcador "= para superposición de", de modo que pueda
reemplazado por una superposición posterior del mismo archivo / módulo. Estas secciones serán
reemplazado en su lugar, por lo que se conservará el orden de las secciones una vez superpuestas por primera vez.

sin superposición
paf dessuperposición Fuente.pm

tiras que todas secciones marcadas como superpuestas y que coinciden con la especificación de superposición de la fuente.

sort
paf sort [-heading = METHODS] Source.pm

Ordene todos los subtítulos en el título mencionado (MÉTODOS si no se proporcionan).

Esto moverá los nodos cortados con sus encabezados, por lo que su código mutará. Utilice "cortar"
si solo desea pod en la salida.

Alternativamente, también puede hacer que se produzca la clasificación de encabezados al incluir "= para clasificar"
al comienzo de su sección (antes del primer subtítulo).

resumen
Proporcione un resumen abreviado del documento. Si hay un nodo literal en el cuerpo de
un encabezado que contiene el nombre del encabezado, se considerará un ejemplo y se expandirá como
parte del resumen.

find
paf buscar [-f =] nombre Fuente.pm

Busque subsecciones específicas o enumere elementos que mencionen el nombre. Se usa para restringir un mayor
documento a un conjunto más pequeño que le interesa. Si no se especifica -f, entonces el
palabra que sigue a encontrar será el término de búsqueda.

sin cortar
paf sin cortar Source.pm

Convierta los nodos cortados en la fuente en texto literal. ¡No es lo inverso al corte!

número_secciones
paf número_secciones Fuente.pm

Aplica una numeración de sección simple de varias partes (3.1.2) a los encabezados head1 a head4.

Tenga en cuenta que number_sections actualmente acumulará algo de inteligencia en cosas como
resumen, ya que los nombres de las secciones ya no coincidirán con los nombres de las funciones.

Utilice pafp en línea utilizando los servicios de onworks.net