Home Explore Blog CI



neovim

47th chunk of `runtime/doc/options.txt`
f34b05df152b40eab9022fe05f22d787c8f82a4ef6851cdb0000000100000fa2
 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 an underline cursor with
				default colors.
	   i-ci:ver30-iCursor-blinkwait300-blinkon200-blinkoff150
				In Insert and Command-line Insert mode, use a
				30% vertical bar cursor with colors from the
				"iCursor" highlight group.  Blink a bit
				faster.

	The 'a' mode is different.  It will set the given argument-list for
	all modes.  It does not reset anything to defaults.  This can be used
	to do a common setting for all modes.  For example, to switch off
	blinking: "a:blinkon0"

	Examples of cursor highlighting: >vim
	    highlight Cursor gui=reverse guifg=NONE guibg=NONE
	    highlight Cursor gui=NONE guifg=bg guibg=fg
<

					*'guifont'* *'gfn'* *E235* *E596*
'guifont' 'gfn'		string	(default "")
			global
	This is a list of fonts which will be used for the GUI version of Vim.
	In its simplest form the value is just one font name.  When
	the font cannot be found you will get an error message.  To try other
	font names a list can be specified, font names separated with commas.
	The first valid font is used.

	Spaces after a comma are ignored.  To include a comma in a font name
	precede it with a backslash.  Setting an option requires an extra
	backslash before a space and a backslash.  See also
	|option-backslash|.  For example: >vim
	    set guifont=Screen15,\ 7x13,font\\,with\\,commas
<	will make Vim try to use the font "Screen15" first, and if it fails it
	will try to use "7x13" and then "font,with,commas" instead.

	If none of the fonts can be loaded, Vim will keep the current setting.
	If an empty font list is given, Vim will try using other resource
	settings (for X, it will use the Vim.font resource), and finally it
	will try some builtin default which should always be there ("7x13" in
	the case of X).  The font names given should be "normal" fonts.  Vim
	will try to find the related bold and italic fonts.

	For Win32 and Mac OS: >vim
	    set guifont=*
<	will bring up a font requester, where you can pick the font you want.

	The font name depends on the GUI used.

	For Mac OSX you can use something like this: >vim
	    set guifont=Monaco:h10
<								*E236*
	Note that the fonts must be mono-spaced (all characters have the same
	width).

	To preview a font on X11, you might be able to use the "xfontsel"
	program.  The "xlsfonts" program gives a list of all available fonts.

	For the Win32 GUI					*E244* *E245*
	- takes these options in the font name:
		hXX - height is XX (points, can be floating-point)
		wXX - width is XX (points, can be floating-point)
		b   - bold
		i   - italic
		u   - underline
		s   - strikeout
		cXX - character set XX.  Valid charsets are: ANSI, ARABIC,
		      BALTIC, CHINESEBIG5, DEFAULT, EASTEUROPE, GB2312, GREEK,
		      HANGEUL, HEBREW, JOHAB, MAC, OEM, RUSSIAN, SHIFTJIS,
		      SYMBOL, THAI, TURKISH, VIETNAMESE ANSI and BALTIC.
		      Normally you would use "cDEFAULT".

	  Use a ':' to separate the options.
	- A '_' can be used in the place of a space, so you don't need to use
	  backslashes to

Title: More Details on the 'guicursor' Option and Introducing 'guifont'
Summary
This section continues detailing the 'guicursor' option, providing examples of how to set different cursor styles for various modes using highlight groups and blinking settings. It then introduces the 'guifont' option, explaining how to specify a list of fonts for the GUI version of Vim, how to handle commas and spaces in font names, and how to use a font requester to pick a font on Win32 and Mac OS.