Home Explore Blog CI



neovim

73th chunk of `runtime/doc/options.txt`
818e4ef82405d42822b9eddaaa5802c658ed5b53633baf0d0000000100000fab
 cannot be set in a modeline when 'modelineexpr' is off.

	The default ruler width is 17 characters.  To make the ruler 15
	characters wide, put "%15(" at the start and "%)" at the end.
	Example: >vim
		set rulerformat=%15(%c%V\ %p%%%)
<

					*'runtimepath'* *'rtp'* *vimfiles*
'runtimepath' 'rtp'	string	(default "$XDG_CONFIG_HOME/nvim,
                                               $XDG_CONFIG_DIRS[1]/nvim,
                                               $XDG_CONFIG_DIRS[2]/nvim,
                                               …
                                               $XDG_DATA_HOME/nvim[-data]/site,
                                               $XDG_DATA_DIRS[1]/nvim/site,
                                               $XDG_DATA_DIRS[2]/nvim/site,
                                               …
                                               $VIMRUNTIME,
                                               …
                                               $XDG_DATA_DIRS[2]/nvim/site/after,
                                               $XDG_DATA_DIRS[1]/nvim/site/after,
                                               $XDG_DATA_HOME/nvim[-data]/site/after,
                                               …
                                               $XDG_CONFIG_DIRS[2]/nvim/after,
                                               $XDG_CONFIG_DIRS[1]/nvim/after,
                                               $XDG_CONFIG_HOME/nvim/after")
			global
	List of directories to be searched for these runtime files:
	  filetype.lua	filetypes |new-filetype|
	  autoload/	automatically loaded scripts |autoload-functions|
	  colors/	color scheme files |:colorscheme|
	  compiler/	compiler files |:compiler|
	  doc/		documentation |write-local-help|
	  ftplugin/	filetype plugins |write-filetype-plugin|
	  indent/	indent scripts |indent-expression|
	  keymap/	key mapping files |mbyte-keymap|
	  lang/		menu translations |:menutrans|
	  lsp/		LSP client configurations |lsp-config|
	  lua/		|Lua| plugins
	  menu.vim	GUI menus |menu.vim|
	  pack/		packages |:packadd|
	  parser/	|treesitter| syntax parsers
	  plugin/	plugin scripts |write-plugin|
	  queries/	|treesitter| queries
	  rplugin/	|remote-plugin| scripts
	  spell/	spell checking files |spell|
	  syntax/	syntax files |mysyntaxfile|
	  tutor/	tutorial files |:Tutor|

	And any other file searched for with the |:runtime| command.

	Defaults are setup to search these locations:
	1. Your home directory, for personal preferences.
	   Given by `stdpath("config")`.  |$XDG_CONFIG_HOME|
	2. Directories which must contain configuration files according to
	   |xdg| ($XDG_CONFIG_DIRS, defaults to /etc/xdg).  This also contains
	   preferences from system administrator.
	3. Data home directory, for plugins installed by user.
	   Given by `stdpath("data")/site`.  |$XDG_DATA_HOME|
	4. nvim/site subdirectories for each directory in $XDG_DATA_DIRS.
	   This is for plugins which were installed by system administrator,
	   but are not part of the Nvim distribution. XDG_DATA_DIRS defaults
	   to /usr/local/share/:/usr/share/, so system administrators are
	   expected to install site plugins to /usr/share/nvim/site.
	5. Session state directory, for state data such as swap, backupdir,
	   viewdir, undodir, etc.
	   Given by `stdpath("state")`.  |$XDG_STATE_HOME|
	6. $VIMRUNTIME, for files distributed with Nvim.
							*after-directory*
	7, 8, 9, 10. In after/ subdirectories of 1, 2, 3 and 4, with reverse
	   ordering.  This is for preferences to overrule or add to the
	   distributed defaults or system-wide settings (rarely needed).

							*packages-runtimepath*
	"start" packages will also be searched (|runtime-search-path|) for
	runtime files after these, though such packages are not explicitly
	reported in &runtimepath. But "opt" packages are explicitly added to
	&runtimepath by |:packadd|.

	Note that, unlike 'path', no wildcards like "**" are allowed.  Normal
	wildcards are allowed, but can significantly slow down

Title: Vim Option: 'runtimepath' Details
Summary
This section describes the 'runtimepath' option in Vim, which specifies a list of directories to search for runtime files such as filetype definitions, autoload scripts, color schemes, compiler files, documentation, plugins, and syntax files. It details the default locations searched, including the user's home directory, XDG config directories, data directories, and the $VIMRUNTIME directory. The section also describes how 'start' and 'opt' packages affect the runtimepath and mentions the use of 'after' subdirectories for overriding default settings.