NAME
man-format at ipakita ang mga pahina ng manu-manong on-line
manpath - matukoy ang path ng paghahanap ng gumagamit para sa mga pahina ng tao
SINOPSIS
tao [ -acdfFhkKtwW ] [ --path ] [ -m system ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ section ] name ...
DESCRIPTION
mga format ng tao at ipinapakita ang mga pahina ng manu-manong on-line. Kung tinukoy mo ang seksyon , tinitingnan lamang ng tao sa bahaging iyon ng manu-manong. Ang pangalan ay karaniwang ang pangalan ng manu-manong pahina, na karaniwan ay ang pangalan ng isang command, function, o file. Gayunpaman, kung ang pangalan ay naglalaman ng slash ( / ) at pagkatapos ay binibigyang kahulugan ito ng tao bilang isang detalye ng file, upang magawa mo ang tao ./foo.5 o kahit na tao / cd / foo / bar.1.gz.
Tingnan sa ibaba para sa paglalarawan ng kung saan hinahanap ng tao ang mga manu-manong pahina ng mga file.
MGA OPTION
-C config_file
Tukuyin ang configuration file na gagamitin; ang default ay /etc/man.config . (Tingnan ang man.conf (5).)
-M landas
Tukuyin ang listahan ng mga direktoryo upang maghanap ng mga pahina ng tao. Paghiwalayin ang mga direktoryo na may mga colon. Ang isang walang laman na listahan ay kapareho ng hindi tumutukoy -M sa lahat. Tingnan ang PAGHAHANAP NG PAGHAHANDA PARA SA MGA MANWALANG PAHINA .
-P pager
Tukuyin kung aling pager ang gagamitin. Binibigyang-override ng pagpipiliang ito ang MANPAGER na kapaligiran na variable, na sa turn overrides sa PAGER variable. Bilang default, ang tao ay gumagamit ng / usr / bin / less -isr .
-S section_list
Ang listahan ay isang listahan ng pinaghiwalay ng colon ng mga seksyon ng manu-manong upang maghanap. Pinipigilan ng pagpipiliang ito ang variable ng kapaligiran ng MANSECT .
-a
Bilang default, lalabas ang tao matapos ipakita ang unang pahina ng manu-manong nahahanap nito. Ang paggamit ng pagpipiliang ito ay pinipilit ang tao na ipakita ang lahat ng mga manu-manong pahina na tumutugma sa pangalan, hindi lamang ang una.
-c
Reformat ang pinagmulan ng tao na pahina, kahit na may isang pahina ng up-to-date na pusa . Ito ay maaaring maging makabuluhan kung ang pahina ng pusa ay na-format para sa isang screen na may ibang bilang ng mga haligi, o kung ang pahina na preformatted ay napinsala.
-d
Hindi talaga ipapakita ang mga pahina ng tao, ngunit huwag i-print ang mga gobs ng debugging na impormasyon.
-D
Parehong pagpapakita at pag-print ng impormasyon sa pag-debug.
-f
Katumbas ng ano .
-F o --preformat
Format lamang - huwag ipakita.
-h
Mag-print ng isang one-line na tulong na mensahe at exit.
-k
Katumbas sa mga apropos .
-K
Hanapin ang tinukoy na string sa * lahat * ng mga pahina ng tao. Babala: marahil ito ay napakabagal! Nakakatulong ito upang tukuyin ang isang seksyon. (Para lamang magbigay ng isang magaspang na ideya, sa aking makina na ito ay tumatagal ng halos isang minuto bawat 500 pahina ng tao.)
-m system
Tukuyin ang isang alternatibong hanay ng mga pahina ng tao upang maghanap batay sa ibinigay na pangalan ng system.
-p string
Tukuyin ang pagkakasunod-sunod ng mga preprocessors na tumakbo bago ang nroff o troff . Hindi lahat ng mga pag-install ay magkakaroon ng isang buong hanay ng mga preprocessor. Ang ilan sa mga preprocessors at ang mga titik na ginamit upang italaga ang mga ito ay: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), sumangguni (r). Binibigyang-override ng pagpipiliang ito ang variable ng kapaligiran ng MANROFFSEQ .
-t
Gamitin / usr / bin / groff -Tps -mandoc upang i-format ang manu-manong pahina, pagpasa sa output sa stdout. Ang output mula sa / usr / bin / groff -Tps -mandoc ay maaaring kailangang maipasa sa pamamagitan ng ilang filter o isa pa bago ma-print.
-w o --path
Hindi talaga ipapakita ang mga pahina ng tao, ngunit i-print ang (mga) lokasyon ng mga file na mai-format o ipapakita. Kung walang argumento ay ibinigay: display (sa stdout) ang listahan ng mga direktoryo na hinahanap ng tao para sa mga pahina ng tao. Kung ang manpath ay isang link sa tao, pagkatapos ay ang "manpath" ay katumbas ng "man -path".
-W
Tulad ng -w, ngunit i-print ang mga pangalan ng file sa bawat linya, nang walang karagdagang impormasyon. Ito ay kapaki-pakinabang sa mga utos ng shell tulad ng tao-aW tao | xargs ls -l
CAT PAGES
Susubukan ng tao na i-save ang mga naka-format na pahina ng tao, upang mai-save ang oras ng pag-format sa susunod na oras ang mga pahinang ito ay kinakailangan. Ayon sa kaugalian, ang mga naka-format na bersyon ng mga pahina sa DIR / manX ay naka-save sa DIR / catX, ngunit ang ibang mga mappings mula sa dir dir sa cat dir ay maaaring itukoy sa /etc/man.config . Walang mga pahina ng cat ang na-save kapag ang kinakailangang direktoryo ng pusa ay hindi umiiral. Walang nai-save na mga pahina ng pusa kapag na-format ang mga ito para sa haba ng linya na naiiba mula sa 80. Walang mga pahina ng cat ang naka-save kapag ang man.conf ay naglalaman ng linya NOCACHE.
Posible na gawing suud sa tao ang isang tao. Pagkatapos, kung ang isang direktoryo ng cat ay mayroong may-ari ng tao at mode 0755 (writable lamang ng tao), at ang mga cat file ay mayroong may-ari ng tao at mode 0644 o 0444 (writable lamang ng tao, o hindi maaaring writable sa lahat), hindi maaaring baguhin ng ordinaryong user ang mga pahina ng pusa o ilagay ang iba pang mga file sa direktoryo ng pusa. Kung ang tao ay hindi ginawa suid, pagkatapos ng isang direktoryo ng pusa ay dapat magkaroon ng mode 0777 kung ang lahat ng mga gumagamit ay dapat na magagawang umalis sa mga pahina ng cat doon.
Ang pagpipiliang -c pwersa reformatting isang pahina, kahit na ang isang kamakailang pahina ng cat ay umiiral.
PATH NG PAGHAHANAP SA MANWAL NA PAHINA
Gumagamit ang tao ng isang sopistikadong paraan ng paghahanap ng mga manu-manong pahina ng mga file, batay sa mga pagpipilian ng invocation at mga variable ng kapaligiran, ang /etc/man.config na pagsasaayos ng file, at ang ilan na binuo sa mga convention at heuristics.
Una sa lahat, kapag ang pangalan ng argumento sa tao ay naglalaman ng slash ( / ), ang tao ay naniniwala na ito ay isang file specification mismo, at walang naghahanap kasangkot.
Ngunit sa normal na kaso kung saan ang pangalan ay hindi naglalaman ng isang slash, ang tao ay naghahanap ng iba't ibang mga direktoryo para sa isang file na maaaring isang manu-manong pahina para sa paksa na pinangalanan.
Kung tinukoy mo ang opsyon ng -M pathlist , ang pathlist ay isang listahan na pinaghihiwalay ng colon ng mga direktoryo na hinahanap ng tao .
Kung hindi mo tukuyin -M ngunit itakda ang variable ng kapaligiran ng MANPATH , ang halaga ng variable na iyon ay ang listahan ng mga direktoryo na hinahanap ng tao .
Kung hindi mo tukuyin ang isang tahasang listahan ng landas na may -M o MANPATH , binubuo ng tao ang sarili nitong listahan ng landas batay sa mga nilalaman ng configuration file /etc/man.config . Ang mga pahayag ng MANPATH sa configuration file ay tumutukoy sa mga partikular na direktoryo na isasama sa path ng paghahanap.
Bukod dito, ang MANPATH_MAP statement ay idagdag sa path ng paghahanap depende sa iyong command path ng paghahanap (ibig sabihin, ang iyong PATH environment variable). Para sa bawat direktoryo na maaaring nasa landas ng paghahanap ng command, isang pahayag ng MANPATH_MAP ay tumutukoy sa isang direktoryo na dapat idagdag sa path ng paghahanap para sa manu-manong mga file ng pahina. Tumitingin ang tao sa variable ng PATH at nagdaragdag ng mga katumbas na direktoryo sa path ng paghahanap ng file ng manu-manong pahina. Kaya, sa wastong paggamit ng MANPATH_MAP , kapag nag-isyu ka ng command na tao xyz , makakakuha ka ng manu-manong pahina para sa programa na tatakbo kung binigyan mo ang command xyz .
Bilang karagdagan, para sa bawat direktoryo sa path ng paghahanap ng command (tatawagan namin itong isang "direktoryo ng utos") na kung saan wala kang pahayag na MANPATH_MAP , awtomatikong hinahanap ng tao ang isang direktang direktoryo ng pahina na "malapit" na katulad ng isang subdirektura sa command direktoryo mismo o sa parent directory ng direktoryo ng command.
Maaari mong hindi paganahin ang awtomatikong "malapit" na mga paghahanap sa pamamagitan ng pagsasama ng isang pahayag ng NOAUTOPATH sa /etc/man.config .
Sa bawat direktoryo sa path ng paghahanap tulad ng inilarawan sa itaas, hinahanap ng tao ang isang file na pinangalanang paksa . seksyon , na may isang opsyonal na suffix sa numero ng seksyon at posibleng isang suffix ng compression. Kung hindi ito mahanap ang isang file, pagkatapos ay titingnan nito sa anumang mga subdirectory na may pangalang tao N o cat N kung saan ang N ang manu-manong numero ng seksyon. Kung ang file ay nasa isang cat N subdirectory, ang tao ay ipinapalagay na ito ay isang naka-format na manu-manong pahina ng file (pahina ng pusa). Kung hindi man , ipinagpapalagay ng tao na hindi ito pinaaayos. Sa alinmang kaso, kung ang filename ay may kilalang suffix ng compression (tulad ng .gz ), ipinagpapalagay ng tao na ito ay gzipped.
Kung nais mong makita kung saan (o kung) mahanap ng tao ang manu-manong pahina para sa isang partikular na paksa, gamitin ang --path ( -w ) na opsyon.
Mahalaga: Gamitin ang command ng tao ( % man ) upang makita kung paano ginagamit ang isang utos sa iyong partikular na computer.