ИМЕ
man - формат и показване на онлайн ръководство страници
manpath - определяне на пътя за търсене на потребителя за страници на човека
Кратък обзор
man [ -cdfFhkKtwW ] [- път ] [ -m система ] [ -п низ ] [ -C config_file ] [ -П пълен списък ] [ -P пейджър ] [ -S section_list ] име на [ секция ] ...
ОПИСАНИЕ
man и показва онлайн наръчниците. Ако посочите секция , човекът само гледа в този раздел на ръководството. името обикновено е името на ръководството, което обикновено е името на команда, функция или файл. Ако обаче името съдържа наклонена черта ( / ), тогава човекът го интерпретира като спецификация на файла, така че можете да направите човек ./foo.5 или дори man /cd/foo/bar.1.gz .
Вижте по-долу описание на мястото, където човек търси файловете с ръчна страница.
НАСТРОИКИ
-C config_file
Посочете конфигурационния файл, който да използвате; по подразбиране е /etc/man.config . (Вижте man.conf (5).)
-М път
Посочете списъка с директории за търсене на страници с инструменти. Разделете директорите с двоеточие. Празен списък е същият, като не се посочва изобщо " М ". Вижте " Пътека за търсене" за ръчни страници .
-P пейджър
Посочете кой пейджър да използвате. Тази опция заменя променливата на средата MANPAGER , която на свой ред заменя променливата PAGER . По подразбиране човек използва / usr / bin / less -isr .
-S списък_секция
Списъкът е разделен на двоеточие, списък с ръчни секции за търсене. Тази опция заменя променливата на средата MANSECT .
-а
По подразбиране човек ще излезе след показването на първата страница, която намери. Използването на тази опция принуждава човека да показва всички ръчни страници, които съответстват на името, а не само на първия.
-° С
Преформатирайте страницата с ръководството на източника, дори когато съществува актуална страница за котки . Това може да има смисъл, ако страницата с котките е форматирана за екран с различен брой колони или ако предварително форматираната страница е повредена.
-д
Всъщност не се показват страниците на човека, но се отпечатват проблясъци на информация за отстраняване на грешки.
-Д
Показва и отпечатва информация за отстраняване на грешки.
-f
Еквивалентен на whatis .
-F или - преформатиране
Само форматиране - не се показва.
-h
Отпечатайте едноредово съобщение за помощ и излезте.
-k
Еквивалент на apropos .
К
Потърсете посочения низ в страниците * all * man. Предупреждение: това вероятно е много бавно! То помага да се определи раздел. (Само за да дам груба представа, на моята машина това отнема около минута на 500 страници.
-м система
Посочете алтернативен набор от страници за търсене, които да се търсят въз основа на даденото име на системата.
-п низ
Посочете последователността на препроцесорите, които да се изпълняват преди nroff или troff . Не всички инсталации ще разполагат с пълен комплект препроцесори. Някои от препроцесорите и буквите, използвани за обозначаването им, са: eqn (e), grap (g), pic (p), tbl (t), vgrind (v). Тази опция заменя променливата на средата MANROFFSEQ .
-T
Използвайте / usr / bin / groff -Tps -mandoc, за да форматирате наръчника, предавайки изхода на stdout. Изходът от / usr / bin / groff -Tps -mandoc може да се наложи да бъде пренесен през някой филтър или друг, преди да бъде отпечатан.
-w или - път
Всъщност не се показват страниците на човека, но се отпечатва местоположението на файловете, които ще бъдат форматирани или показвани. Ако не е даден аргумент: показва (на stdout) списъка с директории, които се търсят от човека за страници на човека. Ако manpath е връзка с човека, тогава "manpath" е еквивалентна на "man-path".
-W
Подобно на -w, но печатайте имената на файлове на ред, без допълнителна информация. Това е полезно в команди на черупки, като например човек-човек | xargs ls -l
КАТЕГОРИИ НА КАТ
Човекът ще се опита да запази форматираните страници на човека, за да запази времето за форматиране следващия път, когато са необходими тези страници. Традиционно, форматираните версии на страниците в DIR / manX се запазват в DIR / catX, но други mappings от man dir до cat dir могат да бъдат зададени в /etc/man.config . Не са запазени страници за котки, когато не съществува необходимата директория за котки. Не са запазени страници за котки, когато са форматирани за дължина на линията, различна от 80. Не са запазени страници за котки, когато man.conf съдържа линията NOCACHE.
Възможно е човекът да бъде съден на потребител. След това, ако директорията с котки има собственик на човек и режим 0755 (само за писане от човека), а файловете с котки имат собственик и режим 0644 или 0444 (само за писане от човек или изобщо не могат да се пишат), обикновен потребител не може да промени котка страници или пуснати други файлове в директорията котка. Ако човек не е суит, тогава директорията с котки трябва да има режим 0777, ако всички потребители трябва да могат да оставят котките там.
Опцията -c принуждава преформатирането на дадена страница, дори и да има скорошна страница за котки.
ПЪТУВАНЕ ЗА ТЪРСЕНЕ НА РЪЧНИ СТРАНИЦИ
човек използва усъвършенстван метод за намиране на ръчни файлове на страници, базирани на опциите за призоваване и променливи на средата, конфигурационния файл /etc/man.config и някои вградени конвенции и евристики.
На първо място, когато името на аргумента за човека съдържа наклонена черта ( / ), човек предполага, че е самата спецификация на файла и няма търсене.
Но в нормалния случай, когато името не съдържа наклонена черта, човек търси в различни директории за файл, който може да бъде ръчна страница за зададената тема.
Ако зададете опцията -M списък за пътеки , списъкът с пътеки е списък, разделен на дебелина , на директории, които човек търси.
Ако не посочите -M, но зададете променливата на MANPATH средата, стойността на тази променлива е списъкът с директории, които човек търси.
Ако не посочите списък с изрични пътеки с -M или MANPATH , човекът разработва свой списък с пътеки въз основа на съдържанието на конфигурационния файл /etc/man.config . Текстовете MANPATH в конфигурационния файл идентифицират конкретни директории, които да бъдат включени в пътя за търсене.
Освен това изявленията MANPATH_MAP добавят към пътя за търсене в зависимост от пътя за търсене на командата (т.е. променливата за обкръжението PATH ). За всяка директория, която може да е в пътя за търсене на команди, изразът MANPATH_MAP указва директория, която трябва да бъде добавена към пътя за търсене на ръчни файлови страници. човек разглежда променливата PATH и добавя съответните директории към пътя за търсене на файл с ръчна страница. По този начин, с правилното използване на MANPATH_MAP , когато издавате командата man xyz , получавате ръчна страница за програмата, която ще се изпълнява, ако сте издали командата xyz .
Освен това, за всяка директория в пътя за търсене на команди (която ще я наречем "команда директория"), за която нямате изявление MANPATH_MAP , човек автоматично търси директна директория на страниците "наблизо", а именно като поддиректория в директорията самата команда или в родителската директория на командната директория.
Можете да деактивирате автоматичните "близки" търсения, като включите израз NOAUTOPATH в /etc/man.config .
Във всяка директория в пътя за търсене, както е описано по-горе, човек търси файл, наречен тема . , с допълнителен суфикс на номера на секцията и евентуално приставка за компресиране. Ако не намери такъв файл, то тогава изглежда във всички поддиректории, наречени man N или cat N, където N е номерът на ръчната секция. Ако файлът е в поддиректория cat N , човек приема, че е форматиран ръчен файл на страницата (страница за котка). В противен случай човек предполага, че е неформатиран. И в двата случая, ако името на файла има известен натиск за компресиране (като .gz ), човек предполага, че е gzipped.
Ако искате да видите къде (или ако) човекът ще намери наръчника за дадена тема, използвайте опцията -path ( -w ).
Важно: Използвайте командата човек ( % man ), за да видите как се използва команда на вашия компютър.