diff --git a/common/locale/en-US/options.xml b/common/locale/en-US/options.xml index 4ec5915d..8d340865 100644 --- a/common/locale/en-US/options.xml +++ b/common/locale/en-US/options.xml @@ -364,24 +364,17 @@ .*

- Enables automatic completion for completion groups matching the - given regular expressions. When automatic completion is enabled, - the completion list is automatically opened when the - &tag.command-line; is focused. + Enables automatic completion for completion contexts (see + :contexts) matching the given regular expressions. When + automatic completion is enabled, the completion list is + automatically opened when the &tag.command-line; is focused. Thereafter, any key press triggers a completion update for the - matching groups (hereafter ‘contexts’). Non-matching contexts will - only be updated when the key is pressed. - This option is useful for disabling auto-completion for - computationally intensive contexts that don't perform well when - your system is under load. + matching contexts. Non-matching contexts will only be updated when + the key is pressed. This option is useful + for disabling auto-completion for computationally intensive + contexts that don't perform well when your system is under load.

- - To enable auto-completion for everything but :history or - :bmarks, you would choose a value such as - !/ex/bmarks,.? - - Completion contexts have names very much like Unix path names. These denote the tree in which they're called. A completer will @@ -391,7 +384,20 @@ so on. -

See also :contexts

+ +

+ To enable auto-completion for everything but :history or + :bmarks, you would choose a value such as + !/ex/(bmarks|history),.? +

+ +

+ To go in the other direction, i.e. only enable + auto-completion for :bmarks, you have to jump through + some hoops, due to the way contexts work (see the note above): + /ex/(bmarks|history),^(/|/ex/?)$ +

+