NÁZOV
man - formát a zobrazenie on - line manuálových stránok
manpath - určuje cestu vyhľadávania používateľov pre manuálne stránky
SYNOPSA
man [ -cdfFhkKtwW ] [ -path ] [ -m systém ] [ -p reťazec ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ názov ] názov ...
POPIS
man a zobrazuje on-line manuálne stránky. Ak zadáte sekciu , človek sa pozrie iba v tej časti manuálu. názov je zvyčajne názov manuálnej stránky, ktorá je zvyčajne názvom príkazu, funkcie alebo súboru. Ak však názov obsahuje lomku ( / ), potom človek to interpretuje ako špecifikáciu súboru, takže môžete urobiť man ./foo.5 alebo dokonca man /cd/foo/bar.1.gz .
Pozrite nižšie, kde nájdete informácie o tom, kde človek hľadá manuálne súbory stránok.
MOŽNOSTI
-C config_file
Zadajte konfiguračný súbor, ktorý chcete použiť; predvolená hodnota je /etc/man.config . (Pozri man.conf (5).)
-M cestu
Zadajte zoznam adresárov na vyhľadávanie manuálových stránok. Oddeľte adresáre dvojbodkami. Prázdny zoznam je rovnaký ako vôbec neuvádza -M . Pozrite si časť Cesta hľadania pre manuálne strany .
-P pager
Určte, ktorý pager chcete použiť. Táto voľba prepíše premennú prostredia MANPAGER , ktorá zase prepíše premennú PAGER . V predvolenom nastavení používa používateľ / usr / bin / less -isr .
-S zoznam_obrázok
Zoznam je zoznam oddelených hrubých čiar pre manuálne sekcie. Táto voľba prepíše premennú prostredia MANSECT .
-a
V predvolenom nastavení sa človek ukončí po zobrazení prvej manuálnej stránky, ktorú nájde. Použitím tejto možnosti si človek vyžiada všetky manuálne stránky, ktoré zodpovedajú názvu, nie iba prvému.
-c
Znova upravte stránku zdroja, aj keď existuje aktuálna stránka kočky . To môže byť zmysluplné, ak bola stránka kocky formátovaná pre obrazovku s odlišným počtom stĺpcov alebo ak je predformátovaná stránka poškodená.
-d
Vlastné stránky sa v skutočnosti nezobrazujú, ale tlačia sa hĺbky informácií o ladení.
-D
Obaja zobrazujú a tlačia informácie o ladení.
-f
Ekvivalent k whatis .
-F alebo -preformat
Len formátovanie - nezobrazovať.
-h
Vytlačte jednu pomocnú správu a skončte.
-k
Ekvivalentný k apropos .
-K
Vyhľadajte zadaný reťazec na stránkach * all * man. Upozornenie: je to pravdepodobne veľmi pomalé! Pomáha špecifikovať sekciu. (Stačí uviesť hrubý nápad, na mojom stroji to trvá asi minútu na 500 manských stránok.)
-m systému
Zadajte alternatívnu množinu manuálových stránok na vyhľadávanie na základe daného názvu systému.
-p reťazec
Určte poradie preprocesorov na spustenie pred nroff alebo troff . Nie všetky inštalácie budú mať kompletnú sadu preprocesorov. Niektoré preprocesory a písmená použité na ich označenie sú: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), odkaz (r). Táto voľba prepíše premennú prostredia MANROFFSEQ .
-t
Použite / usr / bin / groff -Tps -mandoc, aby ste naformátovali manuálnu stránku a preniesli výstup na stdout. Výstup z / usr / bin / groff -Tps -mandoc môže byť potrebné pred tým, než sa vytlačí, prejsť cez niektorý filter alebo iný filter.
-w alebo - cesta
Vlastné stránky sa v skutočnosti nezobrazujú, ale vytlačte umiestnenie súborov, ktoré by boli formátované alebo zobrazené. Ak nie je uvedený žiadny argument: zobrazenie (na stdout) zoznamu adresárov, ktoré hľadá človek pre manuálne stránky. Ak manpath je spojenie s človekom, potom "manpath" je ekvivalentom "man-path".
W
Rovnako ako -w, ale tlačiť názvy súborov jeden na riadok, bez ďalších informácií. Toto je užitočné pri príkazoch pre shell ako man-aW man | xargs ls -l
CAT PAGES
Človek sa pokúsi uložiť formátované stránky mana, aby ušetril formátovací čas pri najbližšom použití týchto stránok. Formátované verzie stránok v DIR / manX sú tradične uložené v adresári DIR / catX, ale ďalšie mapovania z mena dir do mačacieho adresára môžu byť zadané v súbore /etc/man.config . Žiadne stránky mačiek nie sú uložené, ak požadovaný adresár mačiek neexistuje. Žiadne stránky mačiek nie sú uložené, ak sú naformátované pre dĺžku čiar líšiacu sa od 80. Nie sú uložené žiadne stránky mačiek, keď man.conf obsahuje riadok NOCACHE.
Je možné, aby človek suid užívateľovi. Potom, ak katalóg mačky má majiteľa človeka a režim 0755 (len zapisovateľný človekom) a súbory mačiek majú majiteľa a režim 0644 alebo 0444 (zapisovateľné len človekom alebo nie sú zapisovateľné vôbec), žiadny bežný používateľ nemôže zmeniť alebo vložte iné súbory do adresára mačky. Ak človek nie je urobený suid, potom adresár kočky by mal mať režim 0777, ak všetci používatelia by mali mať možnosť nechať mačacie stránky tam.
Možnosť -c vynucuje preformátovanie stránky, aj keď existuje nedávna stránka mačky.
VYHĽADÁVACIE CESTY PRE RUČNÉ STRÁNKY
človek používa sofistikovanú metódu nájdenia manuálnych súborov stránok na základe možností volania a premenných prostredia, konfiguračného súboru /etc/man.config a niektorých konvencií a heuristiky.
Po prvé, ak názov argumentu pre človeka obsahuje lomku ( / ), človek predpokladá, že ide o samotnú špecifikáciu súboru a nie je zahrnuté žiadne vyhľadávanie.
Ale v normálnom prípade, keď meno neobsahuje lomítko, človek hľadá rôzne adresáre pre súbor, ktorý by mohol byť manuálnou stránkou pre danú tému.
Ak zadáte voľbu -M pathlist , pathlist je dvojbodovo oddelený zoznam adresárov, ktoré človek hľadá.
Ak neurčíte -M, ale nastavíte premennú prostredia MANPATH , hodnota tejto premennej je zoznam adresárov, ktoré človek vyhľadáva.
Ak neurčíte zoznam explicitných ciest s -M alebo MANPATH , človek vytvorí svoj vlastný zoznam ciest na základe obsahu konfiguračného súboru /etc/man.config . Príkazy MANPATH v konfiguračnom súbore identifikujú konkrétne adresáre, ktoré sa majú zahrnúť do vyhľadávacej cesty.
Príkazy MANPATH_MAP navyše pridávajú cestu vyhľadávania v závislosti od vašej cesty vyhľadávania príkazov (tj vašej premennej prostredia PATH ). Pre každý adresár, ktorý môže byť v ceste vyhľadávania príkazu, príkaz MANPATH_MAP určuje adresár, ktorý by mal byť pridaný do vyhľadávacej cesty pre manuálne súbory stránok. človek sa pozerá na premennú PATH a pridá príslušné adresáre do cesty vyhľadávania súborov manuálnej stránky. Takže pri správnom používaní MANPATH_MAP , keď vydáte príkaz man xyz , dostanete manuálnu stránku pre program, ktorý by sa spustil, ak ste vydali príkaz xyz .
Okrem toho, pre každý adresár v ceste vyhľadávania príkazov (nazývame to "príkazový adresár"), pre ktorý nemáte príkaz MANPATH_MAP , človek automaticky hľadá adresár manuálnej stránky "v blízkosti", a to ako podadresár v samotný príkazový adresár alebo v nadradenom adresári príkazového adresára.
Automatické vyhľadávanie "v blízkosti" môžete zakázať tak, že do príkazu /etc/man.config zadáte príkaz NOAUTOPATH .
V každom adresári vo vyhľadávacej ceste, ako je popísané vyššie, človek hľadá súbor s názvom téma . sekcia s voliteľnou príponou na číslo sekcie a prípadne prípona kompresie. Ak takýto súbor nenájde, potom sa objaví v ľubovoľných podadresároch s názvom man N alebo mačka N, kde N je číslo manuálnej sekcie. Ak je súbor v podadresári Cat N , človek predpokladá, že ide o formátovaný manuálový súbor stránky (katalógová stránka). V opačnom prípade človek predpokladá, že je neformátovaný. V oboch prípadoch, ak má názov súboru známu príponu kompresie (napr. .gz ), človek predpokladá, že je gzip.
Ak chcete vidieť, kde (alebo ak) človek nájde manuálnu stránku pre konkrétnu tému, použite voľbu - path ( -w ).
Dôležité: Pomocou príkazu man ( % man ) môžete zistiť, ako sa príkaz používa vo vašom konkrétnom počítači.