patch 8.2.4136: Vim9: the "autoload" argument of ":vim9script" is not useful
Problem: Vim9: the "autoload" argument of ":vim9script" is not useful.
Solution: Remove the argument. (closes #9555)
diff --git a/runtime/doc/repeat.txt b/runtime/doc/repeat.txt
index 067234a..9a82ba4 100644
--- a/runtime/doc/repeat.txt
+++ b/runtime/doc/repeat.txt
@@ -365,12 +365,11 @@
Vim version, or update Vim to a newer version. See
|vimscript-version| for what changed between versions.
-:vim9s[cript] [noclear] [autoload] *:vim9s* *:vim9script*
+:vim9s[cript] [noclear] *:vim9s* *:vim9script*
Marks a script file as containing |Vim9-script|
commands. Also see |vim9-namespace|.
Must be the first command in the file.
For [noclear] see |vim9-reload|.
- For [autoload] see |vim9-autoload|.
Without the |+eval| feature this changes the syntax
for some commands.
See |:vim9cmd| for executing one command with Vim9
@@ -378,8 +377,8 @@
*:scr* *:scriptnames*
:scr[iptnames] List all sourced script names, in the order they were
- first sourced. The number is used for the script ID
- |<SID>|.
+ first encountered. The number is used for the script
+ ID |<SID>|.
For a script that was used with `import autoload` but
was not actually sourced yet an "A" is shown after the
script ID.
diff --git a/runtime/doc/vim9.txt b/runtime/doc/vim9.txt
index 94a5057..bbdc2bd 100644
--- a/runtime/doc/vim9.txt
+++ b/runtime/doc/vim9.txt
@@ -1,4 +1,4 @@
-*vim9.txt* For Vim version 8.2. Last change: 2022 Jan 15
+*vim9.txt* For Vim version 8.2. Last change: 2022 Jan 18
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1523,17 +1523,18 @@
directory.
2. In the autoload script put the bulk of the code. >
- vim9script autoload
+ vim9script
export def Stuff(arg: string)
...
< This goes in .../autoload/for/search.vim.
- Adding "autoload" to `:vim9script` has the effect that "for#search#" will
- be prefixed to every exported item. The prefix is obtained from the file
- name, as you would to manually in a legacy autoload script. Thus the
- exported function can be found with "for#search#Stuff", but you would
- normally use `import autoload` and not need to specify the prefix.
+ Putting the "search.vim" script under the "/autoload/for/" directory has
+ the effect that "for#search#" will be prefixed to every exported item. The
+ prefix is obtained from the file name, as you would to manually in a
+ legacy autoload script. Thus the exported function can be found with
+ "for#search#Stuff", but you would normally use `import autoload` and not
+ use the prefix.
You can split up the functionality and import other scripts from the
autoload script as you like. This way you can share code between plugins.