/
lua.txt
170 lines (127 loc) · 7.24 KB
/
lua.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
*lua.txt* Lua file type plug-in for the Vim text editor
The Lua [1] file type plug-in for Vim makes it easier to work with Lua source
code in Vim by providing the following features:
- The |'includeexpr'| option is set so that the |gf| (go to file) mapping knows
how to resolve Lua module names using package.path [2]
- The |'include'| option is set so that Vim follows dofile() [3], loadfile() [4]
and require() [5] calls when looking for identifiers in included files
(this works together with the |'includeexpr'| option)
- An automatic command is installed that runs 'luac -p' when you save your Lua
scripts. If 'luac' reports any errors they are shown in the quick-fix list
and Vim jumps to the line of the first error
- '<F1>' on a Lua function or 'method' call will try to open the relevant
documentation in the Lua Reference for Vim [6]
- The |'completefunc'| option is set to allow completion of Lua 5.1 keywords,
global variables and library members using Control-X Control-U
- The |'omnifunc'| option is set to allow dynamic completion of all modules
installed on the system using Control-X Control-O, however it needs to be
explicitly enabled by setting the |lua_complete_omni| option because this
functionality may have undesired side effects!
- Several |text-objects| are defined so you can jump between blocks and
functions
- A pretty nifty hack of the matchit plug-in (see |matchit-install|) is
included: When the cursor is on a 'function' or 'return' keyword the '%'
mapping cycles between the relevant keywords ('function', 'return', 'end'),
this also works for branching statements ('if', 'elseif', 'else', 'end')
and looping statements ('for', 'while', 'repeat', 'until', 'end')
===============================================================================
*lua-installation*
Installation ~
Unzip the most recent ZIP archive [7] file inside your Vim profile directory
(usually this is '~/.vim' on UNIX and '%USERPROFILE%\vimfiles' on Windows),
restart Vim and execute the command ':helptags ~/.vim/doc' (use ':helptags
~\vimfiles\doc' instead on Windows). Now try it out: Edit a Lua script and try
any of the features documented above.
===============================================================================
*lua-options*
Options ~
The Lua file type plug-in handles options as follows: First it looks at buffer
local variables, then it looks at global variables and if neither exists a
default is chosen. This means you can change how the plug-in works for
individual buffers. For example to change the location of the Lua compiler
used to check the syntax:
>
" This sets the default value for all buffers.
:let g:lua_compiler_name = '/usr/local/bin/luac'
" This is how you change the value for one buffer.
:let b:lua_compiler_name = '/usr/local/bin/lualint'
-------------------------------------------------------------------------------
The *lua_path* option
This option contains the value of 'package.path' as a string. You shouldn't
need to change this because the plug-in is aware of $LUA_PATH [2] and if that
isn't set the plug-in will run a Lua interpreter to get the value of
package.path [2].
-------------------------------------------------------------------------------
The *lua_check_syntax* option
When you write a Lua script to disk the plug-in automatically runs the Lua
compiler to check for syntax errors. To disable this behavior you can set this
option to false (0):
>
let g:lua_check_syntax = 0
-------------------------------------------------------------------------------
The *lua_compiler_name* option
The name or path of the Lua compiler used to check for syntax errors. You can
set this option to run the Lua compiler from a non-standard location or to run
a dedicated syntax checker like lualint [8].
-------------------------------------------------------------------------------
The *lua_error_format* option
If you use a dedicated syntax checker you may need to change this option to
reflect the format of the messages printed by the syntax checker.
-------------------------------------------------------------------------------
The *lua_complete_keywords* option
To disable completion of keywords you can set this option to false (0).
-------------------------------------------------------------------------------
The *lua_complete_globals* option
To disable completion of global functions you can set this option to false
(0).
-------------------------------------------------------------------------------
The *lua_complete_library* option
To disable completion of library functions you can set this option to false
(0).
-------------------------------------------------------------------------------
The *lua_complete_dynamic* option
When you type a dot after a word the Lua file type plug-in will automatically
start completion. To disable this behavior you can set this option to false
(0).
-------------------------------------------------------------------------------
The *lua_complete_omni* option
This option is disabled by default for two reasons:
- The omni completion support works by enumerating and loading all installed
modules. If module loading has side effects this can have unintended
consequences!
- Because all modules installed on the system are loaded, collecting the
completion candidates can be slow. After the first run the completion
candidates are cached so this will only bother you once (until you restart
Vim).
If you want to use the omni completion despite the warnings above, execute the
following command:
>
:let g:lua_complete_omni = 1
Now when you type Control-X Control-O Vim will hang for a moment, after which
you should be presented with an enormous list of completion candidates :-)
===============================================================================
*lua-contact*
Contact ~
If you have questions, bug reports, suggestions, etc. the author can be
contacted at peter@peterodding.com. The latest version is available at
http://peterodding.com/code/vim/lua-ftplugin and http://github.com/xolox/vim-lua-ftplugin.
If you like this plug-in please vote for it on Vim Online [9].
===============================================================================
*lua-license*
License ~
This software is licensed under the MIT license [10]. Copyright 2011 Peter
Odding <peter@peterodding.com>.
===============================================================================
*lua-references*
References ~
[1] http://www.lua.org/
[2] http://www.lua.org/manual/5.1/manual.html#pdf-package.path
[3] http://www.lua.org/manual/5.1/manual.html#pdf-dofile
[4] http://www.lua.org/manual/5.1/manual.html#pdf-loadfile
[5] http://www.lua.org/manual/5.1/manual.html#pdf-require
[6] http://www.vim.org/scripts/script.php?script_id=1291
[7] http://peterodding.com/code/vim/downloads/lua-ftplugin.zip
[8] http://lua-users.org/wiki/LuaLint
[9] http://www.vim.org/scripts/script.php?script_id=3625
[10] http://en.wikipedia.org/wiki/MIT_License
vim: ft=help