Ubuntu Manpage: manpath - format dari berkas /etc/manpath.config

NAMA

       manpath - format dari berkas /etc/manpath.config

DESKRIPSI

       Berkas  konfigurasi  manpath  digunakan oleh aplikasi halaman buku panduan untuk mengakses
       manpath pengguna pada waktu berjalan, mengindikasikan susunan halaman  buku  panduan  mana
       (manpath)  yang  diperlukan  sebagai  sistem  hierarki  dan  menempatkan  direktori  untuk
       digunakan untuk penyimpanan berkas cat.

       Jika  variabel  lingkungan   $MANPATH   telah   diset,   informasi   yang   berada   dalam
       /etc/manpath.config akan menimpanya.

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.

FORMAT

Tipe daerah berikut saat ini dikenal:

# komentar
Baris kosong atau yang berawal dengan sebuah # akan diperlakukan sebagai komentar
dan akan diabaikan.

MANDATORY_MANPATH manpath_element
Baris dari bentuk ini mengindikasikan manpath yang secara otomatis seharusnya
berisi $MANPATH. Ini biasanya termasuk /usr/man.

MANPATH_MAP path_element manpath_element
Baris dari konfigurasi bentuk pemetaan ini $PATH ke $MANPATH. Untuk setiap
path_element ditemukan dalam $PATH pengguna, manpath_element akan ditambahkan ke
$MANPATH.

MANDB_MAP manpath_element [ catpath_element ]
Baris dari bentuk ini mengindikasikan manpaths mana yang diperlakukan sebagai
sistem manpath, dan secara opsional dimana berkas catnya seharusnya disimpan. Tipe
bagian ini biasanya penting jika man adalah aplikasi setuid, seperti (ketika dalam
berkas sistem konfigurasi /etc/manpath.config daripada berkas konfiguras setiap
pengguna .manpath) ini mengindikasikan ke susunan halaman buku panduan mana untuk
diakses sebagai setuid pengguna dan mana yang memanggil pengguna.

Susunan sistem halaman buku panduan biasanya disimpan dibawah /usr seperti
/usr/man, /usr/local/man dan /usr/X11R6/man.

Jika halaman cat dari manpath_element tertentu tidak disimpan atau akan disimpan
dalam lokasi tradisional, catpath_element mungkin diabaikan.

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 Linux FSSTND the keyword FSSTND can be
used in place of an actual directory.

Sayangnya, ini diperlukan untuk menspesifikasikan seluruh susunan jalur sistem buku
panduan, termasuk jalur sistem operasi alternatif seperti /usr/man/sun dan NLS
locale jalur apapun seperti /usr/man/de_DE.88591.

Karena informasi diambil baris demi baris dalam urutan penulisan, ini diperlukan
untuk manpath apapun yang berupa sub-hierarki dari hierarki lain untuk ditampilkan
pertama, jika tidak sebuah kesalahan pencocokan terjadi. Sebagai contoh
/usr/man/de_DE.88591 harus datang sebelum /usr/man.

DEFINISI nilai kunci
Baris dari bentuk ini mendefinisikan variabel konfigurasi lain; lihat berkas
konfigurasi baku untuk variabel tersebut digunakan oleh aplikasi halaman buku
panduan. Termasuk jalur baku ke berbagai aplikasi (seperti grep dan tbl), dan set
baku dari argumen ke aplikasi tersebut.

BAGIAN bagian ...
Baris dari formulir ini mendefinisikan urutan dimana bagian buku panduan seharusnya
dicari. Jika disana tidak ada arah BAGIAN dalam berkas konfigurasi, yang baku
adalah:

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

Jika beberapa BAGIAN direktif diberikan, daftar bagian itu akan dipotong.

Jika sebuah ekstensi tertentu tidak ada dalam daftar ini (contoh, 1mh) ini akan
ditampilkan dengan sisa bagian ini berada. Efek dari ini, anda hanya membutuhkan
untuk secara eksplisit mendaftar ekstensi jika anda ingin memaksa urutan tertentu.
Bagian dengan ekstensi seharusnya berurutan ke bagian utamanya (contoh "1 1mh 8
...").

BAGIAN diterima sebagai sebuah nama alternatif untuk direktif ini.

MINCATWIDTH lebar
Jika lebar terminal lebih kecil dari lebar, halaman cat tidak akan dibuat (jika
hilang) atau ditampilkan. Baku adalah 80.

MAXCATWIDTH lebar
Jika lebar terminal lebih besar dari lebar, halaman cat tidak akan dibuat (jika
hilang) atau ditampilkan. Baku adalah 80.

CATWIDTH lebar
Jika lebar bukan-nol, halaman buku panduan akan selalu diformat untuk sebuah
terminal dari lebar yang diberikan, tidak perduli lebar dari terminal yang sedang
digunakan. Ini seharusnya secara umum berada didalam jangkauan diset oleh
MINCATWIDTH dan MAXCATWIDTH.

NOCACHE
Pilihan ini menjaga man(1) dari membuat halaman cat secara otomatis.

BUGS

       Kecuali  aturan  diatas  diikuti  dan  diamati secara tepat, aplikasi halaman buku panduan
       tidak akan berfungsi seperti yang diinginkan. Aturan yang ada sangat kompleks.

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