Scroll to navigation

MANPATH(5) /etc/manpath.config MANPATH(5)

НАЗИВ

манпутања - запис датотеке /etc/manpath.config

ОПИС

Датотека подешавања ман путање се користи помагалима странице упутства за приступање корисничким ман путањама у време покретања, да укаже које хијерархије страница упутства (ман путање) треба да се сматрају за хијерархије система и да им додели директоријуме који ће бити коришћени за складиштење кат датотека.

Ако је променљива окружења $MANPATH већ постављена, податак садржан унутар /etc/manpath.config је неће преписати.

SEARCH PATH

By default, man-db examines the user's $PATH. For each path_element found there, it adds manpath_element to the search path.

If there is no MANPATH_MAP line in the configuration file for a given path_element, then it adds all of path_element/../man, path_element/man, path_element/../share/man, and path_element/share/man that exist as directories to the search path.

It then adds any MANDATORY_MANPATH entries from the configuration file to the search path.

Finally, if the --systems option is used or the $SYSTEM environment variable is set, then that should consist of a sequence of operating system names separated by commas or colons. This acts as a template, expanding the search path once more to allow access to other operating systems' manual pages: for each system name, man-db looks for that name as a subdirectory of each entry in the search path, and adds it to the final search path if it exists. A system name of man inserts the normal search path without subdirectories. For example, if the search path would otherwise have been /usr/share/man:/usr/local/man, and $SYSTEM is set to newOS:man, then the final search path will be /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man.

The $MANPATH environment variable overrides man-db's default manual page search paths. Most users should not need to set it. Its syntax is similar to the $PATH environment variable: it consists of a sequence of directory names separated by colons. It overrides the default search path described above.

If the value of $MANPATH starts with a colon, then the default search path is added at its start. If the value of $MANPATH ends with a colon, then the default search path is added at its end. If the value of $MANPATH contains a double colon (::), then the default search path is inserted in the middle of the value, between the two colons.

ЗАПИС

Следеће врсте поља су тренутно препознате:

# напомена
Празни редови или они који почињу са # ће се сматрати напоменама и биће занемарени.
ОБАВЕЗНА_МАНПУТАЊА елемент_ман_путање
Редови овог обрасца означавају ман путање које свака самостално створена $MANPATH треба да садржи. Ово ће обично укључити /usr/man.
МАПА_МАНПУТАЊЕ елемент_путање елемент_ман_путање
Редови овог обрасца подешавају $ПУТАЊУ на $MANPATH мапирања. За сваки елемент_путање пронађен у корисничкој $ПУТАЊИ, елемент_ман_путање ће бити додат у $MANPATH.
МАПА_МАНБП елемент_ман_путање [ елемент_кат_путање ]
Редови овог обрасца показују које ман путање ће се сматрати системским ман путањама, и по могућству где би требало да се ускладиште њихове кат датотеке. Ова врста поља је нарочито важна ако је ман сетјиб програм, као што (када у датотеци подешавања система /etc/manpath.config уместо у по кориснику датотеци подешавања „.manpath“) показује којим хијерархијама страница упутства приступити као сетјиб корисник а којим као призивајући корисник.

Системске хијерархије страница упутства су обично оне ускладиштене под /usr као што су /usr/man, /usr/local/man и /usr/X11R6/man.

Ако кат странице из нарочитог елемент_ман_путање неће бити смештене или ће бити смештене на уобичајено место, елемент_кат_путање може бити изостављен.

Уобичајени кат смештај ће бити немогућ за хијерархије страница упутства прикачених само за читање и због тога могуће је навести било коју исправну хијерархију директоријума за њихово складиштење. Да би испоштовало Линукс ФССТНД кључна реч FSSTND може бити коришћена уместо стварног директоријума.

Нажалост, неопходно је навести путање ман стабла читавог система, укључујући заменске путање оперативног система као што је /usr/man/sun и било које путање НЛС језика као што је /usr/man/de_DE.88591.

Како се податак обрађује ред по ред по записаном редоследу, неопходно је за било коју ман путању која је под-хијерархија друге хијерархије да буде прва наведена, у супротном биће урађено нетачно поређење. Један пример јесте да /usr/man/de_DE.88591 мора доћи пре /usr/man.

ОДРЕЂУЈЕ кључ вредност
Редови овог обрасца одређују разне променљиве подешавања; погледајте основну датотеку подешавања за оне променљиве коришћене помагалима страничара упутства. Укључују основне путање до разних програма (као што су греп и тбл), и основне скупове аргумената до тих програма.
ОДЕЉАК одељак ...
Редови овог обрасца одређују редослед по коме одељци упутства требају бити тражени. Ако нема смерница ОДЕЉАК у датотеци подешавања, основно је:

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

Ако је дато више смерница ОДЕЉАК њихови спискови одељака ће бити надовезани.

Ако нарочито проширење није на списку (рецимо, 1mh) биће приказано са остатком одељка коме припада. Ово доводи до тога да једино морате изричито да излистате проширења ако желите да приморате нарочити редослед. Одељци са проширењима обично би требали бити близу њихових главних одељака (тј. „1 1mh 8 ...“).

ОДЕЉЦИ се прихвата као заменски назив за ову одредницу.

НАЈМАЊА_КАТ_ШИРИНА ширина
Ако је ширина терминала мања од ширине, кат странице неће бити створене (ако недостају) или приказане. Основно је 80.
НАЈВЕЋА_КАТ_ШИРИНА ширина
Ако је ширина терминала већа од ширине, кат странице неће бити створене (ако недостају) или приказане. Основно је 80.
КАТ_ШИРИНА ширина
Ако ширина није нула, кат странице ће увек бити обликоване за терминал дате ширине, без обзира на ширину терминала која се заправо користи. Ово треба обично бити унутар скупа опсега НАЈМАЊА_КАТ_ШИРИНА и НАЈВЕЋА_КАТ_ШИРИНА.
Ова опција спречава %ман%(1) да самостално створи кат странице.

ГРЕШКЕ

Ако има одступања од горњих правила, помагала страничара упутства неће радити као што је замишљено. Правила су превише сложена.

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

2022-02-10 2.10.1