Mercurial > vim
changeset 28956:3e6e6b4e74eb v8.2.5000
patch 8.2.5000: no patch for documentation updates
Commit: https://github.com/vim/vim/commit/835ee980eedd1aa0fa2d731312ce38697a12a897
Author: Bram Moolenaar <Bram@vim.org>
Date: Sun May 22 14:50:16 2022 +0100
patch 8.2.5000: no patch for documentation updates
Problem: No patch for documentation updates.
Solution: Update documentation files.
author | Bram Moolenaar <Bram@vim.org> |
---|---|
date | Sun, 22 May 2022 16:00:02 +0200 |
parents | af4548691d70 |
children | 276725e0cabb |
files | runtime/doc/builtin.txt runtime/doc/indent.txt runtime/doc/options.txt runtime/doc/os_win32.txt runtime/doc/todo.txt runtime/doc/usr_52.txt runtime/doc/various.txt runtime/doc/vim9.txt src/version.c |
diffstat | 9 files changed, 36 insertions(+), 38 deletions(-) [+] |
line wrap: on
line diff
--- a/runtime/doc/builtin.txt +++ b/runtime/doc/builtin.txt @@ -1,4 +1,4 @@ -*builtin.txt* For Vim version 8.2. Last change: 2022 May 10 +*builtin.txt* For Vim version 8.2. Last change: 2022 May 21 VIM REFERENCE MANUAL by Bram Moolenaar
--- a/runtime/doc/indent.txt +++ b/runtime/doc/indent.txt @@ -1,4 +1,4 @@ -*indent.txt* For Vim version 8.2. Last change: 2022 Apr 07 +*indent.txt* For Vim version 8.2. Last change: 2022 May 21 VIM REFERENCE MANUAL by Bram Moolenaar
--- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 8.2. Last change: 2022 May 07 +*options.txt* For Vim version 8.2. Last change: 2022 May 21 VIM REFERENCE MANUAL by Bram Moolenaar
--- a/runtime/doc/os_win32.txt +++ b/runtime/doc/os_win32.txt @@ -1,4 +1,4 @@ -*os_win32.txt* For Vim version 8.2. Last change: 2022 Feb 14 +*os_win32.txt* For Vim version 8.2. Last change: 2022 May 22 VIM REFERENCE MANUAL by George Reilly @@ -42,6 +42,11 @@ The GUI version was made by George V. Re For compiling see "src/INSTALLpc.txt". *win32-compiling* + *WSL* +When using Vim on WSL (Windows Subsystem for Linux) the remarks here do not +apply, `has('win32')` will return false then. In case you need to know +whether Vim is running on WSL you can use `exists('$WSLENV')`. + ============================================================================== 1. Known problems *win32-problems*
--- a/runtime/doc/todo.txt +++ b/runtime/doc/todo.txt @@ -1,4 +1,4 @@ -*todo.txt* For Vim version 8.2. Last change: 2022 May 21 +*todo.txt* For Vim version 8.2. Last change: 2022 May 22 VIM REFERENCE MANUAL by Bram Moolenaar @@ -38,20 +38,14 @@ browser use: https://github.com/vim/vim/ *known-bugs* -------------------- Known bugs and current work ----------------------- -Make :defcompile accept a function argument, like :disassemble -Useful for global functions. - -Once Vim9 is stable: +Prepare for Vim 9.0 release: - Use Vim9 for more runtime files. -- Check code coverage, add more tests if needed. +- Check Vim9 code coverage, add more tests if needed. vim9instr.c vim9script.c vim9type.c -- Inlude new set of colors: #9795 - Adjust intro message to say "help version9". -Graduate FEAT_CINDENT and FEAT_SMARTINDENT ? - Update the user manual: - Update usr_41.txt for Vim9 script - Fill usr_50.txt as an "advanced section" of usr_41.txt
--- a/runtime/doc/usr_52.txt +++ b/runtime/doc/usr_52.txt @@ -1,4 +1,4 @@ -*usr_52.txt* For Vim version 8.2. Last change: 2022 May 16 +*usr_52.txt* For Vim version 8.2. Last change: 2022 May 21 VIM USER MANUAL - by Bram Moolenaar @@ -113,36 +113,33 @@ Although it's shorter to do: > Legacy Vim script only checks types at runtime, when the code is executed. And it's permissive, often a computation gives an unexpected value instead of reporting an error. Thus you can define a function and think it's fine, but -see a problem only later when it is called: > - let s:collected = '' - func ExtendAndReturn(add) - let s:collected += a:add - return s:collected +notice a problem only later when the function is called: > + func Concatenate(base, add) + return a:base + a:add endfunc Can you spot the error? Try this: > - echo ExtendAndReturn('text') -And you'll see zero. Why? Because in legacy Vim script "+=" will convert the -arguments to numbers, and any string without a number results in zero! + echo Concatenate('base', 'text') +And you'll see zero. Why? Because in legacy Vim script "+" will convert the +arguments to numbers, and any string without a number results in zero! That's +not what you expected. -With `:def` the type checking happens when compiling the function. For that -you need to specify the argument types and the return type. Also notice that -the argument is used without the "a:" prefix: > - let s:collected = '' - def ExtendAndReturn(add: string): string - s:collected += add - return s:collected +With `:def` the type checking happens when compiling the function. You need +to specify the argument types and the return type to make that possible. Also +notice that the argument names are used without the "a:" prefix: > + def Concatenate(base: string, add: string): string + return base + add enddef - disassemble ExtendAndReturn + defcompile Concatenate -Here we use `:disassemble` to do the compilation right away, without it the -compilation would happen when the function is called. Vim will tell you what -you did wrong: > +Here we use `:defcompile` to do the compilation right away, without it the +compilation would happen when the function is first called. Vim will tell you +what you did wrong: > E1051: Wrong argument type for + -Side note: here the context is legacy script, when using Vim9 script you would -put `:defcompile` at the end of the script to check for errors in the -functions defined in it. +Side note: here the context is legacy script. When using Vim9 script you +would put `:defcompile` at the end of the script to check for errors in all +the functions defined in it. Vim9 script is strict, it uses the "+" operator only for numbers and floats. For string concatenation ".." must be used. This avoids mistakes and avoids
--- a/runtime/doc/various.txt +++ b/runtime/doc/various.txt @@ -1,4 +1,4 @@ -*various.txt* For Vim version 8.2. Last change: 2022 Apr 03 +*various.txt* For Vim version 8.2. Last change: 2022 May 21 VIM REFERENCE MANUAL by Bram Moolenaar