NAME
man-format dhe të shfaqin faqet manuale në internet
manpath - përcakton rrugën e kërkimit të përdoruesit për faqet e njeriut
PËRMBLEDHJE
njeri [ -acdfFhkKtwW ] [ --path ] [ -m sistemi ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ seksioni ] emri ...
PËRSHKRIM
man formatet dhe tregon faqet në internet manual. Nëse specifikoni seksionin , njeriu duket vetëm në atë pjesë të manualit. emri është zakonisht emri i faqes manuale, e cila zakonisht është emri i një komande, funksioni ose skedari. Megjithatë, nëse emri përmban një prerje ( / ) atëherë njeriu e interpreton atë si një specifikim skedari, kështu që ju mund të bëni njeriun ./foo.5 ose edhe njeriun /cd/foo/bar.1.gz .
Shihni më poshtë për një përshkrim të vendit ku njeriu kërkon skedarët e faqeve manuale.
OPSIONE
-C config_file
Specifikoni skedarin e konfigurimit për tu përdorur; parazgjedhja është /etc/man.config . (Shihni man.conf (5).)
-M rrugë
Specifikoni listën e drejtorive për të kërkuar faqet e njeriut. Ndani drejtoritë me dy pika. Një listë e zbrazët është e njëjtë sikur të mos specifikosh -M në të gjitha. Shihni PASHIN E KËRKIMIT PËR FAQET MANUAL .
-P pager
Specifikoni cilën pager do të përdorni. Ky opsion anashkalon ndryshoren e mjedisit MANPAGER , i cili në anën tjetër anashkalon variablin PAGER . By default, njeriu përdor / usr / bin / less -isr .
-S seksion_list
Lista është një listë me dy pika të seksioneve manuale për të kërkuar. Ky opsion anashkalon ndryshoren mjedisore MANSECT .
-a
By default, njeriu do të dalë pas shfaqjes së faqes së parë manuale që gjen. Duke përdorur këtë opsion detyron njeriun të shfaqë të gjitha faqet manuale që përputhen me emrin, jo vetëm të parat.
-c
Riformatoni faqen burimore të burimit, edhe kur ekziston një faqe mace e azhurnuar. Kjo mund të jetë me kuptim nëse faqja e maceve është formatuar për një ekran me një numër të ndryshëm të kolonave, ose nëse faqja e paraformuar është e korruptuar.
-d
Mos shfaq në të vërtetë faqet e njeriut, por shtypni gobs të informacionit debugging.
-D
Të dyja shfaqin dhe shtypin informacionet e debugging.
-f
Ekuivalent me atë .
-F ose --preformat
Vetëm formati - mos shfaq.
-h
Shtypni një mesazh ndihme me një vijë dhe dilni.
-K
Ekuivalent me apropos .
-K
Kërkoni stringin e specifikuar në të gjitha * faqet e njeriut. Paralajmërim: kjo ndoshta është shumë e ngadaltë! Ndihmon në përcaktimin e një seksioni. (Vetëm për të dhënë një ide të përafërt, në makinën time kjo merr rreth një minutë për 500 faqe të njeriut.)
-m sistemit
Specifikoni një grup alternativ për faqet e njeriut për të kërkuar bazuar në emrin e dhënë të sistemit.
-p string
Specifikoni sekuencën e preprocessorëve për të kandiduar para nroff ose troff . Jo të gjitha instalimet do të kenë një sërë preprocessorësh. Disa nga preprocesorët dhe letrat që përdoren për të përcaktuar ato janë: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refero (r). Ky opsion anashkalon ndryshoren e mjedisit MANROFFSEQ .
-T
Përdorni / usr / bin / groff -Tps -mandoc për të formatuar faqen manuale, duke kaluar prodhimin në stdout. Prodhimi nga / usr / bin / groff -Tps -mandoc duhet të kalojë përmes një filtri ose një tjetër përpara se të printohet.
-w ose - path
Mos shfaqni në të vërtetë faqet e njeriut, por printoni vendndodhjen e dosjeve që do të jenë të formatuara ose të shfaqura. Nëse nuk jepet asnjë argument: shfaqni (në stdout) listën e drejtorive që kërkohen nga njeriu për faqet e njeriut. Nëse manpati është një lidhje me njeriun, atëherë "manpath" është e barabartë me "njeri - rrugë".
-W
Ashtu si -w, por emrat e skedarëve shtypen një në rresht, pa informacion shtesë. Kjo është e dobishme në komandat shell si njeriu aW man. | xargs ls -l
FAQET CAT
Njeriu do të përpiqet të ruajë faqet e formatuara të njeriut, me qëllim që të kursejë kohën e formatimit herën tjetër kur këto faqe janë të nevojshme. Tradicionalisht, versionet e formatuara të faqeve në DIR / manX janë ruajtur në DIR / catX, por harta të tjera nga man dir në cat dir mund të specifikohen në /etc/man.config . Asnjë faqe mace nuk ruhet kur dosja e kërkuar e cat nuk ekziston. Asnjë faqe mace nuk ruhet kur formatohen për një gjatësi të linjës të ndryshme nga 80. Asnjë faqe mace nuk është ruajtur kur man.conf përmban linjën NOCACHE.
Është e mundur që njeriu t'i jepet një përdoruesi. Pastaj, nëse një dosje cat ka pronar njeri dhe mode 0755 (vetëm shkruhet nga njeriu), dhe skedarët cat kanë pronar njeriu dhe mode 0644 ose 0444 (vetëm mund të shkruhet nga njeriu ose nuk mund të shkruhet fare), asnjë përdorues i zakonshëm nuk mund të ndryshojë faqet e maces ose vendosni skedarë të tjerë në dosjen e cat. Nëse njeriu nuk është i pajisur, atëherë një direktori cat duhet të ketë modë 0777 nëse të gjithë përdoruesit duhet të jenë në gjendje të lënë faqet e maces aty.
Opsioni -c forca riformatimin e një faqeje, edhe nëse ekziston një faqe e fundit për cat.
KUTI I KËRKIMIT PËR FAQET MANUALE
njeriu përdor një metodë të sofistikuar për gjetjen e skedarëve të faqeve manuale, bazuar në opsionet e invokimit dhe variablat e mjedisit, skedari i konfigurimit /etc/man.config dhe disa të ndërtuara në konventa dhe heuristikë.
Para së gjithash, kur argumenti i emrit të njeriut përmban një prerje ( / ), njeriu supozon se është një specifikim i skedarit në vetvete, dhe nuk ka kërkime të përfshira.
Por në rastin normal ku emri nuk përmban një prerje, njeriu kërkon një shumëllojshmëri të drejtorive për një skedar që mund të jetë një faqe manuale për temën e quajtur.
Nëse specifikoni opsionin -M pathlist , lista e shtegut është një listë e ndara me dy pika e drejtorive që kërkon njeriu .
Nëse nuk specifikoni -M por caktoni ndryshoren e mjedisit MANPATH , vlera e asaj ndryshore është lista e drejtorive që kërkon njeriu .
Nëse nuk specifikoni një listë të qartë të rrugës me -M ose MANPATH , njeriu zhvillon listën e vet të rrugës bazuar në përmbajtjen e skedarit të konfigurimit /etc/man.config . Deklaratat MANPATH në skedën e konfigurimit identifikojnë drejtoritë e veçanta për t'u përfshirë në rrugën e kërkimit.
Për më tepër, deklaratat MANPATH_MAP shtojnë rrugën e kërkimit në varësi të rrugës së kërkimit tuaj të komandës (dmth. Ndryshorja e mjedisit tuaj PATH ). Për çdo direktori që mund të jetë në rrugën e kërkimit të komandës, një deklaratë MANPATH_MAP përcakton një direktori që duhet të shtohet në shtegun e kërkimit për skedarët e faqeve manuale. njeriu shikon në variablin PATH dhe shton drejtoritë përkatëse në rrugën e kërkimit të skedarëve të faqes me dorë. Kështu, me përdorimin e duhur të MANPATH_MAP , kur lëshoni komandën njeri xyz , ju merrni një faqe manuale për programin që do të kandidojë nëse keni lëshuar komandën xyz .
Për më tepër, për çdo dosje në rrugën e kërkimit të komandës (ne do ta quajmë një "komandë komandimi") për të cilën nuk ke një deklaratë MANPATH_MAP , njeriu kërkon automatikisht një faqe të manualit "pranë", si një nënndarje në komanda e komandës vetë ose në dosjen prindore të dosjes së komandave.
Ju mund të çaktivizoni kërkimet automatike "afër" duke përfshirë një deklaratë NOAUTOPATH në /etc/man.config .
Në çdo dosje në rrugën e kërkimit siç përshkruhet më lart, njeriu kërkon një skedar të quajtur temë . seksion , me një sufiksin opsional në numrin e seksionit dhe ndoshta një sugjerim compression. Nëse nuk gjen një skedar të tillë, atëherë ajo duket në çdo nën-direktori të quajtur njeriu N ose cat N ku N është numri i seksionit manual. Nëse skedari është në një nën-drejtori të cat N , njeriu supozon se është një skedar i faqeve me format të formatuar (faqe mace). Përndryshe, njeriu supozon se nuk është i formatuar. Në secilin rast, nëse emri i skedarit ka një prapashtesë të njohur të compression (si .gz ), njeriu supozon se është gzipped.
Nëse dëshironi të shihni se ku (ose nëse) njeriu do të gjejë faqen manuale për një temë të caktuar, përdorni opsionin --path ( -w ).
E rëndësishme: Përdorni komandën e njeriut ( % man ) për të parë se si përdoret një komandë në kompjuterin tuaj të veçantë.