CATMAN(8) | Утиліти переглядача довідки | CATMAN(8) |
ІМʼЯ
catman - створити або оновл сторінки довідки у форматованому вигляді
СИНОПСИС
catman [-d?V] [-М шлях] [-C файл] [розділ] ...
ОПИС
catman використовується для створення актуального набору попередньо форматованих сторінок довідки, відомих як сторінки cat. Сторінки cat зазвичай значно швидше показуються, ніж оригінальні сторінки довідки, але вимагають додаткового місця для зберігання. Рішення щодо підтримки сторінок cat належить місцевому адміністратору, який повинен забезпечити відповідні каталоги для їхнього зберігання.
Опції, доступні для catman, це ієрархії та розділи сторінок довідки, які потрібно підготувати заздалегідь. За замовчуванням використовуються ієрархії, вказані у файлі конфігурації man-db як системні ієрархії, а також розділи або зміст змінної середовища $MANSECT, або стандартний набір, який вбудовано до man, якщо $MANSECT не визначено. Надання catman набору розділів, розділених пробілами, перевизначить обидва вищезгадані варіанти.
catman використовує індекс кешу бази даних, повʼязаний з кожною ієрархією, щоб визначити, які файли потрібно форматувати.
ПАРАМЕТРИ
- -d, --debug
- Вивести інформацію для налагодження.
- -M шлях, --manpath=шлях
- Вказати альтернативний шлях пошуку ієрархії сторінок довідки, розділених двокрапками. За замовчуванням це всі шляхи, вказані як системні ієрархії у файлі конфігурації man-db.
- -C файл, --config-file=файл
- Використовуйте цей користувацький файл конфігурації замість типового у ~/.manpath).
- -?, --help
- Надрукувати повідомлення довідки та вийти.
- --usage
- Надрукувати коротке повідомлення про використання та вийти.
- -V, --version
- Показати інформацію про версію.
СЕРЕДОВИЩЕ
- MANSECT
- Якщо встановлено $MANSECT, його значення є списком розділів, розділених двокрапками, і використовується для визначення, які розділи довідки потрібно шукати та в якому порядку. За замовчуванням це «1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7», якщо не перевизначено директивою SECTION у файлі /etc/man_db.conf.
- MANPATH
- Якщо
встановлено
змінну $MANPATH,
її
значення
інтерпретується
як шлях
пошуку
ієрархії
сторінок
довідки,
розділений
двокрапками.
Дивіться розділ ШЛЯХ ПОШУКУ у manpath(5) щодо поведінки за замовчуванням і подробиць того, як обробляється ця змінна середовища.
ФАЙЛИ
- /etc/man_db.conf
- конфігураційний файл man-db.
- /usr/man/index.(bt|db|dir|pag)
- Традиційний глобальний кеш індексу бази даних.
- /var/catman/index.(bt|db|dir|pag)
- Альтернативний або сумісний з FSSTND глобальний кеш бази даних індексу.
ДИВ. ТАКОЖ
АВТОР
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
2025-05-02 | 2.13.1 |