mirror of https://github.com/doomemacs/doomemacs synced 2025-08-03 12:27:26 -05:00

Files

Henrik Lissner 8951de19d8 bump: :lang

JuliaEditorSupport/julia-emacs@2aca8cf585 -> JuliaEditorSupport/julia-emacs@0f4d74f904
ProofGeneral/PG@b30d65de80 -> ProofGeneral/PG@d668946929
abicky/nodejs-repl.el@03d0b64768 -> abicky/nodejs-repl.el@130d49b073
agda/agda@819993172d -> agda/agda@3344ca8058
ardumont/markdown-toc@3d724e518a -> ardumont/markdown-toc@d2fb4cbd95
babashka/neil@78ffab1868 -> babashka/neil@0b7373dd1b
clojure-emacs/cider@c228dec27d -> clojure-emacs/cider@f00e83d338
clojure-emacs/clojure-mode@59888c84b6 -> clojure-emacs/clojure-mode@eabe29b076
davazp/graphql-mode@c3baca9280 -> davazp/graphql-mode@ee49531935
dgutov/robe@6bc8a07fc4 -> dgutov/robe@ec4b7e74e9
diml/utop@b490baca21 -> diml/utop@3322adaa52
emacs-ess/ESS@8b4664e4a7 -> emacs-ess/ESS@c72b911d70
emacs-geiser/chicken@a480598b59 -> emacs-geiser/chicken@5f2c1bb446
emacs-geiser/geiser@97ce88463f -> emacs-geiser/geiser@74eed1669a
emacs-jupyter/jupyter@e966c5d3d6 -> emacs-jupyter/jupyter@db8a9e233a
emacs-lsp/lsp-metals@b5139c9593 -> emacs-lsp/lsp-metals@6a6a345a8a
emacs-php/php-mode@31f702ee2d -> emacs-php/php-mode@0f756a8c07
emacs-rustic/rustic@9fdf5c76b2 -> emacs-rustic/rustic@e5c0271f1e
emacs-straight/auctex@0de9730957 -> emacs-straight/auctex@f00256cbfd
emacs-straight/org-mode@6a5d0ed342 -> emacs-straight/org-mode@5a4686915e
emacsorphanage/macrostep@419873665f -> emacsorphanage/macrostep@44faf4f7bf
erlang/otp@094260aba7 -> erlang/otp@3e7f126fe4
fxbois/web-mode@0c83581d1e -> fxbois/web-mode@be2d59c8fa
gcv/julia-snail@dff92c4250 -> gcv/julia-snail@24f79a067b
godotengine/emacs-gdscript-mode@bee7f99c6f -> godotengine/emacs-gdscript-mode@c3d9988984
greghendershott/racket-mode@c5bee6895b -> greghendershott/racket-mode@f2645aadd2
hakimel/reveal.js@0d02d8a303 -> hakimel/reveal.js@e15cf92ccd
hvesalai/emacs-scala-mode@bd0638c32a -> hvesalai/emacs-scala-mode@661337d8aa
jrblevin/markdown-mode@b8637bae07 -> jrblevin/markdown-mode@e100778594
jwiegley/emacs-async@af47d6f930 -> jwiegley/emacs-async@b99658e831
jwiegley/nix-update-el@aab70a3816 -> jwiegley/nix-update-el@77022ccd91
nonsequitur/inf-ruby@6399a36682 -> nonsequitur/inf-ruby@dad78a13f1
ocaml/dune@5ac095c7c0 -> ocaml/dune@098117d229
ocaml/merlin@a36f42a5b1 -> ocaml/merlin@3a806ef87f
oer/org-re-reveal@91610ba9b0 -> oer/org-re-reveal@ab1422c163
org-roam/org-roam@2a630476b3 -> org-roam/org-roam@cad3518788
polymode/poly-R@e4a39caaf4 -> polymode/poly-R@8024e852cf
polymode/polymode@15b6c1e94a -> polymode/polymode@74ba75d4bc
psibi/dhall-mode@87ab69fe76 -> psibi/dhall-mode@fca383a9c4
purescript-emacs/purescript-mode@d187b3d4bb -> purescript-emacs/purescript-mode@07e4d6ecfe
rwv/android-mode@d5332e339a -> rwv/android-mode@67f7c0d7d3
seagle0128/grip-mode@d6c7e33e40 -> seagle0128/grip-mode@df0ba7589d
technomancy/fennel-mode@259470b297 -> technomancy/fennel-mode@3632cc77de
tpapp/julia-repl@bb90cc1fce -> tpapp/julia-repl@317d560218

2025-01-09 23:47:38 -05:00

autoload

refactor: (if|when)-let -> (if|when)-let*

2025-01-08 19:33:37 -05:00

.doommodule

feat: add .doommodule files

2024-09-14 20:47:39 -04:00

config.el

refactor: use negated flags

2024-10-20 02:41:50 -04:00

packages.el

bump: :lang

2025-01-09 23:47:38 -05:00

README.org

docs(*): replace all-the-icons with nerd-icons

2023-09-16 20:19:11 +02:00

README.org

:lang lua

Description
- Maintainers
- Module flags
- Packages
- Hacks
- Changelog
Installation
- Language Server Protocol servers
  - LSP-mode
  - Eglot
- Formatter
Usage
Configuration
Troubleshooting
- Install lua-language-server
Frequently asked questions
Appendix

Description unfold

This module adds Lua support to Doom Emacs.

REPL
Love2D specific functions
Moonscript support
Fennel support

Maintainers

@hlissner

Become a maintainer?

Module flags

+fennel: Enable support for the Fennel language.
+lsp: Enable LSP support for lua-mode. Requires doom-module::tools lsp and a langserver (supports EmmyLua, lua-language-server, and lua-lsp).
+tree-sitter: Leverages tree-sitter for better syntax highlighting and structural text editing. Requires doom-module::tools tree-sitter. Has support for both Lua and Fennel.
+moonscript: Enable support for the Moonscript language.

Packages

doom-package:company-lua if doom-module::completion company
doom-package:fennel-mode if doom-module:+fennel
doom-package:lua-mode
if doom-module:+moonscript
- doom-package:flycheck-moonscript if doom-module::checkers syntax
- doom-package:moonscript-mode

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module requires Lua 5.1+ for most of its capabilities and, optionally, the fennel and moonscript transpilers. An LSP server is also required for LSP support.

Language Server Protocol servers

LSP server support depends on which flavor of the doom-module::tools lsp module you have installed (doom-package:eglot or doom-package:lsp-mode).

LSP-mode

Three servers are supported, ordered from highest to lowest priority:

EmmyLua-LanguageServer: Must be in $EMACSDIR/.local/etc/lsp/EmmyLua-LS-all.jar. See lsp-clients-emmy-lua-jar-path variable to change this.
Sumneko language server (lua-language-server): Must be in $EMACSDIR/.local/etc/lsp/lua-language-server/. See lsp-clients-lua-language-server-bin variable to change this.
lua-lsp: Must be available in ~/.luarocks/bin/lua-lsp. See lsp-clients-lua-lsp-server-install-dir variable to change this.

LSP-mode documentation has more information about setting up the server and the configuration variables correctly.

Eglot

Eglot currently only supports one of the above servers out of the box:

Sumneko language server (lua-language-server): Must be in $EMACSDIR/.local/etc/lsp/lua-language-server/. See +lua-lsp-dir variable to change this.

Formatter

Formatting is handled using the doom-module::editor format module via Stylua.

TODO Usage

󱌣 This module has no usage documentation yet. Write some?

TODO Configuration

󱌣 This module's configuration documentation is incomplete. Complete it?

lua-lsp-dir: This must be set when using doom-module:+lsp and using lua-language-server. This controls where the repository has been cloned and built to finish the configuration of the server.

Troubleshooting

Report an issue?

Install lua-language-server

A catch-all issue has been created to gather help for installing lua-language-server on non-VSCode platforms.

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

󱌣 This module has no appendix yet. Write one?