" Author: Antony Lee <anntzer.lee@gmail.com>
" Description: Helper functions for reStructuredText syntax folding
-" Last Modified: 2018-01-07
+" Last Modified: 2018-12-29
function s:CacheRstFold()
+ if !g:rst_fold_enabled
+ return
+ endif
+
let closure = {'header_types': {}, 'max_level': 0, 'levels': {}}
function closure.Process(match) dict
let curline = getcurpos()[1]
let self.levels[curline] = self.header_types[key]
endfunction
let save_cursor = getcurpos()
+ let save_mark = getpos("'[")
silent keeppatterns %s/\v^%(%(([=`:.'"~^_*+#-])\1+\n)?.{1,2}\n([=`:.'"~^_*+#-])\2+)|%(%(([=`:.''"~^_*+#-])\3{2,}\n)?.{3,}\n([=`:.''"~^_*+#-])\4{2,})$/\=closure.Process(submatch(0))/gn
call setpos('.', save_cursor)
+ call setpos("'[", save_mark)
let b:RstFoldCache = closure.levels
endfunction
function RstFold#GetRstFold()
+ if !g:rst_fold_enabled
+ return
+ endif
+
if !has_key(b:, 'RstFoldCache')
call s:CacheRstFold()
endif
endfunction
function RstFold#GetRstFoldText()
+ if !g:rst_fold_enabled
+ return
+ endif
+
if !has_key(b:, 'RstFoldCache')
call s:CacheRstFold()
endif
-*autocmd.txt* For Vim version 8.1. Last change: 2018 May 03
+*autocmd.txt* For Vim version 8.1. Last change: 2018 Dec 28
VIM REFERENCE MANUAL by Bram Moolenaar
Not triggered when 'shelltemp' is off.
*FilterWritePost*
FilterWritePost After writing a file for a filter command or
- making a diff.
+ making a diff with an external diff (see
+ DiffUpdated for internal diff).
Vim checks the pattern against the name of
the current buffer as with FilterWritePre.
Not triggered when 'shelltemp' is off.
*FilterWritePre*
FilterWritePre Before writing a file for a filter command or
- making a diff.
+ making a diff with an external diff.
Vim checks the pattern against the name of
the current buffer, not the name of the
temporary file that is the output of the
-*eval.txt* For Vim version 8.1. Last change: 2018 Dec 27
+*eval.txt* For Vim version 8.1. Last change: 2018 Dec 28
VIM REFERENCE MANUAL by Bram Moolenaar
The properties are ordered by starting column and priority.
Each property is a Dict with these entries:
col starting column
- length length in bytes
+ length length in bytes, one more if line break is
+ included
id property ID
type name of the property type, omitted if
the type was deleted
-*help.txt* For Vim version 8.1. Last change: 2018 Dec 14
+*help.txt* For Vim version 8.1. Last change: 2019 Jan 01
VIM - main help file
k
Jump to a subject: Position the cursor on a tag (e.g. |bars|) and hit CTRL-].
With the mouse: ":set mouse=a" to enable the mouse (in xterm or GUI).
Double-click the left mouse button on a tag, e.g. |bars|.
- Jump back: Type CTRL-T or CTRL-O. Repeat to go further back.
+ Jump back: Type CTRL-O. Repeat to go further back.
Get specific help: It is possible to go directly to whatever you want help
on, by giving an argument to the |:help| command.
help entries for "word".
Or use ":helpgrep word". |:helpgrep|
+ Getting started: Do the Vim tutor, a 20 minute interactive training for the
+ basic commands, see |vimtutor|.
+ Read the user manual from start to end: |usr_01.txt|
+
Vim stands for Vi IMproved. Most of Vim was made by Bram Moolenaar, but only
through the help of many others. See |credits|.
------------------------------------------------------------------------------
*doc-file-list* *Q_ct*
BASIC:
|quickref| Overview of the most common commands you will use
-|tutor| 30 minutes training course for beginners
+|tutor| 20 minutes training course for beginners
|copying| About copyrights
|iccf| Helping poor children in Uganda
|sponsor| Sponsor Vim development, become a registered Vim user
-*intro.txt* For Vim version 8.1. Last change: 2018 Jan 24
+*intro.txt* For Vim version 8.1. Last change: 2019 Jan 01
VIM REFERENCE MANUAL by Bram Moolenaar
there. For beginners, there is a hands-on |tutor|. To learn using Vim, read
the user manual |usr_toc.txt|.
- *book*
-There are many books on Vi that contain a section for beginners. There are
-two books I can recommend:
-
- "Vim - Vi Improved" by Steve Oualline
-
-This is the very first book completely dedicated to Vim. It is very good for
-beginners. The most often used commands are explained with pictures and
-examples. The less often used commands are also explained, the more advanced
-features are summarized. There is a comprehensive index and a quick
-reference. Parts of this book have been included in the user manual
-|frombook|.
-Published by New Riders Publishing. ISBN: 0735710015
-For more information try one of these:
- http://iccf-holland.org/click5.html
- http://www.vim.org/iccf/click5.html
-
- "Learning the Vi editor" by Linda Lamb and Arnold Robbins
-
-This is a book about Vi that includes a chapter on Vim (in the sixth edition).
-The first steps in Vi are explained very well. The commands that Vim adds are
-only briefly mentioned. There is also a German translation.
-Published by O'Reilly. ISBN: 1-56592-426-6.
+ *book* *books*
+Most books on Vi and Vim contain a section for beginners. Others are spending
+more words on specific functionality. You can find an overview of Vim books
+here:
+ http://iccf-holland.org/vim_books.html
==============================================================================
2. Vim on the internet *internet*
contain links to the most recent version of Vim. The FAQ is a list of
Frequently Asked Questions. Read this if you have problems.
- Vim home page: http://www.vim.org/
- Vim FAQ: http://vimdoc.sf.net/
- Downloading: ftp://ftp.vim.org/pub/vim/MIRRORS
+ Vim home page: https://www.vim.org/
+ Vim FAQ: https://vimhelp.appspot.com/vim_faq.txt.html
+ Downloading: https://www.vim.org/download.php
Usenet News group where Vim is discussed: *news* *usenet*
See http://www.vim.org/maillist.php for the latest information.
NOTE:
+- Anyone can see the archive, e.g. on Google groups. Search this if you have
+ questions.
- You can only send messages to these lists if you have subscribed!
+- The first message is moderated, thus it may take a few hours to show up.
- You need to send the messages from the same location as where you subscribed
from (to avoid spam mail).
-- Maximum message size is 40000 characters.
*subscribe-maillist*
If you want to join, send a message to
Where reproduce.vim is a script that reproduces the problem. Try different
machines, if relevant (is this an MS-Windows specific bug perhaps?).
-Send me patches if you can!
+Send me patches if you can! If you create a pull request on
+https://github.com/vim/vim then the automated checks will run and report any
+obvious problems. But you can also send the patch by email (use an attachment
+to avoid white space changes).
It will help to include information about the version of Vim you are using and
your setup. You can get the information with this command: >
==============================================================================
3. Credits *credits* *author* *Bram* *Moolenaar*
-Most of Vim was written by Bram Moolenaar <Bram@vim.org>.
+Most of Vim was created by Bram Moolenaar <Bram@vim.org>.
Parts of the documentation come from several Vi manuals, written by:
W.N. Joy
Ken Takata fixes and features
Kazunobu Kuriyama GTK 3
Christian Brabandt many fixes, features, user support, etc.
+ Yegappan Lakshmanan many quickfix features
I wish to thank all the people that sent me bug reports and suggestions. The
list is too long to mention them all here. Vim would not be the same without
as flexible as Vim.
The version used is 2.1. It is still being developed. Source code is
freely available.
+ *NeoVim*
+NeoVim A Vim clone. Forked the Vim source in 2014 and went a different way.
+ Very much bound to github and has many more dependencies, making
+ development more complex and limiting portability. Code has been
+ refactored, resulting in patches not being exchangeable with Vim.
+ Supports a remote GUI and integration with scripting languages.
==============================================================================
4. Notation *notation*
-*message.txt* For Vim version 8.1. Last change: 2018 Feb 04
+*message.txt* For Vim version 8.1. Last change: 2018 Dec 30
VIM REFERENCE MANUAL by Bram Moolenaar
tag. Sometimes this message is not given, even though the tags file is not
properly sorted.
- *E460* >
- The resource fork would be lost (add ! to override)
-
-On the Macintosh (classic), when writing a file, Vim attempts to preserve all
-info about a file, including its resource fork. If this is not possible you
-get this error message. Append "!" to the command name to write anyway (and
-lose the info).
-
*E424* >
Too many different highlighting attributes in use
-*sign.txt* For Vim version 8.1. Last change: 2018 Dec 26
+*sign.txt* For Vim version 8.1. Last change: 2019 Jan 01
VIM REFERENCE MANUAL by Gordon Prieur
:sign define {name} {argument}...
Define a new sign or set attributes for an existing sign.
The {name} can either be a number (all digits) or a name
- starting with a non-digit. Leading digits are ignored, thus
+ starting with a non-digit. Leading zeros are ignored, thus
"0012", "012" and "12" are considered the same name.
About 120 different signs can be defined.
RESTRUCTURED TEXT *rst.vim* *ft-rst-syntax*
-You may set what syntax definitions should be used for code blocks via >
+Syntax highlighting is enabled for code blocks within the document for a
+select number of file types. See $VIMRUNTIME/syntax/rst.vim for the default
+syntax list.
+
+To set a user-defined list of code block syntax highlighting: >
let rst_syntax_code_list = ['vim', 'lisp', ...]
-<
+
+To assign multiple code block types to a single syntax, define
+`rst_syntax_code_list` as a mapping: >
+ let rst_syntax_code_list = {
+ \ 'cpp' = ['cpp', 'c++'],
+ \ 'bash' = ['bash', 'sh'],
+ ...
+ }
+
+To use color highlighting for emphasis text: >
+ let rst_use_emphasis_colors = 1
+
+To enable folding of sections: >
+ let rst_fold_enabled = 1
+
+Note that folding can cause performance issues on some platforms.
+
REXX *rexx.vim* *ft-rexx-syntax*
E458 message.txt /*E458*
E459 message.txt /*E459*
E46 message.txt /*E46*
-E460 message.txt /*E460*
E461 eval.txt /*E461*
E462 editing.txt /*E462*
E463 netbeans.txt /*E463*
N<Del> various.txt /*N<Del>*
NFA pattern.txt /*NFA*
NL-used-for-Nul pattern.txt /*NL-used-for-Nul*
+NeoVim intro.txt /*NeoVim*
NetBSD-backspace options.txt /*NetBSD-backspace*
NetUserPass() pi_netrw.txt /*NetUserPass()*
Normal intro.txt /*Normal*
bom-bytes mbyte.txt /*bom-bytes*
book intro.txt /*book*
bookmark usr_03.txt /*bookmark*
+books intro.txt /*books*
boolean options.txt /*boolean*
break-finally eval.txt /*break-finally*
browse() eval.txt /*browse()*
-*textprop.txt* For Vim version 8.1. Last change: 2018 Dec 27
+*textprop.txt* For Vim version 8.1. Last change: 2018 Dec 30
VIM REFERENCE MANUAL by Bram Moolenaar
The number 123 is smaller than 4567.
-To highlight the numbers: >
+To highlight the numbers in this text: >
call prop_type_add('number', {'highlight': 'Constant'})
call prop_add(11, 12, {'length': 3, 'type': 'number'})
call prop_add(11, 32, {'length': 4, 'type': 'number'})
+Try inserting or deleting lines above the text, you will see that the text
+properties stick to the text, thus the line number is adjusted as needed.
+
Setting "start_incl" and "end_incl" is useful when white space surrounds the
text, e.g. for a function name. Using false is useful when the text starts
and/or ends with a specific character, such as the quote surrounding a string.
-*todo.txt* For Vim version 8.1. Last change: 2018 Dec 27
+*todo.txt* For Vim version 8.1. Last change: 2019 Jan 01
VIM REFERENCE MANUAL by Bram Moolenaar
*known-bugs*
-------------------- Known bugs and current work -----------------------
+Valgrind error in old regexp engine when using TOhtml.
+(Dominique, 2018 Dec 31, #3749)
+
Possible errors reported from fuzzer. Shadowblade #3716
a) using get_regline() without checking for NULL
b) using getcell() in libvterm without checking for NULL
files that source the actual file. E.g. menu_da_de -> menu_da
Include part of #3242?
+Patch to add 'p' flag to 'formatoptions'. (Tom Ryder, 2018 Dec 28)
+Wait a few days for feedback.
+
When a terminal exit_cb closes the window, a following typed key is lost, if
it's in a mapping. (2018 Oct 6, #2302, #3522)
scrolls back. Should allow for this scrolling, like 'scrolloff' does when
using CTRL-E. (Yee Cheng Chin, #3721)
+We have a SourcePre autocommand event, but not SourcePost. Useful for doing
+some thing after a plugin was loaded. (#3739)
+
Invalid memory access with old regexp engine. (Dominique Pelle, 2018 Sep 3,
#3405) Introduced by 8.0.1517, which was fixing another memory access error.
(Sep 8)
" Vim filetype plugin file
" Language: Vim help file
" Previous Maintainer: Nikolai Weibull <now@bitwi.se>
-" Latest Revision: 2008-07-09
+" Latest Revision: 2018-12-29
if exists("b:did_ftplugin")
finish
let s:cpo_save = &cpo
set cpo&vim
-let b:undo_ftplugin = "setl fo< tw< cole< cocu<"
+let b:undo_ftplugin = "setl fo< tw< cole< cocu< keywordprg<"
-setlocal formatoptions+=tcroql textwidth=78
+setlocal formatoptions+=tcroql textwidth=78 keywordprg=:help
if has("conceal")
setlocal cole=2 cocu=nc
endif
" Vim filetype plugin file
" Language: Logcheck
-" Maintainer: Debian Vim Maintainers <pkg-vim-maintainers@lists.alioth.debian.org>
-" Last Change: 2012 Jan 15
+" Maintainer: Debian Vim Maintainers
+" Last Change: 2018 Dec 27
" License: Vim License
-" URL: http://hg.debian.org/hg/pkg-vim/vim/file/unstable/runtime/ftplugin/logcheck.vim
+" URL: https://salsa.debian.org/vim-team/vim-debian/blob/master/ftplugin/logcheck.vim
-if exists("b:did_ftplugin")
+if exists('b:did_ftplugin')
finish
endif
let b:did_ftplugin = 1
-let b:undo_ftplugin = "setl fo<"
+let b:undo_ftplugin = 'setl fo<'
" Do not hard-wrap non-comment lines since each line is a self-contained
" regular expression
" Maintainer: Marshall Ward <marshall.ward@gmail.com>
" Original Maintainer: Nikolai Weibull <now@bitwi.se>
" Website: https://github.com/marshallward/vim-restructuredtext
-" Latest Revision: 2018-01-07
+" Latest Revision: 2018-12-29
if exists("b:did_ftplugin")
finish
let s:cpo_save = &cpo
set cpo&vim
+"Disable folding
+if !exists('g:rst_fold_enabled')
+ let g:rst_fold_enabled = 0
+endif
+
let b:undo_ftplugin = "setl com< cms< et< fo<"
setlocal comments=fb:.. commentstring=..\ %s expandtab
:help matchit-install
inside Vim.
-For Vim version 6.3. Last change: 2017 May 14
+For Vim version 6.3. Last change: 2018 Dec 31
VIM REFERENCE MANUAL by Benji Fisher
The functionality mentioned here is a plugin, see |add-plugin|.
This plugin is only available if 'compatible' is not set.
-You can avoid loading this plugin by setting the "loaded_matchit" variable
-in your |vimrc| file: >
- :let loaded_matchit = 1
{Vi does not have any of this}
" matchit.vim: (global plugin) Extended "%" matching
-" Last Change: 2018 Jul 3 by Christian Brabandt
+" Last Change: 2018 Dec 31
" Maintainer: Benji Fisher PhD <benji@member.AMS.org>
" Version: 1.13.3, for Vim 6.3+
" Fix from Fernando Torres included.
" TODO: Add a level of indirection, so that custom % scripts can use my
" work but extend it.
-" allow user to prevent loading
-" and prevent duplicate loading
+" Allow user to prevent loading and prevent duplicate loading.
if exists("loaded_matchit") || &cp
finish
endif
" Vim syntax file
-" Language: automake Makefile.am
-" Maintainer: Debian VIM Maintainers <pkg-vim-maintainers@lists.alioth.debian.org>
-" Former Maintainer: John Williams <jrw@pobox.com>
-" Last Change: 2011-06-13
-" URL: http://anonscm.debian.org/hg/pkg-vim/vim/raw-file/unstable/runtime/syntax/automake.vim
+" Language: automake Makefile.am
+" Maintainer: Debian Vim Maintainers
+" Former Maintainer: John Williams <jrw@pobox.com>
+" Last Change: 2018 Dec 27
+" URL: https://salsa.debian.org/vim-team/vim-debian/blob/master/syntax/automake.vim
"
" XXX This file is in need of a new maintainer, Debian VIM Maintainers maintain
" it only because patches have been submitted for it by Debian users and the
" EXTRA_SOURCES.
" Standard syntax initialization
-if exists("b:current_syntax")
+if exists('b:current_syntax')
finish
endif
syn match automakeSubst "@\w\+@"
syn match automakeSubst "^\s*@\w\+@"
-syn match automakeComment1 "#.*$" contains=automakeSubst
-syn match automakeComment2 "##.*$"
+syn match automakeComment1 "#.*$" contains=automakeSubst,@Spell
+syn match automakeComment2 "##.*$" contains=@Spell
syn match automakeMakeError "$[{(][^})]*[^a-zA-Z0-9_})][^})]*[})]" " GNU make function call
syn match automakeMakeError "^AM_LDADD\s*\ze+\==" " Common mistake
hi def link automakeMakeBString makeBString
-let b:current_syntax = "automake"
+let b:current_syntax = 'automake'
" vi: ts=8 sw=4 sts=4
" Maintainer: Marshall Ward <marshall.ward@gmail.com>
" Previous Maintainer: Nikolai Weibull <now@bitwi.se>
" Website: https://github.com/marshallward/vim-restructuredtext
-" Latest Revision: 2018-07-23
+" Latest Revision: 2018-12-29
if exists("b:current_syntax")
finish
execute 'syn region rstComment contained' .
\ ' start=/.*/'
+ \ ' skip=+^$+' .
\ ' end=/^\s\@!/ contains=rstTodo'
execute 'syn region rstFootnote contained matchgroup=rstDirective' .
" Vim syntax file
-" Language: tpp - Text Presentation Program
-" Maintainer: Debian Vim Maintainers <pkg-vim-maintainers@lists.alioth.debian.org>
-" Former Maintainer: Gerfried Fuchs <alfie@ist.org>
-" Last Change: 2007-10-14
-" URL: http://git.debian.org/?p=pkg-vim/vim.git;a=blob_plain;f=runtime/syntax/tpp.vim;hb=debian
-" Filenames: *.tpp
-" License: BSD
+" Language: tpp - Text Presentation Program
+" Maintainer: Debian Vim Maintainers
+" Former Maintainer: Gerfried Fuchs <alfie@ist.org>
+" Last Change: 2018 Dec 27
+" URL: https://salsa.debian.org/vim-team/vim-debian/master/syntax/tpp.vim
+" Filenames: *.tpp
+" License: BSD
"
" XXX This file is in need of a new maintainer, Debian VIM Maintainers maintain
" it only because patches have been submitted for it by Debian users and the
" SPAM is _NOT_ welcome - be ready to be reported!
" quit when a syntax file was already loaded
-if exists("b:current_syntax")
+if exists('b:current_syntax')
finish
endif
-if !exists("main_syntax")
+if !exists('main_syntax')
let main_syntax = 'tpp'
endif
syn region tppPageLocalOption start="^--\%(heading\|center\|right\|huge\|sethugefont\|exec\)" end="$" contains=tppPageLocalOptionKey oneline
syn region tppAbstractOption start="^--\%(author\|title\|date\|footer\)" end="$" contains=tppAbstractOptionKey oneline
-if main_syntax != 'sh'
+if main_syntax !=# 'sh'
" shell command
syn include @tppShExec syntax/sh.vim
unlet b:current_syntax
hi def link tppTimeOption Error
-let b:current_syntax = "tpp"
+let b:current_syntax = 'tpp'
" vim: ts=8 sw=2
2. Para borrar desde el cursor hasta el final de una línea pulse: d$
- 3. Para borrar una línea enter pulse: dd
+ 3. Para borrar una línea entera pulse: dd
4. El formato de un mandato en modo Normal es:
2. Para borrar desde el cursor hasta el final de una línea pulse: d$
- 3. Para borrar una línea enter pulse: dd
+ 3. Para borrar una línea entera pulse: dd
4. El formato de un mandato en modo Normal es: