.if !'po4a'hide' .ds mC CW .\" Man page for lexgrog .\" .\" Copyright (c) 2001 Colin Watson .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .if t .if \n(.g .ds mC CR .if n .ds mC R . .\" in an example (EX/EE)? .nr mE 0 . .if !\n(.g \{\ .de EX . br . if !\\n(mE \{\ . nr mF \\n(.f . nr mP \\n(PD . nr PD 1v . nf . ft \\*(mC . nr mE 1 . \} .. .\} . . .if !\n(.g \{\ .de EE . br . if \\n(mE \{\ . ft \\n(mF . nr PD \\n(mP . fi . nr mE 0 . \} .. .\} .\" End example. . .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LEXGROG 1 2025-05-02 2.13.1 "Утиліти переглядача довідки" .SH ІМʼЯ lexgrog \- аналізувати інформацію заголовку в сторінках довідки .SH СИНОПСИС \fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP \fIкодування\fP\|] \fIфайл\fP \&.\|.\|. .SH ОПИС \fBlexgrog\fP \- це реалізація традиційної утиліти «groff guess» в \fBlex\fP. Вона читає список файлів, переданих їй як аргументи командного рядка, як джерело сторінок man або вже відформатовані «cat» сторінки, і показує їх назву та опис, використовуючи \fBapropos\fP та \fBwhatis\fP, список попередніх фільтрів, необхідних для сторінки man перед тим, як вона буде передана до \fBnroff\fP або \fBtroff\fP, або обох. .PP Якщо його вхідні дані погано сформовані, \fBlexgrog\fP над «parse failed». Це може бути корисним для зовнішніх програм, які повинні перевіряти сторінки man на правильність. Якщо один з вхідних файлів \fBlexgrog\fP є «\-», він прочитає дані зі стандартного вводу; якщо будь\-який вхідний файл стиснутий, буде автоматично прочитана розпакована версія. .SH ПАРАМЕТРИ .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Вивести інформацію для налагодження. .TP .if !'po4a'hide' .BR \-m ", " \-\-man Аналізувати вхідні дані як джерело сторінок man. Це значення за замовчуванням, якщо не вказано ні \fB\-\-man\fP, ні \fB\-\-cat\fP. .TP .if !'po4a'hide' .BR \-c ", " \-\-cat Аналізувати вхідні дані як форматовані сторінки довідки («сторінки cat»). \fB\-\-man\fP та \fB\-\-cat\fP не можуть бути задані одночасно. .TP .if !'po4a'hide' .BR \-w ", " \-\-whatis Показати назву та опис із заголовка сторінки man, як використовується у \fBapropos\fP і \fBwhatis\fP. Це значення за замовчуванням, якщо не вказано ні \fB\-\-whatis\fP, ні \fB\-\-filters\fP. .TP .if !'po4a'hide' .BR \-f ", " \-\-filters Показати список фільтрів, необхідних для попередньої обробки сторінки man перед форматуванням за допомогою \fBnroff\fP або \fBtroff\fP. .TP \fB\-E\fP \fIкодування\fP, \fB\-\-encoding\fP \fIкодування\fP Перевизначити вгадану кодову сторінку для сторінки на \fIкодування\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Надрукувати повідомлення довідки та вийти. .TP .if !'po4a'hide' .B \-\-usage Надрукувати коротке повідомлення про використання та вийти. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Показати інформацію про версію. .SH "СТАТУС ВИХОДУ" .TP .if !'po4a'hide' .B 0 Успішне виконання програми. .TP .if !'po4a'hide' .B 1 Помилка використання. .TP .if !'po4a'hide' .B 2 \fBlexgrog\fP не вдалося розібрати один або кілька своїх вхідних файлів. .SH ПРИКЛАДИ .nf $ lexgrog man.1 man.1: "man \- інтерфейс до системних довідкових керівництв" $ lexgrog \-fw man.1 man.1 (t): "man \- інтерфейс до системних довідкових керівництв" $ lexgrog \-c whatis.cat1 whatis.cat1: "whatis \- показувати описи сторінок довідки" $ lexgrog broken.1 broken.1: синтаксичний аналіз не вдався .fi .SH "РОЗБІР WHATIS" \fBmandb\fP (яка використовує той самий код, що і \fBlexgrog\fP) аналізує розділ \fBNAME\fP у верхній частині кожної сторінки довідника, шукаючи назви та описи функцій, які документуються в кожному. Хоча аналізатор досить толерантний, оскільки він має впоратися з багатьма різними формами, що історично використовувалися, йому іноді може не вдаватися видобути необхідну інформацію. .PP При використанні традиційного набору макросів \fIman\fP, правильний розділ \fBNAME\fP виглядає приблизно так: .PP .RS .EX \&.SH NAME foo \e\- програма для виконання певних дій .EE .RE .PP Деякі гортачі довідки вимагають, щоб \(oq\e\-\(cq було показано точно так само; \fBmandb\fP більш терпимий, але для сумісності з іншими системами все ж бажано зберігати зворотній слеш. .PP Зліва можуть бути вказано кілька імен, розділених комами. Імена, що містять пробіли, будуть ігноруватися, щоб уникнути патологічної поведінки в певних неправильно сформованих секціях \fBNAME\fP. Текст праворуч є довільним та може розподілятися на кілька рядків. Якщо в одній сторінці керівництва описується кілька функцій з різними описами, то використовується наступна форма: .PP .RS .EX \&.SH NAME foo, bar \e\- програми для виконання певних дій \&.br baz \e\- програма, яка нічого не робить .EE .RE .PP (Макрос, який починає новий абзац, на кшталт \fB.PP\fP, може бути використаний замість макросу перенесення рядка \fB.br\fP.) .PP При використанні набору макросів \fImdoc\fP, похідних від BSD, правильний розділ \fBNAME\fP виглядає приблизно так: .PP .RS .EX \&.Sh NAME \&.Nm foo \&.Nd програма для виконання певних дій .EE .RE Існує кілька поширених причин, чому аналіз whatis не вдається. Іноді автори сторінок довідки замінюють \(oq.SH NAME\(cq на \(oq.SH MYPROGRAM\(cq, і тоді \fBmandb\fP не може знайти розділ, з якого потрібно витягнути необхідну інформацію. Іноді автори включають розділ \fBNAME\fP, але розміщують там вільний текст замість \(oqname \e\- опису\(cq. Проте, будь\-яка синтаксична конструкція, що нагадує вищезазначене, повинна бути прийнятною. .SH "ДИВ. ТАКОЖ" .if !'po4a'hide' .IR apropos (1), .if !'po4a'hide' .IR man (1), .if !'po4a'hide' .IR whatis (1), .if !'po4a'hide' .IR mandb (8) .SH ПРИМІТКИ \fBlexgrog\fP намагається аналізувати файли, які містять запити .so, але зможе це робити правильно тільки тоді, коли ці файли будуть правильно встановлені у ієрархії сторінок довідки. .SH АВТОР Код, який використовується \fBlexgrog\fP для сканування сторінок man, написаний: .PP .nf .if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .PP Колін Вотсон написав поточну версію інтерфейсу командного рядка, а також цю сторінку довідки. .SH ПОМИЛКИ .if !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db