MAN(1) Rokasgrāmatu lapotāja rīki MAN(1)

man - sistēmas uzziņu rokasgrāmatu saskarne

man [man_opcijas] [[sadaļa] lapa ...] ...
man -k [apropos_opcijas] regizt ...
man -K [man_opcijas] [sadaļa] termins ...
man -f [whatis opcijas] lapa ...
man -l [man_opcijas] fails ...
man -w|-W [man_opcijas] lapa ...

man ir sistēmas rokasgrāmatu lapotājs. Katrs man padotais lapas arguments parasti ir programmas, utilītas vai funkcijas nosaukums. Pēc tam tiek atrasta un parādīta katram no šiem argumentiem atbilstošā rokasgrāmatas lapa. Ja norādīta sadaļa, man meklēs tikai šajā rokasgrāmatas sadaļā. Noklusējuma darbība ir meklēt visās pieejamajās sadaļās iepriekš noteiktā secībā (skatiet NOKLUSĒJUMI) un rādīt tikai pirmo atrasto lapu, pat ja lapa eksistē vairākās sadaļās.

Zemāk esošajā tabulā parādīti rokasgrāmatas sadaļu numuri un tajās ietverto lapu tipi.

1 Izpildāmās programmas vai čaulas komandas
2 Sistēmas izsaukumi (kodola nodrošinātas funkcijas)
3 Bibliotēku izsaukumi (programmu bibliotēku funkcijas)
4 Īpašie faili (parasti atrodami /dev)
5 Failu formāti un konvencijas, piem., /etc/passwd
6 Spēles
7 Dažādi (ieskaitot makro pakotnes un konvencijas), piem., man(7), groff(7), man-pages(7)
8 Sistēmas administrēšanas komandas (parasti tikai root)
9 Kodola rutīnas [Nestandarta]

Rokasgrāmatas lapa sastāv no vairākām sadaļām.

Ierastie sadaļu nosaukumi ir NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLE, AUTHORS un SEE ALSO.

Šīs konvencijas attiecas uz sadaļu KOPSAVILKUMS, un tās var izmantot kā vadlīnijas arī citās sadaļās.

treknraksts rakstīt tieši tā, kā parādīts.
kursīvs aizstāt ar atbilstošu argumentu.
[-abc] visi vai jebkuri argumenti [ ] iekšpusē nav obligāti.
-a|-b ar | atdalītas opcijas nevar izmantot kopā.
arguments ... argumentu var atkārtot.
[izteiksme] ... visu izteiksmi [ ] iekšpusē var atkārtot.

Precīzs attēlojums var atšķirties atkarībā no izvades ierīces. Piemēram, darbojoties terminālī, man parasti nespēs attēlot kursīvu un tā vietā parasti izmantos pasvītrotu vai krāsainu tekstu.

Komandas vai funkcijas ilustrācija ir šablons, kam jāatbilst visiem iespējamiem izsaukumiem. Dažos gadījumos ieteicams ilustrēt vairākus savstarpēji izslēdzošus izsaukumus, kā parādīts šīs rokasgrāmatas lapas sadaļā KOPSAVILKUMS.

Parādīt rokasgrāmatas lapu vienumam (programmai) ls.
Parādīt makro pakotnes man rokasgrāmatas lapu no sadaļas 7. (Tas ir alternatīvs pieraksts komandai "man 7 man".)
Parādīt makro pakotnes man rokasgrāmatas lapu no sadaļas 7. (Tas ir vēl viens alternatīvs pieraksts komandai "man 7 man". Tas var būt ērtāks, kopējot un ielīmējot atsauces uz rokasgrāmatas lapām. Ņemiet vērā, ka iekavas parasti jāliek pēdiņās, lai pasargātu tās no čaulas.)
Parādīt pēc kārtas visas rokasgrāmatā esošās pieejamās intro rokasgrāmatas lapas. Starp secīgām parādīšanām var iziet vai izlaist jebkuru no tām.
Formatēt bash rokasgrāmatas lapu noklusējuma troff vai groff formātā un novadīt to uz printeri ar nosaukumu ps. groff noklusējuma izvade parasti ir PostScript. man --help vajadzētu norādīt, kurš procesors ir piesaistīts opcijai -t.
Šī komanda atspiedīs un formatēs nroff avota rokasgrāmatas lapu ./foo.1x.gz no ierīces neatkarīgā (dvi) failā. Novirzīšana ir nepieciešama, jo karogs -T liek izvadi novirzīt uz stdout bez lapotāja. Izvadi var skatīt ar tādu programmu kā xdvi vai tālāk apstrādāt uz PostScript ar tādu programmu kā dvips.
Meklēt īsajos aprakstos un rokasgrāmatas lapu nosaukumos atslēgvārdu printf kā regulāro izteiksmi. Izvadīt visas atbilstības. Līdzvērtīgs apropos printf.
Uzmeklēt rokasgrāmatas lapas, uz kurām atsaucas smail, un izvadīt visu atrasto īsos aprakstus. Līdzvērtīgs whatis smail.

man ir pieejamas daudzas opcijas, lai lietotājam nodrošinātu pēc iespējas lielāku elastību. Var mainīt meklēšanas ceļu, sadaļu secību, izvades procesoru un citas tālāk aprakstītās uzvedības un darbības.

Ja iestatīti, tiek vaicāti dažādi vides mainīgie, lai noteiktu man darbību. „Visaptverošo” mainīgo $MANOPT var iestatīt uz jebkuru virkni komandrindas formātā, ar izņēmumu, ka visām atstarpēm, kas ir daļa no opcijas argumenta, jāliek priekšā atpakaļvērstā slīpsvītra. man parsēs $MANOPT pirms savas komandrindas parsēšanas. Opcijas, kurām nepieciešams arguments, tiks ignorētas par labu tām pašām komandrindā atrastajām opcijām. Lai atiestatītu visas $MANOPT iestatītās opcijas, kā pirmo komandrindas opciju var norādīt -D. Tas ļaus man „aizmirst” par $MANOPT norādītajām opcijām, lai gan tām tomēr jābūt bijušām derīgām.

Rokasgrāmatas lapas parasti glabā nroff(1) formātā tādā direktorijā kā /usr/share/man. Dažās instalācijās var būt arī iepriekš formatētas cat lapas, lai uzlabotu veiktspēju. Kur šie faili tiek glabāti, sīkāk skatiet manpath(5).

Šī pakotne atbalsta rokasgrāmatas lapas vairākās valodās, ko nosaka jūsu lokāle. Ja jūsu sistēma to neiestatīja automātiski, jums var būt jāiestata $LC_MESSAGES, $LANG vai cits no sistēmas atkarīgs vides mainīgais, lai norādītu vēlamo lokāli, parasti POSIX formātā:

<valoda>[_<teritorija>[.<rakstzīmju_kopa>[,<versija>]]]

Ja vēlamā lapa ir pieejama jūsu lokālē, tā tiks parādīta standarta (parasti amerikāņu angļu valodas) lapas vietā.

Ja konstatējat, ka šīs pakotnes tulkojumi nav pieejami jūsu dzimtajā valodā, un vēlaties tos nodrošināt, lūdzu, sazinieties ar uzturētāju, kas koordinēs šādu darbību.

Atsevišķas rokasgrāmatas lapas parasti raksta un uztur to programmu, funkciju vai citu tēmu uzturētāji, kuras tās dokumentē, un tās nav iekļautas šajā pakotnē. Ja konstatējat, ka kādas rokasgrāmatas lapas trūkst vai tā ir nepietiekama, lūdzu, ziņojiet par to attiecīgās pakotnes uzturētājiem.

Informāciju par citām šī rokasgrāmatu lapotāja funkcijām un paplašinājumiem lūdzu lasiet pakotnei pievienotajos dokumentos.

Meklējamo sadaļu secību var mainīt ar vides mainīgo $MANSECT vai ar direktīvu SECTION failā /etc/man_db.conf. Pēc noklusējuma tā ir šāda:

1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7

Formatētā rokasgrāmatas lapa tiek parādīta, izmantojot lapotāju. To var norādīt vairākos veidos, pretējā gadījumā tiek izmantots noklusējums (sīkāk skatiet opciju -P).

Filtrus nosaka vairākos veidos. Vispirms tiek vaicāta komandrindas opcija -p vai vides mainīgais $MANROFFSEQ. Ja -p netika izmantota un vides mainīgais nav iestatīts, nroff faila pirmajā rindā tiek meklēta priekšapstrādātāju virkne. Lai saturētu derīgu priekšapstrādātāju virkni, pirmajai rindai jāizskatās šādi

'\" <virkne>

kur virkne var būt jebkura tālāk pie opcijas -p aprakstīto burtu kombinācija.

Ja neviena no iepriekš minētajām metodēm nesniedz informāciju par filtriem, tiek izmantota noklusējuma kopa.

No filtriem un primārā formatētāja (nroff vai [tg]roff ar -t) tiek izveidots un izpildīts formatēšanas konveijers. Alternatīvi, ja man koka saknē eksistē izpildāma programma mandb_nfmt (vai mandb_tfmt ar -t), tiek izpildīta tā. Tai kā argumenti tiek padots rokasgrāmatas avota fails, priekšapstrādātāju virkne un, pēc izvēles, ar -T vai -E norādītā ierīce.

Bez argumentu opcijas, kas dublētas komandrindā, $MANOPT vai abos, nekaitē. Opcijām, kurām nepieciešams arguments, katrs dublikāts ignorē iepriekšējā argumenta vērtību.

Izmantot šo lietotāja konfigurācijas failu noklusējuma ~/.manpath vietā.
Izvadīt atkļūdošanas informāciju.
Šo opciju parasti norāda kā pašu pirmo opciju, un tā atiestata man uzvedību uz noklusējumu. Tā paredzēta, lai atiestatītu opcijas, kas, iespējams, iestatītas $MANOPT. Visām opcijām, kas seko -D, būs parastā ietekme.
Iespējot groff brīdinājumus. To var izmantot rokasgrāmatas lapu avota teksta saprātīguma pārbaudēm. brīdinājumi ir ar komatiem atdalīts brīdinājumu nosaukumu saraksts; ja tas nav norādīts, noklusējums ir "mac". Lai atspējotu groff brīdinājumu, pievienojiet tam priedēkli "!": piemēram, --warnings=mac,!break iespējo brīdinājumus kategorijā "mac" un atspējo brīdinājumus kategorijā "break". Pieejamo brīdinājumu nosaukumu sarakstu skatiet info groff mezglā “Warnings”.

Aptuveni līdzvērtīgs whatis. Parādīt īso aprakstu no rokasgrāmatas lapas, ja pieejams. Sīkāk skatiet whatis(1).
Aptuveni līdzvērtīgs apropos. Meklēt atslēgvārdus rokasgrāmatas lapu īsajos aprakstos un parādīt visas atbilstības. Sīkāk skatiet apropos(1).
Meklēt tekstu visās rokasgrāmatas lapās. Tā ir pilnās pārlases meklēšana, un tā, visticamāk, aizņems kādu laiku; ja iespējams, norādiet sadaļu, lai samazinātu pārmeklējamo lapu skaitu. Meklēšanas termini var būt vienkāršas virknes (noklusējums) vai regulārās izteiksmes, ja izmantota opcija --regex.
Ņemiet vērā, ka tiek pārmeklēti rokasgrāmatas lapu avoti, nevis atveidotais teksts, tāpēc var būt kļūdaini pozitīvi rezultāti, piemēram, avota failu komentāru dēļ, vai kļūdaini negatīvi rezultāti, piemēram, tāpēc, ka avota failos defises rakstītas kā "\-". Atveidotā teksta pārmeklēšana būtu daudz lēnāka.
Aktivizēt „lokālo” režīmu. Formatēt un parādīt lokālus rokasgrāmatas failus, nevis meklēt sistēmas rokasgrāmatu kolekcijā. Katrs rokasgrāmatas lapas arguments tiks interpretēts kā pareizā formātā esošs nroff avota fails. Cat fails netiek veidots. Ja kā viens no argumentiem norādīts '-', ievade tiks ņemta no stdin.
Ja šī opcija netiek izmantota, man tāpat interpretēs rokasgrāmatas lapas argumentus kā lokālu failu nosaukumus, ja arguments satur rakstzīmi "/", jo tā ir laba norāde, ka arguments attiecas uz ceļu failu sistēmā.
Faktiski neparādīt rokasgrāmatas lapu, bet izvadīt tā nroff avota faila atrašanās vietu, kas tiktu formatēts. Ja izmantota arī opcija -a, izvadīt visu meklēšanas kritērijiem atbilstošo avota failu atrašanās vietas.
Faktiski neparādīt rokasgrāmatas lapu, bet izvadīt tā iepriekš formatētā cat faila atrašanās vietu, kas tiktu parādīts. Ja izmantota arī opcija -a, izvadīt visu meklēšanas kritērijiem atbilstošo iepriekš formatēto cat failu atrašanās vietas.
Ja izmantotas gan -w, gan -W, izvadīt gan avota failu, gan cat failu, atdalītus ar atstarpi. Ja izmantotas visas -w, -W un -a, darīt to katrai iespējamai atbilstībai.
Šī opcija nav paredzēta vispārējai lietošanai, un to drīkst izmantot tikai programma catman.
Tā vietā, lai formatētu rokasgrāmatas lapu parastajā veidā, izvadīt tās avotu, pārveidotu norādītajā kodējumā. Ja jau zināt avota faila kodējumu, varat arī tieši izmantot manconv(1). Taču šī opcija ļauj pārveidot vairākas rokasgrāmatas lapas vienā kodējumā, nenorādot katras kodējumu, ja vien tās jau ir instalētas rokasgrāmatas lapu hierarhijai līdzīgā struktūrā.
Vairāku rokasgrāmatas lapu pārveidošanai apsveriet man-recode(1) izmantošanu, jo tās saskarne ir paredzēta masveida pārveidei, tāpēc tā var būt daudz ātrāka.

man parasti nosaka jūsu pašreizējo lokāli, izsaucot C funkciju setlocale(3), kas vaicā dažādus vides mainīgos, iespējams, arī $LC_MESSAGES un $LANG. Lai uz laiku ignorētu noteikto vērtību, izmantojiet šo opciju, lai man tieši padotu lokāles virkni. Ņemiet vērā, ka tā stāsies spēkā tikai tad, kad faktiski sāksies lapu meklēšana. Tāda izvade kā palīdzības ziņojums vienmēr tiks rādīta sākotnēji noteiktajā lokālē.
Ja šai sistēmai ir piekļuve citu operētājsistēmu rokasgrāmatas lapām, tām var piekļūt ar šo opciju. Lai meklētu rokasgrāmatas lapu NewOS rokasgrāmatas lapu kolekcijā, izmantojiet opciju -m NewOS.

Norādītā sistēma var būt ar komatiem atdalītu operētājsistēmu nosaukumu kombinācija. Lai iekļautu meklēšanu vietējās operētājsistēmas rokasgrāmatas lapās, iekļaujiet argumentu virknē sistēmas nosaukumu man. Šī opcija ignorē vides mainīgo $SYSTEM.

Norādīt alternatīvu izmantojamo manpath. Pēc noklusējuma man izmanto no manpath atvasinātu kodu, lai noteiktu meklēšanas ceļu. Šī opcija ignorē vides mainīgo $MANPATH un liek ignorēt opciju -m.

Ceļam, kas norādīts kā manpath, jābūt sadaļās strukturētas rokasgrāmatas lapu hierarhijas saknei, kā aprakstīts man-db rokasgrāmatā (nodaļā "The manual page system"). Lai skatītu rokasgrāmatas lapas ārpus šādām hierarhijām, skatiet opciju -l.

Norādītais saraksts ir ar koliem vai komatiem atdalīts sadaļu saraksts, ko izmanto, lai noteiktu, kurās rokasgrāmatas sadaļās un kādā secībā meklēt. Šī opcija ignorē vides mainīgo $MANSECT. (Pieraksts -s ir saderībai ar System V.)
Dažas sistēmas galvenajā rokasgrāmatas lapu hierarhijā iekļauj lielas rokasgrāmatas lapu pakotnes, piemēram, tās, kas pievienotas pakotnei Tcl. Lai apietu problēmu, ka ir divas rokasgrāmatas lapas ar vienādu nosaukumu, piemēram, exit(3), Tcl lapas parasti visas tika iedalītas sadaļā l. Tā kā tas nav vēlams, tagad lapas ir iespējams ievietot pareizajā sadaļā un piešķirt tām noteiktu „paplašinājumu”, šajā gadījumā exit(3tcl). Parastā darbībā man priekšroku dos exit(3), nevis exit(3tcl). Lai tiktu galā ar šo situāciju un nebūtu jāzina, kurā sadaļā atrodas vajadzīgā lapa, tagad man ir iespējams padot apakšpaplašinājuma virkni, kas norāda, kurai pakotnei lapai jāpieder. Izmantojot iepriekšējo piemēru, opcija -e tcl ierobežos man meklēšanu ar lapām, kuru paplašinājums ir *tcl.
Meklējot rokasgrāmatas lapas, ignorēt reģistru. Tas ir noklusējums.
Meklēt rokasgrāmatas lapas, šķirojot reģistru.
Rādīt visas lapas, kuru nosaukuma vai apraksta jebkura daļa atbilst katram lapas argumentam kā regulārajai izteiksmei, kā apropos(1). Tā kā, meklējot regulāro izteiksmi, parasti nav saprātīga veida izvēlēties „labāko” lapu, šī opcija ietver -a.
Rādīt visas lapas, kuru nosaukuma vai apraksta jebkura daļa atbilst katram lapas argumentam, izmantojot čaulas stila aizstājējzīmes, kā apropos(1) --wildcard. Lapas argumentam jāatbilst visam nosaukumam vai aprakstam vai jāatbilst apraksta vārdu robežās. Tā kā, meklējot ar aizstājējzīmēm, parasti nav saprātīga veida izvēlēties „labāko” lapu, šī opcija ietver -a.
Ja izmantota opcija --regex vai --wildcard, salīdzināt tikai ar lapu nosaukumiem, nevis lapu aprakstiem, kā whatis(1). Pretējā gadījumā bez ietekmes.
Pēc noklusējuma man iziet pēc piemērotākās atrastās rokasgrāmatas lapas parādīšanas. Šī opcija liek man parādīt visas rokasgrāmatas lapas, kuru nosaukumi atbilst meklēšanas kritērijiem.
Šī opcija liek man atjaunināt instalēto rokasgrāmatas lapu datubāzu kešatmiņas. Tas vajadzīgs tikai retos gadījumos, un parasti labāk ir palaist mandb(8).
Pēc noklusējuma man mēģinās interpretēt komandrindā norādītus rokasgrāmatas lapu nosaukumu pārus kā līdzvērtīgus vienam rokasgrāmatas lapas nosaukumam, kas satur defisi vai pasvītru. Tas atbalsta izplatīto programmu modeli, kas realizē vairākas apakškomandas, ļaujot tām nodrošināt rokasgrāmatas lapas katrai no tām, kurām var piekļūt ar līdzīgu sintaksi, kādu izmantotu pašu apakškomandu izsaukšanai. Piemēram:
$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz

Lai atspējotu šo uzvedību, izmantojiet opciju --no-subpages.

$ man -aw --no-subpages git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz

Norādīt, kuru izvades lapotāju izmantot. Pēc noklusējuma man izmanto less, bet, ja less nav atrasts vai nav izpildāms, izmanto cat. Šī opcija ignorē vides mainīgo $MANPAGER, kas savukārt ignorē vides mainīgo $PAGER. To neizmanto kopā ar -f vai -k.

Vērtība var būt vienkāršs komandas nosaukums vai komanda ar argumentiem, un tajā var izmantot čaulas pēdiņas (atpakaļvērstās slīpsvītras, vienpēdiņas vai dubultpēdiņas). Tajā nevar izmantot cauruļvadus vairāku komandu savienošanai; ja tas nepieciešams, izmantojiet ietinējskriptu, kas parādāmo failu var saņemt kā argumentu vai standarta ievadē.

Ja kā lapotājs tiek izmantota jauna less versija, man mēģinās iestatīt tā uzvedni un dažas saprātīgas opcijas. Noklusējuma uzvedne izskatās šādi

Rokasgrāmatas lapa nosaukums(sad) line x

kur nosaukums apzīmē rokasgrāmatas lapas nosaukumu, sad — sadaļu, kurā tā atrasta, un x — pašreizējās rindas numuru. To panāk, izmantojot vides mainīgo $LESS.

Norādot -r ar virkni, šis noklusējums tiks ignorēts. Virkne var saturēt tekstu $MAN_PN, kas tiks izvērsts par pašreizējās rokasgrāmatas lapas nosaukumu un tās sadaļas nosaukumu, ieskautu "(" un ")". Noklusējuma vērtības iegūšanai izmantoto virkni varētu izteikt šādi

\ Rokasgrāmatas\ lapa\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(press h for help or q to quit)

Šeit tā ir sadalīta trīs rindās tikai lasāmības labad. Tās nozīmi skatiet less(1) rokasgrāmatas lapā. Uzvednes virkni vispirms izvērtē čaula. Visām dubultpēdiņām, atpakaļpēdiņām un atpakaļvērstajām slīpsvītrām uzvednē jāliek priekšā atpakaļvērstā slīpsvītra. Uzvednes virkne var beigties ar $, kam priekšā ir atpakaļvērstā slīpsvītra, un aiz tā var sekot citas less opcijas. Pēc noklusējuma man iestata opcijas -ix8.

Tālāk aprakstīto vides mainīgo $MANLESS var izmantot, lai iestatītu noklusējuma uzvednes virkni, ja komandrindā tā nav norādīta.

-7, --ascii
Skatot tīru ascii(7) rokasgrāmatas lapu 7 bitu terminālī vai termināļa emulatorā, dažas rakstzīmes var netikt parādītas pareizi, izmantojot latin1(7) ierīces aprakstu ar GNU nroff. Šī opcija ļauj tīras ascii rokasgrāmatas lapas ar latin1 ierīci parādīt ascii kodējumā. Tā nepārveidos nekādu latin1 tekstu. Šajā tabulā parādīti veiktie pārveidojumi: dažas tās daļas var tikt pareizi parādītas tikai, izmantojot GNU nroff latin1(7) ierīci.
Apraksts Astotnieku latin1 ascii
turpinājuma defise 255 ‐ -
aizzīme (vidējais punkts) 267 • o
akūta akcents 264 ´ '
reizināšanas zīme 327 × x

Ja latin1 kolonna tiek parādīta pareizi, jūsu terminālis, iespējams, ir iestatīts latin1 rakstzīmēm, un šī opcija nav nepieciešama. Ja latin1 un ascii kolonnas ir identiskas, jūs lasāt šo lapu, izmantojot šo opciju, vai arī man šo lapu neformatēja, izmantojot latin1 ierīces aprakstu. Ja latin1 kolonnas trūkst vai tā ir bojāta, jums, iespējams, jāskata rokasgrāmatas lapas ar šo opciju.

Šī opcija tiek ignorēta, izmantojot opcijas -t, -H, -T vai -Z, un var būt nelietderīga citām nroff versijām, kas nav GNU.

Ģenerēt izvadi rakstzīmju kodējumam, kas atšķiras no noklusējuma. Atpakaļsaderības dēļ kodējums var būt nroff ierīce, piemēram, ascii, latin1 vai utf8, kā arī īsts rakstzīmju kodējums, piemēram, UTF-8.
Parasti nroff rindu pārnesumos automātiski dala vārdus pat tad, ja tie nesatur defises, ja tas nepieciešams, lai izkārtotu vārdus rindā bez pārmērīgām atstarpēm. Šī opcija atspējo automātisko vārdu dalīšanu, tāpēc vārdi tiks dalīti tikai tad, ja tie jau satur defises.

Ja rakstāt rokasgrāmatas lapu un vienkārši vēlaties neļaut nroff dalīt vārdu nepiemērotā vietā, neizmantojiet šo opciju, bet skatiet nroff dokumentāciju; piemēram, varat ievietot vārdā "\%", lai norādītu, ka tajā vietā to drīkst dalīt, vai ievietot "\%" vārda sākumā, lai to nedalītu vispār.

Parasti nroff automātiski izlīdzina tekstu pie abām malām. Šī opcija atspējo pilno izlīdzināšanu, atstājot tekstu izlīdzinātu tikai pie kreisās malas — to dažreiz sauc par tekstu ar „robotu labo malu”.

Ja rakstāt rokasgrāmatas lapu un vienkārši vēlaties neļaut nroff izlīdzināt noteiktas rindkopas, neizmantojiet šo opciju, bet skatiet nroff dokumentāciju; piemēram, varat izmantot pieprasījumus ".na", ".nf", ".fi" un ".ad", lai uz laiku atspējotu izlīdzināšanu un aizpildīšanu.

Norādīt priekšapstrādātāju secību, kas jāpalaiž pirms nroff vai troff/groff. Ne visās instalācijās būs pilna priekšapstrādātāju kopa. Daži priekšapstrādātāji un burti, ar ko tos apzīmē: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Šī opcija ignorē vides mainīgo $MANROFFSEQ. zsoelim vienmēr tiek palaists kā pats pirmais priekšapstrādātājs.
Izmantot groff -mandoc, lai formatētu rokasgrāmatas lapu uz stdout. Šī opcija nav nepieciešama kopā ar -H, -T vai -Z.
This option is used to change groff (or possibly troff's) output to be suitable for a device other than the default. It implies -t, unless the device is an nroff device such as ascii, latin1, or utf8. Examples (as of groff 1.23.0) include dvi, latin1, pdf, ps, utf8, X75 and X100.
Šī opcija liks groff veidot HTML izvadi un parādīs šo izvadi tīmekļa pārlūkā. Pārlūku nosaka neobligātais arguments pārlūks, ja tas norādīts, vides mainīgais $BROWSER vai, ja tas nav iestatīts, kompilēšanas laikā noteikts noklusējums (parasti lynx). Šī opcija ietver -t un darbosies tikai ar GNU troff.
Šī opcija parāda groff izvadi grafiskā logā, izmantojot programmu gxditview. dpi (punkti collā) var būt 75, 75-12, 100 vai 100-12, noklusējums ir 75; -12 varianti izmanto 12 punktu bāzes fontu. Šī opcija ietver -T ar attiecīgi ierīci X75, X75-12, X100 vai X100-12.
groff palaidīs troff un pēc tam izmantos atbilstošu pēcapstrādātāju, lai veidotu izvēlētajai ierīcei piemērotu izvadi. Ja groff -mandoc ir groff, šī opcija tiek nodota groff un novērsīs pēcapstrādātāja izmantošanu. Tā ietver -t.

-?, --help
Izvadīt palīdzības ziņojumu un iziet.
Izvadīt īsu lietošanas ziņojumu un iziet.
Parādīt versijas informāciju.

0
Veiksmīga programmas izpilde.
1
Lietošanas, sintakses vai konfigurācijas faila kļūda.
2
Darbības kļūda.
3
Bērnprocess atgrieza izejas statusu, kas nav nulle.
16
Vismaz viena no lapām/failiem/atslēgvārdiem neeksistēja vai netika atrasta atbilstība.

Ja $MANPATH ir iestatīts, tā vērtība tiek izmantota kā rokasgrāmatas lapu meklēšanas ceļš.

Noklusējuma uzvedību un sīkāku informāciju par to, kā tiek apstrādāts šis vides mainīgais, skatiet manpath(5) sadaļā MEKLĒŠANAS CEĻŠ.

Ikreiz, kad man izsauc formatētāju (nroff, troff vai groff), tā pievieno $MANROFFOPT saturu formatētāja komandrindai.

Piemēram, MANROFFOPT=-P-i liek formatētājam izmantot kursīvu (ko atbalsta tikai daži termināļi), nevis pasvītrotu tekstu.

Ja $MANROFFSEQ ir iestatīts, tā vērtība tiek izmantota, lai noteiktu priekšapstrādātāju kopu, caur kuru izlaist katru rokasgrāmatas lapu. Noklusējuma priekšapstrādātāju saraksts ir atkarīgs no sistēmas.
Ja $MANSECT ir iestatīts, tā vērtība ir ar koliem atdalīts sadaļu saraksts, ko izmanto, lai noteiktu, kurās rokasgrāmatas sadaļās un kādā secībā meklēt. Noklusējums ir "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7", ja vien to neignorē direktīva SECTION failā /etc/man_db.conf.
Ja $MANPAGER vai $PAGER ir iestatīts (priekšroka tiek dota $MANPAGER), tā vērtība tiek izmantota kā rokasgrāmatas lapas parādīšanai izmantotās programmas nosaukums. Pēc noklusējuma tiek izmantots less, bet, ja less nav atrasts vai nav izpildāms, tiek izmantots cat.

Vērtība var būt vienkāršs komandas nosaukums vai komanda ar argumentiem, un tajā var izmantot čaulas pēdiņas (atpakaļvērstās slīpsvītras, vienpēdiņas vai dubultpēdiņas). Tajā nevar izmantot cauruļvadus vairāku komandu savienošanai; ja tas nepieciešams, izmantojiet ietinējskriptu, kas parādāmo failu var saņemt kā argumentu vai standarta ievadē.

Ja $MANLESS ir iestatīts, tā vērtība tiks izmantota kā lapotāja less noklusējuma uzvednes virkne, it kā tā būtu padota ar opciju -r (tātad visi teksta $MAN_PN gadījumi tiks izvērsti tāpat). Piemēram, ja vēlaties beznosacījuma kārtā iestatīt uzvednes virkni uz “mana uzvednes virkne”, iestatiet $MANLESS uz ‘-Psmana uzvednes virkne’. Opcijas -r izmantošana ignorē šo vides mainīgo.
Ja $BROWSER ir iestatīts, tā vērtība ir ar koliem atdalīts komandu saraksts, no kurām katru pēc kārtas izmanto, lai mēģinātu palaist tīmekļa pārlūku komandai man --html. Katrā komandā %s tiek aizstāts ar faila nosaukumu, kas satur groff HTML izvadi, %% tiek aizstāts ar vienu procentu zīmi (%), un %c tiek aizstāts ar kolu (:).
Ja $SYSTEM ir iestatīts, tam būs tāda pati ietekme, it kā tas būtu norādīts kā opcijas -m arguments.
Ja $MANOPT ir iestatīts, tas tiks parsēts pirms man komandrindas, un tiek sagaidīts, ka tam būs līdzīgs formāts. Tā kā visus pārējos man specifiskos vides mainīgos var izteikt kā komandrindas opcijas un tātad tie ir kandidāti iekļaušanai $MANOPT, sagaidāms, ka tie kļūs novecojuši. N.B. Visām atstarpēm, kas jāinterpretē kā daļa no opcijas argumenta, jāliek priekšā atpakaļvērstā slīpsvītra.
Ja $MANWIDTH ir iestatīts, tā vērtība tiek izmantota kā rindas garums, kādam jāformatē rokasgrāmatas lapas. Ja tas nav iestatīts, rokasgrāmatas lapas tiks formatētas ar pašreizējam terminālim atbilstošu rindas garumu (izmantojot $COLUMNS vērtību un ioctl(2), ja pieejams, vai 80 rakstzīmes, ja neviens no tiem nav pieejams). Cat lapas tiks saglabātas tikai tad, ja var izmantot noklusējuma formatējumu, t. i., ja termināļa rindas garums ir no 66 līdz 80 rakstzīmēm.
Parasti, ja izvade netiek novirzīta uz termināli (piemēram, uz failu vai cauruļvadu), formatēšanas rakstzīmes tiek atmestas, lai rezultātu būtu vieglāk lasīt bez īpašiem rīkiem. Taču, ja $MAN_KEEP_FORMATTING ir iestatīts uz jebkuru netukšu vērtību, šīs formatēšanas rakstzīmes tiek saglabātas. Tas var noderēt man ietinējiem, kas spēj interpretēt formatēšanas rakstzīmes.
Parasti, ja izvade tiek novirzīta uz termināli (parasti uz lapotāju), visa kļūdu izvade no komandas, ko izmanto rokasgrāmatas lapu formatēto versiju veidošanai, tiek atmesta, lai netraucētu lapotāja attēlojumu. Tādas programmas kā groff bieži izvada salīdzinoši nenozīmīgus kļūdu ziņojumus par tipogrāfiskām problēmām, piemēram, sliktu izlīdzinājumu, kas, parādīti kopā ar rokasgrāmatas lapu, izskatās nepievilcīgi un parasti mulsina. Taču daži lietotāji tos tomēr vēlas redzēt, tāpēc, ja $MAN_KEEP_STDERR ir iestatīts uz jebkuru netukšu vērtību, kļūdu izvade tiks rādīta kā parasti.
Linux sistēmā man parasti ierobežo apakšprocesus, kas apstrādā neuzticamus datus, izmantojot seccomp(2) smilškasti. Tas padara drošāku sarežģīta parsēšanas koda palaišanu patvaļīgām rokasgrāmatas lapām. Ja kāda iemesla dēļ, kas nav saistīts ar parādāmās lapas saturu, rodas problēmas, varat iestatīt $MAN_DISABLE_SECCOMP uz jebkuru netukšu vērtību, lai atspējotu smilškasti.
Ja vides mainīgais $PIPELINE_DEBUG ir iestatīts uz "1", man standarta kļūdu izvadē izvadīs atkļūdošanas ziņojumus, kas apraksta katru palaisto apakšprocesu.
Atkarībā no sistēmas un realizācijas, lai noteiktu pašreizējo ziņojumu lokāli, tiks vaicāts $LANG vai $LC_MESSAGES, vai abi. man parādīs savus ziņojumus šajā lokālē (ja pieejami). Precīzu informāciju skatiet setlocale(3).

/etc/man_db.conf
man-db konfigurācijas fails.
/usr/share/man
Globāla rokasgrāmatas lapu hierarhija.

POSIX.1-2001, POSIX.1-2008, POSIX.1-2017.

apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)

Dažu pakotņu dokumentācija var būt pieejama citos formātos, piemēram, info(1) vai HTML.

VĒSTURE

1990, 1991 – Sākotnēji uzrakstīja John W. Eaton (jwe@che.utexas.edu).

1992. gada 23. decembris: Rik Faith (faith@cs.unc.edu) piemēroja Willem Kasdorp (wkasdo@nikhefk.nikef.nl) sagatavotos kļūdu labojumus.

1994. gada 30. aprīlis – 2000. gada 23. februāris: Wilf. (G.Wilford@ee.surrey.ac.uk) ar dažu uzticīgu cilvēku palīdzību izstrādāja un uzturēja šo pakotni.

1996. gada 30. oktobris – 2001. gada 30. marts: Fabrizio Polacco <fpolacco@debian.org> ar visas kopienas palīdzību uzturēja un uzlaboja šo pakotni Debian projektam.

2001. gada 31. marts – mūsdienas: Colin Watson <cjwatson@debian.org> tagad izstrādā un uztur man-db.

KĻŪDAS

https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db

2026-11-16 2.13.3