Home Explore Blog CI



neovim

8th chunk of `runtime/doc/usr_02.txt`
ab279d3597603de95508987615904de46f65728e5b10e5f50000000100000f99
 all functions available.  Help topics for
   Vim script functions always include the "()", so: >
	:help append()
<   talks about the append Vim script function rather than how to append text
   in the current buffer.

14) Mappings are talked about in the help page :h |map.txt|. Use >
	:help mapmode-i
<    to find out about the |:imap| command.  Also use :map-topic
    to find out about certain subtopics particular for mappings.  e.g: >
	:help :map-local
<    for buffer-local mappings or >
	:help map-bar
<    for how the '|' is handled in mappings.

15) Command definitions are talked about :h command-topic, so use >
	:help command-bar
<    to find out about the '!' argument for custom commands.

16) Window management commands always start with CTRL-W, so you find the
    corresponding help at :h CTRL-W_letter.  E.g. >
	:help CTRL-W_p
<    for moving the previous accessed window.  You can also access >
	:help windows.txt
<    and read your way through if you are looking for window handling
    commands.

17) Use |:helpgrep| to search in all help pages (and also of any installed
    plugins).  See |:helpgrep| for how to use it.
    To search for a topic: >
	:helpgrep topic
<    This takes you to the first match.  To go to the next one: >
	:cnext
<    All matches are available in the quickfix window which can be opened
    with: >
	:copen
<    Move around to the match you like and press Enter to jump to that help.

18) The user manual.  This describes help topics for beginners in a rather
    friendly way.  Start at |usr_toc.txt| to find the table of content (as you
    might have guessed): >
	:help usr_toc.txt
<    Skim over the contents to find interesting topics. The "Digraphs" and
    "Entering special characters" items are in chapter 24, so to go to that
    particular help page: >
	:help usr_24.txt
<    Also if you want to access a certain chapter in the help, the chapter
    number can be accessed directly like this: >
	:help 10.1
<    which goes to chapter 10.1 in |usr_10.txt| and talks about recording
    macros.

19) Highlighting groups.  Always start with hl-groupname.  E.g. >
	:help hl-WarningMsg
<    talks about the WarningMsg highlighting group.

20) Syntax highlighting is namespaced to :syn-topic.  E.g. >
	:help :syn-conceal
<    talks about the conceal argument for the ":syn" command.

21) Quickfix commands usually start with :c while location list commands
    usually start with :l

22) Autocommand events can be found by their name: >
	:help BufWinLeave
<    To see all possible events: >
	:help events

23) Command-line switches always start with "-".  So for the help of the -f
    command switch of Vim use: >
	:help -f

24) Optional features always start with "+".  To find out about the
    conceal feature use: >
	:help +conceal

25) Documentation for included filetype specific functionality is usually
    available  in the form ft-<filetype>-<functionality>.  So >
	:help ft-c-syntax
<    talks about the C syntax file and the option it provides.  Sometimes,
    additional sections for omni completion >
	:help ft-php-omni
<    or filetype plugins >
	:help ft-tex-plugin
<    are available.

26) Error and Warning codes can be looked up directly in the help.  So >
	:help E297
<    takes you exactly to the description of the swap error message and >
	:help W10
<    talks about the warning "Changing a readonly file".
    Sometimes, however, those error codes are not described, but rather are
    listed at the Vim command that usually causes this.  So: >
	:help E128
<    takes you to the |:function| command

27) Documentation for packages distributed with Vim have the form
     package-<name>. So >
	:help package-termdebug
<
    will bring you to the help section for the included termdebug plugin and
    how to enable it.


==============================================================================

Next chapter: |usr_03.txt|  Moving around

Copyright: see |manual-copyright|  vim:tw=78:ts=8:noet:ft=help:norl:

Title: Vim Help System: Mappings, Commands, Window Management, Searching, User Manual, Syntax, and More
Summary
This section continues explaining how to navigate Vim's help system, covering mappings (map.txt), command definitions (command-topic), window management commands (CTRL-W), searching help pages (:helpgrep), using the user manual (usr_toc.txt), highlighting groups (hl-groupname), syntax highlighting (:syn-topic), quickfix (:c) and location list (:l) commands, autocommand events, command-line switches (-), optional features (+), filetype-specific functionality (ft-), error/warning codes (E/W), and packages (package-). It provides examples of how to access specific help topics for each category.