APROPOS(1) Utilitaires de l'afficheur des pages de manuel APROPOS(1) NOM apropos - Chercher le nom et la description des pages de manuel SYNOPSIS apropos [-dalv?V] [-e|-w|-r] [-s liste] [-m systeme[,...]] [-M chemin] [-L locale] [-C fichier] mot-cle ... DESCRIPTION Chaque page de manuel comporte une courte description. apropos recherche et affiche cette description pour chaque page correspondant a mot-cle. mot-cle est, par defaut, considere en tant qu'expression rationnelle, comme avec l'option -r, mais peut aussi contenir des jokers (wildcards) avec l'option -w, ou rechercher une correspondance exacte avec le mot-cle grace a l'option -e. Avec ces options, il peut etre necessaire de placer mot-cle entre guillemets (simples ou doubles) ou de proteger avec << \ >> les caracteres speciaux afin d'empecher leur developpement par l'interpreteur de commandes. Les regles standard permettent de faire des recherches sur le nom des pages ainsi que sur des mots de la description. La base de donnees utilisee par apropos est mise a jour par le programme mandb. Selon votre installation, ce peut etre execute periodiquement a l'aide de cron, ou par vous-meme apres l'installation de nouvelles pages de manuel. OPTIONS -d, --debug Affiche les informations de mise au point. -v, --verbose Affiche des messages d'avertissement etendus. -r, --regex Interprete chaque mot-cle comme une expression rationnelle. C'est le comportement par defaut. Chaque mot-cle sera independamment compare avec le nom des pages et avec leur description. Il peut correspondre a n'importe quelle partie de l'un ou l'autre. La recherche n'est pas limitee aux frontieres de mot. -w, --wildcard Interprete chaque mot-cle comme un motif contenant des jokers (wildcards) comprehensibles par l'interpreteur de commandes. Chaque motif sera compare independamment avec le nom des pages et avec leur description. Si --exact est employe, la recherche n'aboutira que si le motif correspond au nom complet de la page ou a la totalite de la description. Sinon, les correspondances entre le motif et des mots complets de la description seront egalement recherchees. -e, --exact Chaque mot-cle est compare exactement avec le nom des pages et avec leur description. -a, --and Affiche seulement l'element correspondant a tous les mots-cles fournis. Par defaut, les elements affiches sont ceux qui correspondent a n'importe quel mot-cle. -l, --long Ne reduit pas l'affichage a la largeur du terminal. Normalement la sortie sera tronquee a la largeur du terminal pour eviter des resultats deplaisants avec des sections NOM mal ecrites. -s liste, --sections=liste, --section=liste La recherche est limitee aux sections de manuel indiquees. liste est une liste de sections separees par des deux-points ou des virgules. Si une des entrees de la liste est une section simple, par exemple << 3 >>, alors la liste des descriptions affichees inclura les pages des sections << 3 >>, << 3perl >>, << 3x >>, et ainsi de suite. Par contre, si une des entrees de la liste est plus precise, par exemple << 3perl >>, alors la liste n'inclura que les pages de cette partie de section. -m systeme[,...], --systems=systeme[,...] If this system has access to other operating systems' manual page descriptions, they can be searched using this option. To search NewOS's manual page descriptions, use the option -m NewOS. Le systeme indique peut etre une suite de noms de systemes d'exploitation, separes par des virgules. Pour inclure une recherche sur le whatis du systeme natif, il faut inclure le nom systeme << man >> dans la chaine fournie en argument. Cette option remplacera la variable d'environnement $SYSTEM. -M liste_de_chemins, --manpath=liste_de_chemins Indique une liste de structures hierarchiques de pages de manuel, separees par des deux-points, a utiliser lors des recherches. Par defaut, apropos utilise la variable d'environnement $MANPATH, a moins qu'elle ne soit vide ou n'ait ete supprimee. Dans ce cas, il determine la liste appropriee des chemins d'acces aux pages de manuel en se basant sur la variable d'environnement $PATH. Cette option remplace le contenu de $MANPATH. -L locale, --locale=locale apropos determine habituellement la locale (NdT : la langue ou le dialecte) actuelle par un appel a la fonction C setlocale(3) qui consulte diverses variables d'environnement, y compris $LC_MESSAGES et $LANG. Pour remplacer temporairement la valeur definie, utilisez cette option. Elle fournit directement a apropos la chaine de caracteres representant la locale. Notez que cette valeur ne prendra effet qu'a partir de la recherche des pages. Par consequent, les autres affichages, tels que les messages d'aide, seront toujours montres dans la langue initialement determinee. -C fichier, --config-file=fichier Use this user configuration file rather than the default of ~/.manpath. -?, --help Affiche un message d'aide et s'arrete. --usage Affiche un court mode d'emploi et s'arrete. -V, --version Affiche le numero de version. CODE DE RETOUR 0 Programme execute sans erreur. 1 Erreur d'utilisation, de syntaxe ou de fichier de configuration. 2 Erreur d'execution. 16 Rien n'a ete trouve selon les criteres indiques. ENVIRONNEMENT SYSTEM Si $SYSTEM est definie, l'effet sera le meme que si on l'avait indiquee comme argument de l'option -m. MANPATH Si $MANPATH est definie, sa valeur est interpretee comme une liste d'elements, separes par des deux-points, representant les chemins d'acces aux structures hierarchiques 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. MANWIDTH Si $MANWIDTH est definie, sa valeur est utilisee comme largeur de terminal (voir l'option --long). Sinon, la largeur du terminal sera calculee d'apres les valeurs de $COLUMNS et ioctl(2) s'il est disponible, soit a 80 colonnes si aucune indication n'est trouvee. POSIXLY_CORRECT Si $POSIXLY_CORRECT est definie, meme avec une valeur vide, apropos fera, par defaut, une recherche selon une expression rationnelle, comme si l'option << -r >> avait ete indiquee. Il s'agit actuellement du comportement par defaut. FICHIERS /usr/share/man/index.(bt|db|dir|pag) Base de donnees d'indexation globale habituelle. /var/cache/man/index.(bt|db|dir|pag) Base de donnees d'indexation globale, conforme a FHS. /usr/share/man/.../whatis Base de donnees texte whatis traditionnelle. VOIR AUSSI man(1), whatis(1), 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 a l'aide de l'outil po4a par l'equipe francophone de traduction de Debian. Valery Perrin le 2 janvier 2006. David Prevot et l'equipe francophone de traduction de Debian (2010). Veuillez signaler toute erreur de traduction en ecrivant a ou par un rapport de bogue sur le paquet man-db. Vous pouvez toujours avoir acces a la version anglaise de ce document en utilisant la commande << man -L C
>>. 2.12.1 2024-04-05 APROPOS(1)