Это команда pafp, которую можно запустить в бесплатном хостинг-провайдере OnWorks, используя одну из наших многочисленных бесплатных онлайн-рабочих станций, таких как Ubuntu Online, Fedora Online, онлайн-эмулятор Windows или онлайн-эмулятор MAC OS.
ПРОГРАММА:
ИМЯ
paf - Абстрактный фильтр под под. Преобразуйте документы Pod из командной строки.
СИНТАКСИС
sh $>
сводка paf / usr / bin / paf
paf add_podcmds SomeModule.pm
paf sort -heading = МЕТОДЫ Pod / Abstract / Node.pm # МЕТОДЫ по умолчанию
paf сортировать сводку Pod / Abstract / Node.pm
# См. Pod :: Abstract :: Filter :: overlay
Оверлейная сортировка paf cut clear_podcmds SomeClass.pm
# -p будет генерировать исходный код pod вместо создания perldoc.
paf -p sort Pod :: Abstract :: Node
paf -p find hoist Pod :: Abstract :: Node
ОПИСАНИЕ
Paf - это небольшой, но мощный модульный инструмент для фильтрации и преобразования Pod-файлов. Это позволяет полностью
двустороннее преобразование документов Pod с использованием библиотеки Pod :: Abstract с несколькими
цепочки фильтров без необходимости сериализации / повторного анализа документа на каждом этапе.
Paf поставляется с небольшим набором полезных фильтров, но их можно расширить, просто написав новые.
классы в пространстве имен «Pod :: Abstract :: Filter».
ФИЛЬТРЫ
add_podcmds
Добавьте команды explicit = pod в конце каждой секции вырезки, чтобы все секции pod
начался с команды = pod.
Clear_podcmds
Удалить все команды = pod, не завершающие вырезанные блоки. Это очистит документы, которые
были уменьшены также с помощью «обрезного» фильтра.
вырезать
Удалите все вырезанные узлы, чтобы остался только стручок.
наложение
paf наложение Source.pm
Чтобы оверлей работал, в источнике должен быть раздел begin: overlay / end: overlay.
файл с определениями "= overlay SECTION Module" внутри. В итоге любой
отсутствующие подзаголовки в РАЗДЕЛЕ добавляются из того же раздела в указанных Модулях.
Обратите внимание, что это будет перекрывать весь подзаголовок, ВКЛЮЧАЯ ВЫРЕЗАННЫЕ УЗЛЫ, чтобы можно было добавить код
к исходному документу. Используйте «вырезать», если вы этого не хотите.
Каждый наложенный раздел будет включать маркер "= для наложения от", чтобы его можно было
заменяется последующим оверлеем из того же файла / модуля. Эти разделы будут
заменены на месте, поэтому порядок разделов после первого наложения будет сохранен.
не наложить
paf unoverlay Source.pm
Полосы ВСЕ разделы, отмеченные как наложенные и соответствующие спецификации наложения из источника.
sort
paf sort [-heading = МЕТОДЫ] Source.pm
Отсортируйте все подзаголовки в названном заголовке (МЕТОДЫ, если не указаны).
Это переместит вырезанные узлы вместе с их заголовками, так что ваш код будет видоизменяться. Используйте "вырезать"
если вам нужен только pod на выходе.
Кроме того, вы также можете вызвать сортировку заголовков, включив "= для сортировки"
в начале вашего раздела (перед первым подзаголовком).
резюме
Предоставьте сокращенное изложение документа. Если есть дословный узел в теле
заголовок, содержащий название заголовка, он будет рассматриваться как пример и расширен как
часть резюме.
найдите
paf find [-f =] имя Source.pm
Найдите конкретные подразделы или элементы списка, в которых упоминается имя. Используется для ограничения большего
документ до меньшего набора, который вас интересует. Если -f не указан, тогда
слово, следующее за находкой, будет критерием поиска.
неразрезанный
paf неразрезанный Source.pm
Преобразуйте вырезанные узлы в источнике в дословный текст. Не наоборот!
количество_разделов
paf число_секций Источник.pm
Применяет простую составную (3.1.2) нумерацию разделов к заголовкам от head1 до head4.
Обратите внимание, что number_sections в настоящее время добавляет некоторого ума в такие вещи, как
резюме, поскольку имена разделов больше не будут соответствовать именам функций.
Используйте pafp онлайн с помощью сервисов onworks.net
