NAME
man-формат и прикажување на он-лајн упатства страници
manpath - одредување на патеката за пребарување на корисникот за страници на човекот
СИНОПСИС
man [ -acdfFhkKtwW ] [ -path ] [ -m system ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ section ] name ...
ОПИС
човечки формати и ги прикажува страниците за он-лајн упатства. Ако наведете дел , човекот изгледа само во тој дел од прирачникот. името е вообичаено името на страната за упатства, што обично е име на команда, функција или датотека. Меѓутоа, ако името содржи коса црта ( / ), тогаш човекот го толкува како спецификација на датотека, така што можете да го направите човекот. /io5 или дури и човекот /cd/foo/bar.1.gz .
Погледнете подолу за опис на местото каде што мажот ги бара прирачните датотеки со страници.
ОПЦИИ
-C config_file
Наведете ја конфигурациската датотека за користење; стандардно е /etc/man.config . (Видете man.conf (5).)
-М патот
Наведете ја листата на директориуми за да пребарувате за страници со мажи. Одделете ги директориумите со колони. Празна листа е иста како што не специфицира -М воопшто. Видете ПОИСК ПАТ ЗА РАЦИОНАЛНИ СТРАНИ .
-П пејџер
Наведете кој пејџер да го користите. Оваа опција ја преклопува променливата на околината MANPAGER , која за возврат ја пребришува променливата PAGER . Стандардно, човекот користи / usr / bin / less -isr .
-S section_list
Листата е листа на рачни секции за пребарување со дебелина на дебелото црево. Оваа опција ја преклопува променливата на околината MANSECT .
-а
Стандардно, човекот ќе излезе по прикажувањето на првата рачна страница што ја наоѓа. Користењето на оваа опција го принудува човекот да ги прикаже сите страници со упатства кои се совпаѓаат со името, а не само првиот.
-c
Реформирајте ја изворната страница на човекот, дури и кога постои најсовремена мачка . Ова може да биде значајно ако страницата на мачката е форматирана за екранот со различен број колони или ако претходноформатираната страница е корумпирана.
-d
Всушност, не ги прикажувајте страниците на човекот, туку правите печатени грешки за информации за дебагирање.
-Д
Двете приказ и печатење информации за дебагирање.
-f
Еквивалентно на whatis .
-F или -предформат
Само формат - не се прикажува.
-Х
Печати порака за една линија и излезете.
-k
Еквивалентно на приближно .
-K
Пребарај ја наведената низа во * сите * man страници. Предупредување: ова е веројатно многу бавно! Помош за одредување на дел. (Само за да дадам груба идеја, на мојата машина ова трае околу една минута на страници од 500 човекот.)
-m систем
Наведете алтернативен сет на човечки страници за пребарување врз основа на даденото име на системот.
-p стринг
Наведете ја секвенцата на препроцесори за да се кандидира пред nroff или troff . Не сите инсталации ќе имаат целосен препроцесори. Некои од препроцесорите и буквите што се користат за нивно назначување се: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), се однесува (r). Оваа опција ја заменува променливата на околината MANROFFSEQ .
-Т
Користете / usr / bin / groff -Tps -mandoc да ја форматирате страницата со упатства, пренесувајќи го излезот до stdout. Излезот од / usr / bin / groff-Tps-мандо треба да биде пренесен преку некој филтер или друг, пред да биде отпечатен.
-w или - пат
Всушност, не ги прикажувајте страниците на човекот, но печатете ги локациите на датотеките што ќе бидат форматирани или прикажани. Ако не е даден аргумент: прикажи (на stdout) листата на директориуми што ги пребарува човекот за страници на човекот. Ако manpath е врска со човекот, тогаш "manpath" е еквивалентно на "man -path".
-W
Како-w, но печатете ги имињата на датотеките еден по линија, без дополнителни информации. Ова е корисно во командните команди како човекот -aW man | xargs ls -l
САТ СТРАНИ
Човекот ќе се обиде да ги зачува форматираните страници на човекот, за да зачува време за форматирање следниот пат кога ќе бидат потребни овие страници. Традиционално, форматираните верзии на страници во DIR / manX се зачувани во DIR / catX, но другите мапирање од man dir to 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 , мажот претпоставува дека е форматирана рачна страница со датотеки (cat page). Инаку, човекот претпоставува дека е неформатиран. Во секој случај, ако името на датотеката има познат префикс за компресија (како .gz ), човекот претпоставува дека е gzipped.
Ако сакате да видите каде (или ако) човекот ќе ја најде страницата за упатства за одредена тема, користете опција --p ().
Важно: Користете ја командата за човекот ( % man ) за да видите како се користи командата на вашиот компјутер.