2. EL 6 ELS
  3. man
  4. man(1)

Scroll to navigation

man(1) General Commands Manual man(1)

IME

man - oblikovanje in prikaz strani on-line priročnika
manpath - prikaz poti do imenikov, kjer man išče priročnike

SINTAKSA

man [-adfhkKtwW] [-m sistem] [-p niz] [-C nastavitvena_datoteka] [-M pot] [-P paginator] [-S seznam_poglavij] [poglavje] ime ...

OPIS

man oblikuje in prikaže strani on-line priročnika. Ta izvedba pozna spremenljivki MANPATH in (MAN)PAGER, tako da si lahko pripravite lasten nabor osebnih strani priročnika in izberete vaš najljubši program za prikaz oblikovanih strani. Če je določeno poglavje, man išče samo v tem poglavju priročnika. Iz ukazne vrstice ali prek spremenljivk okolja lahko določite tudi vrsti red poglavij, ki jih man preišče, ter katere predprocesorje se pred prikazom uporabijo na izvornem besedilu. Če ime vsebuje znak /, se najprej preveri, če obstaja datoteka s tem imenom. Ukaz man ./foo.5 ali celo man /cd/foo/bar.1.gz. sta zato povsem veljavna.

IZBIRE

Določimo nastavitveno datoteko man.conf, ki jo želimo uporabljati; privzeta izbira je /etc/man.config. (glejte man.conf(5).)
Določimo seznam imenikov, v katerih se išče za stranmi priročnika. Če izbira ni podana, se uporabi spremenljivka okolja MANPATH Če tudi spremenljivke s tem imenom ni, se uporabi privzeta izbira iz nastavitvene datoteke /etc/man.config. Prazen niz v MANPATH implicira privzet seznam imenikov.
Določimo paginator. Ta izbira ima prednost pred spremenljivko okolja MANPAGER, ki ima nadalje prednost pred spremenljivko okolja PAGER. Privzeta izbira za paginator je /usr/bin/less-is.
Seznam_poglavij je z dvopičji ločen seznam poglavij priročnika, v katerem se išče geslo. Ta izbira ima prednost pred spremenljivko okolja MANSECT.
Sam po sebi man prikaže prvo stran, ki ustreza imenu name. S to izbiro zahtevamo, da prikaže vse strani, ki ustrezajo pogoju, ne le prve.
Izrecno zahtevamo ponovno oblikovanje strani, četudi že oblikovana stran obstaja. Izbira je lahko smiselna, če je bila stran oblikovana za drugačno širino zaslona.
Ne prikaži oblikovane strani, ampak le "debugging" informacije.
Prikaži tako oblikovano stran kot tudi "debugging" informacije.
Isto kot whatis.
Izpiši eno vrstico navodila in končaj.
Isto kot apropos.
Preišči *vse* strani priročnika za dani niz. Pozor: to zelo verjetno vzame kar nekaj časa! Hitreje gre, če iskanje omejimo na poglavje. (Kot grob primer: na avtorjevem računalniku traja iskanje prek 500 strani priročnika približno minuto.)
Določimo alternativni nabor strani priročnika na podanem sistemu.
Določimo zaporedje predprocesorjev, ki se poženejo pred nroff ali troff. Nekateri od predprocesorjev, in njihove enočrkovne okrajšave: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Ni nujno, da so na vašem sistemu vsi našteti predprocesorji na voljo. Ta izbira ima prednost pred spremenljivko okolja MANROFFSEQ.
Uporabi /usr/bin/groff -Tps -mandoc za oblikovanje strani priročnika in usmeri izhod na standardni izhod stdout. Lahko, da je izhod iz /usr/bin/groff -Tps -mandoc pred tiskom potrebno obdelati s še kakšnim filtrom.
Ne prikaži oblikovanih strani priročnika, ampak pot do datotek, ki bi bile oblikovane in prikazane. Če je izbira brez argumenta, prikaži pot do imenikov, v katerih man išče strani priročnika. Če je manpath povezava na man, tedaj je "manpath" enakovredno "man --path".
Kot -w, le da prikaže po eno ime datoteke v vrstici in brez dodatnih informacij. To je lahko uporabno v ukazih ukazne lupine, kot npr. man -aW man | xargs ls -l

OBLIKOVANE STRANI

Man poskusi shraniti oblikovane strani in tako prihraniti čas, potreben za oblikovanje, ko se stran naslednjič rabi. Tradicionalno se oblikovane strani iz imenikov DIR/manX shranjujejo v imenike DIR/catX, drugačen dogovor glede preslikave med izvornimi in oblikovanimi različicami pa je možno določiti v /etc/man.config. Oblikovane strani se ne shranijo, če ustrezni imenik ne obstaja.

tem primeru, kadar je imenik z oblikovanimi stranmi v lasti man, način zaščite pa 0755 (dovoljeno pisanje samo lastniku -- man), oblikovane datoteke pa so zaščitene z 0644 ali 0444 (dovoljeno pisanje samo lastniku, ali pa sploh prepovedano pisanje), nihče od uporabnikov ne more ne more spreminjati oblikovanih strani ali puščati svojih datotek v imeniku z oblikovanimi stranmi. Če man ni v lasti (SUID) uporabnika man, mora biti imenik z oblikovanimi stranmi dovoljen za pisanje (0777), če naj bo tam vsem uporabnikom dovoljeno puščati oblikovane strani.
oblikovana stran že obstaja.

SPREMENLJIVKE OKOLJA

Če nastavimo spremenljivko MANPATH, se njena vrednost uporabi za pot do strani priročnika.
Če nastavimo spremenljivko MANROFFSEQ, z njeno vrednostjo določimo zaporedje predprocesorjev, ki obdelajo stran pred nroff ali troff. Privzeta izbira je tabelarni predprocesor tbl.
Če nastavimo spremenljivko MANSECT, njena vrednost določa poglavja v priročniku, v katerih man išče zahtevano stran.
Če nastavimo spremenljivko MANWIDTH, njena vrednost določa širino zaslona, za katero se oblikujejo strani priročnika. Privzeta izbira je cela širina zaslona.
Če nastavimo spremenljivko MANPAGER, njena vrednost določa paginator -- program, ki prikaže oblikovano stran. Če spremenljivka ni nastavljena, se uporabi vrednost spremenljivke PAGER. Če tudi ta ni nastavljena, se uporabi privzeta izbira /usr/bin/less -is.
Če nastavimo spremenljivko LANG, njena vrednost določa podimenik, v katerem man najprej poskusi poiskati stran priročnika. Na primer, pri ukazu ,,LANG=dk man 1 foo'' man najprej poskusi poiskati ustrezno stran priročnika v datoteki .../dk/man1/foo.1, če ta ne obstaja, pa v .../man1/foo.1. Pri tem je ... eden od imenikov, v katerih man išče strani.
Spremenljivki NLSPATH in LC_MESSAGES (ali LANG če LC_MESSAGES ne obstaja) določajo katalog s sporočili programa. (Angleška sporočila so izjema, ker so že vključena v program, tako da zanje ne potrebujemo posebnega kataloga.) Programi kot npr. col(1), ki ga kliče man, prav tako uporabljajo lokalizacijske spremenljivke (npr. LC_CTYPE).
PATH se uporablja za sestavljanje privzete poti, v katerih man išče strani priročnika.
SYSTEM se uporablja za določitev imena alternativnega sistema (z izbiro -m).

GLEJTE TUDI

apropos(1), whatis(1), less(1), groff(1).

NAPAKE

The -t deluje samo, kadar je na voljo troff ali drug enakovreden program.
Če namesto pomišljajev vidite utripajoče \255 or <AD>, dodajte med spremenljivke okolja `LESSCHARSET=latin1'.

2. september 1995