Home Explore Blog CI



neovim

46th chunk of `runtime/doc/options.txt`
81b873eee79a1804d1accdf8f0bc182f8de138985094038b0000000100000fa1
	and '#' characters, which are expanded like when used in a command-
	line.  The placeholder "$*" is allowed to specify where the arguments
	will be included.  Environment variables are expanded |:set_env|.  See
	|option-backslash| about including spaces and backslashes.
	Special value: When 'grepprg' is set to "internal" the |:grep| command
	works like |:vimgrep|, |:lgrep| like |:lvimgrep|, |:grepadd| like
	|:vimgrepadd| and |:lgrepadd| like |:lvimgrepadd|.
	See also the section |:make_makeprg|, since most of the comments there
	apply equally to 'grepprg'.
	This option cannot be set from a |modeline| or in the |sandbox|, for
	security reasons.
	This option defaults to:
	- `rg --vimgrep -uu ` if ripgrep is available (|:checkhealth|),
	- `grep -HIn $* /dev/null` on Unix,
	- `findstr /n $* nul` on Windows.
	Ripgrep can perform additional filtering such as using .gitignore rules
	and skipping hidden files. This is disabled by default (see the -u option)
	to more closely match the behaviour of standard grep.
	You can make ripgrep match Vim's case handling using the
	-i/--ignore-case and -S/--smart-case options.
	An |OptionSet| autocmd can be used to set it up to match automatically.

				*'guicursor'* *'gcr'* *E545* *E546* *E548* *E549*
'guicursor' 'gcr'	string	(default "n-v-c-sm:block,i-ci-ve:ver25,r-cr-o:hor20,t:block-blinkon500-blinkoff500-TermCursor")
			global
	Configures the cursor style for each mode. Works in the GUI and many
	terminals.  See |tui-cursor-shape|.

	To disable cursor-styling, reset the option: >vim
		set guicursor=

<	To enable mode shapes, "Cursor" highlight, and blinking: >vim
		set guicursor=n-v-c:block,i-ci-ve:ver25,r-cr:hor20,o:hor50
		  \,a:blinkwait700-blinkoff400-blinkon250-Cursor/lCursor
		  \,sm:block-blinkwait175-blinkoff150-blinkon175

<	The option is a comma-separated list of parts.  Each part consists of a
	mode-list and an argument-list:
		mode-list:argument-list,mode-list:argument-list,..
	The mode-list is a dash separated list of these modes:
		n	Normal mode
		v	Visual mode
		ve	Visual mode with 'selection' "exclusive" (same as 'v',
			if not specified)
		o	Operator-pending mode
		i	Insert mode
		r	Replace mode
		c	Command-line Normal (append) mode
		ci	Command-line Insert mode
		cr	Command-line Replace mode
		sm	showmatch in Insert mode
		t	Terminal mode
		a	all modes
	The argument-list is a dash separated list of these arguments:
		hor{N}	horizontal bar, {N} percent of the character height
		ver{N}	vertical bar, {N} percent of the character width
		block	block cursor, fills the whole character
			- Only one of the above three should be present.
			- Default is "block" for each mode.
		blinkwait{N}				*cursor-blinking*
		blinkon{N}
		blinkoff{N}
			blink times for cursor: blinkwait is the delay before
			the cursor starts blinking, blinkon is the time that
			the cursor is shown and blinkoff is the time that the
			cursor is not shown.  Times are in msec.  When one of
			the numbers is zero, there is no blinking. E.g.: >vim
				set guicursor=n:blinkon0
<
			Default is "blinkon0" for each mode.
		{group-name}
			Highlight group that decides the color and font of the
			cursor.
			In the |TUI|:
			- |inverse|/reverse and no group-name are interpreted
			  as "host-terminal default cursor colors" which
			  typically means "inverted bg and fg colors".
			- |ctermfg| and |guifg| are ignored.
		{group-name}/{group-name}
			Two highlight group names, the first is used when
			no language mappings are used, the other when they
			are. |language-mapping|

	Examples of parts:
	   n-c-v:block-nCursor	In Normal, Command-line and Visual mode, use a
				block cursor with colors from the "nCursor"
				highlight group
	   n-v-c-sm:block,i-ci-ve:ver25-Cursor,r-cr-o:hor20
				In Normal et al. modes, use a block cursor
				with the default colors defined by the host
				terminal.  In Insert-like modes, use
				a vertical bar cursor with colors from
				"Cursor" highlight group.  In Replace-like
				modes, use

Title: More details on 'grepprg' and the 'guicursor' option
Summary
This section elaborates on the 'grepprg' option, explaining how special characters like '%' and '#' are expanded and how it defaults to different grep commands based on the system. It also details the 'guicursor' option, which configures the cursor style for each mode in the GUI and terminals, including how to customize its appearance and blinking behavior.