156 lines
6.7 KiB
HTML
156 lines
6.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANPATH</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANPATH</H1>
|
|
Section: /etc/manpath.config (5)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAZWA</H2>
|
|
|
|
manpath - format pliku /etc/manpath.config
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OPIS</H2>
|
|
|
|
Plik konfiguracyjny ścieżek przeszukiwania stron podręcznika stosowany jest
|
|
przez narzędzia obsługi stron podręcznika do oszacowania ścieżek manpath
|
|
użytkowników na bieżąco, podczas wykonywania programu. Wskazuje, jakie
|
|
hierarchie stron man (manpaths) powinny być traktowane jako globalne oraz
|
|
przypisuje im katalogi, które będą użyte do składowania plików cat.
|
|
<P>
|
|
Jeżeli jest już ustawiona zmienna środowiska $<B>MANPATH</B>, to informacja
|
|
zawarta w /etc/manpath.config nie będzie jej nadpisywać.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>FORMAT</H2>
|
|
|
|
Obecnie rozpoznawane są następujące typy pól:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>#</B><I> komentarz</I><DD>
|
|
Wiersze puste bądź rozpoczynające się znakiem <B>#</B> zostaną uznane za
|
|
komentarze i zignorowane.
|
|
<DT id="2"><B>MANDATORY_MANPATH</B><I> element_manpath</I><DD>
|
|
Wiersze tej postaci wskazują ścieżki man, które powinna zawierać każda
|
|
automatycznie utworzona wartość zmiennej $<B>MANPATH</B>. Zwykle obejmuje to
|
|
<I>/usr/man</I>.
|
|
<DT id="3"><B>MANPATH_MAP</B><I> element_path element_manpath</I><DD>
|
|
Wiersze tej postaci ustawiają odwzorowania $<B>PATH</B> na $<B>MANPATH</B>. Dla
|
|
każdego <I>elementu_path</I> znalezionego w ścieżce $<B>PATH</B> użytkownika do
|
|
zmiennej <B>$</B>MANPATH zostanie dodany <I>element_manpath</I>.
|
|
<DT id="4"><B>MANDB_MAP </B><I>element_manpath </I>[ <I>element_catpath</I> ]<DD>
|
|
Wiersze tej postaci wskazują, które ścieżki man powinny być traktowane jako
|
|
systemowe, i opcjonalnie, gdzie powinny być składowane ich pliki cat. Ten
|
|
typ pola jest szczególnie ważny, gdy <B>man</B> jest programem setuid, gdyż
|
|
(jeżeli jest umieszczony w systemowym pliku konfiguracyjnym
|
|
/etc/manpath.config, a nie w pliku konfiguracyjnym użytkownika .manpath)
|
|
mówi, do których hierarchii (katalogów) stron man należy sięgać jako
|
|
użytkownik setuid, a do których jako użytkownik wywołujący program.
|
|
<P>
|
|
Systemowe hierarchie stron man są zwykle składowane wewnątrz katalogu
|
|
<I>/usr</I> jak na przykład <I>/usr/man</I>, <I>/usr/local/man</I> czy
|
|
<I>/usr/X11R6/man</I>.
|
|
<P>
|
|
Jeśli strony cat z danej ścieżki <I>element_manpath</I> mają nie być
|
|
przechowywane albo mają być składowane w tradycyjnym miejscu, to
|
|
<I>element_catpath</I> można pominąć.
|
|
<P>
|
|
Traditional cat placement would be impossible for read only mounted manual
|
|
page hierarchies and because of this it is possible to specify any valid
|
|
directory hierarchy for their storage. To observe the <B>Linux FSSTND</B> the
|
|
keyword <B>FSSTND</B> can be used in place of an actual directory.
|
|
<P>
|
|
Niestety, niezbędne jest podanie <B>wszystkich</B> systemowych ścieżek drzew
|
|
man, łącznie ze ścieżkami kolejnych systemów, jak np. <I>/usr/man/sun</I> czy
|
|
też ścieżki <B>NLS locale</B>, takie jak <I>/usr/man/de_DE.88591</I>.
|
|
<P>
|
|
Ponieważ informacja jest analizowana wiersz po wierszu, w kolejności zapisu,
|
|
każda ścieżka manpath będąca podhierarchią innej hierarchii powinna być
|
|
podana jako pierwsza. W przeciwnym razie zostaną wykonane niepoprawne
|
|
dopasowania. Na przykład <I>/usr/man/de_DE.88591</I> musi wystąpić przed
|
|
<I>/usr/man</I>.
|
|
<DT id="5"><B>DEFINE</B><I> klucz wartość</I><DD>
|
|
Linie tej postaci definiują różnorodne zmienne konfiguracyjne - domyślny
|
|
plik konfiguracyjny zawiera zmienne używane przez programy użytkowe
|
|
przeglądarki stron man. Zawierają one domyślne ścieżki do różnych programów
|
|
(takich jak <I>grep</I> i <I>tbl</I>) oraz domyślne argumenty wywołań tych
|
|
programów.
|
|
<DT id="6"><B>SECTION</B> <I>sekcja</I> ...<DD>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
Linie w tej postaci określają porządek przeszukiwania sekcji podręcznika
|
|
ekranowego. Jeżeli plik konfiguracyjny nie zawiera żadnej dyrektywy
|
|
<B>SECTION</B>, to domyślny porządek przeszukiwania sekcji jest następujący:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<PRE>
|
|
SECTION 1 n l 8 3 0 2 5 4 9 6 7</PRE>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Jeśli podano wiele dyrektyw <B>SECTION</B>, podane w nich sekcje będą połączone.
|
|
<P>
|
|
|
|
Jeśli pewne rozszerzenie (na przykład 1mh) nie występuje w liście sekcji, to
|
|
będzie wyświetlane z pozostałą częścią sekcji, do której należy. Tak więc
|
|
nie ma potrzeby wymieniać wszystkich sekcji w pliku konfiguracyjnym, aby
|
|
wymusić określony porządek przeszukiwania sekcji. Sekcje z rozszerzeniami
|
|
będą występować po głównej sekcji (np. "1 1mh 8...").
|
|
<P>
|
|
|
|
Można użyć słowa <B>SECTIONS</B> jako alternatywnej nazwy tej dyrektywy.
|
|
</DL>
|
|
|
|
<DT id="9"><B>MINCATWIDTH</B><I> szerokość</I><DD>
|
|
Jeżeli szerokość terminalu jest mniejsza niż <I>szerokość</I>, to preformatowane
|
|
strony podręcznika nie będą ani tworzone (jeśli ich nie ma), ani
|
|
wyświetlane. Domyślną wartością jest 80.
|
|
<DT id="10"><B>MAXCATWIDTH</B><I> szerokość</I><DD>
|
|
Jeżeli szerokość terminalu jest większa niż <I>szerokość</I>, to preformatowane
|
|
strony podręcznika nie będą ani tworzone (jeśli ich nie ma), ani
|
|
wyświetlane. Domyślną wartością jest 80.
|
|
<DT id="11"><B>CATWIDTH</B><I> szerokość</I><DD>
|
|
Jeżeli <I>szerokość</I> jest większa od zera, to zawsze będą tworzone
|
|
preformatowane strony podręcznika dla terminalu o podanej szerokości,
|
|
niezależnie od szerokości obecnie używanego terminalu. Wartość tego
|
|
ustawienia powinna być w zakresie od <B>MINCATWIDTH</B> do <B>MAXCATWIDTH</B>.
|
|
<DT id="12"><B>NOCACHE</B>
|
|
|
|
|
|
<DD>
|
|
Ta flaga zapobiega automatycznemu tworzeniu preformatowanych stron "cat"
|
|
przez <B>man</B>.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BŁĘDY</H2>
|
|
|
|
Jeżeli nie są ściśle przestrzegane powyższe reguły, to narzędzia
|
|
przeglądania stron man nie będą działać w pożądany sposób.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>TŁUMACZENIE</H2>
|
|
|
|
Wojciech Kotwica w 1999 roku przetłumaczył część stron podręcznika pakietu
|
|
man-db i udostępnił je w ramach Projektu Tłumaczenia Manuali.
|
|
<BR>
|
|
|
|
Robert Luberda tłumaczenie zaktualizował i uzupełnił w roku 2008.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NAZWA</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">OPIS</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">FORMAT</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">BŁĘDY</A><DD>
|
|
<DT id="17"><A HREF="#lbAF">TŁUMACZENIE</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:20 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|