diff options
Diffstat (limited to 'runtime/doc')
| -rw-r--r-- | runtime/doc/builtin.txt | 5 | ||||
| -rw-r--r-- | runtime/doc/change.txt | 5 | ||||
| -rw-r--r-- | runtime/doc/digraph.txt | 4 | ||||
| -rw-r--r-- | runtime/doc/fold.txt | 3 | ||||
| -rw-r--r-- | runtime/doc/gui.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/map.txt | 9 | ||||
| -rw-r--r-- | runtime/doc/options.txt | 11 | ||||
| -rw-r--r-- | runtime/doc/pi_netrw.txt | 44 | ||||
| -rw-r--r-- | runtime/doc/pi_zip.txt | 1 | ||||
| -rw-r--r-- | runtime/doc/recover.txt | 2 | ||||
| -rw-r--r-- | runtime/doc/spell.txt | 3 | ||||
| -rw-r--r-- | runtime/doc/syntax.txt | 13 | ||||
| -rw-r--r-- | runtime/doc/usr_03.txt | 2 |
13 files changed, 57 insertions, 47 deletions
diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt index 9a8ce4d2ad..91531db656 100644 --- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1842,6 +1842,7 @@ execute({command} [, {silent}]) *execute()* Execute {command} and capture its output. If {command} is a |String|, returns {command} output. If {command} is a |List|, returns concatenated outputs. + Line continuations in {command} are not recognized. Examples: > echo execute('echon "foo"') < foo > @@ -3586,7 +3587,7 @@ getscriptinfo([{opts}]) *getscriptinfo()* optional items: name Script name match pattern. If specified, and "sid" is not specified, information about - scripts with name that match the pattern + scripts with a name that match the pattern "name" are returned. sid Script ID |<SID>|. If specified, only information about the script with ID "sid" is @@ -4995,7 +4996,7 @@ maparg({name} [, {mode} [, {abbr} [, {dict}]]]) *maparg()* "!" Insert and Commandline mode (|mapmode-ic|) "sid" The script local ID, used for <sid> mappings - (|<SID>|). + (|<SID>|). Negative for special contexts. "lnum" The line number in "sid", zero if unknown. "nowait" Do not wait for other, longer mappings. (|:map-<nowait>|). diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt index 91358a8cdd..96af05bc63 100644 --- a/runtime/doc/change.txt +++ b/runtime/doc/change.txt @@ -427,6 +427,11 @@ Note similarly, when 'nrformats' includes "bin", binary numbers with a leading '0x' or '0X' can be interpreted as hexadecimal rather than binary since '0b' are valid hexadecimal digits. +When the number under the cursor is too big to fit into 64 bits, it will be +rounded off to the nearest number that can be represented, and the +addition/subtraction is skipped. E.g. CTRL-X on 18446744073709551616 results +in 18446744073709551615. Same for larger numbers, such as 18446744073709551618. + The CTRL-A command is very useful in a macro. Example: Use the following steps to make a numbered list. diff --git a/runtime/doc/digraph.txt b/runtime/doc/digraph.txt index ce0a929bc1..d2cc000789 100644 --- a/runtime/doc/digraph.txt +++ b/runtime/doc/digraph.txt @@ -535,7 +535,7 @@ $ DO 0x24 36 DOLLAR SIGN Θ H* 0398 0920 GREEK CAPITAL LETTER THETA Ι I* 0399 0921 GREEK CAPITAL LETTER IOTA Κ K* 039A 0922 GREEK CAPITAL LETTER KAPPA -Λ L* 039B 0923 GREEK CAPITAL LETTER LAMDA +Λ L* 039B 0923 GREEK CAPITAL LETTER LAMDA (aka LAMBDA) Μ M* 039C 0924 GREEK CAPITAL LETTER MU Ν N* 039D 0925 GREEK CAPITAL LETTER NU Ξ C* 039E 0926 GREEK CAPITAL LETTER XI @@ -566,7 +566,7 @@ $ DO 0x24 36 DOLLAR SIGN θ h* 03B8 0952 GREEK SMALL LETTER THETA ι i* 03B9 0953 GREEK SMALL LETTER IOTA κ k* 03BA 0954 GREEK SMALL LETTER KAPPA -λ l* 03BB 0955 GREEK SMALL LETTER LAMDA +λ l* 03BB 0955 GREEK SMALL LETTER LAMDA (aka LAMBDA) μ m* 03BC 0956 GREEK SMALL LETTER MU ν n* 03BD 0957 GREEK SMALL LETTER NU ξ c* 03BE 0958 GREEK SMALL LETTER XI diff --git a/runtime/doc/fold.txt b/runtime/doc/fold.txt index 859562fae6..78cc14651e 100644 --- a/runtime/doc/fold.txt +++ b/runtime/doc/fold.txt @@ -346,7 +346,8 @@ zC Close all folds under the cursor recursively. Folds that 'foldenable' will be set. *za* -za When on a closed fold: open it. When folds are nested, you +za Summary: Toggle the fold under the cursor. + When on a closed fold: open it. When folds are nested, you may have to use "za" several times. When a count is given, that many closed folds are opened. When on an open fold: close it and set 'foldenable'. This diff --git a/runtime/doc/gui.txt b/runtime/doc/gui.txt index 1fce9fa491..5d44a7d239 100644 --- a/runtime/doc/gui.txt +++ b/runtime/doc/gui.txt @@ -33,7 +33,7 @@ Example: this sets "g:gui" to the value of the UI's "rgb" field: > remembered until the window is opened. The position is adjusted to make the window fit on the screen (if possible). - *:win* *:winsize* *E465* + *:wi* *:win* *:winsize* *E465* :win[size] {width} {height} Set the window height to {width} by {height} characters. Obsolete, use ":set lines=11 columns=22". diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index cd374c6f34..164e2d4ec5 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1322,6 +1322,11 @@ can have arguments, or have a range specified. Arguments are subject to completion as filenames, buffers, etc. Exactly how this works depends upon the command's attributes, which are specified when the command is defined. +When defining a user command in a script, it will be able to call functions +local to the script and use mappings local to the script. When the user +invokes the user command, it will run in the context of the script it was +defined in. This matters if |<SID>| is used in a command. + There are a number of attributes, split into four categories: argument handling, completion behavior, range handling, and special cases. The attributes are described below, by category. @@ -1770,9 +1775,5 @@ errors and the "update" command to write modified buffers): > This will invoke: > :call Allargs("%s/foo/bar/ge|update") < -When defining a user command in a script, it will be able to call functions -local to the script and use mappings local to the script. When the user -invokes the user command, it will run in the context of the script it was -defined in. This matters if |<SID>| is used in a command. vim:tw=78:ts=8:noet:ft=help:norl: diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 46d3f153c2..0aa6769f4e 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -5868,11 +5868,12 @@ A jump table for the options with a short description can be found at |Q_op|. global When "on" the commands listed below move the cursor to the first non-blank of the line. When off the cursor is kept in the same column - (if possible). This applies to the commands: CTRL-D, CTRL-U, CTRL-B, - CTRL-F, "G", "H", "M", "L", gg, and to the commands "d", "<<" and ">>" - with a linewise operator, with "%" with a count and to buffer changing - commands (CTRL-^, :bnext, :bNext, etc.). Also for an Ex command that - only has a line number, e.g., ":25" or ":+". + (if possible). This applies to the commands: + - CTRL-D, CTRL-U, CTRL-B, CTRL-F, "G", "H", "M", "L", "gg" + - "d", "<<" and ">>" with a linewise operator + - "%" with a count + - buffer changing commands (CTRL-^, :bnext, :bNext, etc.) + - Ex commands that only have a line number, e.g., ":25" or ":+". In case of buffer changing commands the cursor is placed at the column where it was the last time the buffer was edited. diff --git a/runtime/doc/pi_netrw.txt b/runtime/doc/pi_netrw.txt index d3d5e4605a..0742071d12 100644 --- a/runtime/doc/pi_netrw.txt +++ b/runtime/doc/pi_netrw.txt @@ -968,7 +968,7 @@ itself: fun! NetReadFixup(method, line1, line2) if method == 3 " ftp (no <.netrc>) let fourblanklines= line2 - 3 - silent fourblanklines .. "," .. line2 .. "g/^\s*/d" + silent fourblanklines.",".line2."g/^\s*/d" endif endfunction endif @@ -1625,10 +1625,8 @@ A further approach is to delete files which match a pattern. This will cause the matching files to be marked. Then, press "D". -If your vim has 7.4 with patch#1107, then |g:netrw_localrmdir| no longer -is used to remove directories; instead, vim's |delete()| is used with -the "d" option. Please note that only empty directories may be deleted -with the "D" mapping. Regular files are deleted with |delete()|, too. +Please note that only empty directories may be deleted with the "D" mapping. +Regular files are deleted with |delete()|, too. The |g:netrw_rm_cmd|, |g:netrw_rmf_cmd|, and |g:netrw_rmdir_cmd| variables are used to control the attempts to remove remote files and directories. The @@ -1647,8 +1645,7 @@ to remove it again using the g:netrw_rmf_cmd variable. Its default value is: |g:netrw_rmf_cmd|: ssh HOSTNAME rm -f Related topics: |netrw-d| -Associated setting variable: |g:netrw_localrmdir| |g:netrw_rm_cmd| - |g:netrw_rmdir_cmd| |g:netrw_ssh_cmd| +Associated setting variable: |g:netrw_rm_cmd| |g:netrw_ssh_cmd| *netrw-explore* *netrw-hexplore* *netrw-nexplore* *netrw-pexplore* @@ -1691,7 +1688,11 @@ DIRECTORY EXPLORATION COMMANDS {{{2 to 2; edits will thus preferentially be made in window#2. The [N] specifies a |g:netrw_winsize| just for the new :Lexplore - window. + window. That means that + if [N] < 0 : use |N| columns for the Lexplore window + if [N] = 0 : a normal split is made + if [N] > 0 : use N% of the current window will be used for the + new window Those who like this method often also like tree style displays; see |g:netrw_liststyle|. @@ -1975,7 +1976,7 @@ To use this function, simply assign its output to |g:netrw_list_hide| option. > Example: let g:netrw_list_hide= netrw_gitignore#Hide('my_gitignore_file') Function can take additional files with git-ignore patterns. - Example: let g:netrw_list_hide= netrw_gitignore#Hide() .. '.*\.swp$' + Example: g:netrw_list_hide= netrw_gitignore#Hide() . '.*\.swp$' Combining 'netrw_gitignore#Hide' with custom patterns. < @@ -2853,18 +2854,6 @@ your browsing preferences. (see also: |netrw-settings|) =" /c move" Windows Options for |g:netrw_localmovecmd| - *g:netrw_localrmdir* ="rmdir" Linux/Unix/MacOS/Cygwin - =expand("$COMSPEC") Windows - Remove directory command (rmdir) - This variable is only used if your vim is - earlier than 7.4 or if your vim doesn't - have patch#1107. Otherwise, |delete()| - is used with the "d" option. - - *g:netrw_localrmdiropt* ="" Linux/Unix/MacOS/Cygwin - =" /c rmdir" Windows - Options for |g:netrw_localrmdir| - *g:netrw_maxfilenamelen* =32 by default, selected so as to make long listings fit on 80 column displays. If your screen is wider, and you have file @@ -3775,7 +3764,7 @@ Example: Clear netrw's marked file list via a mapping on gu > Netrw uses several system level commands to do things (see |g:netrw_localcopycmd|, |g:netrw_localmovecmd|, - |g:netrw_localrmdir|, |g:netrw_mkdir_cmd|). + |g:netrw_mkdir_cmd|). You may need to adjust the default commands for one or more of these commands by setting them properly in your .vimrc. Another @@ -3901,6 +3890,13 @@ netrw: ============================================================================== 12. History *netrw-history* {{{1 + v172: Sep 02, 2021 * (Bram Moolenaar) Changed "l:go" to "go" + * (Bram Moolenaar) no need for "b" in + netrw-safe guioptions + Nov 15, 2021 * removed netrw_localrm and netrw_localrmdir + references + Aug 18, 2022 * (Miguel Barro) improving compatability with + powershell v171: Oct 09, 2020 * included code in s:NetrwOptionsSafe() to allow |'bh'| to be set to delete when rather than hide when g:netrw_fastbrowse @@ -3986,7 +3982,7 @@ netrw: mostly for Windows. Introduced new netrw settings: |g:netrw_localcopycmdopt| |g:netrw_localcopydircmdopt| |g:netrw_localmkdiropt| - |g:netrw_localmovecmdopt| |g:netrw_localrmdiropt| + |g:netrw_localmovecmdopt| g:netrw_localrmdiropt Nov 21, 2016 * (mattn) provided a patch for preview; swapped winwidth() with winheight() Nov 22, 2016 * (glacambre) reported that files containing @@ -4046,7 +4042,7 @@ netrw: refreshes. However, inside a |:map-<expr>|, tab and window changes are disallowed. Fixed. (affects netrw's s:LocalBrowseRefresh()) - * |g:netrw_localrmdir| not used any more, but + * g:netrw_localrmdir not used any more, but the relevant patch that causes |delete()| to take over was #1107 (not #1109). * |expand()| is now used on |g:netrw_home|; diff --git a/runtime/doc/pi_zip.txt b/runtime/doc/pi_zip.txt index 9b531d78b4..dd14b6c295 100644 --- a/runtime/doc/pi_zip.txt +++ b/runtime/doc/pi_zip.txt @@ -102,6 +102,7 @@ Copyright: Copyright (C) 2005-2015 Charles E Campbell *zip-copyright* ============================================================================== 4. History *zip-history* {{{1 + v33 Dec 07, 2021 * *.xlam mentioned twice in zipPlugin v32 Oct 22, 2021 * to avoid an issue with a vim 8.2 patch, zipfile: has been changed to zipfile:// . This often shows up as zipfile:/// with zipped files that are root-based. diff --git a/runtime/doc/recover.txt b/runtime/doc/recover.txt index d9aaa757ad..b05bcd6bc8 100644 --- a/runtime/doc/recover.txt +++ b/runtime/doc/recover.txt @@ -154,7 +154,7 @@ the recover command: :rec[over]! [file] Like ":recover", but any changes in the current buffer are lost. - *E312* *E309* *E310* + *E312* *E309* *E310* *E1364* Vim has some intelligence about what to do if the swap file is corrupt in some way. If Vim has doubt about what it found, it will give an error message and insert lines with "???" in the text. If you see an error message diff --git a/runtime/doc/spell.txt b/runtime/doc/spell.txt index c6c4da2dea..d985093d9f 100644 --- a/runtime/doc/spell.txt +++ b/runtime/doc/spell.txt @@ -205,7 +205,8 @@ line may be postponed. Use |CTRL-L| when needed. Also see |set-spc-auto| for how it can be set automatically when 'spelllang' is set. The 'spelloptions' option has a few more flags that influence the way spell -checking works. +checking works. For example, "camel" splits CamelCased words so that each +part of the word is spell-checked separately. Vim counts the number of times a good word is encountered. This is used to sort the suggestions: words that have been seen before get a small bonus, diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt index 9051375da2..00a5e1c8ad 100644 --- a/runtime/doc/syntax.txt +++ b/runtime/doc/syntax.txt @@ -2769,7 +2769,7 @@ unsetting all the other ones. If you use Python 2 or straddling code (Python 2 and 3 compatible), you can enforce the use of an older syntax file with support for Python 2 and up to Python 3.5. > - : let python_use_python2_syntax = 1 + :let python_use_python2_syntax = 1 This option will exclude all modern Python 3.6 or higher features. Note: Only existence of these options matters, not their value. @@ -3698,11 +3698,12 @@ The syntax script for zsh allows for syntax-based folding: > Vim understands three types of syntax items: 1. Keyword - It can only contain keyword characters, according to the 'iskeyword' - option. It cannot contain other syntax items. It will only match with a - complete word (there are no keyword characters before or after the match). - The keyword "if" would match in "if(a=b)", but not in "ifdef x", because - "(" is not a keyword character and "d" is. + It can only contain keyword characters, according to the characters + specified with |:syn-iskeyword| or the 'iskeyword' option. It cannot + contain other syntax items. It will only match with a complete word (there + are no keyword characters before or after the match). The keyword "if" + would match in "if(a=b)", but not in "ifdef x", because "(" is not a + keyword character and "d" is. 2. Match This is a match with a single regexp pattern. diff --git a/runtime/doc/usr_03.txt b/runtime/doc/usr_03.txt index 2b0d40ba32..b76ca18d20 100644 --- a/runtime/doc/usr_03.txt +++ b/runtime/doc/usr_03.txt @@ -173,6 +173,8 @@ one. Thus if the cursor is at the start of the line of the previous example, ---+----------------> % +Other ways to move around code can be found in |usr_29.txt|. + ============================================================================== *03.5* Moving to a specific line |