10.4. À Propos

Vous pouvez poser un autre style de question plus sophistiqué, comme : "Quelles sont les commandes pour travailler avec les fichiers ?" Pour poser cette question, tapez C-h a file RET, qui affiche une liste de tous les noms de commandes contenant file, dont copy-file, find-file, etc. Avec chaque nom de commande apparaît une description concise de la manière d'utiliser la commande, et les touches à utiliser pour l'invoquer. Par exemple, elle pourrait dire que vous pouvez invoquer la commande find-file en tapant C-x C-f. Le a dans C-h a veut dire "À propos". C-h a exécute la commande apropos-command. Cette commande vérifie normalement seulement les commandes (fonctions interactives) ; si vous spécifiez un argument préfixe, elle vérifie aussi parmi les fonctions non interactives.

C-h a ne recherchant que les fonctions dont les noms contiennent la chaîne spécifiée, vous devez faire preuve d'ingéniosité dans le choix de la chaîne. Si vous cherchez des commandes pour couper le texte précédent (NdT : kill backwards en anglais) et que C-h a kill-backwards ne révèle rien, ne désespérez pas. Essayez seulement kill, ou seulement backwards, ou seulement back. Persistez. Notez aussi que vous pouvez utiliser une expression rationnelle pour plus de flexibilité. (Section 14.5).

Voici un ensemble d'arguments à passer à C-h a qui couvre un grand nombre de classes de commandes Emacs. En vous donnant une idée des conventions de nom, cet ensemble devrait aussi vous servir à développer une technique pour trouver des chaînes apropos.

char, line, word, sentence, paragraph, region, page, sexp, list, defun, rect, buffer, frame, window, face, file, dir, register, mode, beginning, end, forward, backward, next, previous, up, down, search, goto, kill, delete, mark, insert, yank, fill, indent, case, change, set, what, list, find, view, describe, default.

Pour lister toutes les variables utilisateur qui correspondent à une expression rationnelle, utilisez la commande M-x apropos-variable. Cette commande affiche seulement les variables utilisateur et les options de personnalisation par défaut ; si vous spécifiez un argument préfixe, elle parcourt toutes les variables.

Pour obtenir une liste de tous les symboles contenant une correspondance pour une expression rationnelle, et pas seulement ceux définis comme commandes, utilisez la commande M-x apropos plutôt que C-h a. Cette commande ne regarde pas parmi les raccourcis clavier par défaut ; spécifiez un argument numérique pour qu'elle le fasse.

La commande apropos-documentation est semblable à apropos à ceci près qu'elle recherche une correspondance de chaînes dans les documentations des symboles aussi bien que dans leurs noms.

La commande apropos-value est semblable à apropos à ceci près qu'elle recherche une correspondance de chaînes parmi les valeurs des symboles. Cette commande ne parcourt pas les définitions des fonctions ou les listes de propriétés par défaut ; spécifiez un argument numérique pour qu'elle le fasse.

Si la variable apropos-do-all est non nil, les commandes suivantes fonctionnent toutes comme si elles avaient reçu un argument préfixe.

Si vous voulez plus d'informations sur la définition d'une fonction, d'une variable ou sur la propriété d'un symbole listé dans le tampon Apropos, vous pouvez cliquer dessus avec Souris-2 ou vous y déplacer et taper RET.