.\" 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 名稱 manpath \- /etc/man_db.conf 檔案的格式 .SH 描述 manpath 設定檔供手動分頁工具在執行時評估使用者的 manpaths,指示哪些手動分頁階層(manpaths)應視為系統階層,並為其指定用於儲存 cat 檔案的目錄。 如果環境變數 $\fBMANPATH\fP 已設定,/etc/man_db.conf 中包含的資訊不會覆寫它。 .SH 搜尋路徑 預設情況下,man\-db 檢查使用者的 $\fBPATH\fP。對於找到的每個 \fIpath_element\fP,它會將 \fImanpath_element\fP 新增到搜尋路徑。 如果設定檔中給定的 \fIpath_element\fP 沒有 \fBMANPATH_MAP\fP 列,則它會將所有以目錄形式存在的 \fIpath_element/../man\fP、\fIpath_element/man\fP、\fIpath_element/../share/man\fP 和 \fIpath_element/share/man\fP 新增到搜尋路徑。 然後它將設定檔中的任何 \fBMANDATORY_MANPATH\fP 項目新增到搜尋路徑。 最後,如果使用 \fB\-\-systems\fP 選項或設定了 $\fBSYSTEM\fP 環境變數,則應包含以逗號或冒號分隔的作業系統名稱序列。這作為模板,再次擴展搜尋路徑以允許存取其他作業系統的手動分頁:對於每個系統名稱,man\-db 會在搜尋路徑的每個項目中尋找該名稱作為子目錄,如果存在,則將其新增到最終搜尋路徑。系統名稱 \fBman\fP 會插入不含子目錄的正常搜尋路徑。例如,如果搜尋路徑原本會是 \fI/usr/share/man:/usr/local/man\fP,而 $\fBSYSTEM\fP 設定為 \fInewOS:man\fP,則最終搜尋路徑會是 \fI/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man\fP。 $\fBMANPATH\fP 環境變數會覆寫 man\-db 的預設手動分頁搜尋路徑。大多數使用者不需要設定它。其語法類似於 $\fBPATH\fP 環境變數:它由以冒號分隔的目錄名稱序列組成。它會覆寫上述的預設搜尋路徑。 如果 $\fBMANPATH\fP 的值以冒號開頭,則預設搜尋路徑會加在其開頭。如果 $\fBMANPATH\fP 的值以冒號結尾,則預設搜尋路徑會加在其結尾。如果 $\fBMANPATH\fP 的值包含雙冒號(\fB::\fP),則預設搜尋路徑會插入到值的兩個冒號中間。 .SH 格式 目前認可以下欄位類型: .TP \fB#\fP\fI\ comment\fP 空行或以 \fB#\fP 開頭的行將被視為註解並忽略。 .TP \fBMANDATORY_MANPATH\fP\fI\ manpath_element\fP 此格式的行表示每個自動產生的 $\fBMANPATH\fP 應包含的 manpaths。這通常包括 \fI/usr/man\fP。 .TP \fBMANPATH_MAP\fP\fI\ path_element\ manpath_element\fP 此格式的行設定 $\fBPATH\fP 到 $\fBMANPATH\fP 的對應。對於在使用者 $\fBPATH\fP 中找到的每個 \fIpath_element\fP,\fImanpath_element\fP 會被新增到 $\fBMANPATH\fP。 .TP \fBMANDB_MAP \fP\fImanpath_element \fP\|[\| \fIcatpath_element\fP \|] 此格式的行表示哪些 manpaths 應視為系統 manpaths,以及可選地它們的 cat 檔案應儲存在何處。如果 \fBman\fP 是 setuid 程式,此欄位類型特別重要,因為(在系統設定檔 /etc/man_db.conf 而非使用者設定檔 .manpath 中)它指示哪些手動分頁階層應以 setuid 使用者存取,哪些應以呼叫使用者存取。 系統手動分頁階層通常儲存在 \fI/usr\fP 下,例如 \fI/usr/man\fP、\fI/usr/local/man\fP 和 \fI/usr/X11R6/man\fP。 如果特定 \fImanpath_element\fP 的 cat 頁面不儲存或儲存在傳統位置,則可省略 \fIcatpath_element\fP。 對於唯讀掛載的手動分頁階層,傳統的 cat 放置是不可能的,因此可以為其儲存指定任何有效的目錄階層。若要遵守 \fBLinux FSSTND\fP,可以使用 \fBFSSTND\fP 關鍵字代替實際目錄。 不幸的是,必須指定 \fBall\fP 系統 man 樹狀路徑,包括替代作業系統路徑(如 \fI/usr/man/sun\fP)和任何 \fBNLS locale\fP 路徑(如 \fI/usr/man/de_DE.88591\fP)。 由於資訊是以寫入的順序逐行列析,任何作為其他階層的子階層的 manpath 都必須先列出,否則會進行不正確的相符。例如 \fI/usr/man/de_DE.88591\fP 必須在 \fI/usr/man\fP 之前。 .TP \fBDEFINE\fP\fI\ key\ value\fP 此格式的行定義雜項設定變數;請參閱手動分頁工具使用的那些變數的預設設定檔。它們包括各種程式的預設路徑(例如 \fIgrep\fP 和 \fItbl\fP)以及那些程式的預設引數集。 .TP \fBSECTION\fP \fIsection\fP .\|.\|. .RS 此格式的行定義應搜尋手動區段的順序。如果設定檔中沒有 \fBSECTION\fP 指示詞,則預設為: .PP .RS .nf .if !'po4a'hide' SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7 .fi .RE .PP 如果提供多個 \fBSECTION\fP 指示詞,它們的區段清單將被串接。 .PP 如果特定延伸不在此清單中(例如 1mh),則會顯示在其所屬區段的其餘部分。效果是,只有當您想要強制特定順序時,才需要明確列出延伸。具有延伸的區段通常應與其主區段相鄰(例如「1 1mh 8 ...」)。 .PP \fBSECTIONS\fP 被接受為此指示詞的替代名稱。 .RE .TP \fBMINCATWIDTH\fP\fI\ width\fP 如果終端寬度小於 \fIwidth\fP,則不會建立(如果遺失)或顯示 cat 頁面。預設值為 80。 .TP \fBMAXCATWIDTH\fP\fI\ width\fP 如果終端寬度大於 \fIwidth\fP,則不會建立(如果遺失)或顯示 cat 頁面。預設值為 80。 .TP \fBCATWIDTH\fP\fI\ width\fP 如果 \fIwidth\fP 非零,則 cat 頁面一律會針對指定寬度的終端進行格式化,不管實際使用的終端寬度為何。這會覆寫 \fBMINCATWIDTH\fP 和 \fBMAXCATWIDTH\fP。 .TP .if !'po4a'hide' .B NOCACHE 此旗標防止 \fBman\fP(1) 自動建立 cat 頁面。 .SH 錯誤 除非精確遵循和遵守上述規則,否則手動分頁工具將無法按預期運作。這些規則過於複雜。 .PP .if !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues .br .if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db