doomemacs/modules/lang/idris
Henrik Lissner 6f40ad55f5
docs: discourage after! and use-package! use
There's little reason for users to use these macros in their private
configs over plain ol' `with-eval-after-load` and `use-package`, unless
they're writing their own modules.

It's my fault for signal boosting them in documentation and whenever I'm
asked for help, because beginners now believe they are somehow
required for Doom to work correctly (there are guides out there
telling beginners that migrating to Doom involves replacing all
instances of `with-eval-after-load` and `use-package` in their
pre-existing configs with `after!` and `use-package!` -- which was never
true).

What's more, I plan to replace `use-package`, internally, so the
`use-package!` macro won't exist for much longer.
2026-02-09 04:29:47 -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
doctor.el docs(idris): add doctor.el 2024-01-27 03:16:06 -05:00
packages.el bump: :lang idris latex markdown 2025-12-04 04:42:04 -05:00
README.org docs: discourage after! and use-package! use 2026-02-09 04:29:47 -05:00

:lang idris

Description   unfold

This module adds rudimentary Idris support to Doom Emacs.

Maintainers

This module needs a maintainer. Become a maintainer?

Module flags

+lsp
Enable LSP support for idris-mode. Requires doom-module::tools lsp and idris2-lsp.

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

TODO Installation

Enable this module in your doom! block.

For doom-module:+lsp, idris2-lsp is required.

󱌣 No installation steps have been documented. Document them?

TODO Usage

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

In addition to idris-mode goodness, this module adds frequently used functions under the <localleader> key.

TODO Configuration

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

Support for Idris 2

While doom-package:idris-mode was designed for v1 of the IDE-Protocol of Idris, it tries to maintain compatibility with v2. However, not all the features have been realized, so expect a little jank.

To get this working, simply set var:idris-interpreter-path to the path of the idris2 executable. E.g.

;;; add to $DOODMIR/config.el
(with-eval-after-load 'idris-mode
  (setq idris-interpreter-path "idris2"))

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

󱌣 This module has no appendix yet. Write one?