Komanda vīrietis uz Linux ir iegulta katra Linux izstrādātāja un lietotāja muskuļu atmiņā. To lieto burtiski visi; no amatieru un iesācēju izstrādātājiem līdz Linux profesionāļiem un ekspertiem.
To izmanto, lai lasītu komandrindas rokasgrāmatas lapu Linux komandai, konfigurācijas failam vai jebkurai citai funkcijai. Manuālās lapas parasti tiek instalētas kopā ar programmatūras instalēšanu operētājsistēmā Linux. Manuālām lapām ir noteikta sintakse, ko parsē komanda.
Izveidosim man lapu šādam bash skriptam, ko esmu uzrakstījis:
#!/bin/bash if [ "$1" == "h" ]; tad echo "Sveiki" fi if [ "$1" = "b" ]; tad atbalss "Bye" fiŠis skripts veic tikai divas lietas: tas izdrukā "Hello", ja opcija "h" ir norādīta kā arguments, un tas izdrukā "Bye", ja opcija "b" ir norādīta kā arguments.
Izveidosim šīs programmas man lapu. Izmantot vim vai jebkuru jūsu izvēlētu redaktoru, lai izveidotu teksta failu.
vim tests.1Paplašinājums “.1” norāda, ka šī man lapa ir paredzēta izpildāmai komandai. Tā nav piespiedu kārtā, bet gan plaši ievērota konvencija, rakstot man lapas. Rokasgrāmatas lapa cilvēkam (vīrietis vīrietis !) uzskaita kategorijas:
1 Izpildāmās programmas vai čaulas komandas 2 Sistēmas izsaukumi (funkcijas, ko nodrošina kodols) 3 Bibliotēkas izsaukumi (funkcijas programmu bibliotēkās) 4 Īpaši faili (parasti atrodami /dev) 5 Failu formāti un konvencijas, piemēram, /etc/passwd 6 Spēles 7 Dažādi ( ieskaitot makro pakotnes un konvencijas), piemēram, man(7), groff(7) 8 Sistēmas administrēšanas komandas (parasti tikai root) 9 Kodola rutīnas [Nestandarta]Man lapa tiek izveidota, izmantojot ļoti veco roff iezīmēšanas valodu. Tam ir komandas (lasīt marķierus) dažādiem nosaukumiem un sadaļām.
.TH– Šai ir jābūt pirmajai komandai man failā. To izmanto, lai norādītu mana lapas virsrakstu..SH– Sadaļas virsraksts..B– To izmanto, lai blakus esošo tekstu parādītu treknrakstā..TP– To izmanto, lai parādītu informāciju par komandas argumentu (karodziņu)..BR– To izmanto, lai parādītu tekstu treknrakstā un parastajā romiešu fontā.
Tālāk ir manas programmas rokasgrāmata, kas izveidota, izmantojot tikai iepriekš minētās (vienkāršās) roff komandas.
.TH test.sh 1 .SH NOSAUKUMS test.sh \- Drukāt Hello or Bye .SH KOPSAVILKUMS .B test.sh [ h ] [ b ] .SH APRAKSTS .B test.sh Šis ir skripta paraugs, kas veic tikai 2 lietas . Tas vai nu izdrukā "Hello", ja arguments ir "h", vai tas izdrukā "Bye", ja arguments ir "b". SH OPTIONS .TP .BR h Drukāt Hello .TP .BR b Drukāt ByeSaglabājiet failu vispirms nospiežot ESC taustiņu un pēc tam ierakstiet :wq lai saglabātu failu un izietu no vim konsoles.
Pārbaudiet tikko izveidoto man lapu, izmantojot tālāk norādīto komandu:
cilvēks ./test.1
Lai iegūtu vairāk informācijas par vīrietis lietošana, palaist man-lapas komanda terminālī.
? Padoms
Šī ir galvenā sintakse man lapu rakstīšanai. Lai atvieglotu darbību, varat izmantot tādus rīkus kā txt2man, lai konvertētu failu kādā iezīmēšanas valodas formātā uz roff formātu.