NAME
čovek - formatira i prikazuje stranice on-line priručnika
Manpath - određuje putanju za pretragu korisnika za manske stranice
SYNOPSIS
man [ -acdfFhkKtwW ] [ --path ] [ -m system ] [ -p string ] [ -C config_file ] [ -M lista puta ] [ -P pager ] [ -S section_list ] [ section ] name ...
OPIS
man formati i prikazuje stranice on-line priručnika. Ako odredite odeljak , čovjek samo pogleda u tom delu priručnika. ime je obično ime stranice priručnika, što je tipično ime komande, funkcije ili datoteke. Međutim, ako ime sadrži kosu ( / ) onda čovjek to tumači kao specifikaciju datoteke, tako da možete učiniti čovjeka ./foo.5 ili čak čovjeku /cd/foo/bar.1.gz .
Pogledajte ispod za opis gde čovjek traži datoteke sa ručnim stranicama.
OPCIJE
-C config_file
Navedite konfiguracionu datoteku koju ćete koristiti; podrazumevano je /etc/man.config . (Pogledajte man.conf (5).)
-M putu
Navedite listu direktorija za pretraživanje stranica čoveka. Odvojite direktorije kolonama. Prazna lista je ista kao i ne navodi -M uopšte. Pogledajte SEARCH PATH FOR MANUAL PAGES .
-P pejdžer
Navedite koji pejdžer treba da koristi. Ova opcija preklapa varijablu MANPAGER okruženja, koja zauzvrat preklapa varijablu PAGER-a . Podrazumevano, čovjek koristi / usr / bin / manje -isr .
-S section_list
Lista je lista odeljka ručne sekvence za pretragu. Ova opcija nadmašuje MANSECT promenljivu okoline.
-a
Podrazumevano, čovjek će izaći iza prikaza prve priručne stranice koju pronađe. Korišćenjem ove opcije silazi čovjek da prikaže sve stranice sa uputama koje odgovaraju nazivu, a ne samo prvom.
-c
Reformišite stranicu čoveka izvora, čak i kada postoji ažurirana stranica mačke . Ovo može biti značajno ako je stranica mačke formatirana za ekran sa različitim brojem kolona ili ako je preformatirana stranica korumpirana.
-d
Nemojte stvarno prikazati stranice čoveka, već uradite štampanje gobova informacija o otklanjanju grešaka.
-D
Prikazuju i štampaju informacije o debagovanju.
-f
Ekvivalentno tome .
-F ili --preformat
Samo formatiraj - ne prikazuje se.
-h
Štampajte jednu liniju pomoći i izađite.
-k
Ekvivalentno apropos .
-K
Potražite navedeni niz na * svim * man stranicama. Upozorenje: ovo je verovatno veoma sporo! Pomaže u određivanju odeljka. (Samo da bih napravio grubu ideju, na mojoj mašini traje oko minutu na 500 man stranica.)
-m sistem
Navedite alternativni skup mannih stranica za pretragu na osnovu datog naziva sistema.
-p string
Navedite sekvencu preprocesora za pokretanje prije nroff ili troff . Sve instalacije neće imati kompletan skup preprocora. Neki od precesora i slova koja ih koriste za označavanje su: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ova opcija preklapa varijablu okruženja MANROFFSEQ .
-t
Koristite / usr / bin / groff -Tps -mandoc da biste formatirali stranicu priručnika, prenoseći izlaz u stdout. Izlaz iz / usr / bin / groff-Tps -mandoka možda će biti potrebno da se prenese kroz neki filter ili neki drugi pre štampanja.
-w ili - pat
Ne zapravo prikazujte stranice čoveka, ali odštampajte lokaciju (e) datoteka koje će biti formatirane ili prikazane. Ako nije dat argument: prikaz (na stdout) spisak direktorija koje čovjek traži za manne stranice. Ako je manpath veza sa čovekom onda je "manpath" ekvivalentan "man -path".
-W
Kao -w, ali imena datoteka za štampu jedan po redu, bez dodatnih informacija. Ovo je korisno u komandama shell-a kao što je čovek-aW man xargs ls -l
CAT PAGES
Čovjek će pokušati da sačuva formatirane čovječe stranice, kako bi spasio vrijeme za formatiranje sljedeći put kada su ove stranice potrebne. Tradicionalno, formatirane verzije stranica u DIR / manX-u su sačuvane u DIR / catX, ali druge mape iz man dir to cat dir mogu biti specificirane u /etc/man.config . Nijedne stranice mačaka se ne čuvaju kada traženi direktorij mačke ne postoji. Nijedne stranice mačaka se ne čuvaju kada su formatirani za dužinu linije drugačije od 80. Nijedne mačke stranice se ne čuvaju kada man.conf sadrži liniju NOCACHE.
Moguće je učiniti čoveka da muči korisnika čovjeka. Zatim, ako direktorijum mačke ima čovjeka i vlasnika vlasnika 0755 (samo ga može pisati čovjek), a mačka datoteke imaju vlasnika čoveka i moda 0644 ili 0444 (samo čovjek može pisati ili uopšte ne može pisati), običan korisnik ne može promijeniti mačke ili stavite druge datoteke u direktorijum mačke. Ako čovek ne bude upućen, onda direktorica mačke treba da ima mod 0777 ako svi korisnici trebaju biti u mogućnosti ostaviti tu mačke.
Opcija -c sili reformatiranje stranice, čak i ako postoji nedavna mačka stranica.
SEARCH PATH FOR MANUAL PAGES
čovjek koristi sofisticirani način pronalaženja manuelnih stranica datoteka na osnovu varijabli pozivanja i varijable okoline, konfiguracijskog fajla /etc/man.config , a neke ugrađene u konvencije i heuristike.
Pre svega, kada ime argumenta čovjeku sadrži kosu ( / ), čovek pretpostavlja da je sam specifikacija datoteke i da nema uključenog pretraživanja.
Ali u normalnom slučaju kada ime ne sadrži kosu, čovjek traži razne direktorijume za datoteku koja bi mogla biti ručna stranica za temu nazvanu.
Ako odredite opciju -M pathlist , putlist je lista odvojenih od strane kolona direktorija koje čovjek traži.
Ako ne navedete -M, već postavite varijablu okruženja MANPATH , vrijednost te varijable je lista direktorija koje čovjek traži.
Ako ne navedete eksplicitnu listu puta sa -M ili MANPATH , čovek razvija svoju listu putanja na osnovu sadržaja konfiguracione datoteke /etc/man.config . Izjave MANPATH- a u konfiguracijskoj datoteci identifikuju određene direktorijume koji će se uključiti u potragu za pretragu.
Osim toga, MANPATH_MAP izjave dodaju na putanju pretrage u zavisnosti od putanje za pretragu komande (tj. Varijable okoline PATH ). Za svaki direktorijum koji može biti na putu za pretraživanje naredbe, MANPATH_MAP izjava određuje direktorij koji treba dodati u putanju za pretragu za ručne datoteke datoteka. čovjek gleda na varijablu PATH i dodaje odgovarajuće direktorijume na putanju za pretraživanje datoteke sa ručnom stranicom. Stoga, uz pravilnu upotrebu MANPATH_MAP-a , kada izdate komandu man xyz , dobijate manuelnu stranicu za program koji bi se pokrenuo ako ste izdali naredbu xyz .
Pored toga, za svaki direktorijum u putanji za pretragu naredbe (mi ćemo ga nazvati "komandni direktorij") za koji nemate MANPATH_MAP izraz, čovjek automatski traži priručnik katalog stranica "u blizini", odnosno kao poddirektorijum u komandni direktorij ili u matičnom direktorijumu komandnog direktorijuma.
Možete da onemogućite automatska pretraživanja "u blizini" uključivanjem NOAUTOPATH izraza u /etc/man.config .
U svakom direktorijumu u putanji pretraživanja kao što je gore opisano, čovjek traži datoteku pod nazivom tema . sa opcionalnim sufiksom na broju odseka i eventualno sa sufiksom za kompresiju. Ako ne pronađe takvu datoteku, onda se nalazi u bilo kojoj poddirektoriji nazvanim čovekom N ili cat N, gde je N broj ručnog odeljka. Ako je datoteka u poddirektorijumu cat N , čovek pretpostavlja da je formatirana ručna datoteka stranice (mačka stranica). U suprotnom, čovek pretpostavlja da nije formatiran. U oba slučaja, ako ime datoteke ima poznati sufiks kompresije (kao što je .gz ), čovek pretpostavlja da je gzipped.
Ako želite da vidite gde bi (ili ako) čovek pronašao priručnik za određenu temu, koristite opciju --path ( -w ).
Važno: Koristite komandu čovjeka ( % čovjek ) da biste videli kako se na vašem računaru koristi komanda.