Home • Explore • Blog • CI
☰



neovim
18th chunk of `runtime/doc/options.txt`
ee5e9132397270062e6701617da4a38db064652130cb21130000000100000fa8
 command will also unload the buffer
	  delete	delete the buffer from the buffer list, even if
			'hidden' is set; the |:hide| command will also delete
			the buffer, making it behave like |:bdelete|
	  wipe		wipe the buffer from the buffer list, even if
			'hidden' is set; the |:hide| command will also wipe
			out the buffer, making it behave like |:bwipeout|

	CAREFUL: when "unload", "delete" or "wipe" is used changes in a buffer
	are lost without a warning.  Also, these values may break autocommands
	that switch between buffers temporarily.
	This option is used together with 'buftype' and 'swapfile' to specify
	special kinds of buffers.   See |special-buffers|.

			*'buflisted'* *'bl'* *'nobuflisted'* *'nobl'* *E85*
'buflisted' 'bl'	boolean	(default on)
			local to buffer
	When this option is set, the buffer shows up in the buffer list.  If
	it is reset it is not used for ":bnext", "ls", the Buffers menu, etc.
	This option is reset by Vim for buffers that are only used to remember
	a file name or marks.  Vim sets it when starting to edit a buffer.
	But not when moving to a buffer with ":buffer".

						*'buftype'* *'bt'* *E382*
'buftype' 'bt'		string	(default "")
			local to buffer  |local-noglobal|
	The value of this option specifies the type of a buffer:
	  <empty>	normal buffer
	  acwrite	buffer will always be written with |BufWriteCmd|s
	  help		help buffer (do not set this manually)
	  nofile	buffer is not related to a file, will not be written
	  nowrite	buffer will not be written
	  quickfix	list of errors |:cwindow| or locations |:lwindow|
	  terminal	|terminal-emulator| buffer
	  prompt	buffer where only the last line can be edited, meant
			to be used by a plugin, see |prompt-buffer|

	This option is used together with 'bufhidden' and 'swapfile' to
	specify special kinds of buffers.   See |special-buffers|.
	Also see |win_gettype()|, which returns the type of the window.

	Be careful with changing this option, it can have many side effects!
	One such effect is that Vim will not check the timestamp of the file,
	if the file is changed by another program this will not be noticed.

	A "quickfix" buffer is only used for the error list and the location
	list.  This value is set by the |:cwindow| and |:lwindow| commands and
	you are not supposed to change it.

	"nofile" and "nowrite" buffers are similar:
	both:		The buffer is not to be written to disk, ":w" doesn't
			work (":w filename" does work though).
	both:		The buffer is never considered to be |'modified'|.
			There is no warning when the changes will be lost, for
			example when you quit Vim.
	both:		A swap file is only created when using too much memory
			(when 'swapfile' has been reset there is never a swap
			file).
	nofile only:	The buffer name is fixed, it is not handled like a
			file name.  It is not modified in response to a |:cd|
			command.
	both:		When using ":e bufname" and already editing "bufname"
			the buffer is made empty and autocommands are
			triggered as usual for |:edit|.
							*E676*
	"acwrite" implies that the buffer name is not related to a file, like
	"nofile", but it will be written.  Thus, in contrast to "nofile" and
	"nowrite", ":w" does work and a modified buffer can't be abandoned
	without saving.  For writing there must be matching |BufWriteCmd|,
	|FileWriteCmd| or |FileAppendCmd| autocommands.

						*'casemap'* *'cmp'*
'casemap' 'cmp'		string	(default "internal,keepascii")
			global
	Specifies details about changing the case of letters.  It may contain
	these words, separated by a comma:
	internal	Use internal case mapping functions, the current
			locale does not change the case mapping. When
			"internal" is omitted, the towupper() and towlower()
			system library functions are used when available.
	keepascii	For the ASCII characters (0x00 to 0x7f) use the US
			case mapping, the current locale is not effective.
			This probably only matters for Turkish.

				*'cdhome'* *'cdh'* *'nocdhome'* *'nocdh'*
'cdhome' 'cdh'		boolean	(default
Title: Vim Options: buflisted, buftype, and casemap
Summary
This section details three Vim options. It explains 'buflisted', which controls whether a buffer appears in the buffer list. Next, 'buftype' is discussed, which specifies the type of a buffer (e.g., normal, help, nofile, quickfix) and influences how it's handled, particularly regarding writing to disk and swap file creation. Finally, 'casemap' is detailed, which controls how Vim handles case conversions of letters, allowing for the use of internal functions or system libraries, and specifying whether ASCII characters should always use US case mapping.