man(1) man(1)
JMENO
man - zformatuje a zobrazi on-line manualove stranky
manpath - zobrazi manualove cesty uzivatele
SYNTAXE
man [-acdfhkKtwW] [-m system] [-p retezec] [-C konfiguracni soubor] [-M
cesta] [-P strankovac] [-S seznam_sekci] [sekce] jmeno ...
POPIS
man zformatuje a zobrazi on-line manualove stranky. Tato verze umi pra-
covat s promennymi prostredi MANPATH a (MAN)PAGER, proto muzete mit i
vlastni manualove stranky a vlastni program urceny ke strankovani
zformatovanych manualovych stranek. Je-li specifikovana sekce man
hleda danou stranku pouze v teto sekci. Samozrejme muzete take speci-
fikovat poradi sekci, ktere budou prohledavany a take muzete primo na
prikazove radce nebo promennymi prostredi urcit, ktere preprocesory
budou pri formatovani stranek pouzity. Obsahuje-li jmeno znak /, je
prvne vyzkouseno jako jmeno souboru, proto muzete udelat neco jako man
./neco.5 nebo man /cedecko/neco/neco_jineho.1.gz.
VOLBY
-C konfiguracni_soubor
Specifikujete jiny konfiguracni soubor. Standardni je
/etc/man.config. (Viz tez man.conf(5).)
-M cesta
Specifikuje seznam manualovy cest (zde jsou hledany manualove
stranky). Neni-li tato volba specifikovana, je pouzita promenna
prostredi MANPATH /etc/man.config.
-P strankovac
Specifikuje strankovac, kterym budou stranky prohlizeny. Tato
volba ma prednost pred MANPAGER , ktera ma prednost pred PAGER .
Standardni strankovac je /usr/bin/less-is.
-S seznam_sekci
Seznam_sekci je carkami oddeleny seznam sekci manualovych
stranek. Tato volba ma prednost pred promennou prostredi MAN-
SECT .
-a Standardni nastaveni ukonci man pote, co zobrazi prvni nalezenou
manualovou stranku. Tato volba umozni zobrazit vsechny nalezene
stranky, ktere vyhovuji zadanym kriterium.
-c Zformatuj zdroj manualove stranky i kdyz existuje jiz
zformatovana verze. Tato volba je vyznamna. je-li zformatovana
stranka prohlizena na obrazovce s jinym poctem sloupcu.
-d Nezobrazuj zformatovanou stranku, pouze vytiskni ladici infor-
mace.
-D Zobraz ladici informace i zformatovanou stranku.
-f Totez co whatis.
-h Vytiskni kratkou pomoc a skonci.
-k Totez co apropos.
-K Hledej specifikovany reteze ve *vsech* manualovych strankach.
Varovani: tato funkce je pravdepodobne velmi pomala! Specifiku-
jete-li sekci, bude to rychlejsi. (Jen pro zajimavost, na mem
pocitaci to trva priblizne minutu na 500 stranek).
-m system
Specifikuje jinou sadu manualovych stranek zavislou na zadanem
systemu.
-p retezec
Specifikuje poradi preprocesoru pred nroff nebo troff. Ne
vsechny instalace maji plnou sadu preprocesoru. Nektere prepro-
cesory a pismena pouzivana pro jejich spousteni: eqn (e), grap
(g), pic (p), tbl (t), vgrind (v), refer (r). Tato volba ma
prednost pred promennou prostredi MANROFFSEQ .
-t Pouzij /usr/bin/groff -Tps -mandoc k formatovani stranky a
vystup zobraz na stdout. Vystup z /usr/bin/groff -Tps -mandoc
je treba pred tiskem poslat pres nejake filtry.
-w nebo --path
Nezobrazuj manualove stranky, pouze vytiskni cestu(y) souboru,
ktere bys zobrazil. Neni-li zadan zadny argument: zobraz (na
standardni vystup) seznam adresaru, ktere jsou programem man
hledany. Je-li manpath link na man, potom je manpath totozne s
"man --path".
-W Podobne jako -w, ale tiskne jmena souboru po jednom na radek bez
dalsich informaci. To je uzitecne pro prikazy shellu jako napr.
man -aW man | xargs ls -l
ZFORMATOVANE STRANKY
Man se snazi ukladat jiz zformatovane manualove stranky, aby usetril
pri jejich pristim zobrazeni cas. Tradicne se zformatovane stranky z
DIR/manX ukladaji do DIR/catX, ale jina mapovani z manualoveho adresare
na adresar zformatovanych stranek je mozne specifikovat v souboru
/etc/man.config. Neexistuje-li adresar zformatovanych stranek, nejsou
ukladany zadne zformatovane stranky. Je mozne nechat man suid pro
uzivatele man. Potom, je-li majitel adresare zformatovanych stranek man
a mod je 0755 (zapisovat muze pouze vlastnik), a zformatovane stranky
maji mod 0644 nebo 0444 (zapisovat muze bud jenom majitel nebo vubec
nikdo), nemuze normalni uzivatel zmenit zformatovane stranky nebo
umistit do adresare zformatovanych stranek jine soubory. Neni-li man
suid, potom by mel mit adresar zformatovanych stranek mod 0777 aby zde
mohli vsichni uzivatele zanechat jir zformatovane stranky.
Volba -c zpusobi reformatovani stranky i kdyz jiz existuje zformatovana
stranka.
PROSTREDI
MANPATH
Je-li nastavena promenna MANPATH , jeji hodnota je vyuzivana ke
hledani zformatovanych stranek.
MANROFFSEQ
Je-li nastavena promenna prostredi MANROFFSEQ je jeji hdnota
vyuzita pro urceni poradi spousteni preprocesoru pred nroff nebo
troff. Standardne jsou stranky formatovany prvne tabulkovym pro-
cesorem a teprve pote nroffem.
MANSECT
Je-li nastvane promenna prostredi MANSECT je jeji hodnota
vyuzita k urceni sekci, ktere budou prohledavany.
MANWIDTH
Je-li nastavena promenna prostredi MANWIDTH , tak jeji hodnota
urcuje pocet sloupcu, na ktere bude stranka zformatovana. Jinak
bude stranka zformatovana na sirku obrazovky.
MANPAGER
Je-li nastavena promenna prostredi MANPAGER jeji obsah urcuje
strankovac, ktery bude pouzit pri zobrazeni zformatovane
stranky. Neni-li nastavena, je pouzita promenna PAGER . neni-li
ani tato promenna nastavena, pouzije se /usr/bin/less -is .
LANG Je-li nastavena promenna prostredi LANG jeji hodnota definuje
podadresar, ve kterem budou hledany stranky. Potom prikaz
'LANG=cz man 1 manualova_stranka' zobrazi stranku
.../cz/man1/manualova_stranka.1, nebo
NLSPATH, LC_MESSAGES, LANG
Promenne prostredi NLSPATH a LC_MESSAGES (nebo LANG jestlize
predchozi neexistuji) hraji roli pri hledani katalogu zprav.
(Anglicke zpravy jsou zkompilovany a neni pro ne treba kata-
logu.) Dejte pozor na to, ze programy jako col (1) volane pro-
gramem man pouzivaji napr. LC_CTYPE.
PATH PATH je pouzivana pri sestaveni starndardni manualove cesty.
SYSTEM SYSTEM je pouzivana ke zjisteni standardniho jmena systemu (pro
pouziti s volbou -m ).
VIZ TEZ
apropos(1), whatis(1), less(1), groff(1).
CHYBY
Volba -t je funkcni pouze, je-li instalovan program podobny programu
troff.
Uvidite-li blikajici \255 nebo <AD> misto oddelovatek, umistete 'LESS-
CHARSET=latin1' do Vaseho prostredi.
7. ledna, 1997 man(1)
