manlifter - Онлайн в Хмарі

ПРОГРАМА:

ІМ'Я

manlifter - скрипт масового перетворення та тестовий джгут для докліфтера

СИНТАКСИС

манліфтер [-д варіант] [-e] [-f файл зі списком] [-Привіт мандір] [-м] [-М] [-о outdir]
[-с патч-каталог] [-P] [-q] [-v] [-s розділ] [-X виключати] ім'я...

манліфтер [-S]

ОПИС

манліфтер це сценарій, який послідовно докліфтер(1) щоб перетворити ціле дерево сторінок посібника
XML-Docbook, за бажанням також генерує HTML з XML. Інше використання як а
інструмент тортур для докліфтера; він реєструє помилки в стандартному виводі та збирає таймінги.

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

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

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

Заставні сторінки, які є просто .тому переспрямування транслюються у відповідні символічні посилання XML
файли (і, з -h, файли HTML).

манліфтер також може бути викликаний з одним аргументом файлу, який інтерпретується як стовбур
назва потенційної сторінки посібника. манліфтер потім шукає всі вибрані розділи посібника
відповідну сторінку та намагається перетворити її. У цьому випадку копія сторінки man і файл
перетворена версія відразу скидається під вихідний каталог з іменами
foobar.man і foobar.man.xml відповідно. Цей режим, як правило, лише цікавить
до докліфтер розробників для налагодження цієї програми.

У будь-якому з наведених вище випадків, манліфтер розпакує файл, якщо він має файли .gz, .bz2 або
Суфікс .Z у імені.

Варіанти такі:

-d
Передайте аргумент рядка кожному виклику doclifter як параметри. Кожен маркер, розділений пробілом
у рядку стає окремим аргументом у викликі.

-e
Запустити в режимі журнального фільтра (в основному цікавить для докліфтер розробники). У цьому режимі
манліфтер зчитує журнал тестування зі стандартного введення та фільтрує його залежно від
параметри -f і -q. Якщо не вказано жодне з цих повідомлень, відображаються повідомлення про успішні запуски
видалено, і лише помилки передаються на стандартний вихід.

-f
Зазвичай запускайте doclifter для файлів, названих кожним рядком у файлі аргументів. в
У режимі фільтрації помилок аргумент натомість інтерпретується як регулярний фільтр
вираз.

-h
Також генеруйте переклади HTML у вихідний каталог. Розмітка citerefentry DocBook
перетворюється на гіперпосилання в каталозі, а список вмісту створюється до
index.html.

-I
Вкажіть корінь дерева ручних сторінок. За замовчуванням це /usr/share/man.

-m
Зробіть виправлення, щоб виправити останню завантажену сторінку. Копіюється, викликається редактор
копію (з використанням змінної середовища $ РЕДАКТОР), і потім різниця(1) викликається падінням
виправлення в каталозі prepatch. Не вдається з помилкою, якщо такий патч вже є
присутній

-M
Підніміть вказані файли, а потім виконайте еквівалент параметра -m.

-o
Встановіть вихідний каталог, до якого будуть перенесені переклади XML-DocBook. За
за замовчуванням це xmlman у поточному каталозі в пакетному режимі або поточний
каталог інакше.

-p
Інтерпретуйте аргумент як ім’я каталогу виправлення (ім’я за замовчуванням – prepatch
у поточному каталозі). Кожен файл з іменем foo.N.patch інтерпретується як виправлення до
застосовувати до сторінки посібника foo(N), перш ніж doclifter переведе її.

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

-q
Зазвичай передавайте параметр -q (тихий) для кожного виклику doclifter. У режимі фільтрації помилок,
повернути список файлів, для яких не вдалося перекласти.

-v
Передайте параметр -v (докладний) кожному виклику doclifter. Цей параметр можна повторити до
підвищити рівень багатослівності.

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

-S
Скласти статистику помилок з a манліфтер лог-файл, представлений на стандартному введенні. Це
варіант буде цікавий в основному для докліфтер розробники

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

манліфтер видає файл журналу на стандартний вихід. Файл починається з рядка позначки часу та a
порожній рядок, а закінчується рядком із зазначенням часу виконання та різної цікавої статистики.
Між ними розташовані строфи, розділені пустими рядками, по одному для кожного файлу докліфтер
був запущений.

Перший рядок кожної строфи починається з «!», за яким слідує шлях до джерела
ручний пейджер, за яким слід "=" і статус повернення doclifter, запущеного для цього файлу.
Після цього пробіл і докліфтерЧас виконання в секундах.

За цим початковим рядком можуть слідувати інформаційні повідомлення та вихідні дані про помилку
біг на докліфтері.

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

Використовуйте manlifter онлайн за допомогою служб onworks.net