From 61dd06ed9f56a15adaf8b4f141d2f7e47670196b Mon Sep 17 00:00:00 2001 From: Gerald Combs Date: Thu, 19 Jul 2018 15:06:07 -0700 Subject: Lua: Switch from disable_lua to enable_lua. Deprecate "disable_lua" in favor of "enable_lua". Configuration options typically use "true" or a similar value to enable features. Using "disable_lua = false" to enable Lua seems odd. Change-Id: I224acad0559d409ea0a28b5555d1eb898564328c Reviewed-on: https://code.wireshark.org/review/28773 Reviewed-by: Gerald Combs Petri-Dish: Gerald Combs Tested-by: Petri Dish Buildbot Reviewed-by: Anders Broman --- docbook/wsluarm.asciidoc | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) (limited to 'docbook') diff --git a/docbook/wsluarm.asciidoc b/docbook/wsluarm.asciidoc index ab3c96bf88..7861a7d8c1 100644 --- a/docbook/wsluarm.asciidoc +++ b/docbook/wsluarm.asciidoc @@ -20,21 +20,23 @@ the Department of Computer Science. In Wireshark Lua can be used to write dissectors, taps, and capture file readers and writers. -Wireshark’s Lua interpreter starts by loading `init.lua` that is located in the -global configuration directory of Wireshark. Lua is enabled by default. To -disable Lua the line variable _$$disable_lua$$_ should be set to _true_ in -`init.lua`. - -After loading _init.lua_ from the data directory if Lua is enabled Wireshark -will try to load a file named `init.lua` in the user’s directory. - -Wireshark will also load all files with `.lua` suffix from both the global and -the personal plugins directory. +Wireshark’s Lua interpreter starts by loading a file named `init.lua` in +Wireshark's global configuration directory. It is enabled by default. To +disable Lua the line variable _$$enable_lua$$_ should be set to _false_ +in _init.lua_. Wireshark 2.6 and earlier enabled and disabled Lua using +the variable _$$disable_lua$$_. It is still supported, but is deprecated +and support may be removed in a future release. _$$enable_lua$$_ takes +precedence over _$$disable_lua$$_. + +If Lua is enabled Wireshark will then try to load a file named _init.lua_ +in the user’s personal configuration directory. Wireshark will also load +all files with a _.lua_ suffix from both the global and the personal +plugins directory. The command line option _$$-X lua_script:$$++file.lua++_ can be used to load Lua scripts as well. -The Lua code will be executed once after all the protocol dissectors have being +The Lua code will be executed once after all the protocol dissectors have been initialized and before reading any file. [[wslua_dissector_example]] -- cgit v1.2.3