Home Explore Blog CI



neovim

17th chunk of `runtime/doc/options.txt`
b1b569a1e2617ffa52e4bdea12480718371f2d4807e9c2ea0000000100000fa1
 conditions are met, a BOM (Byte
	Order Mark) is prepended to the file:
	- this option is on
	- the 'binary' option is off
	- 'fileencoding' is "utf-8", "ucs-2", "ucs-4" or one of the little/big
	  endian variants.
	Some applications use the BOM to recognize the encoding of the file.
	Often used for UCS-2 files on MS-Windows.  For other applications it
	causes trouble, for example: "cat file1 file2" makes the BOM of file2
	appear halfway through the resulting file.  Gcc doesn't accept a BOM.
	When Vim reads a file and 'fileencodings' starts with "ucs-bom", a
	check for the presence of the BOM is done and 'bomb' set accordingly.
	Unless 'binary' is set, it is removed from the first line, so that you
	don't see it when editing.  When you don't change the options, the BOM
	will be restored when writing the file.

						*'breakat'* *'brk'*
'breakat' 'brk'		string	(default " ^I!@*-+;:,./?")
			global
	This option lets you choose which characters might cause a line
	break if 'linebreak' is on.  Only works for ASCII characters.

			*'breakindent'* *'bri'* *'nobreakindent'* *'nobri'*
'breakindent' 'bri'	boolean	(default off)
			local to window
	Every wrapped line will continue visually indented (same amount of
	space as the beginning of that line), thus preserving horizontal blocks
	of text.

					*'breakindentopt'* *'briopt'*
'breakindentopt' 'briopt'	string	(default "")
			local to window
	Settings for 'breakindent'. It can consist of the following optional
	items and must be separated by a comma:
		min:{n}	    Minimum text width that will be kept after
			    applying 'breakindent', even if the resulting
			    text should normally be narrower. This prevents
			    text indented almost to the right window border
			    occupying lots of vertical space when broken.
			    (default: 20)
		shift:{n}   After applying 'breakindent', the wrapped line's
			    beginning will be shifted by the given number of
			    characters.  It permits dynamic French paragraph
			    indentation (negative) or emphasizing the line
			    continuation (positive).
			    (default: 0)
		sbr	    Display the 'showbreak' value before applying the
			    additional indent.
			    (default: off)
		list:{n}    Adds an additional indent for lines that match a
			    numbered or bulleted list (using the
			    'formatlistpat' setting).
			    (default: 0)
		list:-1	    Uses the width of a match with 'formatlistpat' for
			    indentation.
		column:{n}  Indent at column {n}. Will overrule the other
			    sub-options. Note: an additional indent may be
			    added for the 'showbreak' setting.
			    (default: off)

						*'bufhidden'* *'bh'*
'bufhidden' 'bh'	string	(default "")
			local to buffer  |local-noglobal|
	This option specifies what happens when a buffer is no longer
	displayed in a window:
	  <empty>	follow the global 'hidden' option
	  hide		hide the buffer (don't unload it), even if 'hidden' is
			not set
	  unload	unload the buffer, even if 'hidden' is set; the
			|:hide| 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

Title: Vim Options: bomb, breakat, breakindent, breakindentopt, bufhidden, and buflisted
Summary
This section details several Vim options. It starts by discussing the 'bomb' option and its interaction with file encodings to add or remove Byte Order Marks (BOM). It proceeds to explain 'breakat', which defines characters that can break lines when 'linebreak' is on. 'breakindent' is then covered, which controls the visual indentation of wrapped lines, and 'breakindentopt', which offers fine-grained control over 'breakindent' behavior. Finally, it explains 'bufhidden', which determines what happens when a buffer is no longer displayed, and 'buflisted', which controls whether a buffer appears in the buffer list.