pafp - Online di Cloud

PROGRAM:

NAMA

paf - Filter Abstrak Pod. Transformasikan dokumen Pod dari baris perintah.

RINGKASAN

sh$>
ringkasan paf /usr/bin/paf
paf add_podcmds SomeModule.pm
paf sort -heading=METHODS Pod/Abstract/Node.pm # METHODS adalah default
ringkasan paf sort Pod/Abstract/Node.pm

# Lihat Pod::Abstract::Filter::overlay
paf overlay sortir cut clear_podcmds SomeClass.pm

# -p akan memancarkan sumber pod, alih-alih memunculkan perldoc.
paf -p sort Pod::Abstrak::Node
paf -p temukan hoist Pod::Abstrak::Node

DESKRIPSI

Paf adalah alat transformasi dan filter Pod modular yang kecil namun kuat. Ini memungkinkan penuh
transformasi bolak-balik dokumen Pod menggunakan Pod::Abstract library, dengan banyak
rantai filter tanpa harus membuat serial/parsing ulang dokumen di setiap langkah.

Paf hadir dengan satu set kecil filter yang berguna, tetapi dapat diperpanjang hanya dengan menulis baru
kelas di ruang nama "Pod::Abstract::Filter".

FILTER

tambahkan_podcmds
Tambahkan perintah =pod eksplisit di akhir setiap bagian yang dipotong, sehingga semua bagian pod adalah
dimulai dengan perintah =pod.

clear_podcmds
Hapus semua perintah =pod yang tidak mengakhiri blok potong. Ini akan membersihkan dokumen yang
telah dikurangi dengan menggunakan filter "potong" juga.

memotong
Hapus semua simpul yang dipotong, sehingga hanya pod yang tersisa.

hamparan
paf overlay Sumber.pm

Agar overlay berfungsi, harus ada bagian "mulai :hamparan/akhiri :hamparan" di Sumber
file, dengan definisi "= overlay SECTION Module" di dalamnya. Efek bersihnya adalah apa pun
subjudul yang hilang di BAGIAN ditambahkan dari bagian yang sama di Modul yang ditentukan.

Perhatikan bahwa ini akan menutupi seluruh subpos, TERMASUK CUT NODES, sehingga dapat menambahkan kode
ke dokumen sumber. Gunakan "potong" jika Anda tidak menginginkan ini.

Setiap bagian yang dihamparkan akan menyertakan penanda "=untuk hamparan dari", sehingga dapat
digantikan oleh overlay berikutnya dari file/modul yang sama. Bagian ini akan menjadi
diganti di tempat, jadi pemesanan bagian setelah dilapis pertama akan dipertahankan.

membongkar
paf unoverlay Sumber.pm

Strip semua bagian yang ditandai sebagai overlay dan cocok dengan spesifikasi overlay dari sumbernya.

jenis
paf sort [-heading=METHODS] Sumber.pm

Urutkan semua subpos dalam judul bernama (METODE jika tidak disediakan).

Ini akan memindahkan simpul yang dipotong dengan judulnya, sehingga kode Anda akan bermutasi. Gunakan "potong"
jika Anda hanya ingin pod di output.

Atau, Anda juga dapat menyebabkan penyortiran judul dengan menyertakan "=untuk penyortiran"
di awal bagian Anda (sebelum subpos pertama).

ringkasan
Berikan ringkasan singkat dari dokumen. Jika ada simpul kata demi kata di tubuh
judul yang berisi nama judul, itu akan dianggap sebagai contoh dan diperluas sebagai
bagian dari ringkasan.

menemukan
paf temukan [-f=]nama Source.pm

Temukan sub-bagian tertentu atau daftar item yang menyebutkan nama. Digunakan untuk membatasi yang lebih besar
dokumen ke set yang lebih kecil yang Anda minati. Jika tidak ada -f yang ditentukan, maka
kata berikut find akan menjadi istilah pencarian.

Tidak dipotong
paf dipotong Sumber.pm

Ubah simpul potong di sumber menjadi teks kata demi kata. Bukan kebalikan dari potongan!

nomor_bagian
paf number_sections Sumber.pm

Menerapkan penomoran bagian multipart (3.1.2) sederhana ke judul head1 hingga head4.

Perhatikan bahwa number_sections saat ini akan memasukkan beberapa kepintaran dalam hal-hal seperti
ringkasan, karena nama bagian tidak akan cocok lagi dengan nama fungsi.

Gunakan pafp online menggunakan layanan onworks.net