From 11f98dc0f1fd344981a08e09b00348d61c08f53f Mon Sep 17 00:00:00 2001 From: Coleman McFarland <43583445+dontlaugh@users.noreply.github.com> Date: Sun, 13 Feb 2022 15:15:07 -0500 Subject: [PATCH] Add brief modules explanation In lieu of adding a whole docs page for modules, a brief introduction can be added above the provide-module and require-module command docs. --- doc/pages/commands.asciidoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc index 3a1ec818..f8a1e17f 100644 --- a/doc/pages/commands.asciidoc +++ b/doc/pages/commands.asciidoc @@ -423,6 +423,10 @@ but not really useful in that context. == Module commands +In Kakoune, modules are groups of commands that are evaluated all at once. This allows +lazy loading of complex configurations with a single invocation of *require-moule*. +The builtin filetype handling for Kakoune is implemented via modules. + *provide-module* [] :: declares a module *name* that is defined by *commands*. *commands* will be evaluated as if by source the first time *require-module * is run.