manlifter - Интернет в облаке

ПРОГРАММА:

ИМЯ

manlifter - скрипт массового преобразования и тестовый набор для доклифтера

СИНТАКСИС

человекоподобный [-д вариант] [-е] [-ф список] [-Привет мандир] [-м] [-М] [-о превзойти]
[-п каталог исправлений] [-P] [-q] [-v] [-s .] [-ИКС исключать] имя...

человекоподобный [-С]

ОПИСАНИЕ

человекоподобный это сценарий, который последовательно врач(1) преобразовать все дерево справочных страниц в
XML-Docbook, опционально также генерирующий HTML из XML. Другое использование в качестве
инструмент для испытаний на пытки для врача; он записывает ошибки в стандартный вывод и собирает данные о времени.

Вызываемый без каких-либо аргументов файла, manlifter пытается преобразовать все подходящие страницы руководства
установленной в системе, помещая полученные xml-файлы в xmlman в текущем
каталог. Каждая успешно переведенная страница foo.N копируется в manN / foo.xml под
выходной каталог, независимо от того, из какого исходного каталога он пришел.

Страница руководства считается непригодной для пакетного преобразования, если она содержит текст, указывающий
он был создан мастерами DocBook из Doxygen.

Для каждого проверенного исходного файла, если целевой файл существует и новее, чем
исходный код, преобразование пропускается; таким образом, дополнительные прогоны человекоподобный делать минимум работы
необходимо для поддержания целевого XML-дерева в актуальном состоянии. Аналогично, HTML-файлы, производные от режима -h,
только при необходимости.

Страницы-заглушки, которые просто .так перенаправления переводятся в соответствующие символические ссылки XML
файлы (и, с -h, файлы HTML).

человекоподобный также может быть вызван с одним аргументом файла, который интерпретируется как основа
имя потенциальной справочной страницы. человекоподобный затем ищет во всех выбранных разделах руководства
соответствующую страницу и пытается ее преобразовать. В этом случае копия страницы руководства и
преобразованная версия удаляется сразу после выходного каталога с именами
foobar.man и foobar.man.xml соответственно. Этот режим обычно представляет только интерес.
в врач разработчикам для отладки этой программы.

В любом из вышеперечисленных случаев человекоподобный распакует файл, если он имеет .gz, .bz2 или
.Z суффикс имени.

Варианты следующие:

-d
Передайте строковый аргумент каждому вызову доклифтера в качестве параметров. Каждый токен, разделенный пробелами
в строке становится отдельным аргументом в вызове.

-e
Запуск в режиме лог-фильтра (в основном интересен врач Разработчики). В этом режиме
человекоподобный читает журнал испытаний со стандартного ввода и фильтрует его в зависимости от
параметры -f и -q. Если ни один из них не указан, сообщения об успешных запусках
удаляется, и на стандартный вывод выводятся только ошибки.

-f
Обычно запускайте доклифтер для файлов, названных каждой строкой в ​​файле аргументов. В
режим фильтрации ошибок аргумент вместо этого интерпретируется как обычный фильтр
выражение.

-h
Также сгенерируйте переводы HTML в выходной каталог. DocBook citerefentry разметка
преобразуется в гиперссылки в каталоге, и создается список содержимого для
индекс.html.

-I
Укажите корень дерева справочных страниц. По умолчанию это / usr / share / man.

-m
Сделайте патч, чтобы исправить последнюю загруженную страницу. Копируется, вызывается редактор
копия (с использованием переменной окружения РЕДАКТОР), а потом Разница(1) называется отбрасывать
патч в каталоге препатчей. Вылетает с ошибкой, если такой патч уже есть
настоящее время.

-M
Поднимите указанные файлы, затем выполните эквивалент опции -m.

-o
Задайте выходной каталог, в который будут помещаться переводы XML-DocBook. К
по умолчанию это xmlman в текущем каталоге в пакетном режиме или текущий
каталог в противном случае.

-p
Интерпретируйте аргумент как имя каталога исправлений (имя по умолчанию - предварительное исправление).
в текущем каталоге). Каждый файл с именем foo.N.patch интерпретируется как патч для
применить к странице руководства foo (N) до того, как доклифтер переведет ее.

-P
Включить профилирование с помощью модуля Python hotshot; это полезно только для настройки
доклифтер, чтобы он работал быстрее. Исходные данные записываются в manlifter.prof, а обработанный
отчет добавляется в журнал на стандартный вывод. Предупреждение: файлы необработанных данных могут
становятся огромными, и постобработка для создания отчета может занять столько времени, сколько
фактическая обработка (или дольше!).

-q
Обычно для каждого вызова доклифтера следует передавать параметр -q (тихо). В режиме фильтрации ошибок
вернуть список файлов, для которых не удалось выполнить перевод.

-v
Передайте параметр -v (подробный) каждому вызову доклифтера. Эту опцию можно повторить до
повысить уровень многословности.

-s
Укажите раздел для сканирования. Используйте это с аргументом; в этом не должно быть необходимости, когда
преобразование всего дерева.

-S
Скомпилировать статистику ошибок из человекоподобный файл журнала, представленный на стандартном вводе. Этот
вариант будет интересен в основном врач Разработчики.

-X
В пакетном режиме исключить страницы, перечисленные в файле аргументов. Предназначен для использования на страницах
которые известны хорошо и требуют очень много времени для подъема, чтобы сократить
время для пробного запуска. (Большинство страниц поднимаются менее чем за полсекунды, но некоторым может потребоваться
15 минут или дольше.)

человекоподобный выводит файл журнала на стандартный вывод. Файл начинается со строки с отметкой времени и
пустая строка и заканчивается строкой с указанием времени выполнения и различной интересной статистики.
Между ними находятся строфы, разделенные пустыми строками, по одной для каждого файла, в котором врач
был запущен.

Первая строка каждой строфы начинается с символа "!", За которым следует путь к источнику.
ручной пейджер, за которым следует "=" и статус возврата доклифтера, запущенного для этого файла.
После этого идет пространство и врачвремя выполнения в секундах.

За этой начальной строкой могут следовать информационные сообщения и сообщение об ошибке
доклифтер работает.

человекоподобный должен найти копию врач в текущем каталоге или в одном из
каталоги команд в вашем PATH чтобы бежать.

Используйте manlifter онлайн с помощью сервисов onworks.net