'\" t .\" ** The above line should force tbl to be a preprocessor ** .\" Man page for man .\" .\" Copyright (C) 1994, 1995, Graeme W. Wilford. (Wilf.) .\" Copyright (C) 2001-2019 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. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH MAN 1 2025-05-02 2.13.1 "Утиліти переглядача довідки" .SH ІМʼЯ man \- інтерфейс до довідкових матеріалів системи .SH СИНОПСИС .\" The general command line .\" The apropos command line \fBman\fP [\|\fIпараметри man\fP\|] [\|[\|\fIрозділ\fP\|] \fIсторінка\fP\ \|.\|.\|.\|]\ .\|.\|.\& .br .\" The --global-apropos command line \fBman\fP \fB\-k\fP [\|\fIпараметри apropos\fP\|] \fIрегулярний вираз\fP \&.\|.\|.\& .br .\" The whatis command line \fBman\fP \fB\-K\fP [\|\fIпараметри man\fP\|] [\|\fIрозділ\fP\|] \fIтермін\fP\ .\|.\|.\& .br .\" The --local command line \fBman\fP \fB\-f\fP [\|\fIwhatis\fP \fIпараметри\fP\|] \fIсторінка\fP \&.\|.\|.\& .br .\" The --where/--where-cat command line \fBman\fP \fB\-l\fP [\|\fIпараметри man\fP\|] \fIфайл\fP \&.\|.\|.\& .br \fBman\fP \fB\-w\fP\||\|\fB\-W\fP [\|\fIпараметри man\fP\|] \fIсторінка\fP \&.\|.\|.\& .SH ОПИС \fBman\fP \- це гортач системних сторінок довідки. Кожний аргумент \fIсторінка\fP, наданий \fBman\fP, зазвичай є іменем програми, утиліти або функції. Потім знаходиться та показується \fIсторінка довідки\fP, повʼязана з кожним з цих аргументів. Якщо вказано \fIрозділ\fP, \fBman\fP буде шукати тільки у цьому \fIрозділі\fP довідки. За замовчуванням програма шукає у всіх доступних \fIрозділах\fP за певним попередньо визначеним порядком (дивіться \fBЗА ЗАМОВЧУВАННЯМ\fP) та показує лише першу знайдену \fIсторінку\fP, навіть якщо \fIсторінка\fP існує у декількох \fIрозділах\fP. У таблиці нижче наведено номери розділів довідника, за якими слідують типи сторінок, які вони містять. .TS tab (@); l lx. 1@T{ Виконувані програми або команди оболонки T} 2@T{ Системні виклики (функції, надані ядром) T} 3@T{ Виклики бібліотек (функції всередині програмних бібліотек) T} 4@T{ Спеціальні файли (зазвичай знаходяться в /dev/) T} 5@T{ Формати файлів та узгодження, напр. \& \fI/etc/passwd\fP T} 6@T{ Ігри T} 7@T{ Різне (включно з макропакетами та узгодженнями), напр.\& \fBman\fP(7), \fBgroff\fP(7), \fBman\-pages\fP(7) T} 8@T{ Команди системного адміністрування (зазвичай лише для root) T} 9@T{ Процедури ядра [\|Не стандартні\|] T} .TE \fIСторінка\fP довідника складається з декількох розділів. Типові назви розділів включають \fBNAME\fP, \fBSYNOPSIS\fP, \fBCONFIGURATION\fP, \fBDESCRIPTION\fP, \fBOPTIONS\fP, \fBEXIT\ STATUS\fP, \fBRETURN\ VALUE\fP, \fBERRORS\fP, \fBENVIRONMENT\fP, \fBFILES\fP, \fBVERSIONS\fP, \fBSTANDARDS\fP, \fBNOTES\fP, \fBBUGS\fP, \fBEXAMPLE\fP, \fBAUTHORS\fP, і \fBSEE\ ALSO\fP. Наступні правила застосовуються до розділу \fBСИНОПСИС\fP та можуть бути використані як посібник у інших розділах. .TS tab (@); l lx. \fBжирний текст\fP@T{ введіть точно так, як показано. T} \fIтекст курсивом\fP@T{ замініть відповідним аргументом. T} [\|\fB\-abc\fP\|]@T{ будь\-які або всі аргументи всередині [ ] є необовʼязковими. T} \fB\-a\|\fP|\|\fB\-b\fP@T{ опції, розділені символом '|', не можуть використовуватися разом. T} \fIаргумент\fP .\|.\|.@T{ \fIаргумент\fP можна повторювати. T} [\|\fIвираз\fP\|] .\|.\|.@T{ весь вираз \fIexpression\fP\ всередині [ ] може повторюватися. T} .TE Точність відображення може відрізнятися залежно від кінцевого пристрою. Наприклад, команда man зазвичай не зможе показати курсив у терміналі та часто використовує підкреслений або кольоровий текст замість цього. Ілюстрація команди або функції є шаблоном, який повинен відповідати всім можливим викликам. У деяких випадках бажано ілюструвати кілька виключних викликів, як це показано у розділі \fBСИНОПСИС\fP цієї сторінки довідника. .SH ПРИКЛАДИ .TP \w'man\ 'u \fBman\fP\fI\ ls\fP Показати сторінку довідки для \fIелементу\fP (програми) \fIls\fP. .TP \fBman\fP \fIman\fP.\fI7\fP Показати сторінку довідки для макропакету \fIman\fP з розділу \fI7\fP. (Це альтернативне написання «\fBman\fP \fI7 man\fP».) .TP \fBman '\fP\fIman\fP(\fI7\fP)\fB'\fP Показати сторінку довідки для макропакету \fIman\fP з розділу \fI7\fP. (Це інший варіант написання "\fBman\fP \fI7 man\fP". Це може бути зручніше при копіюванні та вставці посилань на сторінки довідки. Зверніть увагу, що дужки зазвичай повинні бути в лапках, щоб захистити їх від оболонки.) .TP \fBman\ \-a\fP\fI\ intro\fP Послідовно показувати всі доступні сторінки керівництва \fIintro\fP. Можна вийти між показами або пропустити будь\-який з них. .TP \fBman \-t \fP\fIbash \fP|\fI lpr \-Pps\fP Сформувати сторінку довідки для \fIbash\fP у форматі за замовчуванням \fBtroff\fP або \fBgroff\fP та передати її принтеру з назвою \fIps\fP. За замовчуванням вихідні дані для \fBgroff\fP \- це зазвичай PostScript. \fBman \-\-help\fP повинно порадити, який процесор повʼязаний з опцією \fB\-t\fP. .TP \fBman \-l \-T\fP\fIdvi ./foo.1x.gz\fP\fB > \fP\fI./foo.1x.dvi\fP Ця команда розпакує та сформує джерело сторінки керівництва nroff \&\fI./foo.1x.gz\fP у файл \fBнезалежний від пристрою (dvi)\fP файл. Перенаправлення необхідне, оскільки прапорець \fB\-T\fP призводить до виведення результату в \fBstdout\fP без використання гортача. Результат можна переглянути за допомогою програми, такої як \fBxdvi\fP, або далі обробити у PostScript за допомогою програми, такої як \fBdvips\fP. .TP \fBman\ \-k\fP\fI\ printf\fP Шукає короткі описи та назви сторінок довідки за ключовим словом \fIprintf\fP, використовуючи його як регулярний вираз. Надрукує будь\-які збіги. Еквівалентно \fBapropos\fP\fI\ printf\fP\fB.\fP .TP \fBman\ \-f\fP\fI\ smail\fP Знайти сторінки довідника, на які посилається \fIsmail\fP, і надрукувати короткі описи знайдених. Еквівалентно \fBwhatis\fP\fI\ smail\fP\fB.\fP .SH ОГЛЯД Доступно багато опцій для \fBman\fP, щоб надати користувачеві максимальну гнучкість. Можна змінювати шлях пошуку, порядок розділів, обробник виводу та інші операції та поведінки, про які детальніше описано нижче. Якщо встановлено, перевіряються різні змінні середовища для визначення роботи \fB%man\fP. Можливо встановити "загальну" змінну $\fBMANOPT\fP до будь\-якого рядка у форматі командного рядка, за винятком того, що пробіли, використовувані як частина аргументу опції, повинні бути екрановані (зворотньою похилою рискою). \fBman\fP розбере $\fBMANOPT\fP перед тим, як розбирати власний командний рядок. Опції, що вимагають аргументів, будуть перезаписані такими ж опціями, знайденими у командному рядку. Для скидання всіх опцій, встановлених у $\fBMANOPT\fP, \fB\-D\fP можна вказати як першу опцію командного рядка. Це дозволить man «забути» про опції, зазначені у $\fBMANOPT\fP, хоча вони все ще повинні були бути дійсними. Сторінки довідки зазвичай зберігаються у форматі \fBnroff\fP(1) в каталозі, такі як \fI/usr/share/man\fP. У деяких інсталяціях також можуть бути попередньо відформатовані \fIсторінки cat\fP, щоб покращити продуктивність. Дізнайтеся більше у \fBmanpath\fP(5) про подробиці того, де зберігаються ці файли. Цей пакет підтримує сторінки довідки на декількох мовах, керовані вашою \fIлокаллю\fP. Якщо ваша система не встановила це для вас автоматично, тоді вам може знадобитися встановити змінну середовища $\fBLC_MESSAGES\fP, $\fBLANG\fP або іншу системно\-залежну змінну середовища для позначення вашої бажаної локалі, зазвичай вказаної у форматі \fBPOSIX\fP: <\fIмова\fP>[\|\fB_\fP<\fIтериторія\fP>\|[\|\fB.\fP<\fIкодування\fP>\|[\|\fB,\fP<\fIверсія\fP>\|]\|]\|] Якщо бажана сторінка доступна вашою мовою у ваші \fIлокалі\fP, вона буде показана замість стандартної сторінки (зазвичай англійської). Якщо ви знайдете, що переклади, що постачаються з цим пакетом, недоступні вашою рідною мовою але ви хотіли б їх надати нам, будь ласка, звʼяжіться з відповідальним за таку діяльність. Індивідуальні сторінки довідки зазвичай пишуть і підтримують ті, хто відповідає за програму, функцію або іншу тему, яку вони документують, і не включені до цього пакета. Якщо ви знайдете, що сторінка довідки відсутня або недостатньо повна, будь ласка, повідомте про це розробників відповідного пакета. Для отримання інформації про інші функції та розширення, доступні з цим гортачем посібників, будь ласка, прочитайте документи, що постачаються з пакетом. .SH "ЗА ЗАМОВЧУВАННЯМ" Порядок розділів для пошуку може бути перевизначений змінною середовища $\fBMANSECT\fP або директивою \fBSECTION\fP у файлі конфігурації \fI/etc/man_db.conf\fP. За замовчуванням це виглядає так: .RS .if !'po4a'hide' 1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7 .RE Форматована сторінка довідки показується за допомогою \fIгортача\fP (pager). Це можна вказати різними способами, або ж буде використовуватися значення за замовчуванням (дивіться подробиці для опції \fB\-P\fP ). Фільтри розшифровуються різними способами. По\-перше, перевіряється опція командного рядка \fB\-p\fP або змінна середовища $\fBMANROFFSEQ\fP. Якщо \fB\-p\fP не використовувалася і змінна середовища не встановлена, перший рядок файлу nroff аналізується на наявність рядка препроцесора. Для того, щоб містити дійсний рядок препроцесора, перший рядок повинен бути схожим \&\fB'\е"\fP <\fBрядок\fP> де \fBрядок\fP може бути будь\-якою комбінацією літер, описаних опцією \fB\-p\fP нижче. Якщо жоден з вищезгаданих методів не надає інформації про фільтр, використовується набір за замовчуванням. .\" ******************************************************************** Створюється конвеєр форматування з фільтрів та основного форматувальника (\fBnroff\fP або [\fBtg\fP]\fBroff\fP з \fB\-t\fP) і виконується. Або, якщо в корені дерева man існує виконуваний програмний файл \fImandb_nfmt\fP (або \fImandb_tfmt\fP з \fB\-t\fP), то замість цього виконується він. Він отримує файл джерела документації, рядок препроцесора та необовʼязково пристрій, вказаний з \fB\-T\fP або \fB\-E\fP, як аргументи. .SH ПАРАМЕТРИ Опції без аргумента, які дублюються або в командному рядку, або в $\fBMANOPT\fP, не завдають шкоди. Для опцій, що вимагають аргумента, кожне повторення перезаписує попереднє значення аргумента. .SS "Загальні параметри" .TP \fB\-C\ \fP\fIфайл\fP,\ \fB\-\-config\-file=\fP\fIфайл\fP Використовуйте цей користувацький файл конфігурації замість типового у \fI\(ti/.manpath)\fP. .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Вивести інформацію для налагодження. .TP .if !'po4a'hide' .BR \-D ", " \-\-default Ця опція зазвичай видається як перша і скидає поведінку \fBman\fP до її стандартних налаштувань. Її використання полягає в тому, щоб скинути ті опції, які могли бути встановлені в $\fBMANOPT\fP. Будь\-які опції, які йдуть після \fB\-D\fP, збережуть свою звичайну дію. .TP \fB\-\-warnings\fP[=\fIпопередження\/\fP] Увімкнути попередження від \fIgroff\fP. Це може використовуватися для перевірки коректності тексту джерела сторінок довідки. \fIпопередження\fP \- це список імен попереджень, розділених комами; якщо він не вказаний, за замовчуванням використовується "mac". Щоб вимкнути попередження \fIgroff\fP, попереду його назви потрібно поставити "!": наприклад, \fB\-\-warnings=mac,!break\fP увімкне попередження в категорії "mac" і вимкне попередження в категорії "break". Для перегляду списку доступних імен попереджень див. розділ «Попередження» у \fBinfo groff\fP. .SS "Основні режими роботи" .TP .if !'po4a'hide' .BR \-f ", " \-\-whatis Приблизно еквівалентно \fBwhatis\fP. Виводить короткий опис з сторінки довідки, якщо він доступний. Подробиці у \fBwhatis\fP(1). .TP .if !'po4a'hide' .BR \-k ", " \-\-apropos Приблизно еквівалентно команді \fBapropos\fP. Пошук коротких описів сторінок довідки за ключовими словами та показ будь\-яких збігів. Дивіться подробиці у \fBapropos\fP(1). .TP .if !'po4a'hide' .BR \-K ", " \-\-global\-apropos Пошук тексту у всіх сторінках довідки. Це метод грубої сили, і це може зайняти деякий час; якщо можливо, ви повинні вказати розділ, щоб зменшити кількість сторінок, які необхідно переглядати. Пошукові терміни можуть бути простими рядками (за замовчуванням), або регулярними виразами, якщо використовується опція \fB\-\-regex\fP. .IP Зверніть увагу, що цей пошук виконується в джерелах сторінок довідки, а не у відформатованому тексті, тому може включати хибні позитивні результати через такі речі, як коментарі в файлах джерел, або хибні негативні результати через такі речі, як тире, записані як "\e\-" у файлах джерел. Пошук відформатованого тексту був би набагато повільнішим. .TP .if !'po4a'hide' .BR \-l ", " \-\-local\-file .\" Compressed nroff source files with a supported compression .\" extension will be decompressed by man prior to being displaying via the .\" usual filters. Активувати «локальний» режим. Форматувати та показувати локальні файли довідки замість пошуку у колекції системної довідки. Кожен аргумент сторінки довідки буде інтерпретований як джерело nroff у правильному форматі. Не створюється файл cat. Якщо '\-' вказано одним з аргументів, вхідні дані будуть братися зі stdin. .IP Якщо цей параметр не використовується, тоді \fBman\fP також буде вважати аргументи сторінок довідки локальними іменами файлів, якщо аргумент містить символ "/", оскільки це є хорошим індикатором того, що аргумент посилається на шлях у файловій системі. .TP .if !'po4a'hide' .BR \-w ", " \-\-where ", " \-\-path ", " \-\-location Не показувати сторінку довідки, а лише надрукувати розташування вихідного файлу nroff, який би був сформований. Якщо також використовується опція \fB\-a\fP, тоді надрукувати розташування всіх вихідних файлів, які відповідають критеріям пошуку. .TP .if !'po4a'hide' .BR \-W ", " \-\-where\-cat ", " \-\-location\-cat Не показувати сторінку довідки, а лише надрукувати розташування файлу категорії, який би був показаний. Якщо також використовується опція \fB\-a\fP, тоді надрукувати розташування всіх відформатованих файлів категорій, які відповідають критеріям пошуку. .IP Якщо використовуються обидва параметри \fB\-w\fP та \fB\-W\fP, то друкувати як джерело файлу, так і файл каталогу, розділені пробілом. Якщо використовуються всі три параметри \fB\-w\fP, \fB\-W\fP, та \fB\-a\fP, то робити це для кожного можливого збігу. .TP .if !'po4a'hide' .BR \-c ", " \-\-catman Ця опція не призначена для загального використання і повинна використовуватися лише програмою \fBcatman\fP. .TP \fB\-R\ \fP\fIкодування\fP, \ \fB\-\-recode\fP=\fIкодування\fP Замість того, щоб форматувати сторінку довідки за звичайним способом, виведе її джерело, перекодоване у вказане \fIкодування\fP. Якщо ви вже знаєте кодування файлу джерела, ви також можете використовувати \fBmanconv\fP(1) безпосередньо. Однак ця опція дозволяє перекодувати кілька сторінок довідки у одне кодування без необхідності явно вказати кодування кожного, при умові, що вони були вже встановлені в структурі, схожій на ієрархію сторінок довідки. .IP Розгляньте використання \fBman-recode\fP(1) для перекодування декількох сторінок довідки, оскільки воно має інтерфейс, розрахований на масове перекодування, і тому може бути значно швидшим. .SS "Пошук сторінок довідки" .TP \fB\-L\ \fP\fIлокаль\fP,\ \fB\-\-locale=\fP\fIлокаль\fP Зазвичай програма \fBman\fP визначатиме вашу поточний локаль шляхом виклику функції Сі \fBsetlocale\fP(3), яка досліджує різні змінні середовища, можливо, включаючи $\fBLC_MESSAGES\fP та $\fBLANG\fP. Щоб тимчасово перекрити визначене значення, скористайтеся цією опцією для безпосереднього надання рядка \fIлокалі\fP програмі \fBman\fP. Зверніть увагу, що вона не почне діяти до тих пір, поки фактично не почнеться пошук сторінок. Виводи такого типу, як повідомлення про допомогу, завжди будуть показуватися у попередньо визначеній локалі. .TP \fB\-m\fP \fIсистема\fP\|[\|,.\|.\|.\|]\|, \fB\-\-systems=\fP\fIсистема\fP\|[\|,.\|.\|.\|] Якщо ця система має доступ до сторінок довідки інших операційних систем, вони можуть бути доступні за допомогою цієї опції. Для пошуку сторінки довідки з колекції сторінок довідки NewOS використовуйте опцію \fB\-m\fP \fBNewOS\fP. Вказана \fIсистема\fP може бути комбінацією операційних систем, перелічених через кому. Для включення пошуку в керівництвах власної операційної системи, включіть імʼя системної команди \fBman\fP у рядок аргументів. Ця опція перевизначить змінну середовища $\fBSYSTEM\fP. .TP \fB\-M\ \fP\fIшлях\fP,\ \fB\-\-manpath=\fP\fIшлях\fP Вкажіть альтернативний manpath для використання. За замовчуванням, \fBman\fP використовує код, похідний від \fBmanpath\fP, щоб визначити шлях для пошуку. Ця опція перевизначає змінну середовища $\fBMANPATH\fP і призводить до того, що опція \fB\-m\fP буде проігнорована. Шлях, вказаний як manpath, повинен бути коренем ієрархії сторінок довідки, структурованої у розділи, як описано в керівництві man\-db (під розділом «Система сторінок довідки»). Щоб переглянути сторінки довідки поза такими ієрархіями, дивіться опцію \fB\-l\fP. .TP \fB\-S\fP \fIсписок\/\fP, \fB\-s\fP \fIсписок\/\fP, \fB\-\-sections=\fP\fIсписок\/\fP Заданий \fIсписок\fP є списком розділених комами або двокрапками секцій, який використовується для визначення порядку пошуку та в яких саме розділах довідки. Ця опція перевизначає змінну середовища $\fBMANSECT\fP. (Варіант \fB\-s\fP забезпечує сумісність з System V.) .TP \fB\-e\ \fP\fIпід\-розширення\fP,\ \fB\-\-extension=\fP\fIпід\-розширення\fP Деякі системи включають великі пакети сторінок довідки, такі як ті, що супроводжують пакет \fBTcl\fP, у головну ієрархію сторінок довідки. Щоб обійти проблему наявності двох сторінок довідки з однаковою назвою, такою як \fBexit\fP(3), сторінки \fBTcl\fP зазвичай були призначені для розділу \fBl\fP. Оскільки це небажано, тепер можливо розмістити сторінки у правильному розділі та присвоїти їм конкретне "розширення", наприклад, \fBexit\fP(3tcl). За звичайних умов \fBman\fP показує \fBexit\fP(3) замість \fBexit\fP(3tcl). Щоб уникнути необхідності знати, в якому розділі знаходиться потрібна сторінка довідки, тепер можливо надати \fBman\fP рядок \fIпід\-розширень\fP, який вказує, до якого пакету повинна належати сторінка. Використовуючи вищезазначений приклад, надання опції \fB\-e\ tcl\fP до \fBman\fP обмежить пошук сторінок з розширенням \fB*tcl\fP. .TP .if !'po4a'hide' .BR \-i ", " \-\-ignore\-case Ігнорувати регістр при пошуку сторінок довідки. Це значення за замовчуванням. .TP .if !'po4a'hide' .BR \-I ", " \-\-match\-case Шукати сторінки довідки з урахуванням регістру. .TP .if !'po4a'hide' .B \-\-regex Показати всі сторінки, у яких будь\-яка частина їхніх імен або описів відповідає кожному аргументу \fIсторінка\fP як регулярному виразу, як це робиться з \fBapropos\fP(1). Оскільки зазвичай немає розумного способу вибрати «кращу» сторінку при пошуку за регулярним виразом, ця опція передбачає \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-wildcard Показати всі сторінки, у яких будь\-яка частина їхніх назв або описів відповідає кожному аргументу \fIсторінка\fP, використовуючи шаблони командного рядка, як у \fBapropos\fP(1) з опцією \fB\-\-wildcard\fP. Аргумент \fIсторінка\fP повинен повністю відповідати назві або опису, або відповідати у межах слів у описі. Оскільки зазвичай немає розумного способу вибрати "кращу" сторінку при пошуку за шаблоном, ця опція передбачає \fB\-a\fP. .TP .if !'po4a'hide' .B \-\-names\-only Якщо використовуються опції \fB\-\-regex\fP або \fB\-\-wildcard\fP, то шукається збіг тільки за назвами сторінок, а не їх описами, як це робиться в \fBwhatis\fP(1). В іншому випадку, ефекту немає. .TP .if !'po4a'hide' .BR \-a ", " \-\-all За замовчуванням, \fBman\fP завершиться після показу найпридатнішої сторінки довідника. Використання цієї опції змусить \fBman\fP показати всі сторінки довідників, імена яких відповідають критеріям пошуку. .TP .if !'po4a'hide' .BR \-u ", " \-\-update Ця опція призводить до оновлення кешів бази даних \fBman\fP, які містять встановлені сторінки довідки. Це потрібно лише у рідкісних ситуаціях, і зазвичай краще запускати \fBmandb\fP(8) натомість. .TP .if !'po4a'hide' .B \-\-no\-subpages За замовчуванням, \fBman\fP намагається інтерпретувати пари імен сторінок довідки, вказаних у командному рядку, як еквівалент однієї сторінки довідки з дефісом або підкресленням. Це підтримує поширений шаблон програм, які реалізують кілька підкоманд, дозволяючи їм надавати сторінки довідки для кожної з них, доступ до яких можна отримати за допомогою синтаксису, схожого на використання при виклику самих підкоманд. Наприклад: .nf .if !'po4a'hide' \& $ man \-aw git diff .if !'po4a'hide' \& /usr/share/man/man1/git\-diff.1.gz .fi Щоб вимкнути цю поведінку, використовуйте опцію \fB\-\-no\-subpages\fP. .nf .if !'po4a'hide' \& $ man \-aw \-\-no\-subpages git diff .if !'po4a'hide' \& /usr/share/man/man1/git.1.gz .if !'po4a'hide' \& /usr/share/man/man3/Git.3pm.gz .if !'po4a'hide' \& /usr/share/man/man1/diff.1.gz .fi .SS "Керування форматованим виведенням" .TP \fB\-P\ \fP\fIгортач\fP,\ \fB\-\-pager=\fP\fIгортач\fP Вкажіть програму, гортача виводу. За замовчуванням, \fBman\fP використовує \fBless\fP, якщо \fBless\fP не знайдено або не є виконуваним файлом, тоді використовується \fBcat\fP. Ця опція перевизначає змінну середовища $\fBMANPAGER\fP, яка в свою чергу перевизначає змінну середовища $\fBPAGER\fP. Вона не використовується разом з \fB\-f\fP або \fB\-k\fP. Значенням може бути просте імʼя команди або команда з аргументами, які можуть використовувати цитування для оболонки (зворотні похилі риски, одинарні або подвійні лапки). Вона не може використовувати канали для підключення декількох команд; якщо вам потрібно це, використовуйте обгортковий скрипт, який може приймати файл для показу або на стандартному вводі. .TP \fB\-r\ \fP\fIзапрошення\fP,\ \fB\-\-prompt=\fP\fIзапрошення\fP Якщо недавня версію \fBless\fP використовується як гортач сторінок, \fBman\fP намагатиметься встановити його рядок запрошення і декілька розумних опцій. За замовчуванням запрошення виглядає так \fB Сторінки довідника\fP\fI назва\fP(\fIрозділ\fP\fB) рядок\fP\fI x\fP .\"The default options are .\".BR \-six8 . .\"The actual default will depend on your chosen .\".BR locale . де \fIімʼя\fP позначає назву сторінки довідника, \fIрозділ\fP \- розділ, де вона була знайдена, а \fIx\fP \- поточний номер рядка. Це досягається за допомогою змінної середовища $\fBLESS\fP. .\"You may need to do this if your .\"version of .\".B less .\"rejects the default options or if you prefer a different prompt. При вказанні \fB\-r\fP з рядком, буде перевизначено це значення за замовчуванням. Рядок може містити текст \fB$MAN_PN\fP, який буде розширений до імені поточної сторінки керівництва та її назви розділу, оточених «(» і «)». Рядок, який використовується для створення замовчування, може бути виражений як \fB\e\ Сторінка\e\ довідки\e\ $MAN_PN\e\ ?ltрядок\e\ %lt?L/%L.:\fP .br \fBбайт\e\ %bB?s/%s..?\e\ (КІНЕЦЬ):?pB\e\ %pB\e\e%..\fP .br \fB(натисніть h для довідки або q, щоб вийти)\fP Це розбито на три рядки для зручності читання. Для значення дивіться сторінку довідки \fBless\fP(1). Рядок запрошення спочатку оцінюється оболонкою. Усі подвійні лапки, зворотні апострофи та зворотні похилі риски у запрошенні повинні бути екрановані зворотною похилою рискою. Рядок запрошення може закінчуватися екранованим знаком $, який може бути продовжений іншими опціями для less. За замовчуванням \fBman\fP встановлює опції \fB\-ix8\fP. Змінна середовища $\fBMANLESS\fP, описана нижче, може бути використана для встановлення рядка запрошення за умовчанням, якщо в командному рядку не вказано жодного. .TP .if !'po4a'hide' .BR \-7 ", " \-\-ascii При перегляді чистого сторінки довідки \fIascii\fP(7) на 7\-бітовому терміналі або емуляторі терміналу, деякі символи можуть показуватися неправильно при використанні опису пристрою \fIlatin1\fP(7) з \fBGNU\fP \fBnroff\fP. Ця опція дозволяє показувати чисто \fIascii\fP сторінки довідки в \fIascii\fP з використанням пристрою \fIlatin1\fP. Вона не перекодує будь\-який текст \fIlatin1\fP. Наступна таблиця показує виконувані перекодування: деякі частини можуть показуватися правильно тільки при використанні пристрою \fIlatin1\fP(7) \fBGNU\fP \fBnroff\fP. .ie c \[shc] \ . ds softhyphen \[shc] .el \ . ds softhyphen \(hy .TS tab (@); l l l l l c c c . Опис@Вісімкове@latin1@ascii _ продовжувальне тире@255@\*[softhyphen]@- точка (середня точка)@267@\(bu@o гострий акцент@264@\(aa@' знак множення@327@\(mu@x .TE Якщо стовпець \fIlatin1\fP показується коректно, ваш термінал може бути налаштований для символів \fIlatin1\fP, і ця опція не потрібна. Якщо стовпці \fIlatin1\fP та \fIascii\fP ідентичні, ви читаєте цю сторінку з використанням цієї опції або \fBman\fP не сформував цю сторінку за допомогою опису пристрою \fIlatin1\fP. Якщо стовпець \fIlatin1\fP відсутній або пошкоджений, можливо, вам потрібно переглядати сторінки довідника з цією опцією. Ця опція ігнорується при використанні опцій \fB\-t\fP, \fB\-H\fP, \fB\-T\fP, або \fB\-Z\fP і може бути непридатною для інших \fBnroff\fP, крім \fBGNU\fP. .TP \fB\-E\ \fP\fIкодування\fP,\ \fB\-\-encoding\fP=\fIкодування\fP Створити вивід для кодування символів, яке не є за замовчуванням. Для забезпечення сумісності з попередніми версіями, \fIкодування\fP може бути пристроєм \fBnroff\fP, таким як \fBascii\fP, \fBlatin1\fP, або \fButf8\fP, а також справжнім кодуванням символів, таким як \fBUTF\-8\fP. .TP .if !'po4a'hide' .BR \-\-no\-hyphenation ", " \-\-nh Зазвичай \fBnroff\fP автоматично переносить текст на нові рядки навіть у словах, які не містять дефісів, якщо це необхідно для розміщення слів у рядку без надмірного простору. Ця опція вимикає автоматичні переноси слів, тому слова будуть переноситися тільки коли вони вже містять дефіси. Якщо ви пишете сторінку довідки та просто хочете запобігти переносу слова в небажаному місці у \fBnroff\fP, не використовуйте цю опцію, а зверніться до документації \fBnroff\fP; наприклад, ви можете поставити «\e%» всередині слова, щоб вказати, що воно може бути розбито в тому місці, або поставити «\e%» на початку слова, щоб запобігти його переносу. .TP .if !'po4a'hide' .BR \-\-no\-justification ", " \-\-nj Зазвичай, \fBnroff\fP автоматично вирівнює текст до обох країв. Ця опція вимикає повне вирівнювання, залишаючи вирівнювання тільки до лівого краю, що іноді називається «вирівнюванням вліво». Якщо ви пишете сторінку довідки та просто хочете запобігти вирівнюванню певних абзаців у \fBnroff\fP, не використовуйте цю опцію, а зверніться до документації \fBnroff\fP; наприклад, ви можете використовувати запити ".na", ".nf", ".fi" та ".ad", щоб тимчасово вимкнути вирівнювання та заповнення. .TP \fB\-p\ \fP\fIрядок\fP,\ \fB\-\-preprocessor=\fP\fIрядок\fP Вкажіть послідовність препроцесорів, які потрібно запустити перед \fBnroff\fP або \fBtroff\fP/\fBgroff\fP. Не всі інсталяції мають повний набір препроцесорів. Деякі з препроцесорів та літери, що використовуються для їх позначення: \fBeqn\fP (\fBe\fP), \fBgrap\fP (\fBg\fP), \fBpic\fP (\fBp\fP), \fBtbl\fP (\fBt\fP), \fBvgrind\fP (\fBv\fP), \fBrefer\fP (\fBr\fP). Ця опція перевизначає змінну середовища $\fBMANROFFSEQ\fP. \fBzsoelim\fP завжди запускається як перший препроцесор. .TP .if !'po4a'hide' .BR \-t ", " \-\-troff Використовуйте \fIgroff \-mandoc\fP, щоб сформатувати сторінку довідки і вивести до stdout. Ця опція не потрібна разом з \fB\-H\fP, \fB\-T\fP або \fB\-Z\fP. .TP \fB\-T\fP[\fIпристрій\/\fP], \fB\-\-troff\-device\fP[=\fIпристрій\/\fP] Ця опція використовується для зміни виводу \fBgroff\fP (або, можливо, \fBtroff\fP) так, щоб він був підходив для пристрою, відмінного від пристрою за замовчуванням. Вона передбачає \fB\-t\fP. Приклади включають \fBdvi\fP, \fBlatin1\fP, \fBpdf\fP, \fBps\fP, \fButf8\fP, \fBX75\fP та \fBX100\fP. .TP \fB\-H\fP[\fIпереглядач\/\fP], \fB\-\-html\fP[=\fIпереглядач\/\fP] Ця опція призведе до того, що \fBgroff\fP вироблятиме HTML\-вивід, і показуватиме цей вивід у веб\-переглядачі. Вибір переглядача визначається необовʼязковим аргументом \fIпереглядач\fP, якщо він наданий, змінною середовища $\fBBROWSER\fP, або зі значення за замовчуванням під час компіляції, якщо воно не встановлене (зазвичай це \fBlynx\fP). Ця опція передбачає \fB\-t\fP, і працюватиме тільки з \fBGNU\fP \fBtroff\fP. .TP \fB\-X\fP[\fIdpi\/\fP], \fB\-\-gxditview\fP[=\fIdpi\/\fP] Ця опція показує вивід програми \fBgroff\fP у графічному вікні за допомогою програми \fBgxditview\fP. Кількість точок на дюйм (dpi) може бути 75, 75\-12, 100 або 100\-12, за замовчуванням встановлюється значення 75; варіанти з \-12 використовують базовий шрифт розміром 12 пунктів. Ця опція передбачає \fB\-T\fP з відповідним пристроєм X75, X75\-12, X100 або X100\-12. .TP .if !'po4a'hide' .BR \-Z ", " \-\-ditroff \fBgroff\fP запустить \fBtroff\fP і потім використає відповідний пост\-процесор для створення вихідного файлу, придатного для обраного пристрою. Якщо \fIgroff \-mandoc\fP є \fBgroff\fP, то цей параметр передається до \fBgroff\fP і пригнічує використання пост\-процесора. Він підтверджує \fB\-t\fP. .SS "Отримання допомоги" .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 Операційна помилка. .TP .if !'po4a'hide' .B 3 Дочірній процес повернув статус виходу, відмінний від нуля. .TP .if !'po4a'hide' .B 16 Принаймні одна з сторінок/файлів/ключових слів не існувала або не була знайдена. .SH СЕРЕДОВИЩЕ .\".TP \w'MANROFFSEQ\ \ 'u .TP .if !'po4a'hide' .B MANPATH Якщо встановлено змінну $\fBMANPATH\fP, її значення використовується як шлях для пошуку сторінок довідки. Дивіться розділ \fBШЛЯХ ПОШУКУ\fP у \fBmanpath\fP(5) щодо поведінки за замовчуванням і подробиць того, як обробляється ця змінна середовища. .TP .if !'po4a'hide' .B MANROFFOPT Кожного разу, коли \fBman\fP викликає форматувальник (\fBnroff\fP, \fBtroff\fP, або \fBgroff\fP), він додає вміст $\fBMANROFFOPT\fP до командного рядка форматувальника. Наприклад, \fBMANROFFOPT=\-P\-i\fP вказує форматувальнику використовувати курсивний текст (який підтримується лише деякими терміналами) замість підкресленого. .TP .if !'po4a'hide' .B MANROFFSEQ Якщо встановлено змінну $\fBMANROFFSEQ\fP, її значення використовується для визначення набору препроцесорів, через які проходить кожна сторінка довідки. Список препроцесорів за замовчуванням залежить від системи. .TP .if !'po4a'hide' .B MANSECT Якщо встановлено $\fBMANSECT\fP, його значення є списком розділів, розділених двокрапками, і використовується для визначення, які розділи довідки потрібно шукати та в якому порядку. За замовчуванням це «1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7», якщо не перевизначено директивою \fBSECTION\fP у файлі \fI/etc/man_db.conf\fP. .TP .if !'po4a'hide' .BR MANPAGER , " PAGER" Якщо встановлено $\fBMANPAGER\fP або $\fBPAGER\fP (переважно використовується $\fBMANPAGER\fP), його значення використовується як назва програми для показу сторінки довідника (гортач). За замовчуванням використовується \fBless\fP, а якщо \fBless\fP не знайдено або він не є виконуваним, то використовується \fBcat\fP. Значенням може бути просте імʼя команди або команда з аргументами, які можуть використовувати цитування для оболонки (зворотні похилі риски, одинарні або подвійні лапки). Вона не може використовувати канали для підключення декількох команд; якщо вам потрібно це, використовуйте обгортковий скрипт, який може приймати файл для показу або на стандартному вводі. .TP .if !'po4a'hide' .B MANLESS Якщо встановлено змінну середовища $\fBMANLESS\fP, її значення буде використовуватися як рядок запрошення за замовчуванням для переглядача \fBless\fP, так само, ніби вона була передана з допомогою опції \fB\-r\fP (тому будь\-які входження тексту \fB$MAN_PN\fP буде розширено таким же чином). Наприклад, якщо ви хочете однозначно встановити рядок запиту на «my prompt string», встановіть змінну середовища $\fBMANLESS\fP у значення \(oq\fB\-Psmy\ prompt\ string\fP\(cq. Використання опції \fB\-r\fP перевизначає цю змінну середовища. .TP .if !'po4a'hide' .B BROWSER Якщо встановлено змінну $\fBBROWSER\fP, її значення є списком команд, розділених двокрапками. Кожна з цих команд використовується для спроби запустити веб\-переглядач для \fBman\fP \fB\-\-html\fP. У кожній команді \fI%s\fP замінюється на імʼя файлу, що містить HTML вивід з \fBgroff\fP, \fI%%\fP замінюється на одинарний знак відсотка (%), а \fI%c\fP \- на двокрапку (:). .TP .if !'po4a'hide' .B SYSTEM Якщо встановлено $\fBSYSTEM\fP, це матиме такий же ефект, як і якби вона була зазначена як аргумент для опції \fB\-m\fP. .TP .if !'po4a'hide' .B MANOPT Якщо встановлено змінну середовища $\fBMANOPT\fP, вона буде оброблена перед командним рядком \fBman\fP і очікується, що матиме схожий формат. Оскільки всі інші специфічні для \fBman\fP змінні середовища можуть бути виражені як параметри командного рядка, і тому є кандидатами на включення до $\fBMANOPT\fP, очікується, що вони стануть застарілими. Зверніть увагу, що всі пробіли, які повинні бути інтерпретовані як частина аргументу параметра, повинні бути екрановані. .TP .if !'po4a'hide' .B MANWIDTH Якщо встановлено $\fBMANWIDTH\fP, його значення використовується як довжина рядка для форматування сторінок довідки. Якщо воно не встановлено, сторінки довідки будуть відформатовані з довжиною рядка, що відповідає поточному терміналу (використовуючи значення $\fBCOLUMNS\fP, і \fBioctl\fP(2), якщо вони доступні, або за умовчанням використовується 80 символів, якщо жоден з них недоступний). Сторінки cat будуть збережені лише тоді, коли можливе використання форматування за умовчанням, тобто коли довжина рядка терміналу знаходиться між 66 і 80 символами. .TP .if !'po4a'hide' .B MAN_KEEP_FORMATTING Зазвичай, коли вивід не спрямовується на термінал (наприклад, у файл або трубу), символи форматування відкидаються для зручнішого читання результату без спеціальних інструментів. Однак, якщо $\fBMAN_KEEP_FORMATTING\fP встановлено в будь\-яке непорожнє значення, ці символи форматування зберігаються. Це може бути корисним для обгортки навколо \fBman\fP, яка вміє інтерпретувати символи форматування. .TP .if !'po4a'hide' .B MAN_KEEP_STDERR Зазвичай, коли вивід спрямовується до терміналу (зазвичай до гортача), будь\-який помилковий вивід з команди, яка використовується для створення форматованих версій сторінок довідки, відкидається, щоб уникнути втручання в показ гортача . Програми, такі як \fBgroff\fP, часто виробляють незначні повідомлення про помилки стосовно типографічних проблем, таких як погане вирівнювання, які виглядають непривабливо і зазвичай плутають, коли вони показуються разом зі сторінкою довідки. Однак деяким користувачам все одно хочеться їх побачити, тому якщо $\fBMAN_KEEP_STDERR\fP встановлено на будь\-яке непорожнє значення, вивід помилок буде показуватися звичайним чином. .TP .if !'po4a'hide' .B MAN_DISABLE_SECCOMP На Linux, \fBman\fP зазвичай обмежує підпроцеси, які обробляють ненадійні дані, використовуючи пісочницю \fBseccomp\fP(2). Це робить безпечнішим запуск складного коду аналізу довільних сторінок довідки. Якщо це станеться через якусь причину, не повʼязану з вмістом показаної сторінки, ви можете встановити $\fBMAN_DISABLE_SECCOMP\fP у будь\-яке непорожнє значення, щоб вимкнути пісочницю. .TP .if !'po4a'hide' .B PIPELINE_DEBUG Якщо змінна середовища $\fBPIPELINE_DEBUG\fP встановлена у "1", тоді \fBman\fP виведе повідомлення про налагодження до стандартного виводу для помилок, описуючи кожен підпроцес, який він запускає. .TP .if !'po4a'hide' .BR LANG , " LC_MESSAGES" Залежно від системи та реалізації, буде перевірено як $\fBLANG\fP, так і $\fBLC_MESSAGES\fP для поточної мови повідомлень. \fBman\fP показуватиме свої повідомлення в цій мові (якщо доступна). Див. \fBsetlocale\fP(3). .SH ФАЙЛИ .TP .if !'po4a'hide' .I /etc/man_db.conf конфігураційний файл man\-db. .TP .if !'po4a'hide' .I /usr/share/man Глобальна ієрархія сторінок довідки. .SH СТАНДАРТИ POSIX.1\-2001, POSIX.1\-2008, POSIX.1\-2017. .SH "ДИВ. ТАКОЖ" .if !'po4a'hide' .BR apropos (1), .if !'po4a'hide' .BR groff (1), .if !'po4a'hide' .BR less (1), .if !'po4a'hide' .BR manpath (1), .if !'po4a'hide' .BR nroff (1), .if !'po4a'hide' .BR troff (1), .if !'po4a'hide' .BR whatis (1), .if !'po4a'hide' .BR zsoelim (1), .if !'po4a'hide' .BR manpath (5), .if !'po4a'hide' .BR man (7), .if !'po4a'hide' .BR catman (8), .if !'po4a'hide' .BR mandb (8) .PP Документація для деяких пакетів може бути доступна в інших форматах, таких як \fBinfo\fP(1) або HTML. .SH ІСТОРІЯ 1990, 1991 \(en Оригінально написано Джоном В.\& Ейтоном (jwe@che.utexas.edu). 23 грудня 1992 року: Рік Фейт (faith@cs.unc.edu) застосував виправлення помилок, надані Willem Kasdorp (wkasdo@nikhefk.nikef.nl). 30\-го квітня 1994 \(en 23\-го Лютого 2000: Wilf.\& (G.Wilford@ee.surrey.ac.uk) розвивав і підтримував цей пакет з допомогою декількох присвячених цьому людей. 30го жовтня 1996 \(en 30го березня 2001: Fabrizio Polacco підтримував і покращував цей пакет для проекту Debian, з допомогою всієї спільноти. 31го березня 2001 \(en сьогодення: Colin Watson тепер розробляє і підтримує man\-db. .SH ПОМИЛКИ .if !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db