- unstable 2.13.2-1
| CATMAN(8) | 手動分頁工具 | CATMAN(8) |
名稱¶
catman - 建立或更新預先格式化的手動分頁
語法¶
catman [-d?V] [-M path] [-C file] [section] ...
描述¶
catman 用於建立一組最新的預先格式化的手動分頁,稱為 cat 頁面。Cat 頁面通常比原始手動分頁顯示得快,但需要額外的儲存空間。支援 cat 頁面的決定由本機管理員做出,他們必須提供合適的目錄來容納它們。
catman 可用的選項是要預先格式化的手動分頁階層和區段。預設階層是 man-db 設定檔中指定的系統階層,預設區段則是環境變數 $MANSECT 中以冒號分隔的內容,或者如果 $MANSECT 未定義,則是內建到 man 中的標準集。向 catman 提供一組以空白分隔的區段名稱將覆寫上述兩者。
catman 利用與每個階層相關的 index 資料庫快取來判斷哪些檔案需要格式化。
選項¶
- -d, --debug
- 列印除錯資訊。
- -M path, --manpath=path
- 指定替代的以冒號分隔的手動分頁階層搜尋路徑。預設情況下,這是 man-db 設定檔中指示為系統階層的所有路徑。
- -C file, --config-file=file
- 使用此使用者設定檔,而非預設的 ~/.manpath。
- -?, --help
- 列印說明訊息並退出。
- --usage
- 列印簡短用法訊息並退出。
- -V, --version
- 顯示版本資訊。
環境¶
- MANSECT
- 如果已設定 $MANSECT,其值是以冒號分隔的區段清單,用於判斷要搜尋哪些手動區段以及順序。預設是「1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7」,除非被 /etc/manpath.config 中的 SECTION 指示詞覆寫。
- MANPATH
- 如果已設定
$MANPATH,其值會被解讀為要使用的以冒號分隔的說明頁階層搜尋路徑。
請參閱 manpath(5) 的 SEARCH PATH 區段,了解此環境變數的預設行為和處理方式的詳細資訊。
檔案¶
- /etc/manpath.config
- man-db 設定檔。
- /usr/man/index.(bt|db|dir|pag)
- 傳統的全域 index 資料庫快取。
- /var/catman/index.(bt|db|dir|pag)
- 替代或符合 FSSTND 的全域 index 資料庫快取。
請參閱¶
作者¶
Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org).
錯誤¶
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
| 2026-11-15 | 2.13.2 |