Termes ombragés dans l'aide

10

Parfois, lorsque je recherche le système d'aide pour un sujet particulier, il sera masqué par un sujet différent.

Par exemple, si je le fais, :h displayj'obtiens de l'aide pour quelque chose impliquant des "ressources GUI", quand je voulais de l'aide pour le paramètre "affichage" (comme dans set display=lastline).

Comment puis-je trouver ces sujets "masqués" ou répertorier les sujets correspondants les plus pertinents?

xthrd
la source

Réponses:

13

Les noms de paramètres sont toujours entourés de guillemets, utilisez donc:

:help 'display'

pour obtenir la page souhaitée.

Vous obtenez des compléments utiles lorsque vous appuyez sur Ctrl+ D, c'est-à-dire:

:help display<^D>

Te donnera:

-display  :display  'display'  :syn-display  strdisplaywidth()

En finitions :-)

Astuce bonus:
Si vous utilisez :set wildmenu, cela fonctionnera également avec Tab, et vous aurez des fonctionnalités de complétion supplémentaires.

Martin Tournoij
la source
3
Sans 'wildmenu', vous obtenez un achèvement après l'autre via Tab, ou encore la liste entière avec Ctrl-D. Suggérez de mentionner cela.
derobert
@derobert Ah, je ne le savais pas. Je suis tellement habitué à utiliser Tab:-)
Martin Tournoij
Pour les paramètres, :help 'display'est identique à :help display?.
wchargin
9

L'aide pour les commandes Ex est toujours répertoriée avec les deux points inclus:

:help :display

L'aide pour les paramètres est toujours répertoriée avec les guillemets environnants, comme Carpetsmoker l'a déjà décrit :

:help 'display'

Les fichiers d'aide spécifiques sont répertoriés par leur nom de fichier:

:help undo.txt(cf. :help undo)

L'aide pour les fonctions intégrées est répertoriée avec des parenthèses de fin:

:help split()(cf. :help split)

La documentation des arguments de commande de Vim (c'est-à-dire ceux passés lors de l'appel de Vim à partir du shell) est répertoriée avec les tirets précédents:

:help -r(cf. :help r)

Les rubriques d'aide des plugins utilisent généralement le nom du plugin comme préfixe:

:help surround-mappings

Enfin, quelque chose que je n'avais pas réalisé avant d'utiliser Vim depuis un certain temps *, c'est que l'aide comprend des rubriques pour les mappages par défaut dans tous les modes.

Par exemple, Ctrl-vfait quelque chose de très différent en mode Normal de ce qu'il fait en mode Insertion.

Pour accéder aux différents sujets, utilisez les i_, c_et v_préfixes pour Insertion, commande et applications en mode visuel , respectivement, ou pas de préfixe pour le mappage de mode Normal :

:help ctrl-v

:help i_ctrl-v

:help c_ctrl-v

:help v_ctrl-v

* ... malgré le fait que c'est pratiquement la première chose que vous lirez si vous tapez un simple :helpsans arguments! Voir «Obtenir une aide spécifique» quelques paragraphes plus bas. ( :help help-context)

Riches
la source
La plupart d'entre eux, mais pas tous (en particulier les fonctions et les plugins), sont répertoriés dans :help help-context: Peut-être que cela mérite d'être mentionné dans la réponse également.
Sakari Cajanus du
@SakariCajanus Oui! help-contextest en fait presque la première chose sur la première page de Vim :help. J'ai ajouté une note de bas de page le mentionnant à la réponse.
Rich
4

La réponse de @ Carpetsmoker satisfait certainement les critères "les plus pertinents", car les résultats contiendront presque toujours ce que vous recherchez. Cependant, il y a aussi la :helpgrepcommande, qui fonctionne exactement comme la :grepcommande mais recherche le texte de tous les fichiers d'aide.

Vous pouvez parcourir les résultats avec :cnextou voir tous les résultats avec :cwindow.

xthrd
la source