Це команда lexgrog, яку можна запустити в постачальнику безкоштовного хостингу OnWorks за допомогою однієї з наших численних безкоштовних робочих станцій, таких як Ubuntu Online, Fedora Online, онлайн емулятор Windows або онлайн емулятор MAC OS
ПРОГРАМА:
ІМ'Я
lexgrog - аналізує інформацію заголовка на сторінках керівництва
СИНТАКСИС
лексгрог [-m|-c] [-dfw?V] [-E кодування] файл ...
ОПИС
лексгрог є реалізацією традиційної утиліти “groff guess” у лекс. Воно читає
список файлів у його командному рядку у вигляді вихідних файлів сторінки керівництва або попередньо відформатованих
«котячі» сторінки, а також відображає їх ім’я та опис, як вони використовуються з приводу та що,
список фільтрів попередньої обробки, необхідних для сторінки man, перш ніж вона буде передана nroff or
трофабо те й інше.
Якщо його вхід неправильно відформатовано, лексгрог надрукує «parse failed»; це може бути корисно для
зовнішні програми, які повинні перевірити сторінки керівництва на правильність. Якщо один з лексгрог's введення
файли «-», він буде читати зі стандартного введення; якщо будь-який вхідний файл стиснутий, a
розпакована версія буде прочитана автоматично.
ВАРІАНТИ
-d, --відлагоджувати
Роздрукувати інформацію про налагодження.
-m, -- чоловік
Проаналізуйте вхідні дані як вихідні файли сторінки керівництва. Це значення за замовчуванням, якщо ні -- чоловік ні
-- кіт дається.
-c, -- кіт
Проаналізуйте введені дані як попередньо відформатовані сторінки керівництва («котячі сторінки»). -- чоловік та -- кіт може не бути
дається одночасно.
-w, --що
Відобразити назву та опис із заголовка сторінки довідника, як використовується з приводу та
що. Це значення за замовчуванням, якщо ні --що ні --фільтри дається.
-f, --фільтри
Відобразити список фільтрів, необхідних для попередньої обробки сторінки керівництва перед форматуванням
з nroff or троф.
-E кодування, --кодування кодування
Замінити вгаданий набір символів для сторінки кодування.
-?, --допомога
Надрукуйте довідкове повідомлення та вийдіть.
--використання
Роздрукуйте коротке повідомлення про використання та вийдіть.
-V, -- версія
Відобразити інформацію про версію.
EXIT СТАТУС
0 Успішне виконання програми.
1 Помилка використання.
2 лексгрог не вдалося проаналізувати один або кілька своїх вхідних файлів.
ПРИКЛАДИ
$ lexgrog man.1
man.1: "man - інтерфейс до он-лайн посібників"
$ lexgrog -fw man.1
man.1 (t): "man - інтерфейс до он-лайн довідників"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - відображення описів сторінки посібника"
$ lexgrog зламаний.1
зламано.1: синтаксичний аналіз не вдалося
ЩО РАЗБІР
mandb (який використовує той самий код, що і лексгрог) аналізує ІМ'Я розділ у верхній частині кожного
сторінка посібника з пошуком назв та описів функцій, задокументованих у кожній. Хоча
синтаксичний аналізатор є досить толерантним, оскільки він повинен справлятися з низкою різних форм, які мають
історично використовуваний, іноді може не отримати необхідну інформацію.
При використанні традиційних людина набір макросів, правильний ІМ'Я розділ виглядає приблизно так
це:
.SH ІМ'Я
foo \- програма для виконання чогось
Деякі ручні пейджери вимагають, щоб '\-' був таким, як показано; mandb більш толерантний, але
для сумісності з іншими системами, тим не менш, добре зберегти
зворотний скіс.
З лівого боку може бути кілька назв, розділених комами. Назви, що містять
пробіли будуть ігноруватися, щоб уникнути патологічної поведінки на певних неправильно сформованих ІМ'Я
розділи. Текст праворуч є довільною формою і може бути розкиданий на кілька
лінії. Якщо кілька об’єктів з різними описами документуються в одному
сторінки посібника, тому використовується така форма:
.SH ІМ'Я
foo, bar \- програми для виконання чогось
.br
baz \- програма, яка нічого не робить
(Замість макросу розриву можна використовувати макрос, який починає новий абзац, наприклад .PP
.br.)
При використанні похідного BSD mdoc набір макросів, правильний ІМ'Я розділ виглядає приблизно так
це:
.Ш ІМ'Я
.Nm foo
.Nd програма, щоб щось зробити
Існує кілька поширених причин, чому розбір Whatis не вдається. Іноді автори посібника
сторінки замініть ".SH NAME" на ".SH MYPROGRAM", а потім mandb не можу знайти розділ з
який для отримання необхідної інформації. Іноді автори включають розділ NAME, але
помістіть туди текст довільної форми, а не "ім'я \- опис". Однак будь-який синтаксис
схожі на вищезазначене слід прийняти.
Використовуйте lexgrog онлайн за допомогою служб onworks.net
