NOM¶

catman - Créer ou mettre à jour les pages de manuel préformatées

SYNOPSIS¶

catman [-d?V] [-M chemin] [-C fichier] [section] ...

DESCRIPTION¶

catman est utilisé pour créer et mettre à jour l'ensemble des pages de manuel préformatées, connues sous le nom de pages « cat ». Les pages « cat » sont, en général, plus rapides à afficher que les pages de manuel d'origine mais requièrent un espace de stockage supplémentaire. La décision de gérer, ou non, les pages « cat » est de la responsabilité de l'administrateur local qui doit créer les répertoires nécessaires à leur stockage.

Les options de catman permettent de préciser les structures hiérarchiques de pages de manuel, ainsi que les sections, à préformater. Les structures hiérarchiques des pages traitées par défaut sont celles spécifiées comme structures hiérarchiques « système » dans le fichier de configuration de man-db. Les sections par défaut sont celles, séparées par des « : », contenues dans la variable d'environnement $MANSECT. Si $MANSECT n'est pas définie alors la liste standard, compilée dans man, sera utilisée. La présence de plusieurs sections, séparées par des blancs (whitespace), dans la commande catman, remplacera les deux valeurs par défaut précédentes.

catman utilise la base de données d'indexation, associée à chaque structure hiérarchique de pages de manuel, pour déterminer quels sont les fichiers qui doivent être formatés.

OPTIONS¶

-d, --debug

Affiche les informations de mise au point.

-M liste_de_chemins, --manpath=liste_de_chemins

Indique la liste des chemins d'accès aux structures hiérarchiques des pages de manuel. Les éléments de cette liste doivent être séparés par « : ». Par défaut, il s'agit de l'ensemble des chemins correspondants aux structures hiérarchiques « système », indiqués dans le fichier de configuration de man-db.

-C fichier, --config-file=fichier

Use this user configuration file rather than the default of ~/.manpath.

-?, --help

Affiche un message d'aide et s'arrête.

--usage

Affiche un court mode d'emploi et s'arrête.

-V, --version

Affiche le numéro de version.

ENVIRONNEMENT¶

MANSECT

Si $MANSECT est définie, sa valeur est une liste de sections, séparées par des deux-points. Cette liste est utilisée pour déterminer les sections de manuel, et l’ordre, utilisés pour la recherche. C’est « 0 1 n l 8 3 2 5 4 9 6 7 1x 3x 4x 5x 6x 8x 1bind 3bind 5bind 7bind 8bind 1cn 8cn 1m 1mh 5mh 8mh 1netpbm 3netpbm 5netpbm 0p 1p 3p 3posix 1pgsql 3pgsql 5pgsql 3C++ 8C++ 3blt 3curses 3ncurses 3form 3menu 3db 3gdbm 3f 3gk 3paper 3mm 5mm 3perl 3pm 3pq 3qt 3pub 3readline 1ssl 3ssl 5ssl 7ssl 3t 3tk 3tcl 3tclx 3tix 7l 7nr 8c Cg g s m » par défaut, à moins d’être écrasée par la directive SECTION dans /etc/manpath.config.

MANPATH

Si $MANPATH est définie, sa valeur est interprétée comme une liste d'éléments, séparés par des deux-points, représentant les chemins d'accès aux structures hiérarchiques de pages de manuel.

See the SEARCH PATH section of manpath(5) for the default behaviour and details of how this environment variable is handled.

FICHIERS¶

/etc/manpath.config

Fichier de configuration de man-db.

/usr/man/index.(bt|db|dir|pag)

Base de données d'indexation globale habituelle.

/var/catman/index.(bt|db|dir|pag)

Base de données d'indexation globale de remplacement ou conforme à FSSTND.

VOIR AUSSI¶

man(1), manpath(5), mandb(8)

AUTEUR¶

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).

BOGUES¶

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

TRADUCTION¶

Cette traduction est maintenue à l'aide de l'outil po4a <URL:https://po4a.org/> par l'équipe francophone de traduction de Debian.

Valéry Perrin <valery.perrin.debian@free.fr> le 2 janvier 2006. David Prévot <david@tilapin.org> et l'équipe francophone de traduction de Debian (2010).

Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet man-db.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».