.\" Man page for format of the manpath.config data file .\" .\" Copyright (C) 1994, 1995 Graeme W. Wilford. (Wilf.) .\" Copyright (C) 2001-2019 Colin Watson. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file docs/COPYING.GPLv2 that comes with the .\" man-db distribution. .\" .\" Sat Oct 29 13:09:31 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk) .\" .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH MANPATH 5 2026-11-16 2.13.3 /etc/man_db.conf .SH NOSAUKUMS manpath \- faila /etc/man_db.conf formāts .SH APRAKSTS Manpath konfigurācijas failu izmanto rokasgrāmatas lapu utilītas, lai darbības laikā novērtētu lietotāju manpath, norādītu, kuras rokasgrāmatas lapu hierarhijas (manpath) uzskatāmas par sistēmas hierarhijām, un piešķirtu tām direktorijas cat failu glabāšanai. Ja vides mainīgais $\fBMANPATH\fP jau ir iestatīts, informācija no /etc/man_db.conf to neignorēs. .SH "MEKLĒŠANAS CEĻŠ" Pēc noklusējuma man\-db pārbauda lietotāja $\fBPATH\fP. Katram tur atrastajam \fIceļa_elementam\fP tā pievieno meklēšanas ceļam \fImanpath_elementu\fP. Ja konfigurācijas failā konkrētajam \fIceļa_elementam\fP nav rindas \fBMANPATH_MAP\fP, tad meklēšanas ceļam tiek pievienoti visi no \fIceļa_elements/../man\fP, \fIceļa_elements/man\fP, \fIceļa_elements/../share/man\fP un \fIceļa_elements/share/man\fP, kas eksistē kā direktorijas. Pēc tam tā meklēšanas ceļam pievieno visus \fBMANDATORY_MANPATH\fP ierakstus no konfigurācijas faila. Visbeidzot, ja izmantota opcija \fB\-\-systems\fP vai iestatīts vides mainīgais $\fBSYSTEM\fP, tam jāsastāv no operētājsistēmu nosaukumu virknes, atdalītu ar komatiem vai koliem. Tas darbojas kā veidne, vēlreiz izvēršot meklēšanas ceļu, lai ļautu piekļūt citu operētājsistēmu rokasgrāmatas lapām: katram sistēmas nosaukumam man\-db meklē šo nosaukumu kā apakšdirektoriju katrā meklēšanas ceļa ierakstā un, ja tā eksistē, pievieno to galīgajam meklēšanas ceļam. Sistēmas nosaukums \fBman\fP ievieto parasto meklēšanas ceļu bez apakšdirektorijām. Piemēram, ja meklēšanas ceļš citādi būtu \fI/usr/share/man:/usr/local/man\fP un $\fBSYSTEM\fP ir iestatīts uz \fInewOS:man\fP, tad galīgais meklēšanas ceļš būs \fI/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man/newOS:\:/usr/local/man\fP. Vides mainīgais $\fBMANPATH\fP ignorē man\-db noklusējuma rokasgrāmatas lapu meklēšanas ceļus. Lielākajai daļai lietotāju to nevajadzētu iestatīt. Tā sintakse ir līdzīga vides mainīgajam $\fBPATH\fP: tas sastāv no ar koliem atdalītu direktoriju nosaukumu virknes. Tas ignorē iepriekš aprakstīto noklusējuma meklēšanas ceļu. Ja $\fBMANPATH\fP vērtība sākas ar kolu, noklusējuma meklēšanas ceļš tiek pievienots tās sākumā. Ja $\fBMANPATH\fP vērtība beidzas ar kolu, noklusējuma meklēšanas ceļš tiek pievienots tās beigās. Ja $\fBMANPATH\fP vērtība satur dubultkolu (\fB::\fP), noklusējuma meklēšanas ceļš tiek ievietots vērtības vidū starp abiem koliem. .SH FORMĀTS Pašlaik tiek atpazīti šādi lauku tipi: .TP \fB#\fP\fI\ komentārs\fP Tukšas rindas vai rindas, kas sākas ar \fB#\fP, tiks uzskatītas par komentāriem un ignorētas. .TP \fBMANDATORY_MANPATH\fP\fI\ manpath_elements\fP Šādas formas rindas norāda manpath, kam jābūt katrā automātiski ģenerētajā $\fBMANPATH\fP. Parasti tas ietver \fI/usr/man\fP. .TP \fBMANPATH_MAP\fP\fI\ ceļa_elements\ manpath_elements\fP Šādas formas rindas iestata $\fBPATH\fP uz $\fBMANPATH\fP attēlojumus. Katram lietotāja $\fBPATH\fP atrastajam \fIceļa_elementam\fP $\fBMANPATH\fP tiks pievienots \fImanpath_elements\fP. .TP \fBMANDB_MAP \fP\fImanpath_elements \fP\|[\| \fIcatpath_elements\fP \|] Šādas formas rindas norāda, kuri manpath uzskatāmi par sistēmas manpath un, pēc izvēles, kur glabājami to cat faili. Šis lauka tips ir īpaši svarīgs, ja \fBman\fP ir setuid programma, jo (ja tas ir sistēmas konfigurācijas failā /etc/man_db.conf, nevis lietotāja konfigurācijas failā .manpath) tas norāda, kurām rokasgrāmatas lapu hierarhijām piekļūt kā setuid lietotājam un kurām — kā izsaucējam lietotājam. Sistēmas rokasgrāmatas lapu hierarhijas parasti ir tās, kas glabājas zem \fI/usr\fP, piemēram, \fI/usr/man\fP, \fI/usr/local/man\fP un \fI/usr/X11R6/man\fP. Ja cat lapas no konkrēta \fImanpath_elementa\fP nav jāglabā vai jāglabā tradicionālajā vietā, \fIcatpath_elementu\fP var izlaist. Tradicionālais cat izvietojums nebūtu iespējams tikai lasīšanai montētās rokasgrāmatas lapu hierarhijās, tāpēc to glabāšanai ir iespējams norādīt jebkuru derīgu direktoriju hierarhiju. Lai ievērotu \fBLinux FSSTND\fP, īstas direktorijas vietā var izmantot atslēgvārdu \fBFSSTND\fP. Diemžēl ir jānorāda \fBvisi\fP sistēmas man koka ceļi, ieskaitot alternatīvo operētājsistēmu ceļus, piemēram, \fI/usr/man/sun\fP, un visus \fBNLS lokāļu\fP ceļus, piemēram, \fI/usr/man/de_DE.88591\fP. Tā kā informācija tiek parsēta rindu pa rindai rakstītajā secībā, katram manpath, kas ir citas hierarhijas apakšhierarhija, jābūt norādītam pirmajam, citādi tiks konstatēta nepareiza atbilstība. Piemēram, \fI/usr/man/de_DE.88591\fP jābūt pirms \fI/usr/man\fP. .TP \fBDEFINE\fP\fI\ atslēga\ vērtība\fP Šādas formas rindas definē dažādus konfigurācijas mainīgos; rokasgrāmatu lapotāja utilītu izmantotos mainīgos skatiet noklusējuma konfigurācijas failā. Tie ietver dažādu programmu (piemēram, \fIgrep\fP un \fItbl\fP) noklusējuma ceļus un šo programmu noklusējuma argumentu kopas. .TP \fBSECTION\fP \fIsadaļa\fP .\|.\|. .RS Šādas formas rindas nosaka secību, kādā jāpārmeklē rokasgrāmatas sadaļas. Ja konfigurācijas failā nav direktīvu \fBSECTION\fP, noklusējums ir: .PP .RS .nf .if !'po4a'hide' SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 .fi .RE .PP Ja norādītas vairākas \fBSECTION\fP direktīvas, to sadaļu saraksti tiks apvienoti. .PP Ja kāds paplašinājums nav šajā sarakstā (piemēram, 1mh), tas tiks parādīts kopā ar pārējo sadaļu, kurai tas pieder. Tas nozīmē, ka paplašinājumi jānorāda skaidri tikai tad, ja vēlaties piespiest noteiktu secību. Sadaļām ar paplašinājumiem parasti jābūt blakus savai galvenajai sadaļai (piem.,\& "1 1mh 8 ..."). .PP \fBSECTIONS\fP tiek pieņemts kā alternatīvs šīs direktīvas nosaukums. .RE .TP \fBMINCATWIDTH\fP\fI\ platums\fP Ja termināļa platums ir mazāks par \fIplatumu\fP, cat lapas netiks veidotas (ja trūkst) vai rādītas. Noklusējums ir 80. .TP \fBMAXCATWIDTH\fP\fI\ platums\fP Ja termināļa platums ir lielāks par \fIplatumu\fP, cat lapas netiks veidotas (ja trūkst) vai rādītas. Noklusējums ir 80. .TP \fBCATWIDTH\fP\fI\ platums\fP Ja \fIplatums\fP nav nulle, cat lapas vienmēr tiks formatētas norādītā platuma terminālim neatkarīgi no faktiski izmantotā termināļa platuma. Tas ignorē \fBMINCATWIDTH\fP un \fBMAXCATWIDTH\fP. .TP .if !'po4a'hide' .B NOCACHE Šis karogs neļauj \fBman\fP(1) automātiski veidot cat lapas. .SH KĻŪDAS Ja iepriekš minētās kārtulas netiek precīzi ievērotas, rokasgrāmatu lapotāja utilītas nedarbosies, kā vēlams. Kārtulas ir pārāk sarežģītas. .PP .if !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db