1 <?xml version="1.0" encoding="UTF-8"?>
2 <?xml-stylesheet type="text/xsl" href="dactyl://content/help.xsl"?>
4 <!DOCTYPE document SYSTEM "dactyl://cache/options.dtd">
8 title="&dactyl.appName; Options"
10 xmlns:html="&xmlns.html;">
12 <h1 tag="options">Options</h1>
16 &dactyl.appName; has a number of internal variables and switches which can be set to
17 achieve special effects. These options come in the following forms:
20 <dl dt="width: 10em;">
21 <dt/><dd tag="boolean"/>
24 Can only be <hl key="Boolean">on</hl> (<ex>:set <a>option</a></ex>) or
25 <hl key="Boolean">off</hl> (<ex>:set no<a>option</a></ex>)
28 <dt>number</dt> <dd>A numeric value</dd>
29 <dt>string</dt> <dd>A string value</dd>
31 <dt/><dd tag="charlist"/>
33 <dd>A string containing a discrete set of distinct characters</dd>
35 <dt/><dd tag="stringlist"/>
38 A comma-separated list of strings. Any comma appearing within single
39 or double quotes, or prefixed with a <tt>\</tt>, will not be treated
43 <dt/><dd tag="stringmap"/>
45 <dd>A comma-separated list of key-value pairs, e.g., <str delim="">key:val,foo:bar</str></dd>
47 <dt/><dd tag="regexplist"/>
50 A comma-separated list of regular expressions. Expressions may be
51 prefixed with a <tt>!</tt>, in which case the match will be negated. A
52 literal <tt>!</tt> at the beginning of the expression may be matched
53 with <tt>[!]</tt> or by placing the regular expression in quotes.
54 Generally, the first matching regular expression is used. Any comma
55 appearing within single or double quotes, or prefixed with a
56 <tt>\</tt>, will not be treated as an item separator.
59 <dt/><dd tag="regexpmap"/>
62 A combination of a <t>stringmap</t> and a <t>regexplist</t>. Each key
63 in the <a>key</a>:<a>value</a> pair is a regexp. If the regexp begins with a
64 <tt>!</tt>, the sense of the match is negated, such that a non-matching
65 expression will be considered a match and <html:i>vice versa</html:i>.
66 The first <a>key</a> to match yields value.
69 <dt>sitelist</dt> <dd tag="sitelist sitemap"/>
72 Like <t>regexplist</t> and <t>regexpmap</t>, but the keys are
73 <t>site-filters</t> rather than regular expressions.
77 <p tag="macro-string">
78 Some options may be given format strings containing macro replacements in
79 the form of <tt><<a>name</a>></tt>. These tokens are replaced by
80 the parameter <a>name</a> as specified in the relevant documentation.
81 If the token is in the form <tt><q-<a>name</a>></tt>, the value of the
82 parameter is automatically <link topic="quoting">quoted</link>. If it is in
83 the form of <tt><e-<a>name</a>></tt>, its value is never shown but may be
84 used to test whether the given parameter is empty.
87 Array elements, such as in the <tt><args></tt> parameter
88 of <ex>:command</ex> macros, may be accessed by appending
89 <tt>[<a>n</a>]</tt>, where <a>n</a> is the one-based array
90 index, to the macro name. The first argument of a command is
91 therefore accessed with <tt><args[1]></tt>.
94 Any substring enclosed by <em><tt><{</tt></em> and <em><tt>}></tt></em>
95 is automatically elided if any of the contained macros aren't currently
96 valid. A literal <em><tt><</tt></em> or <em><tt>></tt></em> character may
97 be included with the special escape sequences <tt><lt></tt> or
98 <tt><gt></tt> respectively.
101 <p style="text-align: left">
102 For example, given the format string
103 <str><{(cmd: <column>) }><{line: <line> }><file></str>,
104 where <em>line</em>=<hl key="Number">32</hl> and
105 <em>file</em>=<str delim="'">Lieder eines fahrenden Gesellen.txt</str>,
106 the result is formatted as
107 <str>line: 32 'Lieder eines fahrenden Gesellen.txt'</str>
110 <h2 tag="set-option E764">Setting options</h2>
113 <tags>:set :se</tags>
114 <spec>:se<oa>t</oa></spec>
115 <description short="true">
116 <p>Show all options which differ from their default values.</p>
121 <spec>:se<oa>t</oa> all</spec>
122 <description short="true">
123 <p>Show all options.</p>
128 <tags>E518 E519</tags>
129 <spec>:se<oa>t</oa> <a>option</a>?</spec>
131 <p>Show value of <a>option</a>.</p>
136 <spec>:se<oa>t</oa> <a>option</a> <oa>…</oa></spec>
139 For boolean options, turn them on. For all other types,
146 <spec>:se<oa>t</oa> no<a>option</a> <oa>…</oa></spec>
149 For boolean options, turn them off. For all other types,
156 <spec>:se<oa>t</oa> <a>option</a>! <oa>…</oa></spec>
157 <spec>:se<oa>t</oa> inv<a>option</a> <oa>…</oa></spec>
160 For boolean options, invert their value. For all other types,
168 <spec>:se<oa>t</oa> inv<a>option</a>=<a>value</a> <oa>…</oa></spec>
169 <spec>:se<oa>t</oa> <a>option</a>!=<a>value</a> <oa>…</oa></spec>
171 <p>For list options, toggle the specified values.</p>
173 <p style="text-align: left;">
174 If the option is a list, the given values are toggled. Given,
175 <se opt="opt" link="false"><str delim="">foo</str>,<str delim="">bar</str></se>
177 <se opt="opt" op="!=" link="false"><str delim="">foo</str>,<str delim="">baz</str></se>
178 has the same result as
179 <se opt="opt" link="false"><str delim="">bar</str>,<str delim="">baz</str></se>
183 This extends to string options in a natural way, e.g.,
184 <se opt="stal" op="!="><str delim="">always</str>,<str delim="">never</str></se>
185 toggles between the two values.
191 <tags>:set-default</tags>
192 <spec>:se<oa>t</oa> <a>option</a>& <oa>…</oa></spec>
194 <p>Reset option to its default value.</p>
199 <tags>:set-default-all</tags>
200 <spec>:se<oa>t</oa> all&</spec>
202 <p>Set all options to their default value.</p>
207 <tags>:set-args E487 E521</tags>
208 <spec>:se<oa>t</oa> <a>option</a>=<a>value</a> <oa>…</oa></spec>
211 Set string or number option to <a>value</a>.
212 For numeric options the value must be given in decimal.
213 The old value can be inserted by typing <k name="Tab" mode="c"/>.
220 <spec>:se<oa>t</oa> <a>option</a>+=<a>value</a> <oa>…</oa></spec>
223 Add the <a>value</a> to a number option, or append the <a>value</a>
224 to a string option. When the option is a comma separated list, a
225 comma is added, unless the value was empty. If the option is a list
226 of flags, superfluous flags are removed. When adding a flag that
227 was already present the option value doesn't change.
234 <spec>:se<oa>t</oa> <a>option</a>^=<a>value</a> <oa>…</oa></spec>
237 Multiply the <a>value</a> to a number option, or prepend the
238 <a>value</a> to a string option. When the option is a comma
239 separated list, a comma is added, unless the value was empty.
246 <spec>:se<oa>t</oa> <a>option</a>-=<a>value</a> <oa>…</oa></spec>
249 Subtract the <a>value</a> from a number option, or remove the
250 <a>value</a> from a string option if it is there. If the
251 <a>value</a> is not found in a string option, there is no error or
252 warning. When the option is a comma separated list, a comma is
253 deleted, unless the option becomes empty. When the option is a list
254 of flags, <a>value</a> must be exactly as they appear in the option.
255 Remove flags one by one to avoid problems.
261 <tags>:setlocal :setl</tags>
262 <spec>:setl<oa>ocal</oa> …</spec>
265 The same as <ex>:set</ex> command, but operates on current tab options
266 only. See <ex>:set</ex> for details.
272 <tags>:setglobal :setg</tags>
273 <spec>:setg<oa>lobal</oa> …</spec>
276 The same as <ex>:set</ex> command, but operates on global options only.
277 See <ex>:set</ex> for details.
282 <p tag="expand-environment-var expand-env :set_env">
283 Environment variables are expanded for path options like <o>cdpath</o> and
284 <o>runtimepath</o>. The variable notation is <em>$VAR</em> (terminated by a non-word
285 character) or <em>${VAR}</em>. <em>%VAR%</em> is also supported on Windows.
288 <h2 tag="&dactyl.host;-options preferences">Setting &dactyl.host; options</h2>
290 <p>&dactyl.host; options can be viewed and set with the following commands:</p>
293 <tags>:pref :prefs :preferences</tags>
294 <spec>:pref<oa>erences</oa></spec>
297 Show the &dactyl.host; preferences dialog. You can change the browser
298 preferences from this dialog. Be aware that not all &dactyl.host;
299 preferences work, because &dactyl.appName; overrides some key bindings and
300 changes &dactyl.host;'s GUI.
306 <tags>:pref! :prefs! :preferences!</tags>
307 <spec>:pref<oa>erences</oa>!</spec>
310 Opens about:config in the current tab, where you can change advanced &dactyl.host;
317 <tags>:set! :set-!</tags>
318 <spec>:se<oa>t</oa>! …</spec>
321 The same as <ex>:set</ex> but operates on &dactyl.host; preferences
322 (those on the about:config page). See <ex>:set</ex> for operator
326 The <em>no</em> and <em>inv</em> prefix operators are not available
327 for setting preferences.
332 <p tag="overridden-preferences">
333 &dactyl.appName; needs to set several &dactyl.host; preferences at
334 startup in order to function properly. If this is unacceptable,
335 they can be changed in your RC file with the <ex>:set!</ex>
336 command, but beware of unexpected behavior. The affected
341 <li><pref>accessibility.typeaheadfind</pref></li>
344 <h2 tag="list-options">List of options</h2>
347 <tags>'act' 'activate'</tags>
349 <spec>'activate' 'act'</spec>
350 <type>&option.activate.type;</type>
351 <default>addons,bookmarks,diverted,downloads,extoptions,
352 help,homepage,quickmark,tabopen,paste</default>
355 A list of items which, when opened in a new tab, are
356 automatically focused. Available items:
360 <dt>all</dt> <dd>Activate all items.</dd>
361 <dt>addons</dt> <dd><ex>:addo<oa>ns</oa></ex> command</dd>
362 <dt>bookmarks</dt> <dd>Tabs loaded from bookmarks</dd>
363 <dt>diverted</dt> <dd>Links with targets set to new tabs</dd>
364 <dt>downloads</dt> <dd><ex>:downl<oa>oads</oa></ex> command</dd>
365 <dt>extoptions</dt> <dd><ex>:exto<oa>ptions</oa></ex> command</dd>
366 <dt>help</dt> <dd><ex>:h<oa>elp</oa></ex> command</dd>
367 <dt>homepage</dt> <dd><k>gH</k> mapping</dd>
368 <dt>links</dt> <dd>Middle- or Control-clicked links</dd>
369 <dt>quickmark</dt> <dd><k>go</k> and <k>gn</k> mappings</dd>
370 <dt>tabopen</dt> <dd><ex>:tabopen<oa>!</oa></ex> command</dd>
371 <dt>paste</dt> <dd><k>P</k> and <k>gP</k> mappings</dd>
377 <tags>'awim' 'altwildmode'</tags>
378 <spec>'altwildmode' 'awim'</spec>
379 <type>&option.altwildmode.type;</type>
380 <default>&option.altwildmode.default;</default>
383 Like <o>wildmode</o>, but when the <k name="A-Tab" mode="c"/> key
390 <tags>'au' 'autocomplete'</tags>
391 <spec>'autocomplete' 'au'</spec>
392 <type>&option.autocomplete.type;</type>
393 <default>&option.autocomplete.default;</default>
396 Enables automatic completion for completion contexts (see
397 <ex>:contexts</ex>) matching the given regular expressions. When
398 automatic completion is enabled, the completion list is
399 automatically opened when the &tag.command-line; is focused.
400 Thereafter, any key press triggers a completion update for the
401 matching contexts. Non-matching contexts will only be updated when
402 the <k name="Tab" mode="c"/> key is pressed. This option is useful
403 for disabling auto-completion for computationally intensive
404 contexts that don't perform well when your system is under load.
408 Completion contexts have names very much like Unix path names.
409 These denote the tree in which they're called. A completer will
410 never be called unless every completer preceding it in the tree
411 was also called. For example, if your completer excludes
412 <str>/ex/</str>, it will also exclude <str>/ex/bmarks</str>, and
417 To enable auto-completion for everything but <ex>:history</ex> or
418 <ex>:bmarks</ex>, you would choose a value such as
419 <str delim="">!/ex/(bmarks|history),.?</str>
423 To go in the other direction, i.e. <em>only</em> enable
424 auto-completion for those commands, you have to jump through
425 some hoops, due to the way contexts work (see the note above):
426 <str delim="">/ex/(bmarks|history),^(/|/ex/?)$</str>
432 <tags>'bh' 'banghist'</tags>
433 <spec>'banghist' 'bh'</spec>
434 <type>&option.banghist.type;</type>
435 <default>&option.banghist.default;</default>
438 Replace occurrences of ! with the previous command when
439 executing external commands.
446 <tags>'cd' 'cdpath'</tags>
447 <spec>'cdpath' 'cd'</spec>
448 <type>&option.cdpath.type;</type>
449 <default type="plain">equivalent to <str>.</str> or <str>.,$CDPATH</str></default>
452 List of directories searched when executing the <ex>:cd</ex>
453 command. This is only used for relative paths; if an absolute path is
454 specified, this option is ignored.
457 If the <em>CDPATH</em> environment variable is set this path list
458 is appended to the default value of <str>.</str>.
464 <tags>'ca' 'cookieaccept'</tags>
465 <spec>'cookieaccept' 'ca'</spec>
466 <type>&option.cookieaccept.type;</type>
467 <default>&option.cookieaccept.default;</default>
469 <p>When to accept cookies.</p>
472 <dt>all</dt> <dd>Accept all cookies</dd>
473 <dt>none</dt> <dd>Accept no cookies</dd>
474 <dt>samesite</dt> <dd>Accept all non-third-party cookies</dd>
480 <tags>'cl' 'cookielifetime'</tags>
481 <spec>'cookielifetime' 'cl'</spec>
482 <type>&option.cookielifetime.type;</type>
483 <default>&option.cookielifetime.default;</default>
486 The lifetime for which to accept cookies. The available
490 <dt>default</dt> <dd>The lifetime requested by the setter</dd>
491 <dt>prompt</dt> <dd>Always prompt for a lifetime</dd>
492 <dt>session</dt> <dd>The current session</dd>
493 <dt><a>days</a></dt> <dd>When a number is given, it is
494 interpreted as the number of days for which to keep
501 <tags>'ck' 'cookies'</tags>
502 <spec>'cookies' 'ck'</spec>
503 <type>&option.cookies.type;</type>
504 <default>&option.cookies.default;</default>
506 <p>The default action for the <ex>:cookies</ex> command.</p>
511 <tags>'cpt' 'complete'</tags>
512 <spec>'complete' 'cpt'</spec>
513 <type>&option.complete.type;</type>
514 <default>&option.complete.default;</default>
516 <p>Items which are completed at the <ex>:open</ex> prompts. Available items:</p>
518 <dl dt="width: 6.5em;">
519 <dt>search</dt> <dd>Search engines and keyword URLs</dd>
520 <dt>file</dt> <dd>Local files</dd>
521 <dt>location</dt> <dd>&dactyl.host; location bar entries (bookmarks and history sorted in an intelligent way)</dd>
522 <dt>bookmark</dt> <dd>Bookmarks</dd>
523 <dt>history</dt> <dd>History</dd>
524 <dt>suggestion</dt> <dd>Search engine suggestions</dd>
528 Additionally, native search providers can be added by prefixing
529 their names with the string <str delim="'">native:</str>. These
530 providers are often added by other add-ons and are occasionally
535 The order is important, such that <se opt="complete"><str delim="">bsf</str></se> will
536 list bookmarks followed by matching quick searches and then
541 For backward compatibility, this option currently accepts a single
542 entry containing single-letter names for completers. This usage
543 is deprecated and will be removed in the future.
547 Using <em>bookmark</em> and <em>history</em> can make completion very slow if
548 there are many items.
554 <tags>'ds' 'defsearch'</tags>
555 <spec>'defsearch' 'ds'</spec>
556 <type>&option.defsearch.type;</type>
557 <default>&option.defsearch.default;</default>
560 Sets the default search engine. The default search engine is
561 used by <ex>:open</ex> and related commands for arguments which
562 include no search or bookmark keywords and can't otherwise be
563 converted into URLs or existing file names.
567 This means that with <o>defsearch</o> set to <str>youtube</str>,
568 <ex>:open Tim Minchin</ex> behaves exactly as
569 <ex>:open youtube Tim Minchin</ex>, so long as you don't have a
570 search or bookmark keyword called ‘Tim’.
576 <tags>'dls' 'dlsort' 'downloadsort'</tags>
577 <spec>'downloadsort' 'dlsort' 'dls'</spec>
579 <type>&option.downloadsort.type;</type>
580 <default>&option.downloadsort.default;</default>
583 <ex>:downloads</ex> sort order, in order of precedence.
584 Each element must be preceded by a <tt>+</tt> or
585 <tt>-</tt>, indicating ascending or descending sorting,
586 respectively. Valid sort orders are:
590 <dt>active</dt> <dd>Whether download is active</dd>
591 <dt>complete</dt> <dd>Percent complete</dd>
592 <dt>date</dt> <dd>Date and time the download began</dd>
593 <dt>filename</dt> <dd>Target filename</dd>
594 <dt>size</dt> <dd>File size</dd>
595 <dt>speed</dt> <dd>Download speed</dd>
596 <dt>time</dt> <dd>Time remaining</dd>
597 <dt>url</dt> <dd>Source URL</dd>
603 <tags>'editor'</tags>
604 <spec>'editor'</spec>
605 <type>&option.editor.type;</type>
606 <default>&option.editor.default;</default>
609 Set the external text editor.
610 This is the editor used by <k name="C-i" mode="I"/>, <k>gF</k>, and
611 other commands which launch an external text editor.
615 Accepts a <t>macro-string</t> with the following escapes available.
616 Arguments containing escapes which are not relevant to a given call
617 are automatically elided. All field splitting is done before format
618 characters are processed.
622 <dt><file></dt> <dd>The file to edit. Appended as the final argument if missing.</dd>
623 <dt><line></dt> <dd>The line number at which to position the cursor.</dd>
624 <dt><column></dt> <dd>The column at which to position the cursor.</dd>
628 &dactyl.appName; will not behave correctly if the editor forks its
629 own process rather than blocking until editing is complete. Gvim
630 invoked without the <em>-f</em> option is one such example.
636 <tags>'enc' 'encoding'</tags>
637 <spec>'encoding' 'enc'</spec>
638 <type>&option.encoding.type;</type>
639 <default>&option.encoding.default;</default>
642 Changes the character encoding of the current buffer. Valid only
643 until a new page is loaded.
649 <tags>'noeb' 'noerrorbells'</tags>
650 <tags>'eb' 'errorbells'</tags>
651 <spec>'errorbells' 'eb'</spec>
652 <type>&option.errorbells.type;</type>
653 <default>&option.errorbells.default;</default>
656 Ring the bell when an error message is displayed. See also
663 <tags>'ei' 'eventignore'</tags>
664 <spec>'eventignore' 'ei'</spec>
665 <type>&option.eventignore.type;</type>
666 <default>&option.eventignore.default;</default>
669 A list of autocommand event names which should be ignored. If the
670 list contains the value <str>all</str> then all events are
677 <tags>'noex' 'noexrc'</tags>
678 <tags>'ex' 'exrc'</tags>
679 <spec>'exrc' 'ex'</spec>
680 <type>&option.exrc.type;</type>
681 <default>&option.exrc.default;</default>
684 Allow reading of an RC file in the current directory. This file is
685 sourced after the default <tt><t>&dactyl.name;rc</t></tt> file in your
692 <tags>'eht' 'extendedhinttags'</tags>
693 <spec>'extendedhinttags' 'eht'</spec>
695 <type>&option.extendedhinttags.type;</type>
696 <default>[asOTvVWy]:':-moz-any-link',area[href],img[src],iframe[src],
699 [F]:body,code,div,html,p,pre,span,
701 [S]:button,'input:not([type=hidden])',select,textarea</default>
704 Defines specialized CSS selectors or XPath expressions for arbitrary
705 <t>extended-hints</t> modes. The syntax is the same as for
706 <o>hinttags</o>. If no matches are found, the value of
707 <o>hinttags</o> is used.
713 <tags>'fenc' 'fileencoding'</tags>
714 <spec>'fileencoding' 'fenc'</spec>
715 <type>&option.fileencoding.type;</type>
716 <default>&option.fileencoding.default;</default>
719 Changes the character encoding that &dactyl.appName; uses to read
726 <tags>'fc' 'findcase'</tags>
727 <spec>'findcase' 'fc'</spec>
728 <type>&option.findcase.type;</type>
729 <default>&option.findcase.default;</default>
731 <p>Find case matching mode.</p>
734 <dt>ignore</dt> <dd>Case is never significant</dd>
735 <dt>match</dt> <dd>Case is always significant</dd>
736 <dt>smart</dt> <dd>Case is significant when capital letters are typed</dd>
742 <tags>'ff' 'findflags'</tags>
743 <spec>'findflags' 'ff'</spec>
744 <type>&option.findflags.type;</type>
745 <default>&option.findflags.default;</default>
747 <p>Default flags for find invocations.</p>
750 <dt>C</dt> <dd>Match case</dd>
751 <dt>L</dt> <dd>Search all text</dd>
752 <dt>R</dt> <dd>Perform a plain string search</dd>
753 <dt>c</dt> <dd>Ignore case</dd>
754 <dt>l</dt> <dd>Search only in links</dd>
755 <dt>r</dt> <dd>Perform a regular expression search</dd>
761 <tags>'fh' 'followhints'</tags>
762 <spec>'followhints' 'fh'</spec>
763 <type>&option.followhints.type;</type>
764 <default>&option.followhints.default;</default>
767 Define the conditions under which hints selected by typing the link
768 substring are followed. Hints selected by typing their label (as
769 specified by <o>hintkeys</o>) are always followed immediately.
772 <p>Possible values:</p>
774 <dl dt="width: 6em;">
775 <dt>0</dt> <dd>Follow the first hint as soon as typed text uniquely identifies it.</dd>
776 <dt>1</dt> <dd>Follow the selected hint on <k name="CR" link="false"/>.</dd>
782 <tags>'nofs' 'nofullscreen'</tags>
783 <tags>'fs' 'fullscreen'</tags>
784 <spec>'fullscreen' 'fs'</spec>
785 <type>&option.fullscreen.type;</type>
786 <default>&option.fullscreen.default;</default>
789 Show the current window full-screen. Also hide certain GUI elements, such as
790 <t>status-line</t> and tab bar.
796 <tags>'go' 'guioptions'</tags>
797 <spec>'guioptions' 'go'</spec>
798 <type>&option.guioptions.type;</type>
799 <default>&option.guioptions.default;</default>
801 <p>Show or hide certain GUI elements.</p>
803 <p>Supported characters:</p>
805 <dl dt="width: 6em;">
806 <dt>B</dt> <dd>Bookmark bar</dd>
807 <dt>C</dt> <dd>Always show the command line outside of the status line</dd>
808 <dt>M</dt> <dd>Always show messages outside of the status line</dd>
809 <dt>N</dt> <dd>Tab number over image</dd>
810 <dt>T</dt> <dd>Toolbar</dd>
811 <dt>b</dt> <dd>Bottom scrollbar</dd>
812 <dt>c</dt> <dd>Always show the command line, even when empty</dd>
813 <dt>l</dt> <dd>Left scrollbar (<em>l</em> and <em>r</em> are mutually exclusive)</dd>
814 <dt>m</dt> <dd>Menu bar</dd>
815 <dt>n</dt> <dd>Tab number</dd>
816 <dt>r</dt> <dd>Right scrollbar</dd>
817 <dt>s</dt> <dd>Status bar</dd>
820 <p>See also <o>showtabline</o>.</p>
822 <note>Scrollbar changes require a page reload to take effect.</note>
823 <note>Only one of <em>l</em> or <em>r</em> may be included.</note>
828 <tags>'hf' 'helpfile'</tags>
829 <spec>'helpfile' 'hf'</spec>
830 <type>&option.helpfile.type;</type>
831 <default>&option.helpfile.default;</default>
834 Name of the main help file. This is that page shown if the
835 <ex>:help</ex> command is called without any arguments.
841 <tags>'hin' 'hintinputs'</tags>
842 <spec>'hintinputs' 'hin'</spec>
843 <type>&option.hintinputs.type;</type>
844 <default>&option.hintinputs.default;</default>
847 When generating hints for input elements that do not have an
848 explicit caption, this specifies the methods used to generate a
849 textual hint. The options are attempted in the order they are
850 given, and the first successful value is used.
853 <dl dt="width: 8em;">
854 <dt>value</dt> <dd>The hint is the value displayed in a text input, or the selected option for a drop-down.</dd>
855 <dt>label</dt> <dd>The value of an explicit label for the input; this will not match most manually added labels that are found on sites.</dd>
856 <dt>name </dt> <dd>The name of the input will be used; although the name is not designed for user consumption, it is frequently very similar to the label.</dd>
862 <tags>'hk' 'hintkeys'</tags>
863 <spec>'hintkeys' 'hk'</spec>
864 <type>&option.hintkeys.type;</type>
865 <default>&option.hintkeys.default;</default>
868 The keys used to label and select hints. With its default value,
869 each hint has a unique number which can be typed to select it,
870 while all other characters are used to filter hints based on their
871 text. With a value such as <str>asdfg;lkjh</str>, each hint is
872 ‘numbered’ based on the characters of the home row.
878 <tags>'hm' 'hintmatching'</tags>
879 <spec>'hintmatching' 'hm'</spec>
880 <type>&option.hintmatching.type;</type>
881 <default>&option.hintmatching.default;</default>
883 <p>Change the hint matching algorithm used in Hints mode.</p>
885 <p>Possible values:</p>
890 The typed characters are split on whitespace, and
891 these character groups have to match anywhere inside
892 the text of the link.
894 <dt>wordstartswith</dt>
896 The typed characters are matched with the beginning
897 of the first word (see <o>wordseparators</o>) in the
898 link as long as possible. If no matches occur in the
899 current word, then the matching is continued at the
900 beginning of the next word. The words are worked
901 through in the order they appear in the link. If the
902 typed characters contain spaces, then the characters
903 are split on whitespace. These character groups are
904 then matched with the beginning of the words,
905 beginning at the first one and continuing with the
906 following words in the order they appear in the
909 <dt>firstletters</dt>
911 Behaves like wordstartswith, but non-matching words
916 Delegate to the function
917 <tt>dactyl.plugins.customHintMatcher</tt>.
919 <dt>transliterated</dt>
921 Certain alphanumeric characters are transliterated into their
922 unaccented equivalents, such that ‘euro’ will match 'æuró',
923 and ‘Ångström’ will match ‘angstrom’.
930 <tags>'ht' 'hinttags'</tags>
932 <spec>'hinttags' 'ht'</spec>
933 <type>&option.hinttags.type;</type>
934 <default>:-moz-any-link,area,button,iframe,input:not([type=hidden]),
935 label[for],select,textarea,
936 [onclick],[onmouseover],[onmousedown],[onmouseup],[oncommand],
937 [tabindex],[role=link],[role=button],[contenteditable=true]</default>
940 A list of CSS selectors or XPath expressions used to select elements
941 for <link topic="hints">hinting</link>. Values beginning with the
942 string <str>xpath:</str> are treated as XPath expressions, while any
943 other values are treated as CSS selectors. Can be overridden for
944 individual <t>extended-hints</t> modes with the
945 <o>extendedhinttags</o> option.
951 <tags>'hto' 'hinttimeout'</tags>
952 <spec>'hinttimeout' 'hto'</spec>
953 <type>&option.hinttimeout.type;</type>
954 <default>&option.hinttimeout.default;</default>
957 Timeout in milliseconds before automatically following a non-unique
958 hint. The timeout is measured since the last time a key listed in
959 <o>hintkeys</o> was pressed. It has no effect when narrowing hints
960 by typing part of their text. Set to 0 (the default) to only follow
961 hints after pressing <k name="CR" link="false"/> or when the hint is unique.
967 <tags>'hi' 'history'</tags>
968 <spec>'history' 'hi'</spec>
969 <type>&option.history.type;</type>
970 <default>&option.history.default;</default>
973 Maximum number of Ex commands and find patterns to store in the
974 <t>command-line</t> history.
980 <tags>'nohlf' 'nohlfind'</tags>
981 <tags>'hlf' 'hlfind'</tags>
982 <spec>'hlfind' 'hlf'</spec>
983 <type>&option.hlfind.type;</type>
984 <default>&option.hlfind.default;</default>
986 <p>Highlight previous find pattern matches.</p>
991 <tags>'noif' 'noincfind'</tags>
992 <tags>'if' 'incfind'</tags>
993 <spec>'incfind' 'if'</spec>
994 <type>&option.incfind.type;</type>
995 <default>&option.incfind.default;</default>
997 <p>Show the first match for a find pattern as it is typed.</p>
1002 <tags>'noim' 'noinsertmode'</tags>
1003 <tags>'im' 'insertmode'</tags>
1004 <spec>'insertmode' 'im'</spec>
1005 <type>&option.insertmode.type;</type>
1006 <default>&option.insertmode.default;</default>
1009 Use Insert mode as the default for text areas. This is useful if you
1010 want to use the known &dactyl.host; interface for editing text areas.
1011 Input fields default to this behavior irrespective of this option's
1016 Text Edit mode can be entered with <k name="C-t" mode="I"/> from Insert mode.
1022 <tags>'isk' 'iskeyword'</tags>
1023 <spec>'iskeyword' 'isk'</spec>
1024 <type>&option.iskeyword.type;</type>
1025 <default>&option.iskeyword.default;</default>
1027 <p>Regular expression defining which characters constitute words.</p>
1032 <tags>'nojsd' 'nojsdebugger'</tags>
1033 <tags>'jsd' 'jsdebugger'</tags>
1034 <spec>'jsdebugger' 'jsd'</spec>
1035 <type>&option.jsdebugger.type;</type>
1036 <default>&option.jsdebugger.default;</default>
1039 Use the JavaScript debugger service for JavaScript completion.
1045 <tags>'jt' 'jumptags'</tags>
1046 <spec>'jumptags' 'jt'</spec>
1047 <type>&option.jumptags.type;</type>
1048 <default>&option.jumptags.default;</default>
1050 <p>XPath or CSS selector strings of jumpable elements for extended hint modes.</p>
1055 <tags>'ln' 'linenumbers'</tags>
1056 <spec>'linenumbers' 'ln'</spec>
1057 <type>&option.linenumbers.type;</type>
1058 <default><![CDATA['view-source:*':[id^=line],
1059 code.google.com:'#nums [id^="nums_table"] a[href^="#"]',
1060 github.com:.line_numbers>*,
1061 mxr.mozilla.org:a.l,
1062 pastebin.com:#code_frame>div>ol>li,
1063 addons.mozilla.org:.gutter>.line>a,
1064 bugzilla.mozilla.org:.bz_comment:not(.bz_first_comment):not(.ih_history),
1065 *:'/* Hgweb/Gitweb */ .completecodeline a.codeline, a.linenr']]></default>
1068 Patterns used to determine line numbers used by <k>G</k>. May be
1069 either a selector expression as accepted by <o>hinttags</o>, or the
1070 string <str delim="'">func:</str> followed by a JavaScript
1071 expression which evaluates to a function. In the former case, the
1072 first matching element whose text content is equal to the desired
1073 line number is used. If no such element exists, the <oa>count</oa>th
1074 matching element is used. In the latter case, the provided function
1075 must accept two arguments, the document in question and the desired
1076 line number, and must return the element corresponding to the given
1084 <tags>'lpl' 'loadplugins'</tags>
1085 <spec>'loadplugins' 'lpl'</spec>
1086 <type>&option.loadplugins.type;</type>
1087 <default>&option.loadplugins.default;</default>
1090 A regular expression list that defines which plugins are loaded at
1091 startup or via <ex>:loadplugins</ex>. The first item to match is
1092 the one that takes effect. If no items match, the file is not
1093 loaded. Setting this to a blank value effectively disables plugin
1097 For example, to prepend to the default value of this option to load
1098 all plugins except for <em>foobar-plugin</em>, you could use:
1100 <set opt="loadplugins" op="^=">!<str delim="'">foobar-plugin</str></set>
1102 Alternatively, you can specify which plugins to load and which to
1103 omit in your <tt><t>&dactyl.name;rc</t></tt> using something like
1106 <set opt="loadplugins">!<str delim="'">foo|bar</str>,<str delim="'">\.(js|&dactyl.fileExt;)$</str></set>
1108 That will load all plugins but <em>foo</em> and <em>bar</em>.
1111 Note that in the first expression of the latter example you don't
1112 need parentheses, as the <em>!</em> negates the whole of the
1113 following expression (cf. <t>regexplist</t>).
1116 See also <ex>:runtime</ex>.
1122 <tags>'maxitems'</tags>
1123 <spec>'maxitems'</spec>
1124 <type>&option.maxitems.type;</type>
1125 <default>&option.maxitems.default;</default>
1127 <p>Maximum number of items to display at once in a listing.</p>
1132 <tags>'msgs' 'messages'</tags>
1133 <spec>'messages' 'msgs'</spec>
1134 <type>&option.messages.type;</type>
1135 <default>&option.messages.default;</default>
1137 <p>Maximum number of messages to store in the message history.</p>
1142 <tags>'nomore' 'more'</tags>
1144 <type>&option.more.type;</type>
1145 <default>&option.more.default;</default>
1148 Pause the message list window when more than one screen of
1149 listings is displayed.
1155 <tags>'newtab'</tags>
1156 <spec>'newtab'</spec>
1157 <type>&option.newtab.type;</type>
1158 <default>&option.newtab.default;</default>
1161 Defines which Ex commands open pages in new tabs rather than the
1162 current tab by default. This may be overridden with the
1163 <ex>:tab</ex> command, and is usually inverted by affixing a
1164 <em>!</em> to the command in question.
1167 <p>Possible values:</p>
1170 <dt>all</dt> <dd>All commands</dd>
1171 <dt>addons</dt> <dd><ex>:addo<oa>ns</oa></ex> command</dd>
1172 <dt>downloads</dt> <dd><ex>:downl<oa>oads</oa></ex> command</dd>
1173 <dt>extoptions</dt> <dd><ex>:exto<oa>ptions</oa></ex> command</dd>
1174 <dt>help</dt> <dd><ex>:h<oa>elp</oa></ex> command</dd>
1175 <dt>javascript</dt> <dd><ex>:javascript!</ex> or <ex>:js!</ex> command</dd>
1176 <dt>prefs</dt> <dd><ex>:pref<oa>erences</oa>!</ex> or <ex>:prefs!</ex> command</dd>
1183 <tags>'nextpattern'</tags>
1185 <spec>'nextpattern'</spec>
1186 <type>&option.nextpattern.type;</type>
1187 <default>&option.nextpattern.default;</default>
1190 Patterns to use when guessing the next page in a document
1191 sequence after pressing the <k>]]</k> key. Each pattern is
1192 successively tested against each link in the page (as defined by
1193 <o>hinttags</o>, starting with the last), and the first link to
1200 <tags>'noonline' 'online'</tags>
1201 <spec>'online'</spec>
1202 <type>&option.online.type;</type>
1203 <default>&option.online.default;</default>
1206 Enables or disables ‘offline’ mode, where network access is
1207 disabled and all web pages are loaded entirely from cache.
1213 <tags>'pa' 'pageinfo'</tags>
1214 <spec>'pageinfo' 'pa'</spec>
1215 <type>&option.pageinfo.type;</type>
1216 <default>&option.pageinfo.default;</default>
1218 <p>Info shown in the <ex>:pageinfo</ex> output.</p>
1220 <p>Items available by default:</p>
1222 <dl dt="width: 6em;">
1223 <dt>g</dt> <dd>General info</dd>
1224 <dt>e</dt> <dd>Search Engines</dd>
1225 <dt>f</dt> <dd>Feeds</dd>
1226 <dt>m</dt> <dd>Meta tags</dd>
1227 <dt>s</dt> <dd>Security information</dd>
1231 The order of the options defines the order in which they appear in
1238 <tags>'pk' 'passkeys'</tags>
1239 <spec>'passkeys' 'pk'</spec>
1240 <type>&option.passkeys.type;</type>
1241 <default>&option.passkeys.default;</default>
1244 Pass certain keys through directly for the given URLs.
1245 For any page with a URL matching a given <t>site-filter</t>, all key
1246 events for keys listed in the corresponding value are passed
1247 through directly to &dactyl.host;, and are not processed
1248 by &dactyl.appName; in any way. Key names are separated
1249 by commas, where the first key name is treated as a list
1250 of individual keys and each subsequent key is treated as
1251 a key chain. Individual key entries always apply to all
1252 modes. Key chains apply only to non-input modes unless
1253 they begin with a key requiring a modifier other than
1257 <example><set opt="passkeys" op="+="><str delim="">mail.google.com</str>:<str delim="">jk<CR></str>,<str delim="">gi</str></set></example>
1260 More subtle and complex pass through can be achieved
1261 using <t>groups</t> and mode-specific mappings utilizing
1262 the <k name="Pass"/> pseudo-key.
1268 <tags>'pu' 'passunknown'</tags>
1269 <spec>'passunknown' 'pu'</spec>
1270 <type>&option.passunknown.type;</type>
1271 <default>&option.passunknown.default;</default>
1274 Pass unknown keys through to &dactyl.host; in these
1275 <t>modes</t>. The first element matching a currently
1276 active mode is the one that takes effect. Modes may be
1277 negated by prefixing them with a <tt>!</tt>.
1283 <tags>'pps' 'popups'</tags>
1284 <spec>'popups' 'pps'</spec>
1285 <type>&option.popups.type;</type>
1286 <default>&option.popups.default;</default>
1289 Defines where to show requested pop-up windows. Applies only to
1290 links which request to open in a new window. The behavior of
1291 middle-, shift-, or control- clicking a link is unaffected by this
1295 <p>Possible values are:</p>
1297 <dl dt="width: 8em;">
1298 <dt>tab</dt> <dd>Open pop-ups in a new tab</dd>
1299 <dt>window</dt> <dd>Open pop-ups in a new window</dd>
1300 <dt>resized</dt> <dd>Open resized pop-ups in a new window</dd>
1304 If neither <em>tab</em> nor <em>window</em> is provided, all
1305 pop-ups open in the current tab. <em>tab</em> and <em>window</em>
1306 are mutually exclusive, and the last one listed is effective.
1310 This option does not alter the &dactyl.host; pop-up blocker behavior
1317 <tags>'previouspattern'</tags>
1319 <spec>'previouspattern'</spec>
1320 <type>&option.previouspattern.type;</type>
1321 <default>&option.previouspattern.default;</default>
1324 Patterns to use when guessing the previous page in a document
1325 sequence after pressing the <k>[[</k> key. Each pattern is
1326 successively tested against each link in the page (as defined by
1327 <o>hinttags</o>, starting with the last), and the first link to
1334 <tags>$&dactyl.idName;_RUNTIME</tags>
1335 <tags>'rtp' 'runtimepath'</tags>
1336 <spec>'runtimepath' 'rtp'</spec>
1337 <type>&option.runtimepath.type;</type>
1338 <default type="plain"><str>$&dactyl.idName;_RUNTIME</str> or
1339 Unix, Mac: <str>~/.&dactyl.name;</str>
1340 Windows: <str>~/&dactyl.name;</str></default>
1342 <p>List of directories searched for runtime files:</p>
1351 <set opt="runtimepath"><str delim="">~/my&dactyl.name;</str>,<str delim="">~/.&dactyl.name;</str></set>
1354 This will search for plugins in both
1355 <str>~/my&dactyl.name;/plugins</str> and
1356 <str>~/.&dactyl.name;/plugins</str>
1360 On startup, if the environment variable <em>$&dactyl.idName;_RUNTIME</em> does not
1361 exist, &dactyl.appName; will set it to match this value.
1367 <tags>'si' 'sanitizeitems'</tags>
1368 <spec>'sanitizeitems' 'si'</spec>
1370 <type>&option.sanitizeitems.type;</type>
1371 <default>&option.sanitizeitems.default;</default>
1374 The default list of private items to sanitize. See
1375 <ex>:sanitize</ex> for a list and explanation of possible values. A
1376 value of <str>all</str> will cause all items to be sanitized. Items
1377 may be excluded by prefixing them with a <tt>!</tt>. The first
1378 matching item takes precedence.
1384 <tags>'ss' 'sanitizeshutdown'</tags>
1385 <spec>'sanitizeshutdown' 'ss'</spec>
1386 <type>&option.sanitizeshutdown.type;</type>
1387 <default>&option.sanitizeshutdown.default;</default>
1389 <p>The items to sanitize automatically at shutdown.</p>
1394 <tags>'sts' 'sanitizetimespan'</tags>
1395 <spec>'sanitizetimespan' 'sts'</spec>
1397 <type>&option.sanitizetimespan.type;</type>
1398 <default>&option.sanitizetimespan.default;</default>
1401 The default sanitizer time span. Only items created within this timespan are
1402 deleted. The value must be of the one of:
1405 <dl dt="width: 8em;">
1406 <dt>all</dt> <dd>Everything</dd>
1407 <dt>session</dt> <dd>The current session</dd>
1408 <dt><a>n</a>m</dt> <dd>Past <a>n</a> Minutes</dd>
1409 <dt><a>n</a>h</dt> <dd>Past <a>n</a> Hours</dd>
1410 <dt><a>n</a>d</dt> <dd>Past <a>n</a> Days</dd>
1411 <dt><a>n</a>w</dt> <dd>Past <a>n</a> Weeks</dd>
1417 <tags>'scr' 'scroll'</tags>
1418 <spec>'scroll' 'scr'</spec>
1419 <type>&option.scroll.type;</type>
1420 <default>&option.scroll.default;</default>
1423 Number of lines to scroll with <k name="C-u"/> and <k name="C-d"/>
1424 commands. The number of lines scrolled defaults to half the window
1425 size. When a <oa>count</oa> is specified to the <k name="C-u"/> or
1426 <k name="C-d"/> commands, set this option to <oa>count</oa> before
1427 executing the command. Setting this to <em>0</em> restores the
1434 <tags>'scs' 'scrollsteps'</tags>
1435 <spec>'scrollsteps' 'scs'</spec>
1436 <type>&option.scrollsteps.type;</type>
1437 <default>&option.scrollsteps.default;</default>
1440 The number of steps in which to smooth scroll to a new position. If
1441 set to 1, smooth scrolling is not used.
1447 <tags>'sct' 'scrolltime'</tags>
1448 <spec>'scrolltime' 'sct'</spec>
1449 <type>&option.scrolltime.type;</type>
1450 <default>&option.scrolltime.default;</default>
1452 <p>The time, in milliseconds, in which to smooth scroll to a new position.</p>
1457 <tags>'sh' 'shell'</tags>
1458 <spec>'shell' 'sh'</spec>
1459 <type>&option.shell.type;</type>
1460 <default type="plain"><em>$SHELL</em> or <str>sh</str>, Windows: <str>cmd.exe</str></default>
1462 <p>Shell to use for executing <ex>:!</ex> and <ex>:run</ex> commands.</p>
1467 <tags>'shcf' 'shellcmdflag'</tags>
1468 <spec>'shellcmdflag' 'shcf'</spec>
1470 <type>&option.shellcmdflag.type;</type>
1471 <default type="plain"><str>-c</str>, Windows: <str>/c</str></default>
1473 <p>Flag passed to shell when executing <ex>:!</ex> and <ex>:run</ex> commands.</p>
1478 <tags>'smd' 'showmode'</tags>
1479 <spec>'showmode' 'smd'</spec>
1480 <type>&option.showmode.type;</type>
1481 <default>&option.showmode.default;</default>
1484 Show the current mode in the command line if it or any
1485 of its parent <t>modes</t> is included in the list.
1486 Modes may be negated by prefixing them with a
1493 <tags>'ssli' 'showstatuslinks'</tags>
1494 <spec>'showstatuslinks' 'ssli'</spec>
1496 <type>&option.showstatuslinks.type;</type>
1497 <default>&option.showstatuslinks.default;</default>
1500 When the mouse hovers over a link, or a link is otherwise focused,
1501 show its destination in the status bar.
1504 <p>Possible values are:</p>
1507 <dt></dt> <dd>Don't show link destination</dd>
1508 <dt>status</dt> <dd>Show the link destination in the &tag.status-line;</dd>
1509 <dt>command</dt> <dd>Show the link destination in the &tag.command-line;</dd>
1515 <tags>'stal' 'showtabline'</tags>
1516 <spec>'showtabline' 'stal'</spec>
1517 <type>&option.showtabline.type;</type>
1518 <default>&option.showtabline.default;</default>
1520 <p>Define when the tab bar is visible.</p>
1523 <dt>always</dt> <dd>Always show the tab bar</dd>
1524 <dt>multitab</dt> <dd>Show the tab bar when there are multiple tabs</dd>
1525 <dt>never</dt> <dd>Never show the tab bar</dd>
1531 <tags>'spl' 'spelllang'</tags>
1532 <spec>'spelllang' 'spl'</spec>
1533 <type>&option.spelllang.type;</type>
1534 <default>&option.spelllang.default;</default>
1535 <description short="true">
1536 <p>The language used by the spell checker.</p>
1541 <tags>'sf' 'strictfocus'</tags>
1542 <spec>'strictfocus' 'sf'</spec>
1543 <type>&option.strictfocus.type;</type>
1544 <default>&option.strictfocus.default;</default>
1547 Prevent scripts from focusing input elements without user intervention.
1550 <p>Possible values:</p>
1553 <dt>despotic</dt> <dd>Only allow focus changes when explicitly requested by the user</dd>
1554 <dt>laissez-faire</dt> <dd>Always allow focus changes</dd>
1555 <dt>moderate</dt> <dd>Allow focus changes after user-initiated focus change</dd>
1561 <tags>'suggestengines'</tags>
1562 <spec>'suggestengines'</spec>
1563 <type>&option.suggestengines.type;</type>
1564 <default>&option.suggestengines.default;</default>
1567 Set the search engines which can be used for completion
1568 suggestions when <o>complete</o> contains <em>S</em>.
1574 <tags>'notmo' 'notimeout'</tags>
1575 <tags>'tmo' 'timeout'</tags>
1576 <spec>'timeout' 'tmo'</spec>
1577 <type>&option.timeout.type;</type>
1578 <default>&option.timeout.default;</default>
1581 When this option is set and a key sequence interpretable both as a
1582 complete command and as a start of a longer command is typed,
1583 execute the shorter command after <o>timeoutlen</o> milliseconds.
1589 <tags>'tmol' 'timeoutlen'</tags>
1590 <spec>'timeoutlen' 'tmol'</spec>
1591 <type>&option.timeoutlen.type;</type>
1592 <default>&option.timeoutlen.default;</default>
1595 Maximum number of milliseconds to wait for a longer key command
1596 when a shorter one exists. Only effective when <o>timeout</o> is
1603 <tags>'titlestring'</tags>
1604 <spec>'titlestring'</spec>
1605 <type>&option.titlestring.type;</type>
1606 <default>&option.titlestring.default;</default>
1609 Set the application name shown after the current page title in
1610 &dactyl.host;'s title bar.
1612 <example><set opt="titlestring"><str>Mozilla &dactyl.host;</str></set></example>
1617 <tags>'us' 'urlsep' 'urlseparator'</tags>
1618 <spec>'urlseparator' 'urlsep' 'us'</spec>
1619 <type>&option.urlseparator.type;</type>
1620 <default>&option.urlseparator.default;</default>
1623 The regular expression used to split URL lists in commands
1624 like <ex>:open</ex>. When set to the empty string, URL lists
1625 are never split. With the default settings, the following will open
1626 three URLs (the first one in the current tab and the latter two in
1627 two new background tabs):
1629 <code><ex>:open <str delim="">google Linux</str> | <str delim="">wikipedia Arch Linux</str> | <str delim="">imdb Serenity</str></ex></code>
1634 <tags>'noum' 'nousermode'</tags>
1635 <tags>'um' 'usermode'</tags>
1636 <spec>'usermode' 'um'</spec>
1637 <type>&option.usermode.type;</type>
1638 <default>&option.usermode.default;</default>
1640 <p>Show current website with minimal styling.</p>
1645 <tags>'vbs' 'verbose'</tags>
1646 <spec>'verbose' 'vbs'</spec>
1647 <type>&option.verbose.type;</type>
1648 <default>&option.verbose.default;</default>
1651 Define which info messages are displayed. As the value increases,
1652 &dactyl.appName; will show more messages about its progress.
1653 These can be viewed at any time with the <ex>:messages</ex>
1654 command. The highest useful value is 15, being the most verbose
1657 <!-- TODO: list levels and associated messages -->
1662 <tags>'novb' 'novisualbell'</tags>
1663 <tags>'vb' 'visualbell'</tags>
1664 <spec>'visualbell' 'vb'</spec>
1665 <type>&option.visualbell.type;</type>
1666 <default>&option.visualbell.default;</default>
1669 Use visual bell instead of beeping on errors. The visual bell
1670 style is controlled by <ex>:highlight Bell</ex>. See also
1677 <tags>'wia' 'wildanchor'</tags>
1679 <spec>'wildanchor' 'wia'</spec>
1680 <type>&option.wildanchor.type;</type>
1681 <default>&option.wildanchor.default;</default>
1684 Regular expression list defining which completion groups show only
1685 matches anchored to the beginning of the result. The first
1686 matching expression is the one that applies. If the match is
1687 negated, then the current filter may match anywhere in the result.
1688 If it is not negated, then the match may only occur at the
1689 beginning of the result. If no items match, then a
1690 context-dependent default value is used.
1696 <tags>'wic' 'wildcase'</tags>
1697 <spec>'wildcase' 'wic'</spec>
1698 <type>&option.wildcase.type;</type>
1699 <default>&option.wildcase.default;</default>
1702 Defines how completions are matched with regard to character case.
1703 Keys in the <t>regexpmap</t> refer to completion context names (see
1704 <ex>:contexts</ex>) for which the value applies. Possible values
1709 <dt><str>smart</str></dt> <dd>Case is significant when capital letters are typed</dd>
1710 <dt><str>match</str></dt> <dd>Case is always significant</dd>
1711 <dt><str>ignore</str></dt> <dd>Case is never significant</dd>
1717 <tags>'wig' 'wildignore'</tags>
1718 <spec>'wildignore' 'wig'</spec>
1719 <type>&option.wildignore.type;</type>
1720 <default>&option.wildignore.default;</default>
1723 List of path name patterns to ignore when completing files and
1724 directories. For example, the following will ignore object files
1728 <set opt="wildignore"><str delim="'">\.o$</str>,<str delim="'">^\..*\.s[a-z]{2}$</str></set>
1730 <note>Unlike Vim, each pattern is a regular expression rather than a glob.</note>
1735 <tags>'wim' 'wildmode'</tags>
1736 <spec>'wildmode' 'wim'</spec>
1737 <type>&option.wildmode.type;</type>
1738 <default>&option.wildmode.default;</default>
1741 Defines how command-line completion works. It is a comma-separated
1742 list of parts, where each part specifies what to do for each
1743 consecutive press of the <k name="Tab" mode="c"/> key. The last
1744 element in the list is used for each succeeding <k name="Tab" mode="c"/>
1745 after it has been reached.
1748 <p>These are the possible values for each part:</p>
1751 <dt><str></str></dt> <dd>Complete only the first match.</dd>
1752 <dt><str>full</str></dt> <dd>Complete the next full match. After the last, the original string is used.</dd>
1753 <dt><str>longest</str></dt> <dd>Complete the longest common substring of all completions.</dd>
1754 <dt><str>list</str></dt> <dd>When more than one match, list all matches.</dd>
1755 <dt><str>list:full</str></dt> <dd>When more than one match, list all matches and complete the first match.</dd>
1756 <dt><str>list:longest</str></dt>
1758 When more than one match, list all matches and
1759 complete till the longest common string. When there
1760 is only a single match, it is fully completed
1761 regardless of the case.
1766 See also <o>altwildmode</o>.
1773 <tags>'wis' 'wildsort'</tags>
1774 <spec>'wildsort' 'wis'</spec>
1775 <type>&option.wildsort.type;</type>
1776 <default>&option.wildsort.default;</default>
1779 A list of regular expressions defining which completion contexts
1780 should be sorted. The main purpose of this option is to prevent
1781 sorting of certain completion lists that don't perform well under
1785 <p>See also <ex>:contexts</ex>.</p>
1790 <tags>'wsp' 'wordseparators'</tags>
1791 <spec>'wordseparators' 'wsp'</spec>
1793 <type>&option.wordseparators.type;</type>
1794 <default>&option.wordseparators.default;</default>
1797 A regular expression which defines how words are split for
1798 the <o>hintmatching</o> types <str>wordstartswith</str> and
1799 <str>firstletters</str>. Words are split on each occurrence of the
1806 <tags>'ys' 'yankshort'</tags>
1807 <spec>'yankshort' 'ys'</spec>
1808 <type>&option.yankshort.type;</type>
1809 <default>&option.yankshort.default;</default>
1811 <p>Yank the canonical short URL of a web page where provided.</p>
1818 <!-- vim:se sts=4 sw=4 et: -->