Lines Matching refs:buffer
22 7. Argument and buffer list commands |buffer-list|
26 11. Using hidden buffers |buffer-hidden|
36 A buffer is the in-memory text of a file.
37 A window is a viewport on a buffer.
40 A window is a viewport onto a buffer. You can use multiple windows on one
41 buffer, or several windows on different buffers.
43 A buffer is a file loaded into memory for editing. The original file remains
44 unchanged until you write the buffer to the file.
46 A buffer can be in one of three states:
48 *active-buffer*
49 active: The buffer is displayed in a window. If there is a file for this
50 buffer, it has been read into the buffer. The buffer may have been
52 *hidden-buffer*
53 hidden: The buffer is not displayed. If there is a file for this buffer, it
54 has been read into the buffer. Otherwise it's the same as an active
55 buffer, you just can't see it.
56 *inactive-buffer*
57 inactive: The buffer is not displayed and does not contain anything. Options
58 for the buffer are remembered if the file was once loaded. It can
59 contain marks from the |viminfo| file. But the buffer doesn't
86 Each buffer has a unique number and the number will not change within a Vim
88 between a buffer name and the buffer number.
141 The lines after the last buffer line in a window are called filler lines. By
165 is not loaded in any buffer, it will be read. Else the new
166 window will use the already loaded buffer.
199 used for the new buffer. If 'fileformats' is empty, the
200 'fileformat' of the current buffer is used. This can be
205 3. BufLeave for the current buffer
206 4. BufEnter for the new buffer
229 Same as ":split", but set 'readonly' option for this buffer.
238 buffer N. Similar to ":sp #" and ":sp #N", but it allows the
239 other buffer to be unnamed. This command matches the behavior
309 current buffer, it becomes hidden. When 'hidden' is not set,
310 and there is only one window for the current buffer, and the
311 buffer was changed, the command fails.
334 If this was the last window for a buffer, any changes to that
335 buffer are lost. When quitting the last window (not counting
336 help windows), exit Vim. The contents of the buffer are lost,
345 When the 'hidden' option is set, or when the buffer was
346 changed and the [!] is used, the buffer becomes hidden (unless
355 - When 'hidden' is not set, [!] is not used, the buffer has
356 changes, and there is no other window on this buffer.
357 Changes to the buffer are not written and won't get lost, so
372 The buffer becomes hidden (unless there is another window
378 to the buffer are not written and won't get lost, so this is a
385 < This will edit "Makefile", and hide the current buffer if it
457 If Visual mode is active and the new window is not for the same buffer, the
458 Visual mode is ended. If the window is on the same buffer, the cursor
618 7. Argument and buffer list commands *buffer-list*
620 args list buffer list meaning ~
621 1. :[N]argument [N] 11. :[N]buffer [N] to arg/buf N
631 split & args list split & buffer list meaning ~
649 [N] is a buffer number, defaulting to current buffer, for 11 and 31
666 All the entries in the argument list are added to the buffer list. Thus, you
667 can also get to them with the buffer list commands, like ":bnext".
730 current window. If the current buffer can't be |abandon|ed,
765 :[range]bufdo[!] {cmd} Execute {cmd} in each buffer in the buffer list or if
767 buffer number is in the [range]. It works like doing
776 When an error is detected on one buffer, further
779 The last buffer (or where an error occurred) becomes
780 the current buffer.
783 buffer list.
787 each buffer.
800 This resets the 'fileencoding' in each buffer and writes it if this changed
801 the buffer. The result is that all buffers will use the 'encoding' encoding
899 - If the file is in a buffer already, it will be re-used. This will allow for
902 window. However, if you later open the same buffer in a normal window, you
910 "Preview" window without changing the current buffer or cursor
924 option is set, or when the buffer was changed and the [!] is
925 used, the buffer becomes hidden (unless there is another
926 window editing it). The command fails if any "Preview" buffer
1020 11. Using hidden buffers *buffer-hidden*
1022 A hidden buffer is not displayed in a window, but is still loaded into memory.
1024 write the file every time you get another buffer in a window.
1026 *:buffer-!*
1029 commands that move through the buffer list sometimes make the current buffer
1030 hidden although the 'hidden' option is not set. This happens when a buffer is
1032 'autowrite' is off or the buffer can't be written.
1034 You can make a hidden buffer not hidden by starting to edit it with any
1038 can be used to make an exception for a specific buffer. It can take these
1041 hide Hide this buffer, also when 'hidden' is not set.
1042 unload Don't hide but unload this buffer, also when 'hidden'
1044 delete Delete the buffer.
1047 When you try to quit Vim while there is a hidden, modified buffer, you will
1048 get an error message and Vim will make that buffer the current buffer. You
1049 can then decide to write this buffer (":wq") or quit without writing (":q!").
1052 A buffer can also be unlisted. This means it exists, but it is not in the
1053 list of buffers. |unlisted-buffer|
1068 Each buffer has a unique number. That number will not change,
1069 thus you can always go to a specific buffer with ":buffer N"
1070 or "N CTRL-^", where N is the buffer number.
1073 [Prompt] |prompt-buffer|
1074 [Popup] buffer of a |popup-window|
1077 For a |terminal-window| buffer the status is used.
1080 u an unlisted buffer (only displayed when [!] is used)
1081 |unlisted-buffer|
1082 % the buffer in the current window
1083 # the alternate buffer for ":e #" and CTRL-^
1084 a an active buffer: it is loaded and visible
1085 h a hidden buffer: It is loaded, but currently not
1086 displayed in a window |hidden-buffer|
1087 - a buffer with 'modifiable' off
1088 = a readonly buffer
1089 R a terminal buffer with a running job
1090 F a terminal buffer with a finished job
1091 ? a terminal buffer without a job: `:terminal NONE`
1092 + a modified buffer
1093 x a buffer with read errors
1104 % current buffer
1105 # alternate buffer
1115 displayed buffer name, e.g.: >
1120 Add file name {fname} to the buffer list, without loading it,
1121 if it wasn't listed yet. If the buffer was previously
1124 line when the buffer is first entered. Note that other
1134 Unload buffer [N] (default: current buffer) and delete it from
1135 the buffer list. If the buffer was changed, this fails,
1137 The file remains unaffected. Any windows for this buffer are
1138 closed. If buffer [N] is the current buffer, another buffer
1140 the jump list that points into a loaded buffer.
1141 Actually, the buffer isn't completely deleted, it is removed
1142 from the buffer list |unlisted-buffer| and option values,
1143 variables and mappings/abbreviations for the buffer are
1151 Like ":bdelete[!] [N]", but buffer given by name, see
1155 Do ":bdelete[!]" for buffer N1, N2, etc. The arguments can be
1156 buffer numbers or buffer names (but not buffer names that are
1157 a number). Insert a backslash before a space in a buffer
1167 Like |:bdelete|, but really delete the buffer. Everything
1168 related to the buffer is lost. All marks in this buffer
1178 Unload buffer [N] (default: current buffer). The memory
1179 allocated for this buffer will be freed. The buffer remains
1180 in the buffer list.
1181 If the buffer was changed, this fails, unless when [!] is
1183 Any windows for this buffer are closed. If buffer [N] is the
1184 current buffer, another buffer will be displayed instead.
1186 into a loaded buffer.
1189 Like ":bunload[!] [N]", but buffer given by name.
1196 Do ":bunload[!]" for buffer N1, N2, etc. The arguments can be
1197 buffer numbers or buffer names (but not buffer names that are
1198 a number). Insert a backslash before a space in a buffer
1201 :[N]b[uffer][!] [+cmd] [N] *:b* *:bu* *:buf* *:buffer* *E86*
1202 Edit buffer [N] from the buffer list. If [N] is not given,
1203 the current buffer remains being edited. See |:buffer-!| for
1204 [!]. This will also edit a buffer that is not in the buffer
1209 Edit buffer for {bufname} from the buffer list. A partial
1212 Note that a buffer whose name is a number cannot be referenced
1213 by that name; use the buffer number instead.
1214 Insert a backslash before a space in a buffer name.
1215 See |:buffer-!| for [!].
1216 This will also edit a buffer that is not in the buffer list,
1221 Split window and edit buffer [N] from the buffer list. If [N]
1222 is not given, the current buffer is edited. Respects the
1224 also edit a buffer that is not in the buffer list, without
1229 Split window and edit buffer for |{bufname}| from the buffer
1230 list. This will also edit a buffer that is not in the buffer
1232 Note: If what you want to do is split the buffer, make a copy
1238 Go to [N]th next buffer in buffer list. [N] defaults to one.
1239 Wraps around the end of the buffer list.
1240 See |:buffer-!| for [!].
1242 If you are in a help buffer, this takes you to the next help
1243 buffer (if there is one). Similarly, if you are in a normal
1244 (non-help) buffer, this takes you to the next normal buffer.
1251 Split window and go to [N]th next buffer in buffer list.
1252 Wraps around the end of the buffer list. Uses 'switchbuf'
1257 Go to [N]th previous buffer in buffer list. [N] defaults to
1258 one. Wraps around the start of the buffer list.
1259 See |:buffer-!| for [!] and 'switchbuf'.
1264 Split window and go to [N]th previous buffer in buffer list.
1265 Wraps around the start of the buffer list.
1270 Go to first buffer in buffer list. If the buffer list is
1271 empty, go to the first unlisted buffer.
1272 See |:buffer-!| for [!].
1279 Split window and go to first buffer in buffer list. If the
1280 buffer list is empty, go to the first unlisted buffer.
1288 Go to last buffer in buffer list. If the buffer list is
1289 empty, go to the last unlisted buffer.
1290 See |:buffer-!| for [!].
1293 Split window and go to last buffer in buffer list. If the
1294 buffer list is empty, go to the last unlisted buffer.
1298 Go to [N]th next modified buffer. Note: this command also
1299 finds unlisted buffers. If there is no modified buffer the
1303 Split window and go to [N]th next modified buffer.
1305 Note: this command also finds buffers not in the buffer list.
1309 Rearrange the screen to open one window for each loaded buffer
1310 in the buffer list. When a count is given, this is the
1314 :[N]sba[ll] [N] Rearrange the screen to open one window for each buffer in
1315 the buffer list. When a count is given, this is the maximum
1323 Note: All the commands above that start editing another buffer, keep the
1331 purposes. A few options can be set to change the behavior of a buffer:
1332 'bufhidden' what happens when the buffer is no longer displayed
1334 'buftype' what kind of a buffer this is
1335 'swapfile' whether the buffer will have a swap file
1336 'buflisted' buffer shows up in the buffer list
1338 A few useful kinds of a buffer:
1346 command. The flag that indicates a help buffer is internal
1348 for a help buffer.
1350 terminal A terminal window buffer, see |terminal|. The contents cannot
1354 plugin. The buffer is created with these settings: >
1358 < The buffer name is the name of the directory and is adjusted
1361 *scratch-buffer*
1368 < The buffer name can be used to identify the buffer, if you
1371 *unlisted-buffer*
1372 unlisted The buffer is not in the buffer list. It is not used for
1375 thus it doesn't completely delete the buffer. Settings: >