Home Explore Blog CI



neovim

59th chunk of `runtime/doc/options.txt`
e9678a4338d9380c6c13ced9da8ecba9a868c4fc507711980000000100000fa7
 while displaying Tabs with spaces, use: >vim
		set list lcs=tab:\ \
<
	Note that list mode will also affect formatting (set with 'textwidth'
	or 'wrapmargin') when 'cpoptions' includes 'L'.  See 'listchars' for
	changing the way tabs are displayed.

						*'listchars'* *'lcs'*
'listchars' 'lcs'	string	(default "tab:> ,trail:-,nbsp:+")
			global or local to window |global-local|
	Strings to use in 'list' mode and for the |:list| command.  It is a
	comma-separated list of string settings. *E1511*

							*lcs-eol*
	  eol:c		Character to show at the end of each line.  When
			omitted, there is no extra character at the end of the
			line.
							*lcs-tab*
	  tab:xy[z]	Two or three characters to be used to show a tab.
			The third character is optional.

	  tab:xy	The 'x' is always used, then 'y' as many times as will
			fit.  Thus "tab:>-" displays: >
				>
				>-
				>--
				etc.
<
	  tab:xyz	The 'z' is always used, then 'x' is prepended, and
			then 'y' is used as many times as will fit.  Thus
			"tab:<->" displays: >
				>
				<>
				<->
				<-->
				etc.
<
			When "tab:" is omitted, a tab is shown as ^I.
							*lcs-space*
	  space:c	Character to show for a space.  When omitted, spaces
			are left blank.
							*lcs-multispace*
	  multispace:c...
			One or more characters to use cyclically to show for
			multiple consecutive spaces.  Overrides the "space"
			setting, except for single spaces.  When omitted, the
			"space" setting is used.  For example,
			`:set listchars=multispace:---+` shows ten consecutive
			spaces as: >
				---+---+--
<
							*lcs-lead*
	  lead:c	Character to show for leading spaces.  When omitted,
			leading spaces are blank.  Overrides the "space" and
			"multispace" settings for leading spaces.  You can
			combine it with "tab:", for example: >vim
				set listchars+=tab:>-,lead:.
<
							*lcs-leadmultispace*
	  leadmultispace:c...
			Like the |lcs-multispace| value, but for leading
			spaces only.  Also overrides |lcs-lead| for leading
			multiple spaces.
			`:set listchars=leadmultispace:---+` shows ten
			consecutive leading spaces as: >
				---+---+--XXX
<
			Where "XXX" denotes the first non-blank characters in
			the line.
							*lcs-trail*
	  trail:c	Character to show for trailing spaces.  When omitted,
			trailing spaces are blank.  Overrides the "space" and
			"multispace" settings for trailing spaces.
							*lcs-extends*
	  extends:c	Character to show in the last column, when 'wrap' is
			off and the line continues beyond the right of the
			screen.
							*lcs-precedes*
	  precedes:c	Character to show in the first visible column of the
			physical line, when there is text preceding the
			character visible in the first column.
							*lcs-conceal*
	  conceal:c	Character to show in place of concealed text, when
			'conceallevel' is set to 1.  A space when omitted.
							*lcs-nbsp*
	  nbsp:c	Character to show for a non-breakable space character
			(0xA0 (160 decimal) and U+202F).  Left blank when
			omitted.

	The characters ':' and ',' should not be used.  UTF-8 characters can
	be used.  All characters must be single width. *E1512*

	Each character can be specified as hex: >vim
		set listchars=eol:\\x24
		set listchars=eol:\\u21b5
		set listchars=eol:\\U000021b5
<	Note that a double backslash is used.  The number of hex characters
	must be exactly 2 for \\x, 4 for \\u and 8 for \\U.

	Examples: >vim
	    set lcs=tab:>-,trail:-
	    set lcs=tab:>-,eol:<,nbsp:%
	    set lcs=extends:>,precedes:<
<	|hl-NonText| highlighting will be used for "eol", "extends" and
	"precedes". |hl-Whitespace| for "nbsp", "space", "tab", "multispace",
	"lead" and "trail".

			*'loadplugins'* *'lpl'* *'noloadplugins'* *'nolpl'*
'loadplugins' 'lpl'	boolean	(default on)
			global
	When on the plugin scripts are loaded when starting up |load-plugins|.
	This option can be reset in your |vimrc| file to disable the loading
	of plugins.
	Note that using the "-u NONE" and "--noplugin" command line arguments
	reset this option.

Title: Vim Option: 'listchars' - Customizing Display in List Mode
Summary
This section details the 'listchars' option in Vim, which allows customization of how special characters are displayed in 'list' mode (tabs, trailing spaces, end-of-line markers, etc.). It explains the various settings available (eol, tab, space, multispace, lead, leadmultispace, trail, extends, precedes, conceal, nbsp) and how to use them, including examples. Also included is a description of the 'loadplugins' option.