1- *autocmd.txt* For Vim version 9.1. Last change: 2025 Sep 14
1+ *autocmd.txt* For Vim version 9.1. Last change: 2025 Oct 12
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -236,7 +236,7 @@ autocmds.
236236
237237 *:autocmd-verbose*
238238When 'verbose' is non-zero, listing an autocommand will also display where it
239- was last defined. Example: >
239+ was last defined. Example: >
240240
241241 :verbose autocmd BufEnter
242242 FileExplorer BufEnter
@@ -344,7 +344,8 @@ Name triggered by ~
344344| GUIEnter | after starting the GUI successfully
345345| GUIFailed | after starting the GUI failed
346346| TermResponse | after the terminal response to | t_RV | is received
347- | TermResponseAll | after the terminal response to | t_RV | and others is received
347+ | TermResponseAll | after the terminal response to | t_RV | and others is
348+ received
348349
349350| QuitPre | when using `:quit ` , before deciding whether to exit
350351| ExitPre | when using a command that may make Vim exit
@@ -381,7 +382,8 @@ Name triggered by ~
381382| FocusGained | Vim got input focus
382383| FocusLost | Vim lost input focus
383384| CursorHold | the user doesn't press a key for a while
384- | CursorHoldI | the user doesn't press a key for a while in Insert mode
385+ | CursorHoldI | the user doesn't press a key for a while in Insert
386+ mode
385387| CursorMoved | the cursor was moved in Normal mode
386388| CursorMovedC | the cursor was moved in the | Command-line |
387389| CursorMovedI | the cursor was moved in Insert mode
@@ -566,7 +568,8 @@ BufWinEnter After a buffer is displayed in a window. This
566568 since it reloads that buffer.
567569 Does not happen for a terminal window, because
568570 it starts in Terminal-Job mode and Normal mode
569- commands won't work. Use | TerminalOpen | instead.
571+ commands won't work. Use | TerminalOpen |
572+ instead.
570573 *BufWinLeave*
571574BufWinLeave Before a buffer is removed from a window.
572575 Not when it's still visible in another window.
@@ -679,7 +682,7 @@ ColorScheme After loading a color scheme. |:colorscheme|
679682 Not triggered if the color scheme is not
680683 found.
681684 The pattern is matched against the
682- colorscheme name. <afile> can be used for the
685+ colorscheme name. <afile> can be used for the
683686 name of the actual file where this option was
684687 set, and <amatch> for the new colorscheme
685688 name.
@@ -748,7 +751,7 @@ CursorHold When the user doesn't press a key for the time
748751 triggered. | q |
749752 *<CursorHold>*
750753 Internally the autocommand is triggered by the
751- <CursorHold> key. In an expression mapping
754+ <CursorHold> key. In an expression mapping
752755 | getchar() | may see this character.
753756
754757 Note: Interactive commands cannot be used for
@@ -1014,7 +1017,7 @@ InsertLeave Just after leaving Insert mode. Also when
10141017 using CTRL-O | i_CTRL-O | . But not for | i_CTRL-C | .
10151018 *KeyInputPre*
10161019KeyInputPre Just before a key is processed after mappings
1017- have been applied. The pattern is matched
1020+ have been applied. The pattern is matched
10181021 against a string that indicates the current
10191022 mode, which is the same as what is returned by
10201023 `mode (1 )` .
@@ -1046,7 +1049,7 @@ MenuPopup Just before showing the popup menu (under the
10461049 c Command line
10471050 tl Terminal
10481051 *ModeChanged*
1049- ModeChanged After changing the mode. The pattern is
1052+ ModeChanged After changing the mode. The pattern is
10501053 matched against `' old_mode:new_mode' ` , for
10511054 example match against `* :c * ` to simulate
10521055 | CmdlineEnter | .
@@ -1082,18 +1085,18 @@ OptionSet After setting an option. The pattern is
10821085
10831086 | v:option_oldlocal | is only set when | :set |
10841087 or | :setlocal | or a | modeline | was used to set
1085- the option. Similarly | v:option_oldglobal | is
1088+ the option. Similarly | v:option_oldglobal | is
10861089 only set when | :set | or | :setglobal | was used.
10871090
10881091 This does not set | <abuf> | , you could use
10891092 | bufnr() | .
10901093
10911094 Note that when setting a | global-local | string
10921095 option with | :set | , then | v:option_old | is the
1093- old global value. However, for all other kinds
1094- of options (local string options, global-local
1095- number options, ...) it is the old local
1096- value.
1096+ old global value. However, for all other
1097+ kinds of options (local string options,
1098+ global-local number options, ...) it is the
1099+ old local value.
10971100
10981101 OptionSet is not triggered on startup and for
10991102 the 'key' option for obvious reasons.
@@ -1105,7 +1108,7 @@ OptionSet After setting an option. The pattern is
11051108
11061109 Note: It's a bad idea to reset an option
11071110 during this autocommand, this may break a
1108- plugin. You can always use `:noa ` to prevent
1111+ plugin. You can always use `:noa ` to prevent
11091112 triggering this autocommand.
11101113
11111114 When using | :set | in the autocommand the event
@@ -1130,7 +1133,7 @@ QuickFixCmdPre Before a quickfix command is run (|:make|,
11301133 *QuickFixCmdPost*
11311134QuickFixCmdPost Like QuickFixCmdPre, but after a quickfix
11321135 command is run, before jumping to the first
1133- location. For | :cfile | and | :lfile | commands
1136+ location. For | :cfile | and | :lfile | commands
11341137 it is run after the error file is read and
11351138 before moving to the first error.
11361139 See | QuickFixCmdPost-example | .
@@ -1174,7 +1177,7 @@ SafeState When nothing is pending, going to wait for the
11741177 screen was scrolled for messages.
11751178 *SafeStateAgain*
11761179SafeStateAgain Like SafeState but after processing any
1177- messages and invoking callbacks. This may be
1180+ messages and invoking callbacks. This may be
11781181 triggered often, don't do something that takes
11791182 time.
11801183
@@ -1278,12 +1281,12 @@ TermChanged After the value of 'term' has changed. Useful
12781281 settings. Executed for all loaded buffers.
12791282 *TerminalOpen*
12801283TerminalOpen Just after a terminal buffer was created, with
1281- `:terminal ` or | term_start() | . This event is
1284+ `:terminal ` or | term_start() | . This event is
12821285 triggered even if the buffer is created
12831286 without a window, with the ++hidden option.
12841287 *TerminalWinOpen*
12851288TerminalWinOpen Just after a terminal buffer was created, with
1286- `:terminal ` or | term_start() | . This event is
1289+ `:terminal ` or | term_start() | . This event is
12871290 triggered only if the buffer is created
12881291 with a window. Can be used to set window
12891292 local options for the terminal window.
@@ -1480,7 +1483,7 @@ WinLeave Before leaving a window. If the window to be
14801483 Not used for ":qa" or ":q" when exiting Vim.
14811484
14821485 *WinNewPre*
1483- WinNewPre Before creating a new window. Triggered
1486+ WinNewPre Before creating a new window. Triggered
14841487 before commands that modify window layout by
14851488 creating a split.
14861489 Not done when creating tab pages and for the
@@ -1789,8 +1792,8 @@ option will not cause any commands to be executed.
17891792 After applying the autocommands the modelines are
17901793 processed, so that their settings overrule the
17911794 settings from autocommands, like what happens when
1792- editing a file. This is skipped when the <nomodeline>
1793- argument is present. You probably want to use
1795+ editing a file. This is skipped when the <nomodeline>
1796+ argument is present. You probably want to use
17941797 <nomodeline> for events that are not used when loading
17951798 a buffer, such as | User | .
17961799 Processing modelines is also skipped when no
@@ -1802,7 +1805,7 @@ option will not cause any commands to be executed.
18021805 loaded buffer. The current buffer is done last.
18031806
18041807 Note that [fname] is used to select the autocommands,
1805- not the buffers to which they are applied. Example: >
1808+ not the buffers to which they are applied. Example: >
18061809 augroup mine
18071810 autocmd!
18081811 autocmd FileType * echo expand('<amatch>')
0 commit comments