emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs: change link format

Browse source
This commit is contained in:
TEC 2022-09-26 02:19:42 +08:00 • committed by Henrik Lissner
parent 58fb83c98e
commit 5ac2a5258b
160 changed files with 1161 additions and 1152 deletions
Download patch file Download diff file Expand all files Collapse all files

4
docs/appendix.org
View file

@ -184,8 +184,8 @@
[[kbd:][C-x]] and [[kbd:][C-x C-k]] can be considered prefixes. [[kbd:][C-x]] and [[kbd:][C-x C-k]] can be considered prefixes.
Prefix keys allow to store and move keybindings in groups. For example by Prefix keys allow to store and move keybindings in groups. For example by
default all [[doom-package:][lsp-mode]] commands are under ~SPC c l ...~, but if you want to default all [[doom-package:lsp-mode]] commands are under ~SPC c l ...~, but if you want to
change that prefix to ~SPC L ...~ for all [[doom-package:][lsp-mode]] commands, it is a one liner change that prefix to ~SPC L ...~ for all [[doom-package:lsp-mode]] commands, it is a one liner
in your configuration; you do _not_ have to rebind each command manually to in your configuration; you do _not_ have to rebind each command manually to
its new ~SPC L ...~ variant. its new ~SPC L ...~ variant.

4
docs/examples.org
View file

@ -14,8 +14,8 @@ examples; where the former can also be useful to users who don't use Doom.
Some of Doom's components will read this file to generate documentation for you, Some of Doom's components will read this file to generate documentation for you,
for example: for example:
- Doom's [[doom-module:][:lang emacs-lisp]] module installs the [[doom-package:][elisp-demos]] package. This displays - Doom's [[doom-module:][:lang emacs-lisp]] module installs the [[doom-package:elisp-demos]] package. This displays
usage examples alongside documentation in [[doom-package:][help]] and [[doom-package:][helpful]] buffers (produced usage examples alongside documentation in [[doom-package:help]] and [[doom-package:helpful]] buffers (produced
by =describe-*= and =helpful-*= commands; e.g. [[kbd:][<help> h f]]). Doom has extended by =describe-*= and =helpful-*= commands; e.g. [[kbd:][<help> h f]]). Doom has extended
this package to search this file as well. this package to search this file as well.
- [[id:1b8b8fa9-6233-4ed8-95c7-f46f8e4e2592][Some Doom's CLI commands]] will emit documentation informed by Doom's org files, - [[id:1b8b8fa9-6233-4ed8-95c7-f46f8e4e2592][Some Doom's CLI commands]] will emit documentation informed by Doom's org files,

58
docs/faq.org
View file

@ -199,10 +199,10 @@ Doom's LSP support and install a supported LSP client.
This provides code completion, lookup {definition,references,documentation} This provides code completion, lookup {definition,references,documentation}
functionality, and syntax checking, all in one: functionality, and syntax checking, all in one:
1. Enable Doom's [[doom-module:][:tools lsp]] module. ([[id:01cffea4-3329-45e2-a892-95a384ab2338][How do I enable modules?]]) 1. Enable Doom's [[doom-module::tools lsp]] module. ([[id:01cffea4-3329-45e2-a892-95a384ab2338][How do I enable modules?]])
2. Enable the ~+lsp~ flag on the ~:lang~ module corresponding to the language 2. Enable the ~+lsp~ flag on the ~:lang~ module corresponding to the language
you want LSP support for. E.g. For python, enable [[doom-module:][:lang python +lsp]]. For you want LSP support for. E.g. For python, enable [[doom-module::lang python +lsp]]. For
rust, enable [[doom-module:][:lang rust +lsp]]. ([[id:01cffea4-3329-45e2-a892-95a384ab2338][How do I enable module flags?]]) rust, enable [[doom-module::lang rust +lsp]]. ([[id:01cffea4-3329-45e2-a892-95a384ab2338][How do I enable module flags?]])
3. Install [[https://emacs-lsp.github.io/lsp-mode/page/languages/][a supported LSP client]] on your system using your OS package manager 3. Install [[https://emacs-lsp.github.io/lsp-mode/page/languages/][a supported LSP client]] on your system using your OS package manager
OR from within Emacs using ~M-x lsp-install-server~ (warning: not all servers OR from within Emacs using ~M-x lsp-install-server~ (warning: not all servers
can be installed this way). can be installed this way).
@ -215,7 +215,7 @@ functionality, and syntax checking, all in one:
*** Potential issues *** Potential issues
1. Some language modules lack LSP support (either because it doesn't exist or 1. Some language modules lack LSP support (either because it doesn't exist or
I'm not aware of it -- let me know!). If you're certain a language is I'm not aware of it -- let me know!). If you're certain a language is
supported by [[doom-package:][lsp-mode]], simply adding [[fn:][lsp!]] to that major mode's hook will be supported by [[doom-package:lsp-mode]], simply adding [[fn:lsp!]] to that major mode's hook will be
enough to enable it: enough to enable it:
#+begin_src elisp #+begin_src elisp
@ -238,15 +238,15 @@ documentation with [[kbd:][<help> d m]] (or ~M-x doom/help-modules~).
** Change my fonts ** Change my fonts
Doom exposes a couple variables for setting fonts. They are: Doom exposes a couple variables for setting fonts. They are:
- [[var:][doom-font]]: the primary font for Emacs to use. - [[var:doom-font]]: the primary font for Emacs to use.
- [[var:][doom-variable-pitch-font]]: used for non-monospace fonts (e.g. when using - [[var:doom-variable-pitch-font]]: used for non-monospace fonts (e.g. when using
variable-pitch-mode or mixed-pitch-mode). Popular for text modes, like Org or variable-pitch-mode or mixed-pitch-mode). Popular for text modes, like Org or
Markdown. Markdown.
- [[var:][doom-unicode-font]]: used for rendering unicode glyphs. This is ~Symbola~ by - [[var:doom-unicode-font]]: used for rendering unicode glyphs. This is ~Symbola~ by
default. It is ignored if the [[doom-module:][:ui unicode]] module is enabled. default. It is ignored if the [[doom-module::ui unicode]] module is enabled.
- [[var:][doom-serif-font]]: the sans-serif font to use wherever the [[face:][fixed-pitch-serif]] - [[var:doom-serif-font]]: the sans-serif font to use wherever the [[face:fixed-pitch-serif]]
face is used. face is used.
- [[var:][doom-big-font]]: the large font to use when [[fn:][doom-big-font-mode]] is active. - [[var:doom-big-font]]: the large font to use when [[fn:doom-big-font-mode]] is active.
Each of these variables accept one of: Each of these variables accept one of:
@ -329,7 +329,7 @@ This is documented in more detail in our user manual:
- [[id:8e0d2c05-6028-4e68-a50d-b81851f3f258][How to bind aliases for your leader / localleader prefix]] - [[id:8e0d2c05-6028-4e68-a50d-b81851f3f258][How to bind aliases for your leader / localleader prefix]]
** Change the style of (or disable) line-numbers? ** Change the style of (or disable) line-numbers?
Doom uses the [[doom-package:][display-line-numbers]] package, which is included with Emacs 26+. Doom uses the [[doom-package:display-line-numbers]] package, which is included with Emacs 26+.
*** To disable line numbers entirely *** To disable line numbers entirely
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -357,7 +357,7 @@ For example:
#+end_src #+end_src
You'll find more precise documentation on the variable through [[kbd:][<help> v You'll find more precise documentation on the variable through [[kbd:][<help> v
display-line-numbers-type]] ([[kbd:][<help>]] is [[kbd:][SPC h]] for [[doom-package:][evil]] users, [[kbd:][C-h]] otherwise). display-line-numbers-type]] ([[kbd:][<help>]] is [[kbd:][SPC h]] for [[doom-package:evil]] users, [[kbd:][C-h]] otherwise).
*** To cycle through different styles of line numbers *** To cycle through different styles of line numbers
Use ~M-x doom/toggle-line-numbers~ (bound to [[kbd:][<leader> t l]] by default) to cycle Use ~M-x doom/toggle-line-numbers~ (bound to [[kbd:][<leader> t l]] by default) to cycle
@ -366,7 +366,7 @@ through the available line number styles in the current buffer.
E.g. ~normal -> relative -> visual -> disabled -> normal~ E.g. ~normal -> relative -> visual -> disabled -> normal~
** Disable Evil (vim emulation)? ** Disable Evil (vim emulation)?
By disabling the [[doom-module:][:editor evil]] module ([[id:01cffea4-3329-45e2-a892-95a384ab2338][how to toggle modules]]). By disabling the [[doom-module::editor evil]] module ([[id:01cffea4-3329-45e2-a892-95a384ab2338][how to toggle modules]]).
Read the "[[id:f3925da6-5f0b-4d11-aa08-7bb58bea1982][Removing evil-mode]]" section in the module's documentation for precise Read the "[[id:f3925da6-5f0b-4d11-aa08-7bb58bea1982][Removing evil-mode]]" section in the module's documentation for precise
instructions. instructions.
@ -408,7 +408,7 @@ moved.
Delete =$EMACSDIR/.local/straight= and run ~$ doom sync~. Delete =$EMACSDIR/.local/straight= and run ~$ doom sync~.
** Restore the s and S keys to their default vim behavior ([[doom-ref:][#1307]]) ** Restore the s and S keys to their default vim behavior ([[doom-ref:][#1307]])
[[kbd:][s]] and [[kbd:][S]] have been intentionally replaced with the [[doom-package:][evil-snipe]] plugin, which [[kbd:][s]] and [[kbd:][S]] have been intentionally replaced with the [[doom-package:evil-snipe]] plugin, which
provides 2-character versions of the f/F/t/T motion keys, ala [[https://github.com/goldfeld/vim-seek][vim-seek]] or provides 2-character versions of the f/F/t/T motion keys, ala [[https://github.com/goldfeld/vim-seek][vim-seek]] or
[[https://github.com/justinmk/vim-sneak][vim-sneak]]. [[https://github.com/justinmk/vim-sneak][vim-sneak]].
@ -456,7 +456,7 @@ The common explanations for this are:
the error can shed more light on it (and will be required if you ask the the error can shed more light on it (and will be required if you ask the
community for help debugging it). community for help debugging it).
- You have disabled the [[doom-module:][:ui doom-dashboard]] module. Read about - You have disabled the [[doom-module::ui doom-dashboard]] module. Read about
[[id:5e267107-81fa-45b4-8ff3-26d4b98e508e][what Doom modules are]] and [[id:01cffea4-3329-45e2-a892-95a384ab2338][how to [[id:5e267107-81fa-45b4-8ff3-26d4b98e508e][what Doom modules are]] and [[id:01cffea4-3329-45e2-a892-95a384ab2338][how to
toggle them]]. toggle them]].
@ -521,7 +521,7 @@ Here are a few common causes for random crashes:
~doom-unicode-font~. ~doom-unicode-font~.
- Ligatures can cause Emacs to crash. Try a different [[doom-module::ui ligatures +fira][ligature font]] or disable - Ligatures can cause Emacs to crash. Try a different [[doom-module::ui ligatures +fira][ligature font]] or disable
the [[doom-module:][:ui ligatures]] module altogether. the [[doom-module::ui ligatures]] module altogether.
- On some systems (particularly MacOS), manipulating the fringes or window - On some systems (particularly MacOS), manipulating the fringes or window
margins can cause Emacs to crash. This is most prominent in Doom's Dashboard margins can cause Emacs to crash. This is most prominent in Doom's Dashboard
@ -540,7 +540,7 @@ Here are a few common causes for random crashes:
(setq org-startup-indented nil)) (setq org-startup-indented nil))
#+end_src #+end_src
Or disable the [[doom-module:][:ui doom-dashboard]] and [[doom-module:][:tools magit]] modules (see [[doom-ref:][#1170]]). Or disable the [[doom-module::ui doom-dashboard]] and [[doom-module::tools magit]] modules (see [[doom-ref:][#1170]]).
If these don't help, check our troubleshooting guides for [[id:f88eaf35-97c4-48de-85ef-2d53f8615d4a][hard crashes]] or If these don't help, check our troubleshooting guides for [[id:f88eaf35-97c4-48de-85ef-2d53f8615d4a][hard crashes]] or
[[id:0b744192-c648-452d-ba62-1b4c76dc3aee][freezes/hangs]]. [[id:0b744192-c648-452d-ba62-1b4c76dc3aee][freezes/hangs]].
@ -575,10 +575,10 @@ There are a couple ways to address this:
#+end_src #+end_src
3. Use [[https://editorconfig.org/][editorconfig]] to configure code style on a per-project basis. If you 3. Use [[https://editorconfig.org/][editorconfig]] to configure code style on a per-project basis. If you
enable Doom's [[doom-module:][:tools editorconfig]] module, Doom will recognize enable Doom's [[doom-module::tools editorconfig]] module, Doom will recognize
=.editorconfigrc= files. =.editorconfigrc= files.
4. Or trust in [[doom-package:][dtrt-indent]]; a plugin Doom uses to analyze and detect indentation 4. Or trust in [[doom-package:dtrt-indent]]; a plugin Doom uses to analyze and detect indentation
when you open a file (that isn't in a project with an editorconfig file). when you open a file (that isn't in a project with an editorconfig file).
This isn't foolproof, and won't work for files that have no content in them, This isn't foolproof, and won't work for files that have no content in them,
but it can help in one-off scenarios. but it can help in one-off scenarios.
@ -886,7 +886,7 @@ All that said, I take no steps to disable or cripple =Customize= in Doom
to cause issues). If used sparingly, you may not even run into these issues. to cause issues). If used sparingly, you may not even run into these issues.
** Why no =expand-region= for evil users (by default)? ** Why no =expand-region= for evil users (by default)?
I believe [[doom-package:][expand-region]] is redundant with and less precise than evil's text I believe [[doom-package:expand-region]] is redundant with and less precise than evil's text
objects and motions. objects and motions.
- There's a text object for every "step" of expansion that expand-region - There's a text object for every "step" of expansion that expand-region
@ -904,7 +904,7 @@ objects and motions.
the surrounding brackets/parentheses, etc. There is no reverse of this the surrounding brackets/parentheses, etc. There is no reverse of this
however; you'd have to restart visual mode. however; you'd have to restart visual mode.
The [[doom-package:][expand-region]] way dictates you start at some point and expand/contract until The [[doom-package:expand-region]] way dictates you start at some point and expand/contract until
you have what you want selected. The vim/evil way would rather you select you have what you want selected. The vim/evil way would rather you select
exactly what you want from the get go. In the rare event a text object fails exactly what you want from the get go. In the rare event a text object fails
you, a combination of [[kbd:][o]] (swaps your cursor between the two ends of the region) you, a combination of [[kbd:][o]] (swaps your cursor between the two ends of the region)
@ -921,7 +921,7 @@ editing paradigm. Vimmers will feel right at home. To everyone else: mastering
them will have a far-reaching effect on your effectiveness in vim environments. them will have a far-reaching effect on your effectiveness in vim environments.
I highly recommend putting in the time to learn them. I highly recommend putting in the time to learn them.
That said, if you aren't convinced, it is trivial to install [[doom-package:][expand-region]] and That said, if you aren't convinced, it is trivial to install [[doom-package:expand-region]] and
binds keys to it yourself: binds keys to it yourself:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;;; in $DOOMDIR/packages.el ;;; in $DOOMDIR/packages.el
@ -939,17 +939,17 @@ variables. This affects macOS users (all =Emacs.app= bundles launch Emacs in an
isolated environment), Linux users who misconfigure their launchers to use the isolated environment), Linux users who misconfigure their launchers to use the
wrong shell, or Windows users who may have no shell environment at all. wrong shell, or Windows users who may have no shell environment at all.
[[doom-package:][exec-path-from-shell]] was written to mitigate this, by polling the shell at [[doom-package:exec-path-from-shell]] was written to mitigate this, by polling the shell at
startup for those environment variables. ~$ doom env~ was written as more startup for those environment variables. ~$ doom env~ was written as more
reliable (and slightly faster) substitute. Here's why it's better: reliable (and slightly faster) substitute. Here's why it's better:
1. [[doom-package:][exec-path-from-shell]] must spawn (at least) one process at startup to scrape 1. [[doom-package:exec-path-from-shell]] must spawn (at least) one process at startup to scrape
your shell environment. This can be slow depending on the user's shell your shell environment. This can be slow depending on the user's shell
configuration and may fail on non-standard shells (like =fish=). A single configuration and may fail on non-standard shells (like =fish=). A single
program (like =pyenv= or =nvm=) or config framework (like =oh-my-zsh=) could program (like =pyenv= or =nvm=) or config framework (like =oh-my-zsh=) could
all our startup optimizations in one fell swoop. all our startup optimizations in one fell swoop.
2. [[doom-package:][exec-path-from-shell]] takes a whitelist approach and captures only =$PATH= and 2. [[doom-package:exec-path-from-shell]] takes a whitelist approach and captures only =$PATH= and
=$MANPATH= by default. You must be proactive in order to capture all the =$MANPATH= by default. You must be proactive in order to capture all the
envvars relevant to your development environment and tools. envvars relevant to your development environment and tools.
@ -957,7 +957,7 @@ reliable (and slightly faster) substitute. Here's why it's better:
environment. This front loads the debugging process, which is nicer than environment. This front loads the debugging process, which is nicer than
dealing with it later, while you're getting work done. dealing with it later, while you're getting work done.
That said, if you still want [[var:][exec-path-from-shell]], it is trivial to install That said, if you still want [[var:exec-path-from-shell]], it is trivial to install
yourself: yourself:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;;; in $DOOMDIR/packages.el ;;; in $DOOMDIR/packages.el
@ -970,12 +970,12 @@ yourself:
#+end_src #+end_src
** Why =ws-butler= over =whitespace-cleanup= or =delete-trailing-whitespace=? ** Why =ws-butler= over =whitespace-cleanup= or =delete-trailing-whitespace=?
I believe [[doom-package:][ws-butler]] is less imposing on teammates/project maintainers; it only I believe [[doom-package:ws-butler]] is less imposing on teammates/project maintainers; it only
cleans up whitespace on the lines you've touched. cleans up whitespace on the lines you've touched.
You know the story: a PR with 99 whitespace adjustments around a one-line You know the story: a PR with 99 whitespace adjustments around a one-line
contribution. Why? Because they added [[fn:][delete-trailing-whitespace]] (or contribution. Why? Because they added [[fn:delete-trailing-whitespace]] (or
[[fn:][whitespace-cleanup]]) to [[var:][before-save-hook]], which mutates entire buffers. [[fn:whitespace-cleanup]]) to [[var:before-save-hook]], which mutates entire buffers.
Automated processes that mutate entire files (or worse, whole projects) should Automated processes that mutate entire files (or worse, whole projects) should
be deliberately invoked, and by someone privvy to the consequences, rather than be deliberately invoked, and by someone privvy to the consequences, rather than

238
modules/README.org
View file

@ -38,7 +38,7 @@ setup instructions.
** [[doom-module::app][:app]] (6) :unfold: ** [[doom-module::app][:app]] (6) :unfold:
Application modules are complex and opinionated modules that transform Emacs Application modules are complex and opinionated modules that transform Emacs
toward a specific purpose. They may have additional dependencies and *should be toward a specific purpose. They may have additional dependencies and *should be
loaded last* (but before [[doom-module:][:config]] modules). loaded last* (but before [[doom-module::config]] modules).
*** [[doom-module::app calendar][calendar]]: - *** [[doom-module::app calendar][calendar]]: -
: Watch your missed deadlines in real time : Watch your missed deadlines in real time
@ -87,7 +87,7 @@ For modules dedicated to linting plain text (primarily code and prose).
: Tasing grammar mistake every you make : Tasing grammar mistake every you make
This module adds grammar checking to Emacs to aid your writing by combining This module adds grammar checking to Emacs to aid your writing by combining
[[doom-package:][lang-tool]] and [[doom-package:][writegood-mode]]. [[doom-package:lang-tool]] and [[doom-package:writegood-mode]].
*** [[doom-module::checkers spell][spell]]: [[doom-module::checkers spell +aspell][+aspell]] [[doom-module::checkers spell +enchant][+enchant]] [[doom-module::checkers spell +everywhere][+everywhere]] [[doom-module::checkers spell +flyspell][+flyspell]] [[doom-module::checkers spell +hunspell][+hunspell]] *** [[doom-module::checkers spell][spell]]: [[doom-module::checkers spell +aspell][+aspell]] [[doom-module::checkers spell +enchant][+enchant]] [[doom-module::checkers spell +everywhere][+everywhere]] [[doom-module::checkers spell +flyspell][+flyspell]] [[doom-module::checkers spell +hunspell][+hunspell]]
: Tasing you for misspelling mispelling : Tasing you for misspelling mispelling
@ -102,13 +102,13 @@ includes ~org-mode~, ~markdown-mode~, the Git Commit buffer (from magit),
- Spell checking and correction using =aspell=, =hunspell= or =enchant=. - Spell checking and correction using =aspell=, =hunspell= or =enchant=.
- Ignores source code inside org or markdown files. - Ignores source code inside org or markdown files.
- Lazily spellchecking recent changes only when idle. - Lazily spellchecking recent changes only when idle.
- Choosing suggestions using completion interfaces ([[doom-package:][ivy]] or [[doom-package:][helm]]). - Choosing suggestions using completion interfaces ([[doom-package:ivy]] or [[doom-package:helm]]).
*** [[doom-module::checkers syntax][syntax]]: [[doom-module::checkers syntax +childframe][+childframe]] *** [[doom-module::checkers syntax][syntax]]: [[doom-module::checkers syntax +childframe][+childframe]]
: Tasing you for every semicolon you forget : Tasing you for every semicolon you forget
This module provides syntax checking and error highlighting, powered by This module provides syntax checking and error highlighting, powered by
[[doom-package:][flycheck]]. [[doom-package:flycheck]].
** [[doom-module::completion][:completion]] (5) :unfold: ** [[doom-module::completion][:completion]] (5) :unfold:
@ -119,7 +119,7 @@ completion.
: The ultimate code completion backend : The ultimate code completion backend
This module provides code completion, powered by [[https://github.com/company-mode/company-mode][company-mode]]. Many of Doom's This module provides code completion, powered by [[https://github.com/company-mode/company-mode][company-mode]]. Many of Doom's
[[doom-module:][:lang]] modules require it for "intellisense" functionality. [[doom-module::lang]] modules require it for "intellisense" functionality.
https://assets.doomemacs.org/completion/company/overlay.png https://assets.doomemacs.org/completion/company/overlay.png
@ -153,7 +153,7 @@ provides a united interface for project search and replace, powered by [[https:/
It does this with several modular packages focused on enhancing the built-in It does this with several modular packages focused on enhancing the built-in
~completing-read~ interface, rather than replacing it with a parallel ecosystem ~completing-read~ interface, rather than replacing it with a parallel ecosystem
like [[doom-package:][ivy]] and [[doom-package:][helm]] do. The primary packages are: like [[doom-package:ivy]] and [[doom-package:helm]] do. The primary packages are:
- Vertico, which provides the vertical completion user interface - Vertico, which provides the vertical completion user interface
- Consult, which provides a suite of useful commands using ~completing-read~ - Consult, which provides a suite of useful commands using ~completing-read~
@ -173,7 +173,7 @@ This module provides a set of reasonable defaults, including:
- A Spacemacs-inspired keybinding scheme - A Spacemacs-inspired keybinding scheme
- A configuration for (almost) universally repeating searches with [[kbd:][;]] and [[kbd:][,]] - A configuration for (almost) universally repeating searches with [[kbd:][;]] and [[kbd:][,]]
- A [[doom-package:][smartparens]] configuration for smart completion of certain delimiters, like - A [[doom-package:smartparens]] configuration for smart completion of certain delimiters, like
~/* */~ command blocks in C-languages, ~<?php ?>~ tags in PHP, or ~def end~ in ~/* */~ command blocks in C-languages, ~<?php ?>~ tags in PHP, or ~def end~ in
Ruby/Crystal/etc. Ruby/Crystal/etc.
@ -197,12 +197,12 @@ This holy module brings the Vim editing model to Emacs.
*** [[doom-module::editor file-templates][file-templates]]: - *** [[doom-module::editor file-templates][file-templates]]: -
: Fill the void in your empty files : Fill the void in your empty files
This module adds file templates for blank files, powered by [[doom-package:][yasnippet]]. This module adds file templates for blank files, powered by [[doom-package:yasnippet]].
*** [[doom-module::editor fold][fold]]: - *** [[doom-module::editor fold][fold]]: -
: What you can't see won't hurt you : What you can't see won't hurt you
This module marries [[doom-package:][hideshow]], [[doom-package:][vimish-fold]], and ~outline-minor-mode~ to bring you This module marries [[doom-package:hideshow]], [[doom-package:vimish-fold]], and ~outline-minor-mode~ to bring you
marker, indent and syntax-based code folding for as many languages as possible. marker, indent and syntax-based code folding for as many languages as possible.
*** [[doom-module::editor format][format]]: [[doom-module::editor format +onsave][+onsave]] *** [[doom-module::editor format][format]]: [[doom-module::editor format +onsave][+onsave]]
@ -222,7 +222,7 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
*** [[doom-module::editor god][god]]: - *** [[doom-module::editor god][god]]: -
: IDDQD : IDDQD
Adds [[doom-package:][god-mode]] support to Doom Emacs, allowing for entering commands without Adds [[doom-package:god-mode]] support to Doom Emacs, allowing for entering commands without
modifier keys, similar to Vim's modality, separating command mode and insert modifier keys, similar to Vim's modality, separating command mode and insert
mode. mode.
@ -251,7 +251,7 @@ evil) that loosely take after multi-cursors in Atom or Sublime Text.
*** [[doom-module::editor objed][objed]]: [[doom-module::editor objed +manual][+manual]] *** [[doom-module::editor objed][objed]]: [[doom-module::editor objed +manual][+manual]]
: Text object editing for the innocent : Text object editing for the innocent
This modules adds [[doom-package:][objed]], a global minor-mode for navigating and manipulating This modules adds [[doom-package:objed]], a global minor-mode for navigating and manipulating
text objects. It combines the ideas of ~versor-mode~ and other editors like Vim text objects. It combines the ideas of ~versor-mode~ and other editors like Vim
or Kakoune and tries to align them with regular Emacs conventions. or Kakoune and tries to align them with regular Emacs conventions.
@ -274,12 +274,12 @@ keywords or text patterns at point, like ~true~ and ~false~, or ~public~,
*** [[doom-module::editor snippets][snippets]]: - *** [[doom-module::editor snippets][snippets]]: -
: My elves type so I don't have to : My elves type so I don't have to
This module adds snippet expansions to Emacs, powered by [[doom-package:][yasnippet]]. This module adds snippet expansions to Emacs, powered by [[doom-package:yasnippet]].
*** [[doom-module::editor word-wrap][word-wrap]]: - *** [[doom-module::editor word-wrap][word-wrap]]: -
: Soft-wrapping with language-aware indent : Soft-wrapping with language-aware indent
This module adds a minor-mode [[fn:][+word-wrap-mode]], which intelligently wraps long This module adds a minor-mode [[fn:+word-wrap-mode]], which intelligently wraps long
lines in the buffer without modifying the buffer content. lines in the buffer without modifying the buffer content.
@ -294,13 +294,13 @@ This module provides reasonable defaults and augmentations for dired.
*** [[doom-module::emacs electric][electric]]: - *** [[doom-module::emacs electric][electric]]: -
: Shocking keyword-based electric-indent : Shocking keyword-based electric-indent
This module augments the built-in [[doom-package:][electric]] package with keyword-based This module augments the built-in [[doom-package:electric]] package with keyword-based
indentation (as opposed to character-based). indentation (as opposed to character-based).
*** [[doom-module::emacs ibuffer][ibuffer]]: [[doom-module::emacs ibuffer +icons][+icons]] *** [[doom-module::emacs ibuffer][ibuffer]]: [[doom-module::emacs ibuffer +icons][+icons]]
: Edit me like one of your French buffers : Edit me like one of your French buffers
This module augments the built-in [[doom-package:][ibuffer]] package. This module augments the built-in [[doom-package:ibuffer]] package.
- Adds project-based grouping of buffers - Adds project-based grouping of buffers
- Support for file-type icons - Support for file-type icons
@ -330,15 +330,15 @@ Modules that turn Emacs in an email client.
This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/code/mu/mu4e.html][mu4e]]. This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/code/mu/mu4e.html][mu4e]].
- Tidied mu4e headers view, with flags from [[doom-package:][all-the-icons]]. - Tidied mu4e headers view, with flags from [[doom-package:all-the-icons]].
- Consistent coloring of reply depths (across compose and gnus modes). - Consistent coloring of reply depths (across compose and gnus modes).
- Prettified =mu4e:main= view. - Prettified =mu4e:main= view.
- Cooperative locking of the =mu= process. Another Emacs instance may request - Cooperative locking of the =mu= process. Another Emacs instance may request
access, or grab the lock when it's available. access, or grab the lock when it's available.
- [[doom-package:][org-msg]] integration with [[doom-module:][+org]], which can be toggled per-message, with revamped - [[doom-package:org-msg]] integration with [[doom-module:+org]], which can be toggled per-message, with revamped
style and an accent color. style and an accent color.
- Gmail integrations with the [[doom-module:][+gmail]] flag. - Gmail integrations with the [[doom-module:+gmail]] flag.
- Email notifications with [[doom-package:][mu4e-alert]], and (on Linux) a customised notification - Email notifications with [[doom-package:mu4e-alert]], and (on Linux) a customised notification
style. style.
#+begin_quote #+begin_quote
@ -355,7 +355,7 @@ This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/cod
*** [[doom-module::email notmuch][notmuch]]: [[doom-module::email notmuch +afew][+afew]] [[doom-module::email notmuch +org][+org]] *** [[doom-module::email notmuch][notmuch]]: [[doom-module::email notmuch +afew][+afew]] [[doom-module::email notmuch +org][+org]]
: Closest Emacs will ever be to multi-threaded : Closest Emacs will ever be to multi-threaded
This module turns Emacs into an email client using [[doom-package:][notmuch]]. This module turns Emacs into an email client using [[doom-package:notmuch]].
*** [[doom-module::email wanderlust][wanderlust]]: [[doom-module::email wanderlust +gmail][+gmail]] *** [[doom-module::email wanderlust][wanderlust]]: [[doom-module::email wanderlust +gmail][+gmail]]
: To boldly go where no mail has gone before : To boldly go where no mail has gone before
@ -431,7 +431,7 @@ This module adds support for the Clojure(Script) language.
*** [[doom-module::lang common-lisp][common-lisp]]: - *** [[doom-module::lang common-lisp][common-lisp]]: -
: If you've seen one lisp, you've seen them all : If you've seen one lisp, you've seen them all
This module provides support for [[https://lisp-lang.org/][Common Lisp]] and the [[doom-package:][Sly]] development This module provides support for [[https://lisp-lang.org/][Common Lisp]] and the [[doom-package:Sly]] development
environment. Common Lisp is not a single language but a specification, with many environment. Common Lisp is not a single language but a specification, with many
competing compiler implementations. By default, [[http://www.sbcl.org/][Steel Bank Common Lisp]] (SBCL) is competing compiler implementations. By default, [[http://www.sbcl.org/][Steel Bank Common Lisp]] (SBCL) is
assumed to be installed, but this can be configured. assumed to be installed, but this can be configured.
@ -489,7 +489,7 @@ functions + types + imports.
*** [[doom-module::lang elixir][elixir]]: [[doom-module::lang elixir +lsp][+lsp]] *** [[doom-module::lang elixir][elixir]]: [[doom-module::lang elixir +lsp][+lsp]]
: Erlang done right : Erlang done right
This module provides support for [[https://elixir-lang.org/][Elixir programming language]] via [[doom-package:][alchemist]] or This module provides support for [[https://elixir-lang.org/][Elixir programming language]] via [[doom-package:alchemist]] or
[[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]]. [[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]].
*** [[doom-module::lang elm][elm]]: [[doom-module::lang elm +lsp][+lsp]] *** [[doom-module::lang elm][elm]]: [[doom-module::lang elm +lsp][+lsp]]
@ -505,7 +505,7 @@ This module extends support for Emacs Lisp in Doom Emacs.
- Macro expansion - Macro expansion
- Go-to-definitions or references functionality - Go-to-definitions or references functionality
- Syntax highlighting for defined and quoted symbols - Syntax highlighting for defined and quoted symbols
- Replaces the built-in help with the more powerful [[doom-package:][helpful]] - Replaces the built-in help with the more powerful [[doom-package:helpful]]
- Adds function example uses to documentation - Adds function example uses to documentation
*** [[doom-module::lang erlang][erlang]]: [[doom-module::lang erlang +lsp][+lsp]] *** [[doom-module::lang erlang][erlang]]: [[doom-module::lang erlang +lsp][+lsp]]
@ -515,8 +515,8 @@ This module provides support [[https://www.erlang.org/][Erlang programming langu
[[https://github.com/erlang/sourcer][sourcer]] language server is optional. [[https://github.com/erlang/sourcer][sourcer]] language server is optional.
Includes: Includes:
- Code completion ([[doom-module:][+lsp]], [[doom-module:][:completion company]], & [[doom-module:][:completion ivy]]) - Code completion ([[doom-module:+lsp]], [[doom-module::completion company]], & [[doom-module::completion ivy]])
- Syntax checking ([[doom-module:][:checkers syntax]]) - Syntax checking ([[doom-module::checkers syntax]])
*** [[doom-module::lang ess][ess]]: [[doom-module::lang ess +stan][+stan]] *** [[doom-module::lang ess][ess]]: [[doom-module::lang ess +stan][+stan]]
: 73.6% of all statistics are made up : 73.6% of all statistics are made up
@ -528,7 +528,7 @@ SAS, Julia and Stata.
: ... : ...
This module adds support to the [[https://github.com/factor/factor][factor]] programming language and its associated This module adds support to the [[https://github.com/factor/factor][factor]] programming language and its associated
[[doom-package:][fuel]] emacs plugin. [[doom-package:fuel]] emacs plugin.
*** [[doom-module::lang faust][faust]]: - *** [[doom-module::lang faust][faust]]: -
: DSP, but you can keep your soul : DSP, but you can keep your soul
@ -549,7 +549,7 @@ Add support to [[https://faust.grame.fr/][Faust language]] inside emacs.
shortcuts, etc.) shortcuts, etc.)
- Automatic keyword completion (if Auto-Complete is installed) - Automatic keyword completion (if Auto-Complete is installed)
- Automatic objets (functions, operators, etc.) template insertion with default - Automatic objets (functions, operators, etc.) template insertion with default
sensible values (if [[doom-module:][:editor snippets]] is enabled) sensible values (if [[doom-module::editor snippets]] is enabled)
- Modeline indicator of the state of the code - Modeline indicator of the state of the code
*** [[doom-module::lang fsharp][fsharp]]: [[doom-module::lang fsharp +lsp][+lsp]] *** [[doom-module::lang fsharp][fsharp]]: [[doom-module::lang fsharp +lsp][+lsp]]
@ -584,7 +584,7 @@ This module adds [[https://golang.org][Go]] support, with optional (but recommen
- Eldoc support (~go-eldoc~) - Eldoc support (~go-eldoc~)
- REPL (~gore~) - REPL (~gore~)
- Syntax-checking (~flycheck~) - Syntax-checking (~flycheck~)
- Auto-formatting on save (~gofmt~) (requires [[doom-module:][:editor format +onsave]]) - Auto-formatting on save (~gofmt~) (requires [[doom-module::editor format +onsave]])
- Code navigation & refactoring (~go-guru~) - Code navigation & refactoring (~go-guru~)
- [[../../editor/file-templates/templates/go-mode][File templates]] - [[../../editor/file-templates/templates/go-mode][File templates]]
- [[https://github.com/hlissner/doom-snippets/tree/master/go-mode][Snippets]] - [[https://github.com/hlissner/doom-snippets/tree/master/go-mode][Snippets]]
@ -617,13 +617,13 @@ This module adds [[https://www.java.com][Java]] support to Doom Emacs, including
This module adds [[https://www.javascript.com/][JavaScript]] and [[https://www.typescriptlang.org/][TypeScript]] support to Doom Emacs. This module adds [[https://www.javascript.com/][JavaScript]] and [[https://www.typescriptlang.org/][TypeScript]] support to Doom Emacs.
- Code completion ([[doom-package:][tide]]) - Code completion ([[doom-package:tide]])
- REPL support ([[doom-package:][nodejs-repl]]) - REPL support ([[doom-package:nodejs-repl]])
- Refactoring commands ([[doom-package:][js2-refactor]]) - Refactoring commands ([[doom-package:js2-refactor]])
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Browser code injection with [[doom-package:][skewer-mode]] - Browser code injection with [[doom-package:skewer-mode]]
- Coffeescript & JSX support - Coffeescript & JSX support
- Jump-to-definitions and references support ([[doom-package:][xref]]) - Jump-to-definitions and references support ([[doom-package:xref]])
*** [[doom-module::lang json][json]]: [[doom-module::lang json +lsp][+lsp]] *** [[doom-module::lang json][json]]: [[doom-module::lang json +lsp][+lsp]]
: At least it ain't XML : At least it ain't XML
@ -635,9 +635,9 @@ This module adds [[https://www.json.org/json-en.html][JSON]] support to Doom Ema
This module adds support for [[https://julialang.org/][the Julia language]] to Doom Emacs. This module adds support for [[https://julialang.org/][the Julia language]] to Doom Emacs.
- Syntax highlighting and latex symbols from [[doom-package:][julia-mode]] - Syntax highlighting and latex symbols from [[doom-package:julia-mode]]
- REPL integration from [[doom-package:][julia-repl]] - REPL integration from [[doom-package:julia-repl]]
- Code completion and syntax checking, requires [[doom-module:][:tools lsp]] and [[doom-module:][+lsp]] - Code completion and syntax checking, requires [[doom-module::tools lsp]] and [[doom-module:+lsp]]
*** [[doom-module::lang kotlin][kotlin]]: [[doom-module::lang kotlin +lsp][+lsp]] *** [[doom-module::lang kotlin][kotlin]]: [[doom-module::lang kotlin +lsp][+lsp]]
: A Java(Script) that won't depress you : A Java(Script) that won't depress you
@ -651,11 +651,11 @@ Provide a helping hand when working with LaTeX documents.
- Sane defaults - Sane defaults
- Fontification of many popular commands - Fontification of many popular commands
- Pretty indentation of wrapped lines using the [[doom-package:][adaptive-wrap]] package - Pretty indentation of wrapped lines using the [[doom-package:adaptive-wrap]] package
- Spell checking with [[doom-package:][flycheck]] - Spell checking with [[doom-package:flycheck]]
- Change PDF viewer to Okular or [[doom-package:][latex-preview-pane]] - Change PDF viewer to Okular or [[doom-package:latex-preview-pane]]
- Bibtex editor - Bibtex editor
- Autocompletion using [[doom-package:][company-mode]] - Autocompletion using [[doom-package:company-mode]]
- Compile your =.tex= code only once using LatexMk - Compile your =.tex= code only once using LatexMk
*** [[doom-module::lang lean][lean]]: - *** [[doom-module::lang lean][lean]]: -
@ -722,9 +722,9 @@ for Markdown's syntax is the format of plain text email. -- John Gruber
This module adds [[https://nim-lang.org][Nim]] support to Doom Emacs. This module adds [[https://nim-lang.org][Nim]] support to Doom Emacs.
- Code completion ([[doom-package:][nimsuggest]] + [[doom-package:][company]]) - Code completion ([[doom-package:nimsuggest]] + [[doom-package:company]])
- Syntax checking ([[doom-package:][nimsuggest]] + [[doom-package:][flycheck]]) - Syntax checking ([[doom-package:nimsuggest]] + [[doom-package:flycheck]])
- Org babel support ([[doom-package:][ob-nim]]) - Org babel support ([[doom-package:ob-nim]])
*** [[doom-module::lang nix][nix]]: - *** [[doom-module::lang nix][nix]]: -
: I hereby declare "nix geht mehr!" : I hereby declare "nix geht mehr!"
@ -734,23 +734,23 @@ for managing [[https://nixos.org/][Nix(OS)]].
Includes: Includes:
- Syntax highlighting - Syntax highlighting
- Completion through [[doom-package:][company]] and/or [[doom-package:][helm]] - Completion through [[doom-package:company]] and/or [[doom-package:helm]]
- Nix option lookup - Nix option lookup
- Formatting (~nixfmt~) - Formatting (~nixfmt~)
*** [[doom-module::lang ocaml][ocaml]]: [[doom-module::lang ocaml +lsp][+lsp]] *** [[doom-module::lang ocaml][ocaml]]: [[doom-module::lang ocaml +lsp][+lsp]]
: An objective camel : An objective camel
This module adds [[https://ocaml.org/][OCaml]] support to Doom Emacs, powered by [[doom-package:][tuareg-mode]]. This module adds [[https://ocaml.org/][OCaml]] support to Doom Emacs, powered by [[doom-package:tuareg-mode]].
- Code completion, documentation look-up, code navigation and refactoring - Code completion, documentation look-up, code navigation and refactoring
([[doom-package:][merlin]]) ([[doom-package:merlin]])
- Type, documentation and function argument display on idle ([[doom-package:][merlin-eldoc]]) - Type, documentation and function argument display on idle ([[doom-package:merlin-eldoc]])
- REPL ([[doom-package:][utop]]) - REPL ([[doom-package:utop]])
- Syntax-checking ([[doom-package:][merlin]] with [[doom-package:][flycheck-ocaml]]) - Syntax-checking ([[doom-package:merlin]] with [[doom-package:flycheck-ocaml]])
- Auto-indentation ([[doom-package:][ocp-indent]]) - Auto-indentation ([[doom-package:ocp-indent]])
- Code formatting ([[doom-package:][ocamlformat]]) - Code formatting ([[doom-package:ocamlformat]])
- Dune file format ([[doom-package:][dune]]) - Dune file format ([[doom-package:dune]])
*** [[doom-module::lang org][org]]: [[doom-module::lang org +brain][+brain]] [[doom-module::lang org +dragndrop][+dragndrop]] [[doom-module::lang org +gnuplot][+gnuplot]] [[doom-module::lang org +hugo][+hugo]] [[doom-module::lang org +ipython][+ipython]] [[doom-module::lang org +journal][+journal]] [[doom-module::lang org +jupyter][+jupyter]] [[doom-module::lang org +noter][+noter]] [[doom-module::lang org +pandoc][+pandoc]] [[doom-module::lang org +pomodoro][+pomodoro]] [[doom-module::lang org +present][+present]] [[doom-module::lang org +pretty][+pretty]] [[doom-module::lang org +roam][+roam]] [[doom-module::lang org +roam2][+roam2]] *** [[doom-module::lang org][org]]: [[doom-module::lang org +brain][+brain]] [[doom-module::lang org +dragndrop][+dragndrop]] [[doom-module::lang org +gnuplot][+gnuplot]] [[doom-module::lang org +hugo][+hugo]] [[doom-module::lang org +ipython][+ipython]] [[doom-module::lang org +journal][+journal]] [[doom-module::lang org +jupyter][+jupyter]] [[doom-module::lang org +noter][+noter]] [[doom-module::lang org +pandoc][+pandoc]] [[doom-module::lang org +pomodoro][+pomodoro]] [[doom-module::lang org +present][+present]] [[doom-module::lang org +pretty][+pretty]] [[doom-module::lang org +roam][+roam]] [[doom-module::lang org +roam2][+roam2]]
: Organize your plain life in plain text : Organize your plain life in plain text
@ -769,7 +769,7 @@ intuitive out of the box:
- A configuration for using org-mode for slide-show presentations or exporting - A configuration for using org-mode for slide-show presentations or exporting
org files to reveal.js slideshows. org files to reveal.js slideshows.
- Drag-and-drop support for images (with inline preview) and media files (drops - Drag-and-drop support for images (with inline preview) and media files (drops
a file icon and a short link) (requires [[doom-module:][+dragndrop]] flag). a file icon and a short link) (requires [[doom-module:+dragndrop]] flag).
- Integration with pandoc, ipython, jupyter, reveal.js, beamer, and others - Integration with pandoc, ipython, jupyter, reveal.js, beamer, and others
(requires flags). (requires flags).
- Export-to-clipboard functionality, for copying text into formatted html, - Export-to-clipboard functionality, for copying text into formatted html,
@ -826,10 +826,10 @@ This module adds [[https://www.purescript.org/][Purescript]] support to Doom Ema
This module adds [[https://www.python.org/][Python]] support to Doom Emacs. This module adds [[https://www.python.org/][Python]] support to Doom Emacs.
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Snippets - Snippets
- Run tests ([[doom-package:][nose]], [[doom-package:][pytest]]) - Run tests ([[doom-package:nose]], [[doom-package:pytest]])
- Auto-format (with ~black~, requires [[doom-module:][:editor format]]) - Auto-format (with ~black~, requires [[doom-module::editor format]])
- LSP integration (=mspyls=, =pyls=, or =pyright=) - LSP integration (=mspyls=, =pyls=, or =pyright=)
*** [[doom-module::lang qt][qt]]: - *** [[doom-module::lang qt][qt]]: -
@ -877,11 +877,11 @@ This module adds [[https://docutils.sourceforge.io/rst.html][ReStructured Text]]
This module add Ruby and optional Ruby on Rails support to Emacs. This module add Ruby and optional Ruby on Rails support to Emacs.
- Code completion ([[doom-package:][robe]]) - Code completion ([[doom-package:robe]])
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Jump-to-definitions ([[doom-package:][robe]]) - Jump-to-definitions ([[doom-package:robe]])
- Bundler - Bundler
- Rubocop integration ([[doom-package:][flycheck]]) - Rubocop integration ([[doom-package:flycheck]])
*** [[doom-module::lang rust][rust]]: [[doom-module::lang rust +lsp][+lsp]] *** [[doom-module::lang rust][rust]]: [[doom-module::lang rust +lsp][+lsp]]
: Fe2O3.unwrap().unwrap().unwrap().unwrap() : Fe2O3.unwrap().unwrap().unwrap().unwrap()
@ -889,9 +889,9 @@ This module add Ruby and optional Ruby on Rails support to Emacs.
This module adds support for the Rust language and integration for its tools, This module adds support for the Rust language and integration for its tools,
e.g. ~cargo~. e.g. ~cargo~.
- Code completion ([[doom-package:][racer]] or an LSP server) - Code completion ([[doom-package:racer]] or an LSP server)
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- LSP support (for rust-analyzer and rls) ([[doom-package:][rustic]]) - LSP support (for rust-analyzer and rls) ([[doom-package:rustic]])
- Snippets - Snippets
*** [[doom-module::lang scala][scala]]: [[doom-module::lang scala +lsp][+lsp]] *** [[doom-module::lang scala][scala]]: [[doom-module::lang scala +lsp][+lsp]]
@ -926,8 +926,8 @@ This module provides support for the Scheme family of Lisp languages, powered by
This module adds support for shell scripting languages (including Powershell and This module adds support for shell scripting languages (including Powershell and
Fish script) to Doom Emacs. Fish script) to Doom Emacs.
- Code completion ([[doom-package:][company-shell]]) - Code completion ([[doom-package:company-shell]])
- Syntax Checking ([[doom-package:][flycheck]]) - Syntax Checking ([[doom-package:flycheck]])
*** [[doom-module::lang sml][sml]]: - *** [[doom-module::lang sml][sml]]: -
: ... : ...
@ -939,8 +939,8 @@ THis module adds [[https://smlfamily.github.io/][SML (Standard ML) programming l
This module adds [[https://github.com/ethereum/solidity][Solidity]] support to Doom Emacs. This module adds [[https://github.com/ethereum/solidity][Solidity]] support to Doom Emacs.
- Syntax-checking ([[doom-package:][flycheck]]) - Syntax-checking ([[doom-package:flycheck]])
- Code completion ([[doom-package:][company-solidity]]) - Code completion ([[doom-package:company-solidity]])
- Gas estimation (~C-c C-g~) - Gas estimation (~C-c C-g~)
*** [[doom-module::lang swift][swift]]: [[doom-module::lang swift +lsp][+lsp]] *** [[doom-module::lang swift][swift]]: [[doom-module::lang swift +lsp][+lsp]]
@ -972,7 +972,7 @@ This module adds [[https://ziglang.org/][Zig]] support, with optional (but recom
[[https://github.com/zigtools/zls][zls]]. [[https://github.com/zigtools/zls][zls]].
- Syntax highlighting - Syntax highlighting
- Syntax-checking ([[doom-package:][flycheck]]) - Syntax-checking ([[doom-package:flycheck]])
- Code completion and LSP integration (~zls~) - Code completion and LSP integration (~zls~)
@ -1001,9 +1001,9 @@ This module configures Emacs for use in the terminal, by providing:
What's an operating system without a terminal? The modules in this category What's an operating system without a terminal? The modules in this category
bring varying degrees of terminal emulation into Emacs. bring varying degrees of terminal emulation into Emacs.
If you can't decide which to choose, I recommend [[doom-package:][vterm]] or [[doom-package:][eshell]]. [[doom-module:][:term vterm]] If you can't decide which to choose, I recommend [[doom-package:vterm]] or [[doom-package:eshell]]. [[doom-module::term vterm]]
offers that best terminal emulation available but requires a few extra steps to offers that best terminal emulation available but requires a few extra steps to
get going. [[doom-module:][:term eshell]] works everywhere that Emacs runs, even Windows, and get going. [[doom-module::term eshell]] works everywhere that Emacs runs, even Windows, and
provides a shell entirely implemented in Emacs Lisp. provides a shell entirely implemented in Emacs Lisp.
*** [[doom-module::term eshell][eshell]]: - *** [[doom-module::term eshell][eshell]]: -
@ -1011,7 +1011,7 @@ provides a shell entirely implemented in Emacs Lisp.
This module provides additional features for the built-in [[https://www.gnu.org/software/emacs/manual/html_mono/eshell.html][Emacs Shell]] This module provides additional features for the built-in [[https://www.gnu.org/software/emacs/manual/html_mono/eshell.html][Emacs Shell]]
The Emacs Shell or [[doom-package:][eshell]] is a shell-like command interpreter implemented in The Emacs Shell or [[doom-package:eshell]] is a shell-like command interpreter implemented in
Emacs Lisp. It is an alternative to traditional shells such as =bash=, =zsh=, Emacs Lisp. It is an alternative to traditional shells such as =bash=, =zsh=,
=fish=, etc. that is built into Emacs and entirely cross-platform. =fish=, etc. that is built into Emacs and entirely cross-platform.
@ -1022,8 +1022,8 @@ Provides a REPL for your shell.
#+begin_quote #+begin_quote
💡 =shell= is more REPL than terminal emulator. You can edit your command line 💡 =shell= is more REPL than terminal emulator. You can edit your command line
like you would any ordinary text in Emacs -- something you can't do in [[doom-package:][term]] like you would any ordinary text in Emacs -- something you can't do in [[doom-package:term]]
(without ~term-line-mode~, which can be unstable) or [[doom-package:][vterm]]. (without ~term-line-mode~, which can be unstable) or [[doom-package:vterm]].
Due to =shell='s simplicity, you're less likely to encounter edge cases Due to =shell='s simplicity, you're less likely to encounter edge cases
(e.g. against your shell config), but it's also the least capable. TUI (e.g. against your shell config), but it's also the least capable. TUI
@ -1043,7 +1043,7 @@ This module provides a terminal emulator powered by libvterm. It is still in
alpha and requires a component be compiled (=vterm-module.so=). alpha and requires a component be compiled (=vterm-module.so=).
#+begin_quote #+begin_quote
💡 [[doom-package:][vterm]] is as good as terminal emulation gets in Emacs (at the time of 💡 [[doom-package:vterm]] is as good as terminal emulation gets in Emacs (at the time of
writing) and the most performant, as it is implemented in C. However, it writing) and the most performant, as it is implemented in C. However, it
requires extra steps to set up: requires extra steps to set up:
@ -1051,9 +1051,9 @@ alpha and requires a component be compiled (=vterm-module.so=).
- and =vterm-module.so= must be compiled, which depends on =libvterm=, - and =vterm-module.so= must be compiled, which depends on =libvterm=,
=cmake=, and =libtool-bin=. =cmake=, and =libtool-bin=.
[[doom-package:][vterm]] will try to automatically build =vterm-module.so= when you first open [[doom-package:vterm]] will try to automatically build =vterm-module.so= when you first open
it, but this will fail on Windows, NixOS and Guix out of the box. Install it, but this will fail on Windows, NixOS and Guix out of the box. Install
instructions for nix/guix can be found in the [[doom-module:][:term vterm]] module's instructions for nix/guix can be found in the [[doom-module::term vterm]] module's
documentation. There is no way to install vterm on Windows that I'm aware of documentation. There is no way to install vterm on Windows that I'm aware of
(but perhaps with WSL?). (but perhaps with WSL?).
#+end_quote #+end_quote
@ -1073,9 +1073,9 @@ Modules that integrate external tools into Emacs.
*** [[doom-module::tools debugger][debugger]]: [[doom-module::tools debugger +lsp][+lsp]] *** [[doom-module::tools debugger][debugger]]: [[doom-module::tools debugger +lsp][+lsp]]
: Step through code to help you add bugs : Step through code to help you add bugs
Introduces a code debugger to Emacs, powered by [[doom-package:][realgud]] or [[doom-package:][dap-mode]] (LSP). Introduces a code debugger to Emacs, powered by [[doom-package:realgud]] or [[doom-package:dap-mode]] (LSP).
This document will help you to configure [[doom-package:][dap-mode]] [[https://emacs-lsp.github.io/dap-mode/page/configuration/#native-debug-gdblldb][Native Debug(GDB/LLDB)]] as This document will help you to configure [[doom-package:dap-mode]] [[https://emacs-lsp.github.io/dap-mode/page/configuration/#native-debug-gdblldb][Native Debug(GDB/LLDB)]] as
there is still not *enough* documentation for it. there is still not *enough* documentation for it.
*** [[doom-module::tools direnv][direnv]]: - *** [[doom-module::tools direnv][direnv]]: -
@ -1104,7 +1104,7 @@ Emacs.
Provides a major ~dockerfile-mode~ to edit =Dockerfiles=. Additional convenience Provides a major ~dockerfile-mode~ to edit =Dockerfiles=. Additional convenience
functions allow images to be built easily. functions allow images to be built easily.
[[doom-package:][docker-tramp]] offers [[https://www.gnu.org/software/tramp/][TRAMP]] support for Docker containers. [[doom-package:docker-tramp]] offers [[https://www.gnu.org/software/tramp/][TRAMP]] support for Docker containers.
*** [[doom-module::tools editorconfig][editorconfig]]: - *** [[doom-module::tools editorconfig][editorconfig]]: -
: Let someone else argue tabs and spaces : Let someone else argue tabs and spaces
@ -1148,33 +1148,33 @@ or synonyms.
This module integrates [[https://langserver.org/][language servers]] into Doom Emacs. They provide features This module integrates [[https://langserver.org/][language servers]] into Doom Emacs. They provide features
you'd expect from IDEs, like code completion, realtime linting, language-aware you'd expect from IDEs, like code completion, realtime linting, language-aware
[[doom-package:][imenu]]/[[doom-package:][xref]] integration, jump-to-definition/references support, and more. [[doom-package:imenu]]/[[doom-package:xref]] integration, jump-to-definition/references support, and more.
As of this writing, this is the state of LSP support in Doom Emacs: As of this writing, this is the state of LSP support in Doom Emacs:
| Module | Major modes | Default language server | | Module | Major modes | Default language server |
|------------------+---------------------------------------------------------+---------------------------------------------------------------| |------------------+---------------------------------------------------------+---------------------------------------------------------------|
| [[doom-module:][:lang cc]] | c-mode, c++-mode, objc-mode | ccls, clangd | | [[doom-module::lang cc]] | c-mode, c++-mode, objc-mode | ccls, clangd |
| [[doom-module:][:lang clojure]] | clojure-mode | clojure-lsp | | [[doom-module::lang clojure]] | clojure-mode | clojure-lsp |
| [[doom-module:][:lang csharp]] | csharp-mode | omnisharp | | [[doom-module::lang csharp]] | csharp-mode | omnisharp |
| [[doom-module:][:lang elixir]] | elixir-mode | elixir-ls | | [[doom-module::lang elixir]] | elixir-mode | elixir-ls |
| [[doom-module:][:lang fsharp]] | fsharp-mode | Mono, .NET core | | [[doom-module::lang fsharp]] | fsharp-mode | Mono, .NET core |
| [[doom-module:][:lang go]] | go-mode | go-langserver | | [[doom-module::lang go]] | go-mode | go-langserver |
| [[doom-module:][:lang haskell]] | haskell-mode | haskell-language-server | | [[doom-module::lang haskell]] | haskell-mode | haskell-language-server |
| [[doom-module:][:lang java]] | java-mode | lsp-java | | [[doom-module::lang java]] | java-mode | lsp-java |
| [[doom-module:][:lang javascript]] | js2-mode, rjsx-mode, typescript-mode | ts-ls, deno-ls | | [[doom-module::lang javascript]] | js2-mode, rjsx-mode, typescript-mode | ts-ls, deno-ls |
| [[doom-module:][:lang julia]] | julia-mode | LanguageServer.jl | | [[doom-module::lang julia]] | julia-mode | LanguageServer.jl |
| [[doom-module:][:lang ocaml]] | tuareg-mode | ocaml-language-server | | [[doom-module::lang ocaml]] | tuareg-mode | ocaml-language-server |
| [[doom-module:][:lang php]] | php-mode | php-language-server | | [[doom-module::lang php]] | php-mode | php-language-server |
| [[doom-module:][:lang purescript]] | purescript-mode | purescript-language-server | | [[doom-module::lang purescript]] | purescript-mode | purescript-language-server |
| [[doom-module:][:lang python]] | python-mode | lsp-python-ms | | [[doom-module::lang python]] | python-mode | lsp-python-ms |
| [[doom-module:][:lang ruby]] | ruby-mode | solargraph | | [[doom-module::lang ruby]] | ruby-mode | solargraph |
| [[doom-module:][:lang rust]] | rust-mode | rls | | [[doom-module::lang rust]] | rust-mode | rls |
| [[doom-module:][:lang scala]] | scala-mode | metals | | [[doom-module::lang scala]] | scala-mode | metals |
| [[doom-module:][:lang sh]] | sh-mode | bash-language-server | | [[doom-module::lang sh]] | sh-mode | bash-language-server |
| [[doom-module:][:lang swift]] | swift-mode | sourcekit | | [[doom-module::lang swift]] | swift-mode | sourcekit |
| [[doom-module:][:lang web]] | web-mode, css-mode, scss-mode, sass-mode, less-css-mode | vscode-css-languageserver-bin, vscode-html-languageserver-bin | | [[doom-module::lang web]] | web-mode, css-mode, scss-mode, sass-mode, less-css-mode | vscode-css-languageserver-bin, vscode-html-languageserver-bin |
| [[doom-module:][:lang zig]] | zig-mode | zls | | [[doom-module::lang zig]] | zig-mode | zls |
*** [[doom-module::tools magit][magit]]: [[doom-module::tools magit +forge][+forge]] *** [[doom-module::tools magit][magit]]: [[doom-module::tools magit +forge][+forge]]
: Wield git like a wizard : Wield git like a wizard
@ -1197,12 +1197,12 @@ This module provides an Emacs interface to [[https://www.passwordstore.org/][Pas
This module improves support for reading and interacting with PDF files in This module improves support for reading and interacting with PDF files in
Emacs. Emacs.
It uses [[doom-package:][pdf-tools]], which is a replacement for the built-in ~doc-view-mode~ for It uses [[doom-package:pdf-tools]], which is a replacement for the built-in ~doc-view-mode~ for
PDF files. The key difference being pages are not pre-rendered, but instead PDF files. The key difference being pages are not pre-rendered, but instead
rendered on-demand and stored in memory; a much faster approach, especially for rendered on-demand and stored in memory; a much faster approach, especially for
larger PDFs. larger PDFs.
Displaying PDF files is just one function of [[doom-package:][pdf-tools]]. See [[https://github.com/politza/pdf-tools][its project website]] Displaying PDF files is just one function of [[doom-package:pdf-tools]]. See [[https://github.com/politza/pdf-tools][its project website]]
for details and videos. for details and videos.
*** [[doom-module::tools prodigy][prodigy]]: - *** [[doom-module::tools prodigy][prodigy]]: -
@ -1220,7 +1220,7 @@ to easily modify color values or formats.
*** [[doom-module::tools taskrunner][taskrunner]]: - *** [[doom-module::tools taskrunner][taskrunner]]: -
: Taskrunner for all your projects : Taskrunner for all your projects
This module integrates [[doom-package:][taskrunner]] into Doom Emacs, which scraps runnable tasks This module integrates [[doom-package:taskrunner]] into Doom Emacs, which scraps runnable tasks
from build systems like make, gradle, npm and the like. from build systems like make, gradle, npm and the like.
*** [[doom-module::tools terraform][terraform]]: - *** [[doom-module::tools terraform][terraform]]: -
@ -1263,11 +1263,11 @@ quickly jot down thoughts and easily retrieve them later.
: Make Doom fabulous again : Make Doom fabulous again
This module gives Doom its signature look: powered by the [[doom-package:doom-themes][doom-one]] theme This module gives Doom its signature look: powered by the [[doom-package:doom-themes][doom-one]] theme
(loosely inspired by [[https://github.com/atom/one-dark-syntax][Atom's One Dark theme]]) and [[doom-package:][solaire-mode]]. Includes: (loosely inspired by [[https://github.com/atom/one-dark-syntax][Atom's One Dark theme]]) and [[doom-package:solaire-mode]]. Includes:
- A custom folded-region indicator for [[doom-package:][hideshow]]. - A custom folded-region indicator for [[doom-package:hideshow]].
- "Thin bar" fringe bitmaps for [[doom-package:][git-gutter-fringe]]. - "Thin bar" fringe bitmaps for [[doom-package:git-gutter-fringe]].
- File-visiting buffers are slightly brighter (thanks to [[doom-package:][solaire-mode]]). - File-visiting buffers are slightly brighter (thanks to [[doom-package:solaire-mode]]).
*** [[doom-module::ui doom-dashboard][doom-dashboard]]: - *** [[doom-module::ui doom-dashboard][doom-dashboard]]: -
: Welcome to your doom : Welcome to your doom
@ -1341,7 +1341,7 @@ feature found in many other editors.
: Snazzy, Atom-inspired modeline, plus API : Snazzy, Atom-inspired modeline, plus API
This module provides an Atom-inspired, minimalistic modeline for Doom Emacs, This module provides an Atom-inspired, minimalistic modeline for Doom Emacs,
powered by the [[doom-package:][doom-modeline]] package (where you can find screenshots). powered by the [[doom-package:doom-modeline]] package (where you can find screenshots).
*** [[doom-module::ui nav-flash][nav-flash]]: - *** [[doom-module::ui nav-flash][nav-flash]]: -
: Blink after big motions : Blink after big motions
@ -1360,7 +1360,7 @@ This module brings a side panel for browsing project files, inspired by vim's
NERDTree. NERDTree.
#+begin_quote #+begin_quote
💡 Sure, there's [[doom-package:][dired]] and [[doom-package:][projectile]], but sometimes I'd like a bird's eye view 💡 Sure, there's [[doom-package:dired]] and [[doom-package:projectile]], but sometimes I'd like a bird's eye view
of a project. of a project.
#+end_quote #+end_quote
@ -1371,7 +1371,7 @@ This module provides op-hints (operation hinting), i.e. visual feedback for
certain operations. It highlights regions of text that the last operation (like certain operations. It highlights regions of text that the last operation (like
yank) acted on. yank) acted on.
Uses [[doom-package:][evil-goggles]] for evil users and [[doom-package:][volatile-highlights]] otherwise. Uses [[doom-package:evil-goggles]] for evil users and [[doom-package:volatile-highlights]] otherwise.
*** [[doom-module::ui popup][popup]]: [[doom-module::ui popup +all][+all]] [[doom-module::ui popup +defaults][+defaults]] *** [[doom-module::ui popup][popup]]: [[doom-module::ui popup +all][+all]] [[doom-module::ui popup +defaults][+defaults]]
: Tame sudden yet inevitable temporary windows : Tame sudden yet inevitable temporary windows
@ -1401,9 +1401,9 @@ system outlines of your projects in a simple tree layout allowing quick
navigation and exploration, while also possessing basic file management navigation and exploration, while also possessing basic file management
utilities. It includes: utilities. It includes:
- Integration with Git (if [[doom-module:][:tools magit]] is enabled) - Integration with Git (if [[doom-module::tools magit]] is enabled)
- Integration with Evil (if [[doom-module:][:editor evil +everywhere]] is enabled) - Integration with Evil (if [[doom-module::editor evil +everywhere]] is enabled)
- Workspace awareness (if [[doom-module:][:ui workspaces]] is enabled) - Workspace awareness (if [[doom-module::ui workspaces]] is enabled)
*** [[doom-module::ui unicode][unicode]]: - *** [[doom-module::ui unicode][unicode]]: -
: Extended unicode support for various languages : Extended unicode support for various languages
@ -1443,18 +1443,18 @@ Displays a tilde(~) in the left fringe to indicate an empty line, similar to Vi.
This module provides several methods for selecting windows without the use of This module provides several methods for selecting windows without the use of
the mouse or spatial navigation (e.g. [[kbd:][C-w {h,j,k,l}]]). the mouse or spatial navigation (e.g. [[kbd:][C-w {h,j,k,l}]]).
The command ~other-window~ is remapped to either [[doom-package:][switch-window]] or [[doom-package:][ace-window]], The command ~other-window~ is remapped to either [[doom-package:switch-window]] or [[doom-package:ace-window]],
depending on which backend you've enabled. It is bound to [[kbd:][C-x o]] (and [[kbd:][C-w C-w]] for depending on which backend you've enabled. It is bound to [[kbd:][C-x o]] (and [[kbd:][C-w C-w]] for
evil users). evil users).
It also provides numbered windows and selection with the [[doom-package:][winum]] package, if It also provides numbered windows and selection with the [[doom-package:winum]] package, if
desired. Evil users can jump to window N in [[kbd:][C-w <N>]] (where N is a number between desired. Evil users can jump to window N in [[kbd:][C-w <N>]] (where N is a number between
0 and 9). Non evil users have [[kbd:][C-x w <N>]] instead. 0 and 9). Non evil users have [[kbd:][C-x w <N>]] instead.
*** [[doom-module::ui workspaces][workspaces]]: - *** [[doom-module::ui workspaces][workspaces]]: -
: Tab emulation, persistence, & separate workspaces : Tab emulation, persistence, & separate workspaces
This module adds support for workspaces, powered by [[doom-package:][persp-mode]], as well as a API This module adds support for workspaces, powered by [[doom-package:persp-mode]], as well as a API
for manipulating them. for manipulating them.
#+begin_quote #+begin_quote
@ -1471,7 +1471,7 @@ for manipulating them.
This module provides two minor modes that make Emacs into a more comfortable This module provides two minor modes that make Emacs into a more comfortable
writing or coding environment. Folks familiar with "distraction-free" or "zen" writing or coding environment. Folks familiar with "distraction-free" or "zen"
modes from other editors -- or [[doom-package:][olivetti]], [[doom-package:][sublimity]], and [[doom-package:][tabula-rasa]] (Emacs modes from other editors -- or [[doom-package:olivetti]], [[doom-package:sublimity]], and [[doom-package:tabula-rasa]] (Emacs
plugins) -- will feel right at home. plugins) -- will feel right at home.
These modes are: These modes are:

2
modules/app/README.org
View file

@ -5,7 +5,7 @@
* Description * Description
Application modules are complex and opinionated modules that transform Emacs Application modules are complex and opinionated modules that transform Emacs
toward a specific purpose. They may have additional dependencies and *should be toward a specific purpose. They may have additional dependencies and *should be
loaded last* (but before [[doom-module:][:config]] modules). loaded last* (but before [[doom-module::config]] modules).
* Frequently asked questions * Frequently asked questions
/This category has no FAQs yet./ [[doom-suggest-faq:][Ask one?]] /This category has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]

8
modules/app/calendar/README.org
View file

@ -14,9 +14,9 @@ support.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][calfw]] - [[doom-package:calfw]]
- [[doom-package:][calfw-org]] - [[doom-package:calfw-org]]
- [[doom-package:][org-gcal]] - [[doom-package:org-gcal]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -30,7 +30,7 @@ support.
This module requires: This module requires:
- A Google Calendar account. - A Google Calendar account.
- [[https://github.com/kidd/org-gcal.el#installation][An OAuth client ID]], for syncing said account with [[doom-package:][org-gcal]]. - [[https://github.com/kidd/org-gcal.el#installation][An OAuth client ID]], for syncing said account with [[doom-package:org-gcal]].
* TODO Usage * TODO Usage
#+begin_quote #+begin_quote

2
modules/app/emms/README.org
View file

@ -14,7 +14,7 @@ server and [[https://musicpd.org/clients/mpc/][mpc]] to update your music databa
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][emms]] - [[doom-package:emms]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

4
modules/app/everywhere/README.org
View file

@ -15,7 +15,7 @@ This module adds system-wide popup Emacs windows for quick edits.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][emacs-everywhere]] - [[doom-package:emacs-everywhere]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -49,7 +49,7 @@ return to the original window and paste the content with [[kbd:][C-c C-c]] or [[
exit without pasting, use [[kbd:][C-c C-k]]. exit without pasting, use [[kbd:][C-c C-k]].
* Configuration * Configuration
[[doom-package:][emacs-everywhere]] likes to guess if you triggered it from an application which [[doom-package:emacs-everywhere]] likes to guess if you triggered it from an application which
supports markdown. Configure ~emacs-everywhere-markdown-windows~ and supports markdown. Configure ~emacs-everywhere-markdown-windows~ and
~emacs-everywhere-markdown-apps~ to improve how accurate this is on your system. ~emacs-everywhere-markdown-apps~ to improve how accurate this is on your system.

6
modules/app/irc/README.org
View file

@ -13,8 +13,8 @@ This module turns Emacs into an IRC client, capable of OS notifications.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][circe]] - [[doom-package:circe]]
- [[doom-package:][circe-notifications]] - [[doom-package:circe-notifications]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -96,7 +96,7 @@ here are ways to avoid that:
#+end_quote #+end_quote
[[https://www.passwordstore.org/][Pass]] is my tool of choice. I use it to manage my passwords. If you activate the [[https://www.passwordstore.org/][Pass]] is my tool of choice. I use it to manage my passwords. If you activate the
[[doom-module:][:tools pass]] module you get an elisp API through which to access your password [[doom-module::tools pass]] module you get an elisp API through which to access your password
store. store.
~set-irc-server!~ accepts a plist can use functions instead of strings. ~set-irc-server!~ accepts a plist can use functions instead of strings.

8
modules/app/rss/README.org
View file

@ -11,13 +11,13 @@ Read RSS feeds in the comfort of Emacs.
** Module flags ** Module flags
- +org :: - +org ::
Enable [[doom-package:][elfeed-org]], so you can configure your feeds with an org file Enable [[doom-package:elfeed-org]], so you can configure your feeds with an org file
(={org-directory}/elfeed.org=) rather than Elisp. (={org-directory}/elfeed.org=) rather than Elisp.
** Packages ** Packages
- [[doom-package:][elfeed]] - [[doom-package:elfeed]]
- [[doom-package:][elfeed-goodies]] - [[doom-package:elfeed-goodies]]
- [[doom-package:][elfeed-org]] if [[doom-module:][+org]] - [[doom-package:elfeed-org]] if [[doom-module:+org]]
** Hacks ** Hacks
- By default ~elfeed-search-filter~ is set to ~@2-weeks-ago~ and makes the last - By default ~elfeed-search-filter~ is set to ~@2-weeks-ago~ and makes the last

6
modules/app/twitter/README.org
View file

@ -20,8 +20,8 @@ Enjoy twitter from emacs.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][avy]] - [[doom-package:avy]]
- [[doom-package:][twittering-mode]] - [[doom-package:twittering-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -64,7 +64,7 @@ Here is a list of available commands and their default keybindings (defined in
| ~+twitter/quit~ | [[kbd:][q]] | Close current window | | ~+twitter/quit~ | [[kbd:][q]] | Close current window |
| ~+twitter/quit-all~ | [[kbd:][Q]] | Close all twitter windows and buffers, and delete workspace | | ~+twitter/quit-all~ | [[kbd:][Q]] | Close all twitter windows and buffers, and delete workspace |
And when [[doom-module:][:editor evil +everywhere]] is active: And when [[doom-module::editor evil +everywhere]] is active:
| command | key / ex command | description | | command | key / ex command | description |
|--------------------------------------------------+------------------+------------------------------------------------------------------| |--------------------------------------------------+------------------+------------------------------------------------------------------|
| ~twittering-favorite~ | [[kbd:][f]] | Favorite/Like a tweet | | ~twittering-favorite~ | [[kbd:][f]] | Favorite/Like a tweet |

6
modules/checkers/grammar/README.org
View file

@ -5,7 +5,7 @@
* Description :unfold: * Description :unfold:
This module adds grammar checking to Emacs to aid your writing by combining This module adds grammar checking to Emacs to aid your writing by combining
[[doom-package:][lang-tool]] and [[doom-package:][writegood-mode]]. [[doom-package:lang-tool]] and [[doom-package:writegood-mode]].
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
@ -14,8 +14,8 @@ This module adds grammar checking to Emacs to aid your writing by combining
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][langtool]] - [[doom-package:langtool]]
- [[doom-package:][writegood-mode]] - [[doom-package:writegood-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

36
modules/checkers/spell/README.org
View file

@ -14,7 +14,7 @@ includes ~org-mode~, ~markdown-mode~, the Git Commit buffer (from magit),
- Spell checking and correction using =aspell=, =hunspell= or =enchant=. - Spell checking and correction using =aspell=, =hunspell= or =enchant=.
- Ignores source code inside org or markdown files. - Ignores source code inside org or markdown files.
- Lazily spellchecking recent changes only when idle. - Lazily spellchecking recent changes only when idle.
- Choosing suggestions using completion interfaces ([[doom-package:][ivy]] or [[doom-package:][helm]]). - Choosing suggestions using completion interfaces ([[doom-package:ivy]] or [[doom-package:helm]]).
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
@ -27,21 +27,21 @@ includes ~org-mode~, ~markdown-mode~, the Git Commit buffer (from magit),
- +everywhere :: - +everywhere ::
Spell check in programming modes as well (in comments only). Spell check in programming modes as well (in comments only).
- +flyspell :: - +flyspell ::
Use [[doom-package:][flyspell]] instead of [[doom-package:][spell-fu]]. It's significantly slower, but supports Use [[doom-package:flyspell]] instead of [[doom-package:spell-fu]]. It's significantly slower, but supports
multiple languages and dictionaries. multiple languages and dictionaries.
- +hunspell :: - +hunspell ::
Use =hunspell= as a backend for correcting words. Use =hunspell= as a backend for correcting words.
** Packages ** Packages
- if [[doom-module:][+flyspell]] - if [[doom-module:+flyspell]]
- [[doom-package:][flyspell-correct]] - [[doom-package:flyspell-correct]]
- [[doom-package:][flyspell-correct-ivy]] if [[doom-module:][:completion ivy]] - [[doom-package:flyspell-correct-ivy]] if [[doom-module::completion ivy]]
- [[doom-package:][flyspell-correct-helm]] if [[doom-module:][:completion helm]] - [[doom-package:flyspell-correct-helm]] if [[doom-module::completion helm]]
- [[doom-package:][flyspell-correct-popup]] unless [[doom-module:][:completion ivy]], [[doom-module:][:completion helm]], or - [[doom-package:flyspell-correct-popup]] unless [[doom-module::completion ivy]], [[doom-module::completion helm]], or
[[doom-module:][:completion vertico]] [[doom-module::completion vertico]]
- [[doom-package:][flyspell-lazy]] - [[doom-package:flyspell-lazy]]
- else - else
- [[doom-package:][spell-fu]] - [[doom-package:spell-fu]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -58,9 +58,9 @@ your system and in your =$PATH=. They also need dictionaries for your
language(s). language(s).
#+begin_quote #+begin_quote
🚧 If you *are not* using [[doom-module:][+flyspell]], you will need =aspell= (and a dictionary) 🚧 If you *are not* using [[doom-module:+flyspell]], you will need =aspell= (and a dictionary)
installed whether or not you have [[doom-module:][+hunspell]] or [[doom-module:][+enchant]] enabled. This is installed whether or not you have [[doom-module:+hunspell]] or [[doom-module:+enchant]] enabled. This is
because [[doom-package:][spell-fu]] does not support generating the word list with anything because [[doom-package:spell-fu]] does not support generating the word list with anything
other than =aspell= yet. other than =aspell= yet.
#+end_quote #+end_quote
@ -111,7 +111,7 @@ language(s).
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
When using [[doom-module:][+everywhere]], spell checking is performed for as many major modes as When using [[doom-module:+everywhere]], spell checking is performed for as many major modes as
possible, and not only ~text-mode~ derivatives. e.g. in comments for programming possible, and not only ~text-mode~ derivatives. e.g. in comments for programming
major modes. major modes.
@ -133,7 +133,7 @@ recent changes:
#+end_src #+end_src
*** Flyspell users *** Flyspell users
Lazy spellcheck is provided by [[doom-package:][flyspell-lazy]] package. Lazy spellcheck is provided by [[doom-package:flyspell-lazy]] package.
~flyspell-lazy-idle-seconds~ sets how many idle seconds until spellchecking ~flyspell-lazy-idle-seconds~ sets how many idle seconds until spellchecking
recent changes (default as 1), while ~flyspell-lazy-window-idle-seconds~ sets recent changes (default as 1), while ~flyspell-lazy-window-idle-seconds~ sets
@ -193,15 +193,15 @@ Return nil if on a link url, markup, html, or references."
** Adding or removing words to your personal dictionary ** Adding or removing words to your personal dictionary
Use ~M-x +spell/add-word~ and ~M-x +spell/remove-word~ to whitelist words that Use ~M-x +spell/add-word~ and ~M-x +spell/remove-word~ to whitelist words that
you know are not misspellings. For evil users these are bound to [[kbd:][zg]] and [[kbd:][zw]], you know are not misspellings. For evil users these are bound to [[kbd:][zg]] and [[kbd:][zw]],
respectively. [[doom-module:][+flyspell]] users can also add/remove words from the respectively. [[doom-module:+flyspell]] users can also add/remove words from the
[[doom-package:][flyspell-correct]] popup interface (there will be extra options on the list of [[doom-package:flyspell-correct]] popup interface (there will be extra options on the list of
corrections for "save word to dictionary"). corrections for "save word to dictionary").
* Troubleshooting * Troubleshooting
[[doom-report:][Report an issue?]] [[doom-report:][Report an issue?]]
** spell-fu highlights every single word ** spell-fu highlights every single word
[[doom-package:][spell-fu]] caches its word list. If it was activated before your dictionaries were [[doom-package:spell-fu]] caches its word list. If it was activated before your dictionaries were
installed, it will generate an empty word list, causing it to highlight all installed, it will generate an empty word list, causing it to highlight all
words as incorrect. Delete its cache files in =$EMACSDIR/.local/etc/spell-fu/= words as incorrect. Delete its cache files in =$EMACSDIR/.local/etc/spell-fu/=
to fix this. to fix this.

8
modules/checkers/syntax/README.org
View file

@ -5,7 +5,7 @@
* Description :unfold: * Description :unfold:
This module provides syntax checking and error highlighting, powered by This module provides syntax checking and error highlighting, powered by
[[doom-package:][flycheck]]. [[doom-package:flycheck]].
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
@ -16,9 +16,9 @@ This module provides syntax checking and error highlighting, powered by
*Requires GUI Emacs.* *Requires GUI Emacs.*
** Packages ** Packages
- [[doom-package:][flycheck]] - [[doom-package:flycheck]]
- [[doom-package:][flycheck-popup-tip]] - [[doom-package:flycheck-popup-tip]]
- [[doom-package:][flycheck-posframe]] if [[doom-module:][+childframe]] - [[doom-package:flycheck-posframe]] if [[doom-module:+childframe]]
** Hacks ** Hacks
- If ~lsp-ui-mode~ is active, most of the aesthetic functionality of this module - If ~lsp-ui-mode~ is active, most of the aesthetic functionality of this module

8
modules/completion/company/README.org
View file

@ -5,7 +5,7 @@
* Description :unfold: * Description :unfold:
This module provides code completion, powered by [[https://github.com/company-mode/company-mode][company-mode]]. Many of Doom's This module provides code completion, powered by [[https://github.com/company-mode/company-mode][company-mode]]. Many of Doom's
[[doom-module:][:lang]] modules require it for "intellisense" functionality. [[doom-module::lang]] modules require it for "intellisense" functionality.
https://assets.doomemacs.org/completion/company/overlay.png https://assets.doomemacs.org/completion/company/overlay.png
@ -23,9 +23,9 @@ https://assets.doomemacs.org/completion/company/overlay.png
[[kbd:][S-TAB]] will navigate the completion candidates. [[kbd:][S-TAB]] will navigate the completion candidates.
** Packages ** Packages
- [[doom-package:][company-box]] if [[doom-module:][+childframe]] - [[doom-package:company-box]] if [[doom-module:+childframe]]
- [[doom-package:][company-dict]] - [[doom-package:company-dict]]
- [[doom-package:][company-mode]] - [[doom-package:company-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

36
modules/completion/helm/README.org
View file

@ -18,21 +18,21 @@ as a unified interface for project search and replace, powered by [[https://gith
Enable fuzzy completion for Helm searches. Enable fuzzy completion for Helm searches.
- +icons :: - +icons ::
Display icons on completion results (where possible) using either Display icons on completion results (where possible) using either
[[doom-package:][all-the-icons]] or [[doom-package:][treemacs]] iconsets. [[doom-package:all-the-icons]] or [[doom-package:treemacs]] iconsets.
** Packages ** Packages
- [[doom-package:][helm]] - [[doom-package:helm]]
- [[doom-package:][helm-company]] - [[doom-package:helm-company]]
- [[doom-package:][helm-c-yasnippet]] - [[doom-package:helm-c-yasnippet]]
- [[doom-package:][helm-descbinds]] - [[doom-package:helm-descbinds]]
- [[doom-package:][helm-describe-modes]] - [[doom-package:helm-describe-modes]]
- [[doom-package:][helm-flx]]* if [[doom-module:][+fuzzy]] - [[doom-package:helm-flx]]* if [[doom-module:+fuzzy]]
- [[doom-package:][helm-icons]]* if [[doom-module:][+icons]] - [[doom-package:helm-icons]]* if [[doom-module:+icons]]
- [[doom-package:][helm-org]]* if [[doom-module:][:lang org]] - [[doom-package:helm-org]]* if [[doom-module::lang org]]
- [[doom-package:][helm-posframe]]* if [[doom-module:][+childframe]] - [[doom-package:helm-posframe]]* if [[doom-module:+childframe]]
- [[doom-package:][helm-projectile]] - [[doom-package:helm-projectile]]
- [[doom-package:][helm-rg]] - [[doom-package:helm-rg]]
- [[doom-package:][helm-swiper]] - [[doom-package:helm-swiper]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote
@ -59,13 +59,13 @@ Helm command or plugin.
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
Much like [[doom-package:][ivy]] and [[doom-package:][vertico]], [[doom-package:][helm]] is a /large/ framework. Covering all its Much like [[doom-package:ivy]] and [[doom-package:vertico]], [[doom-package:helm]] is a /large/ framework. Covering all its
features is not within the scope of this module's documentation, so only its features is not within the scope of this module's documentation, so only its
highlights will be covered here. highlights will be covered here.
** Jump-to navigation ** Jump-to navigation
Similar to Ivy, this module provides an interface to navigate within a project Similar to Ivy, this module provides an interface to navigate within a project
using [[doom-package:][projectile]]: using [[doom-package:projectile]]:
| Keybind | Description | | Keybind | Description |
|------------------+-------------------------------------| |------------------+-------------------------------------|
| [[kbd:][SPC p f]], [[kbd:][SPC SPC]] | Jump to file in project | | [[kbd:][SPC p f]], [[kbd:][SPC SPC]] | Jump to file in project |
@ -109,7 +109,7 @@ Changes to the resulting wgrep buffer (opened by [[kbd:][C-c C-e]]) can be commi
[[kbd:][C-c C-c]] and aborted with [[kbd:][C-c C-k]] (alternatively [[kbd:][ZZ]] and [[kbd:][ZQ]], for evil users). [[kbd:][C-c C-c]] and aborted with [[kbd:][C-c C-k]] (alternatively [[kbd:][ZZ]] and [[kbd:][ZQ]], for evil users).
** In-buffer searching ** In-buffer searching
The [[doom-package:][swiper]] package provides an interactive buffer search powered by helm. It can The [[doom-package:swiper]] package provides an interactive buffer search powered by helm. It can
be invoked with: be invoked with:
- [[kbd:][SPC s s]] (~swiper-isearch~) - [[kbd:][SPC s s]] (~swiper-isearch~)
- [[kbd:][SPC s S]] (~swiper-isearch-thing-at-point~) - [[kbd:][SPC s S]] (~swiper-isearch-thing-at-point~)
@ -156,8 +156,8 @@ Helm also has a number of overrides for built-in functionality:
#+end_quote #+end_quote
** Icons ** Icons
Icon support is now included, through one of two providers: [[doom-package:][all-the-icons]] and Icon support is now included, through one of two providers: [[doom-package:all-the-icons]] and
[[doom-package:][treemacs]]. By default, to maintain consistency we use [[doom-package:][all-the-icons]]; however if [[doom-package:treemacs]]. By default, to maintain consistency we use [[doom-package:all-the-icons]]; however if
you wish to modify this you can do so using the below snippet: you wish to modify this you can do so using the below snippet:
#+begin_src emacs-lisp #+begin_src emacs-lisp

10
modules/completion/ido/README.org
View file

@ -13,11 +13,11 @@ Interactive DO things. The completion engine that is /mostly/ built-into Emacs.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][crm-custom]] - [[doom-package:crm-custom]]
- [[doom-package:][flx-ido]] - [[doom-package:flx-ido]]
- [[doom-package:][ido-completing-read+]] - [[doom-package:ido-completing-read+]]
- [[doom-package:][ido-sort-mtime]] - [[doom-package:ido-sort-mtime]]
- [[doom-package:][ido-vertical-mode]] - [[doom-package:ido-vertical-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

32
modules/completion/ivy/README.org
View file

@ -27,18 +27,18 @@ lighter, simpler and faster in many cases.
Enable prescient filtering and sorting for Ivy searches. Enable prescient filtering and sorting for Ivy searches.
** Packages ** Packages
- [[doom-package:][all-the-icons-ivy]]* if [[doom-module:][+icons]] - [[doom-package:all-the-icons-ivy]]* if [[doom-module:+icons]]
- [[doom-package:][amx]] - [[doom-package:amx]]
- [[doom-package:][counsel]] - [[doom-package:counsel]]
- [[doom-package:][counsel-projectile]] - [[doom-package:counsel-projectile]]
- [[doom-package:][flx]]* if [[doom-module:][+fuzzy]] - [[doom-package:flx]]* if [[doom-module:+fuzzy]]
- [[doom-package:][ivy]] - [[doom-package:ivy]]
- [[doom-package:][ivy-hydra]] - [[doom-package:ivy-hydra]]
- [[doom-package:][ivy-posframe]]* if [[doom-module:][+childframe]] - [[doom-package:ivy-posframe]]* if [[doom-module:+childframe]]
- [[doom-package:][ivy-rich]] - [[doom-package:ivy-rich]]
- [[doom-package:][prescient]]* if [[doom-module:][+prescient]] - [[doom-package:prescient]]* if [[doom-module:+prescient]]
- [[doom-package:][swiper]] - [[doom-package:swiper]]
- [[doom-package:][wgrep]] - [[doom-package:wgrep]]
** Hacks ** Hacks
- Functions with ivy/counsel equivalents have been globally remapped (like - Functions with ivy/counsel equivalents have been globally remapped (like
@ -67,14 +67,14 @@ use their associated Helm command or plugin.
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
[[doom-package:][ivy]] is a /large/ framework for completing things. Covering all its features is [[doom-package:ivy]] is a /large/ framework for completing things. Covering all its features is
not within the scope of this module's documentation, so only its highlights will not within the scope of this module's documentation, so only its highlights will
be covered here. be covered here.
** Jump-to navigation ** Jump-to navigation
Inspired by Sublime Text's jump-to-anywhere, CtrlP/Unite in Vim, and Textmate's Inspired by Sublime Text's jump-to-anywhere, CtrlP/Unite in Vim, and Textmate's
Command-T, this module provides similar functionality by bringing [[doom-package:][projectile]] and Command-T, this module provides similar functionality by bringing [[doom-package:projectile]] and
[[doom-package:][ivy]] together. [[doom-package:ivy]] together.
https://assets.doomemacs.org/completion/ivy/projectile.png https://assets.doomemacs.org/completion/ivy/projectile.png
@ -125,7 +125,7 @@ Changes to the resulting wgrep buffer (opened by [[kbd:][C-c C-e]]) can be commi
https://assets.doomemacs.org/completion/ivy/search-replace.png https://assets.doomemacs.org/completion/ivy/search-replace.png
** In-buffer searching ** In-buffer searching
The [[doom-package:][swiper]] package provides an interactive buffer search powered by ivy. It The [[doom-package:swiper]] package provides an interactive buffer search powered by ivy. It
can be invoked with: can be invoked with:
- [[kbd:][SPC s s]] (~swiper-isearch~) - [[kbd:][SPC s s]] (~swiper-isearch~)

30
modules/completion/vertico/README.org
View file

@ -9,7 +9,7 @@ provides a united interface for project search and replace, powered by [[https:/
It does this with several modular packages focused on enhancing the built-in It does this with several modular packages focused on enhancing the built-in
~completing-read~ interface, rather than replacing it with a parallel ecosystem ~completing-read~ interface, rather than replacing it with a parallel ecosystem
like [[doom-package:][ivy]] and [[doom-package:][helm]] do. The primary packages are: like [[doom-package:ivy]] and [[doom-package:helm]] do. The primary packages are:
- Vertico, which provides the vertical completion user interface - Vertico, which provides the vertical completion user interface
- Consult, which provides a suite of useful commands using ~completing-read~ - Consult, which provides a suite of useful commands using ~completing-read~
@ -31,16 +31,16 @@ like [[doom-package:][ivy]] and [[doom-package:][helm]] do. The primary packages
Add icons to =file= and =buffer= category completion selections. Add icons to =file= and =buffer= category completion selections.
** Packages ** Packages
- [[doom-package:][all-the-icons-completion]] if [[doom-module:][+icons]] - [[doom-package:all-the-icons-completion]] if [[doom-module:+icons]]
- [[doom-package:][consult]] - [[doom-package:consult]]
- [[doom-package:][consult-flycheck]] if [[doom-module:][:checkers syntax]] - [[doom-package:consult-flycheck]] if [[doom-module::checkers syntax]]
- [[doom-package:][embark]] - [[doom-package:embark]]
- [[doom-package:][embark-consult]] - [[doom-package:embark-consult]]
- [[doom-package:][marginalia]] - [[doom-package:marginalia]]
- [[doom-package:][orderless]] - [[doom-package:orderless]]
- [[doom-package:][vertico]] - [[doom-package:vertico]]
- [[doom-package:][vertico-posframe]] if [[doom-module:][+childframe]] - [[doom-package:vertico-posframe]] if [[doom-module:+childframe]]
- [[doom-package:][wgrep]] - [[doom-package:wgrep]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -95,7 +95,7 @@ due to Marginalia annotations.
** Jump-to navigation ** Jump-to navigation
This module provides an interface to navigate within a project using This module provides an interface to navigate within a project using
[[doom-package:][projectile]]: [[doom-package:projectile]]:
https://assets.doomemacs.org/completion/vertico/projectile.png https://assets.doomemacs.org/completion/vertico/projectile.png
@ -135,8 +135,8 @@ commands.
On top of the usual Vertico keybindings, search commands also offer support for On top of the usual Vertico keybindings, search commands also offer support for
exporting the current candidate list to an editable buffer [[kbd:][C-c C-e]]. After exporting the current candidate list to an editable buffer [[kbd:][C-c C-e]]. After
editing the changes can be committed with [[kbd:][C-c C-c]] and aborted with [[kbd:][C-c C-k]] editing the changes can be committed with [[kbd:][C-c C-c]] and aborted with [[kbd:][C-c C-k]]
(alternatively [[kbd:][ZZ]] and [[kbd:][ZQ]], for evil users). It uses [[doom-package:][wgrep]] for grep searches, (alternatively [[kbd:][ZZ]] and [[kbd:][ZQ]], for evil users). It uses [[doom-package:wgrep]] for grep searches,
[[doom-package:][wdired]] for file searches, and =occur= for buffer searches. [[doom-package:wdired]] for file searches, and =occur= for buffer searches.
https://assets.doomemacs.org/completion/vertico/search-replace.png https://assets.doomemacs.org/completion/vertico/search-replace.png
@ -213,7 +213,7 @@ Consult async commands (e.g. ~consult-ripgrep~) will have a preceding separator
character (usually ~#~) before the search input. This is known as the =perl= character (usually ~#~) before the search input. This is known as the =perl=
splitting style. Input typed after the separator will be fed to the async splitting style. Input typed after the separator will be fed to the async
command until you type a second seperator, afterwhich the candidate list will be command until you type a second seperator, afterwhich the candidate list will be
filtered with Emacs instead (and can be filtered using [[doom-package:][orderless]], for example). filtered with Emacs instead (and can be filtered using [[doom-package:orderless]], for example).
The specific seperator character can be changed by editing it, and might be The specific seperator character can be changed by editing it, and might be
different if the initial input already contains =#=. different if the initial input already contains =#=.

10
modules/config/default/README.org
View file

@ -8,7 +8,7 @@ This module provides a set of reasonable defaults, including:
- A Spacemacs-inspired keybinding scheme - A Spacemacs-inspired keybinding scheme
- A configuration for (almost) universally repeating searches with [[kbd:][;]] and [[kbd:][,]] - A configuration for (almost) universally repeating searches with [[kbd:][;]] and [[kbd:][,]]
- A [[doom-package:][smartparens]] configuration for smart completion of certain delimiters, like - A [[doom-package:smartparens]] configuration for smart completion of certain delimiters, like
~/* */~ command blocks in C-languages, ~<?php ?>~ tags in PHP, or ~def end~ in ~/* */~ command blocks in C-languages, ~<?php ?>~ tags in PHP, or ~def end~ in
Ruby/Crystal/etc. Ruby/Crystal/etc.
@ -23,10 +23,10 @@ This module provides a set of reasonable defaults, including:
- +smartparens :: ... - +smartparens :: ...
** Packages ** Packages
- [[doom-package:][avy]] - [[doom-package:avy]]
- [[doom-package:][drag-stuff]] - [[doom-package:drag-stuff]]
- [[doom-package:][link-hint]] - [[doom-package:link-hint]]
- [[doom-package:][expand-region]] unless [[doom-module:][:editor evil]] - [[doom-package:expand-region]] unless [[doom-module::editor evil]]
** Hacks ** Hacks
- ~epa-pinentry-mode~ is set to ~'loopback~, forcing gpg-agent to use the Emacs - ~epa-pinentry-mode~ is set to ~'loopback~, forcing gpg-agent to use the Emacs

17
modules/config/literate/autoload.el
View file

@ -24,6 +24,9 @@
(org-startup-indented nil) (org-startup-indented nil)
(org-startup-folded nil) (org-startup-folded nil)
(vc-handled-backends nil) (vc-handled-backends nil)
;; Emit more information about the tangle process:
(org-babel-pre-tangle-hook org-babel-pre-tangle-hook) ; before file tangle
(org-babel-tangle-body-hook org-babel-tangle-body-hook) ; after src block
;; Prevent unwanted entries in recentf, or formatters, or ;; Prevent unwanted entries in recentf, or formatters, or
;; anything that could be on these hooks, really. Nothing else ;; anything that could be on these hooks, really. Nothing else
;; should be touching these files (particularly in interactive ;; should be touching these files (particularly in interactive
@ -38,9 +41,17 @@
;; Allow evaluation of src blocks at tangle-time (would abort ;; Allow evaluation of src blocks at tangle-time (would abort
;; them otherwise). This is a security hazard, but Doom will ;; them otherwise). This is a security hazard, but Doom will
;; trust that you know what you're doing! ;; trust that you know what you're doing!
(org-confirm-babel-evaluate nil) (org-confirm-babel-evaluate nil))
;; Say a little more (push (lambda () (print! (start "Tangling file: %s...") buffer-file-name))
(doom-print-message-level 'info)) org-babel-pre-tangle-hook)
(print-group!
(push (lambda ()
(let ((element (org-element-at-point)))
(when (eq 'src-block (org-element-type element))
(org-element-property :language element)
(print! (start "Tangling %s block...")
(org-element-property :language element)))))
org-babel-tangle-body-hook))
(if-let (files (org-babel-tangle-file target dest)) (if-let (files (org-babel-tangle-file target dest))
(always (print! (success "Done tangling %d file(s)!" (length files)))) (always (print! (success "Done tangling %d file(s)!" (length files))))
(print! (error "Failed to tangle any blocks from your config.")) (print! (error "Failed to tangle any blocks from your config."))

50
modules/editor/evil/README.org
View file

@ -17,24 +17,24 @@ This holy module brings the Vim editing model to Emacs.
as a foundation. as a foundation.
** Packages ** Packages
- [[doom-package:][evil]] - [[doom-package:evil]]
- [[doom-package:][evil-args]] - [[doom-package:evil-args]]
- [[doom-package:][evil-collection]] if [[doom-module:][+everywhere]] - [[doom-package:evil-collection]] if [[doom-module:+everywhere]]
- [[doom-package:][evil-easymotion]] - [[doom-package:evil-easymotion]]
- [[doom-package:][evil-embrace]] - [[doom-package:evil-embrace]]
- [[doom-package:][evil-escape]] - [[doom-package:evil-escape]]
- [[doom-package:][evil-exchange]] - [[doom-package:evil-exchange]]
- [[doom-package:][evil-indent-plus]] - [[doom-package:evil-indent-plus]]
- [[doom-package:][evil-lion]] - [[doom-package:evil-lion]]
- [[doom-package:][evil-nerd-commentary]] - [[doom-package:evil-nerd-commentary]]
- [[doom-package:][evil-numbers]] - [[doom-package:evil-numbers]]
- [[doom-package:][evil-quick-diff]] - [[doom-package:evil-quick-diff]]
- [[doom-package:][evil-snipe]] - [[doom-package:evil-snipe]]
- [[doom-package:][evil-surround]] - [[doom-package:evil-surround]]
- [[doom-package:][evil-textobj-anyblock]] - [[doom-package:evil-textobj-anyblock]]
- [[doom-package:][evil-vimish-fold]] - [[doom-package:evil-vimish-fold]]
- [[doom-package:][evil-visualstar]] - [[doom-package:evil-visualstar]]
- [[doom-package:][exato]] - [[doom-package:exato]]
** Hacks ** Hacks
- The o/O keys will respect and continue commented lines (can be disabled by - The o/O keys will respect and continue commented lines (can be disabled by
@ -76,11 +76,11 @@ The following vim plugins have been ported to evil:
This module has also ported vim-unimpaired keybinds to Emacs. This module has also ported vim-unimpaired keybinds to Emacs.
In other modules: In other modules:
- The [[doom-module:][:ui neotree]] & [[doom-module:][:ui treemacs]] modules provide a =NERDTree= equivalent. - The [[doom-module::ui neotree]] & [[doom-module::ui treemacs]] modules provide a =NERDTree= equivalent.
- The [[doom-module:][:editor multiple-cursors]] module contains functionality equal to the - The [[doom-module::editor multiple-cursors]] module contains functionality equal to the
following vim plugins: following vim plugins:
- [[doom-package:][evil-multiedit]] => [[github:hlissner/vim-multiedit][vim-multiedit]] - [[doom-package:evil-multiedit]] => [[github:hlissner/vim-multiedit][vim-multiedit]]
- [[doom-package:][evil-mc]] => [[https://github.com/terryma/vim-multiple-cursors][vim-multiple-cursors]] - [[doom-package:evil-mc]] => [[https://github.com/terryma/vim-multiple-cursors][vim-multiple-cursors]]
** Custom Text Objects ** Custom Text Objects
This module provides a couple extra text objects, along with the built-in ones. This module provides a couple extra text objects, along with the built-in ones.
@ -157,13 +157,13 @@ To undo this, use:
#+end_src #+end_src
** The [[kbd:][s]]/[[kbd:][S]] keys behave differently from Vim ** The [[kbd:][s]]/[[kbd:][S]] keys behave differently from Vim
Doom replaces the [[kbd:][s]] and [[kbd:][S]] keys with the [[doom-package:][evil-snipe]] package (a port of Doom replaces the [[kbd:][s]] and [[kbd:][S]] keys with the [[doom-package:evil-snipe]] package (a port of
vim-seek/vim-sneak for 2-character versions of f/F/t/T). vim-seek/vim-sneak for 2-character versions of f/F/t/T).
To disable evil-snipe on s/S, you can either: To disable evil-snipe on s/S, you can either:
1. Disable ~evil-snipe-mode~ by adding ~(remove-hook 'doom-first-input-hook 1. Disable ~evil-snipe-mode~ by adding ~(remove-hook 'doom-first-input-hook
#'evil-snipe-mode)~ to =$DOOMDIR/config.el=, #'evil-snipe-mode)~ to =$DOOMDIR/config.el=,
2. Or disable [[doom-package:][evil-snipe]] completely with ~(package! evil-snipe :disable t)~ 2. Or disable [[doom-package:evil-snipe]] completely with ~(package! evil-snipe :disable t)~
added to =$DOOMDIR/packages.el=, but this will also disable incremental added to =$DOOMDIR/packages.el=, but this will also disable incremental
highlighting for the f/F/t/T motions keys. highlighting for the f/F/t/T motions keys.
3. Or use [[kbd:][cl]] and [[kbd:][cc]], respectively; they do the same thing. 3. Or use [[kbd:][cl]] and [[kbd:][cc]], respectively; they do the same thing.
@ -198,7 +198,7 @@ If you prefer the old behavior, it can be reversed with:
#+end_quote #+end_quote
Evil-specific configuration and keybindings (defined with ~map!~) will be Evil-specific configuration and keybindings (defined with ~map!~) will be
ignored without [[doom-module:][:editor evil]] present (and omitted when byte-compiling). ignored without [[doom-module::editor evil]] present (and omitted when byte-compiling).
** Include underscores in evil word motions? ** Include underscores in evil word motions?
A more in-depth answer and explanation for this can be found [[https://evil.readthedocs.io/en/latest/faq.html#underscore-is-not-a-word-character][in Evil's A more in-depth answer and explanation for this can be found [[https://evil.readthedocs.io/en/latest/faq.html#underscore-is-not-a-word-character][in Evil's

8
modules/editor/file-templates/README.org
View file

@ -4,7 +4,7 @@
#+since: 2.0.0 #+since: 2.0.0
* Description :unfold: * Description :unfold:
This module adds file templates for blank files, powered by [[doom-package:][yasnippet]]. This module adds file templates for blank files, powered by [[doom-package:yasnippet]].
** Maintainers ** Maintainers
- [[doom-user:][@hlissner]] - [[doom-user:][@hlissner]]
@ -18,7 +18,7 @@ This module adds file templates for blank files, powered by [[doom-package:][yas
/This module doesn't install any packages./ /This module doesn't install any packages./
** Hacks ** Hacks
- [[doom-package:][yasnippet]] - [[doom-package:yasnippet]]
** TODO Changelog ** TODO Changelog
# This section will be machine generated. Don't edit it by hand. # This section will be machine generated. Don't edit it by hand.
@ -60,13 +60,13 @@ A special command is available for inserting software licenses: ~M-x
New file templates can be added to New file templates can be added to
=$DOOMDIR/snippets/{major-mode}/{snippet-name}=. The yasnippet documentation =$DOOMDIR/snippets/{major-mode}/{snippet-name}=. The yasnippet documentation
covers [[https://joaotavora.github.io/yasnippet/snippet-development.html][how to write a snippet]]. You can map a snippet to a file path, major mode, covers [[https://joaotavora.github.io/yasnippet/snippet-development.html][how to write a snippet]]. You can map a snippet to a file path, major mode,
or another arbitrary predicate using [[fn:][set-file-template!]]. or another arbitrary predicate using [[fn:set-file-template!]].
Look into its documentation with [[kbd:][<help> f set-file-template\!]]. Look into its documentation with [[kbd:][<help> f set-file-template\!]].
** Adding new OSS licenses ** Adding new OSS licenses
Add snippet files to =$DOOMDIR/snippets/text-mode/= with the =__licenses-= Add snippet files to =$DOOMDIR/snippets/text-mode/= with the =__licenses-=
prefix and [[fn:][+file-templates/insert-license]] will recognize them. E.g. prefix and [[fn:+file-templates/insert-license]] will recognize them. E.g.
=$DOOMDIR/snippets/text-mode/__license-mit=. =$DOOMDIR/snippets/text-mode/__license-mit=.
* Troubleshooting * Troubleshooting

16
modules/editor/file-templates/templates/org-mode/__doom-readme
View file

@ -39,7 +39,7 @@ the purpose of the module and the features/technology(ies) it provides.
Display X in a [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Child-Frames.html][child frame]] rather than an overlay or tooltip. *Requires GUI Display X in a [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Child-Frames.html][child frame]] rather than an overlay or tooltip. *Requires GUI
Emacs.* Emacs.*
- +lsp :: - +lsp ::
Enable LSP support for ~X-mode~. Requires [[doom-module:][:tools lsp]] and a Enable LSP support for ~X-mode~. Requires [[doom-module::tools lsp]] and a
langserver (supports A, B, and C). langserver (supports A, B, and C).
# If this module has no flags, then... # If this module has no flags, then...
@ -52,13 +52,13 @@ the purpose of the module and the features/technology(ies) it provides.
#+end_quote #+end_quote
** Packages ** Packages
- [[doom-package:][org]] - [[doom-package:org]]
- [[doom-package:][org-contrib]] if [[doom-module:][+contrib]] - [[doom-package:org-contrib]] if [[doom-module:+contrib]]
- [[doom-package:][org-bullets]] unless [[doom-module:][+bullets]] - [[doom-package:org-bullets]] unless [[doom-module:+bullets]]
- if [[doom-module:][+present]] - if [[doom-module:+present]]
- [[doom-package:][centered-window]] - [[doom-package:centered-window]]
- [[doom-package:][org-tree-slide]] - [[doom-package:org-tree-slide]]
- [[doom-package:][org-re-reveal]] - [[doom-package:org-re-reveal]]
# If this module installs no packages, then... # If this module installs no packages, then...
/This module doesn't install any packages./ /This module doesn't install any packages./

12
modules/editor/fold/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 #+since: 21.12.0
* Description :unfold: * Description :unfold:
This module marries [[doom-package:][hideshow]], [[doom-package:][vimish-fold]], and ~outline-minor-mode~ to bring you This module marries [[doom-package:hideshow]], [[doom-package:vimish-fold]], and ~outline-minor-mode~ to bring you
marker, indent and syntax-based code folding for as many languages as possible. marker, indent and syntax-based code folding for as many languages as possible.
** Maintainers ** Maintainers
@ -16,10 +16,10 @@ marker, indent and syntax-based code folding for as many languages as possible.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][evil-vimish-fold]] - [[doom-package:evil-vimish-fold]]
- [[doom-package:][vimish-fold]] - [[doom-package:vimish-fold]]
- if [[doom-module:][:tools tree-sitter]] - if [[doom-module::tools tree-sitter]]
- [[doom-package:][ts-fold]] - [[doom-package:ts-fold]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote
@ -40,7 +40,7 @@ marker, indent and syntax-based code folding for as many languages as possible.
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
Emacs keybinds when [[doom-module:][:editor evil +everywhere]] is disabled: Emacs keybinds when [[doom-module::editor evil +everywhere]] is disabled:
| Keybind | Description | | Keybind | Description |
|--------------------+---------------------------| |--------------------+---------------------------|
| [[kbd:][C-c C-f C-f]] | Fold region | | [[kbd:][C-c C-f C-f]] | Fold region |

12
modules/editor/format/README.org
View file

@ -27,11 +27,11 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
** Module flags ** Module flags
- +onsave :: - +onsave ::
Enable reformatting of a buffer when it is saved. See Enable reformatting of a buffer when it is saved. See
[[var:][+format-on-save-enabled-modes]] to control what major modes to (or not to) [[var:+format-on-save-enabled-modes]] to control what major modes to (or not to)
format on save. format on save.
** Packages ** Packages
- [[doom-package:][format-all]] - [[doom-package:format-all]]
** Hacks ** Hacks
- format-all has been heavily modified to suit Doom's goals for this module: - format-all has been heavily modified to suit Doom's goals for this module:
@ -39,7 +39,7 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
affect on cursor position. affect on cursor position.
- Adds partial formatting, i.e. you can now reformat a subset of the buffer. - Adds partial formatting, i.e. you can now reformat a subset of the buffer.
- Adds the ability to use any arbitrary formatter on the current buffer if you - Adds the ability to use any arbitrary formatter on the current buffer if you
pass the universal argument to [[fn:][+format/buffer]] or [[fn:][+format/region]] (i.e. pass the universal argument to [[fn:+format/buffer]] or [[fn:+format/region]] (i.e.
removes the major-mode lock on formatters). removes the major-mode lock on formatters).
** TODO Changelog ** TODO Changelog
@ -51,7 +51,7 @@ rustfmt, scalafmt, script shfmt, snakefmt, sqlformat, styler, swiftformat, tidy
This module has no direct requirements, but each language will need one of their This module has no direct requirements, but each language will need one of their
supported formatter programs in order for this to work. In their absence, supported formatter programs in order for this to work. In their absence,
[[doom-package:][format-all]] will fail silently. [[doom-package:format-all]] will fail silently.
Supported formatters: Supported formatters:
- Angular/Vue (prettier) - Angular/Vue (prettier)
@ -137,7 +137,7 @@ default value:
If you want to format code when you save a buffer, but want more granular If you want to format code when you save a buffer, but want more granular
control over which major modes this behavior is enabled in, there is an control over which major modes this behavior is enabled in, there is an
alternative. Make sure [[doom-module:][+onsave]] is disabled before you try this: alternative. Make sure [[doom-module:+onsave]] is disabled before you try this:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(add-hook 'python-mode-hook #'format-all-mode) (add-hook 'python-mode-hook #'format-all-mode)
(add-hook 'js2-mode-hook #'format-all-mode) (add-hook 'js2-mode-hook #'format-all-mode)
@ -145,7 +145,7 @@ alternative. Make sure [[doom-module:][+onsave]] is disabled before you try this
** Disabling the LSP formatter ** Disabling the LSP formatter
If you are in a buffer with ~lsp-mode~ enabled and a server that supports If you are in a buffer with ~lsp-mode~ enabled and a server that supports
=textDocument/formatting=, it will be used instead of [[doom-package:][format-all]]'s formatter. =textDocument/formatting=, it will be used instead of [[doom-package:format-all]]'s formatter.
+ To disable this behavior universally use: ~(setq +format-with-lsp nil)~ + To disable this behavior universally use: ~(setq +format-with-lsp nil)~
+ To disable this behavior in one mode: ~(setq-hook! 'python-mode-hook + To disable this behavior in one mode: ~(setq-hook! 'python-mode-hook

4
modules/editor/god/README.org
View file

@ -8,7 +8,7 @@
#+end_quote #+end_quote
* Description :unfold: * Description :unfold:
Adds [[doom-package:][god-mode]] support to Doom Emacs, allowing for entering commands without Adds [[doom-package:god-mode]] support to Doom Emacs, allowing for entering commands without
modifier keys, similar to Vim's modality, separating command mode and insert modifier keys, similar to Vim's modality, separating command mode and insert
mode. mode.
@ -19,7 +19,7 @@ mode.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][god-mode]] - [[doom-package:god-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

8
modules/editor/lispy/README.org
View file

@ -24,8 +24,8 @@ languages:
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][lispy]] - [[doom-package:lispy]]
- [[doom-package:][lispyville]] if [[doom-module:][:editor evil +everywhere]] - [[doom-package:lispyville]] if [[doom-module::editor evil +everywhere]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -44,8 +44,8 @@ languages:
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
If [[doom-module:][:editor evil]] is enabled, [[doom-package:][lispyville]] would also be activated for every mode If [[doom-module::editor evil]] is enabled, [[doom-package:lispyville]] would also be activated for every mode
where [[doom-package:][lispy]] is active. where [[doom-package:lispy]] is active.
* TODO Configuration * TODO Configuration
#+begin_quote #+begin_quote

16
modules/editor/multiple-cursors/README.org
View file

@ -16,17 +16,17 @@ evil) that loosely take after multi-cursors in Atom or Sublime Text.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- if [[doom-module:][:editor evil]] - if [[doom-module::editor evil]]
- [[doom-package:][evil-multiedit]] - [[doom-package:evil-multiedit]]
- [[doom-package:][evil-mc]] - [[doom-package:evil-mc]]
- else - else
- [[doom-package:][multiple-cursors]] - [[doom-package:multiple-cursors]]
** Hacks ** Hacks
- Attempts to smooth over [[doom-package:][multiple-cursors]]' incompatibilities with [[doom-package:][evil]], which - Attempts to smooth over [[doom-package:multiple-cursors]]' incompatibilities with [[doom-package:evil]], which
is used internally in some third party plugins. is used internally in some third party plugins.
- Attempts to smooth over [[doom-package:][evil-mc]]'s incompatibilities with other packages, like - Attempts to smooth over [[doom-package:evil-mc]]'s incompatibilities with other packages, like
[[doom-package:][lispy]]. [[doom-package:lispy]].
** TODO Changelog ** TODO Changelog
# This section will be machine generated. Don't edit it by hand. # This section will be machine generated. Don't edit it by hand.
@ -43,7 +43,7 @@ evil) that loosely take after multi-cursors in Atom or Sublime Text.
#+end_quote #+end_quote
** evil-mc ** evil-mc
- The [[doom-package:][evil-mc]] keys are under the [[kbd:][gz]] prefix, e.g. - The [[doom-package:evil-mc]] keys are under the [[kbd:][gz]] prefix, e.g.
- [[kbd:][gzz]] to toggle new (frozen) cursors at point. - [[kbd:][gzz]] to toggle new (frozen) cursors at point.
- [[kbd:][gzt]] to toggle mirroring on and off (or switch to insert mode to activate - [[kbd:][gzt]] to toggle mirroring on and off (or switch to insert mode to activate
them). them).

10
modules/editor/objed/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 #+since: 21.12.0
* Description :unfold: * Description :unfold:
This modules adds [[doom-package:][objed]], a global minor-mode for navigating and manipulating This modules adds [[doom-package:objed]], a global minor-mode for navigating and manipulating
text objects. It combines the ideas of ~versor-mode~ and other editors like Vim text objects. It combines the ideas of ~versor-mode~ and other editors like Vim
or Kakoune and tries to align them with regular Emacs conventions. or Kakoune and tries to align them with regular Emacs conventions.
@ -15,11 +15,11 @@ or Kakoune and tries to align them with regular Emacs conventions.
** Module flags ** Module flags
- +manual :: - +manual ::
Don't activate [[doom-package:][objed]] at startup, automatically, leaving it to the user to call Don't activate [[doom-package:objed]] at startup, automatically, leaving it to the user to call
[[fn:][objed-activate]] (bound to [[kbd:][M-SPC]] if using [[doom-module:][:config default +bindings]]). [[fn:objed-activate]] (bound to [[kbd:][M-SPC]] if using [[doom-module::config default +bindings]]).
** Packages ** Packages
- [[doom-package:][objed]] - [[doom-package:objed]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -34,7 +34,7 @@ or Kakoune and tries to align them with regular Emacs conventions.
/This module has no external requirements./ /This module has no external requirements./
#+begin_quote #+begin_quote
🚧 This module is incompatible with [[doom-module:][:editor evil]]. Do not enable them both at 🚧 This module is incompatible with [[doom-module::editor evil]]. Do not enable them both at
the same time or you will get errors. the same time or you will get errors.
#+end_quote #+end_quote

2
modules/editor/parinfer/README.org
View file

@ -15,7 +15,7 @@ balanced and beautiful.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][parinfer-rust-mode]] - [[doom-package:parinfer-rust-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

2
modules/editor/rotate-text/README.org
View file

@ -17,7 +17,7 @@ keywords or text patterns at point, like ~true~ and ~false~, or ~public~,
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][rotate-text]] - [[doom-package:rotate-text]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

8
modules/editor/snippets/README.org
View file

@ -4,7 +4,7 @@
#+since: 2.0.0 #+since: 2.0.0
* Description :unfold: * Description :unfold:
This module adds snippet expansions to Emacs, powered by [[doom-package:][yasnippet]]. This module adds snippet expansions to Emacs, powered by [[doom-package:yasnippet]].
** Maintainers ** Maintainers
- [[doom-user:][@hlissner]] - [[doom-user:][@hlissner]]
@ -15,9 +15,9 @@ This module adds snippet expansions to Emacs, powered by [[doom-package:][yasnip
/This module exposes no flags./ /This module exposes no flags./
** Packages ** Packages
- [[doom-package:][yasnippet]] - [[doom-package:yasnippet]]
- [[doom-package:][auto-yasnippet]] - [[doom-package:auto-yasnippet]]
- [[doom-package:][doom-snippets]] - [[doom-package:doom-snippets]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

4
modules/editor/word-wrap/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 (#1709) #+since: 21.12.0 (#1709)
* Description :unfold: * Description :unfold:
This module adds a minor-mode [[fn:][+word-wrap-mode]], which intelligently wraps long This module adds a minor-mode [[fn:+word-wrap-mode]], which intelligently wraps long
lines in the buffer without modifying the buffer content. lines in the buffer without modifying the buffer content.
** Maintainers ** Maintainers
@ -16,7 +16,7 @@ lines in the buffer without modifying the buffer content.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][adaptive-wrap]] - [[doom-package:adaptive-wrap]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

18
modules/emacs/dired/README.org
View file

@ -16,12 +16,12 @@ This module provides reasonable defaults and augmentations for dired.
Enables dired to be more like [[https://github.com/ranger/ranger][ranger]]. Enables dired to be more like [[https://github.com/ranger/ranger][ranger]].
** Packages ** Packages
- [[doom-package:][all-the-icons-dired]] if [[doom-module:][+icons]] - [[doom-package:all-the-icons-dired]] if [[doom-module:+icons]]
- [[doom-package:][diff-hl]] - [[doom-package:diff-hl]]
- [[doom-package:][diredfl]] - [[doom-package:diredfl]]
- [[doom-package:][dired-rsync]] - [[doom-package:dired-rsync]]
- [[doom-package:][fd-dired]] - [[doom-package:fd-dired]]
- [[doom-package:][ranger]] if [[doom-module:][+ranger]] - [[doom-package:ranger]] if [[doom-module:+ranger]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote
@ -47,13 +47,13 @@ This module has no requirements *except on BSDs* like MacOS or FreeBSD, where
|---------+----------------------------| |---------+----------------------------|
| [[kbd:][SPC f d]] | Find directory with dired | | [[kbd:][SPC f d]] | Find directory with dired |
| [[kbd:][q]] | Exit dired buffer | | [[kbd:][q]] | Exit dired buffer |
| [[kbd:][C-c C-r]] | Run [[doom-package:][dired-rsync]] | | [[kbd:][C-c C-r]] | Run [[doom-package:dired-rsync]] |
| [[kbd:][C-c C-e]] | Rename entries with [[doom-package:][wdired]] | | [[kbd:][C-c C-e]] | Rename entries with [[doom-package:wdired]] |
Other keybindings can be found on the official [[https://www.gnu.org/software/emacs/refcards/pdf/dired-ref.pdf][Dired reference card]]. Other keybindings can be found on the official [[https://www.gnu.org/software/emacs/refcards/pdf/dired-ref.pdf][Dired reference card]].
** Ranger ** Ranger
If [[doom-module:][+ranger]] is enabled often a buffer will be opened in minimal ranger mode If [[doom-module:+ranger]] is enabled often a buffer will be opened in minimal ranger mode
(~deer-mode~). In this case [[kbd:][z P]] can be used to toggle between full ranger and (~deer-mode~). In this case [[kbd:][z P]] can be used to toggle between full ranger and
~deer-mode~. ~deer-mode~.

2
modules/emacs/electric/README.org
View file

@ -4,7 +4,7 @@
#+since: 2.0.0 #+since: 2.0.0
* Description :unfold: * Description :unfold:
This module augments the built-in [[doom-package:][electric]] package with keyword-based This module augments the built-in [[doom-package:electric]] package with keyword-based
indentation (as opposed to character-based). indentation (as opposed to character-based).
** Maintainers ** Maintainers

8
modules/emacs/ibuffer/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 #+since: 21.12.0
* Description :unfold: * Description :unfold:
This module augments the built-in [[doom-package:][ibuffer]] package. This module augments the built-in [[doom-package:ibuffer]] package.
- Adds project-based grouping of buffers - Adds project-based grouping of buffers
- Support for file-type icons - Support for file-type icons
@ -15,11 +15,11 @@ This module augments the built-in [[doom-package:][ibuffer]] package.
** Module flags ** Module flags
- +icons :: - +icons ::
Enable filetype icons for buffers using [[doom-package:][all-the-icons]]. Enable filetype icons for buffers using [[doom-package:all-the-icons]].
** Packages ** Packages
- [[doom-package:][ibuffer-projectile]] - [[doom-package:ibuffer-projectile]]
- [[doom-package:][ibuffer-vc]] - [[doom-package:ibuffer-vc]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

10
modules/emacs/undo/README.org
View file

@ -14,13 +14,13 @@ persist across Emacs sessions.
** Module flags ** Module flags
- +tree :: - +tree ::
Uses [[doom-package:][undo-tree]] instead of [[doom-package:][undo-fu]], which is a little less stable, but offers Uses [[doom-package:undo-tree]] instead of [[doom-package:undo-fu]], which is a little less stable, but offers
branching undo history and a visualizer for navigating it. branching undo history and a visualizer for navigating it.
** Packages ** Packages
- [[doom-package:][undo-fu]] - [[doom-package:undo-fu]]
- [[doom-package:][undo-fu-session]] - [[doom-package:undo-fu-session]]
- [[doom-package:][undo-tree]] if [[doom-module:][+tree]] - [[doom-package:undo-tree]] if [[doom-module:+tree]]
** Hacks ** Hacks
- Both undo-fu and undo-tree have been modified to use =zstd= to compress undo - Both undo-fu and undo-tree have been modified to use =zstd= to compress undo
@ -54,7 +54,7 @@ persist across Emacs sessions.
#+end_quote #+end_quote
** Disabling persistent undo history ** Disabling persistent undo history
- If you are using [[doom-module:][+tree]]: - If you are using [[doom-module:+tree]]:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(after! undo-tree (after! undo-tree
(setq undo-tree-auto-save-history nil)) (setq undo-tree-auto-save-history nil))

14
modules/emacs/vc/README.org
View file

@ -16,17 +16,17 @@ integration with =git=.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][browse-at-remote]] - [[doom-package:browse-at-remote]]
- [[doom-package:][git-timemachine]] - [[doom-package:git-timemachine]]
- [[doom-package:][gitconfig-mode]] - [[doom-package:gitconfig-mode]]
- [[doom-package:][gitignore-mode]] - [[doom-package:gitignore-mode]]
** Hacks ** Hacks
- Allow [[doom-package:][browse-at-remote]] commands in [[doom-package:][git-timemachine]] buffers to open that file - Allow [[doom-package:browse-at-remote]] commands in [[doom-package:git-timemachine]] buffers to open that file
in your browser at the visited revision. in your browser at the visited revision.
- [[doom-package:][git-timemachine]] buffers will display revision details in the header-line, - [[doom-package:git-timemachine]] buffers will display revision details in the header-line,
rather than the minibuffer (easier to see). rather than the minibuffer (easier to see).
- [[doom-package:][browse-at-remote]] will fall back to the =master= branch if target is in a - [[doom-package:browse-at-remote]] will fall back to the =master= branch if target is in a
detached state. detached state.
** TODO Changelog ** TODO Changelog

22
modules/email/mu4e/README.org
View file

@ -6,15 +6,15 @@
* Description :unfold: * Description :unfold:
This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/code/mu/mu4e.html][mu4e]]. This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/code/mu/mu4e.html][mu4e]].
- Tidied mu4e headers view, with flags from [[doom-package:][all-the-icons]]. - Tidied mu4e headers view, with flags from [[doom-package:all-the-icons]].
- Consistent coloring of reply depths (across compose and gnus modes). - Consistent coloring of reply depths (across compose and gnus modes).
- Prettified =mu4e:main= view. - Prettified =mu4e:main= view.
- Cooperative locking of the =mu= process. Another Emacs instance may request - Cooperative locking of the =mu= process. Another Emacs instance may request
access, or grab the lock when it's available. access, or grab the lock when it's available.
- [[doom-package:][org-msg]] integration with [[doom-module:][+org]], which can be toggled per-message, with revamped - [[doom-package:org-msg]] integration with [[doom-module:+org]], which can be toggled per-message, with revamped
style and an accent color. style and an accent color.
- Gmail integrations with the [[doom-module:][+gmail]] flag. - Gmail integrations with the [[doom-module:+gmail]] flag.
- Email notifications with [[doom-package:][mu4e-alert]], and (on Linux) a customised notification - Email notifications with [[doom-package:mu4e-alert]], and (on Linux) a customised notification
style. style.
#+begin_quote #+begin_quote
@ -38,12 +38,12 @@ This module makes Emacs an email client, using [[https://www.djcbsoftware.nl/cod
Enable gmail-specific configuration for mail ~To~ or ~From~ a gmail address, Enable gmail-specific configuration for mail ~To~ or ~From~ a gmail address,
or a maildir with ~gmail~ in the name. or a maildir with ~gmail~ in the name.
- +org :: - +org ::
Use [[doom-package:][org-msg]] for composing email in Org, then sending a multipart text (ASCII Use [[doom-package:org-msg]] for composing email in Org, then sending a multipart text (ASCII
export) and HTML message. export) and HTML message.
** Packages ** Packages
- [[doom-package:][mu4e-alert]] - [[doom-package:mu4e-alert]]
- [[doom-package:][org-msg]] if [[doom-module:][+org]] - [[doom-package:org-msg]] if [[doom-module:+org]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote
@ -160,7 +160,7 @@ mail by disabling this module's backend selection and setting the value of the
If your command prompts you for a passphrase, you might want to change the value If your command prompts you for a passphrase, you might want to change the value
of the ~mu4e~get-mail-password-regexp~ variable of the ~mu4e~get-mail-password-regexp~ variable
(~mu4e--get-mail-password-regexp~ if =mu= *>=1.8*) such that [[doom-package:][mu4e]] will recognize (~mu4e--get-mail-password-regexp~ if =mu= *>=1.8*) such that [[doom-package:mu4e]] will recognize
the prompt and let you provide the passphrase from within Emacs. the prompt and let you provide the passphrase from within Emacs.
** mu and mu4e ** mu and mu4e
@ -214,7 +214,7 @@ you are not replying to an email to or from one of the specified aliases, you
will be prompted for an alias to send from. will be prompted for an alias to send from.
*** Gmail *** Gmail
With the [[doom-module:][+gmail]] flag, integrations are applied which account for the different With the [[doom-module:+gmail]] flag, integrations are applied which account for the different
behaviour of Gmail. behaviour of Gmail.
The integrations are applied to addresses with /both/ "@gmail.com" in the The integrations are applied to addresses with /both/ "@gmail.com" in the
@ -243,7 +243,7 @@ as deleted: Auto-Expunge off - Wait for the client to update the server." and
folder: Move the message to the trash" for the integrations to work as expected. folder: Move the message to the trash" for the integrations to work as expected.
** OrgMsg ** OrgMsg
With the [[doom-module:][+org]] flag, [[doom-package:][org-msg]] is installed, and ~org-msg-mode~ is enabled before With the [[doom-module:+org]] flag, [[doom-package:org-msg]] is installed, and ~org-msg-mode~ is enabled before
composing the first message. To disable ~org-msg-mode~ by default: composing the first message. To disable ~org-msg-mode~ by default:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; add to $DOOMDIR/config.el ;; add to $DOOMDIR/config.el
@ -251,7 +251,7 @@ composing the first message. To disable ~org-msg-mode~ by default:
#+end_src #+end_src
To toggle org-msg for a single message, just apply the universal argument to the To toggle org-msg for a single message, just apply the universal argument to the
compose or reply command ([[kbd:][SPC u]] with [[doom-package:][evil]], [[kbd:][C-u]] otherwise). compose or reply command ([[kbd:][SPC u]] with [[doom-package:evil]], [[kbd:][C-u]] otherwise).
The accent color that Doom uses can be customised by setting The accent color that Doom uses can be customised by setting
~+org-msg-accent-color~ to a CSS color string. ~+org-msg-accent-color~ to a CSS color string.

2
modules/email/mu4e/autoload/email.el
View file

@ -132,7 +132,7 @@ will also be the width of all other printable characters."
(setq mu4e-use-fancy-chars t (setq mu4e-use-fancy-chars t
mu4e-headers-draft-mark (cons "D" (+mu4e-normalised-icon "pencil")) mu4e-headers-draft-mark (cons "D" (+mu4e-normalised-icon "pencil"))
mu4e-headers-flagged-mark (cons "F" (+mu4e-normalised-icon "flag")) mu4e-headers-flagged-mark (cons "F" (+mu4e-normalised-icon "flag"))
mu4e-headers-new-mark (cons "N" (+mu4e-normalised-icon "sync" :set "material" :height 0.8 :v-adjust -0.10)) mu4e-headers-new-mark (cons "N" (+mu4e-normalised-icon "eye-slash" :v-adjust 0.05 :height 0.7))
mu4e-headers-passed-mark (cons "P" (+mu4e-normalised-icon "arrow-right")) mu4e-headers-passed-mark (cons "P" (+mu4e-normalised-icon "arrow-right"))
mu4e-headers-replied-mark (cons "R" (+mu4e-normalised-icon "arrow-right")) mu4e-headers-replied-mark (cons "R" (+mu4e-normalised-icon "arrow-right"))
mu4e-headers-seen-mark (cons "S" "") ;(+mu4e-normalised-icon "eye" :height 0.6 :v-adjust 0.07 :color "dsilver")) mu4e-headers-seen-mark (cons "S" "") ;(+mu4e-normalised-icon "eye" :height 0.6 :v-adjust 0.07 :color "dsilver"))

3
modules/email/mu4e/autoload/mu-lock.el
View file

@ -34,7 +34,6 @@ If STRICT only accept an unset lock file."
(pid (car lock-info))) (pid (car lock-info)))
(when (or strict (/= (emacs-pid) pid)) t)))) (when (or strict (/= (emacs-pid) pid)) t))))
;;;###autoload
(defun +mu4e-lock-file-delete-maybe () (defun +mu4e-lock-file-delete-maybe ()
"Check `+mu4e-lock-file', and delete it if this process is responsible for it." "Check `+mu4e-lock-file', and delete it if this process is responsible for it."
(when (+mu4e-lock-available) (when (+mu4e-lock-available)
@ -54,7 +53,7 @@ Else, write to this process' PID to the lock file"
(user-error "Unfortunately another Emacs is already doing stuff with Mu4e, and you can only have one at a time") (user-error "Unfortunately another Emacs is already doing stuff with Mu4e, and you can only have one at a time")
(write-region (number-to-string (emacs-pid)) nil +mu4e-lock-file) (write-region (number-to-string (emacs-pid)) nil +mu4e-lock-file)
(delete-file +mu4e-lock-request-file) (delete-file +mu4e-lock-request-file)
(call-process "touch" nil nil nil +mu4e-lock-request-file) ;; (call-process "touch" nil nil nil +mu4e-lock-request-file)
(funcall orig-fun callback) (funcall orig-fun callback)
(when +mu4e-lock--request-watcher (when +mu4e-lock--request-watcher
(file-notify-rm-watch +mu4e-lock--request-watcher)) (file-notify-rm-watch +mu4e-lock--request-watcher))

12
modules/email/notmuch/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 #+since: 21.12.0
* Description :unfold: * Description :unfold:
This module turns Emacs into an email client using [[doom-package:][notmuch]]. This module turns Emacs into an email client using [[doom-package:notmuch]].
** Maintainers ** Maintainers
*This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]] *This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]]
@ -13,13 +13,13 @@ This module turns Emacs into an email client using [[doom-package:][notmuch]].
- +afew :: - +afew ::
Enable integration with [[https://github.com/afewmail/afew][afew]]. Enable integration with [[https://github.com/afewmail/afew][afew]].
- +org :: - +org ::
Enable [[doom-package:][org-mime]] for writing HTML emails using org-mode. Enable [[doom-package:org-mime]] for writing HTML emails using org-mode.
** Packages ** Packages
- [[doom-package:][counsel-notmuch]] if [[doom-module:][:completion ivy]] - [[doom-package:counsel-notmuch]] if [[doom-module::completion ivy]]
- [[doom-package:][helm-notmuch]] if [[doom-module:][:completion helm]] - [[doom-package:helm-notmuch]] if [[doom-module::completion helm]]
- [[doom-package:][notmuch]] - [[doom-package:notmuch]]
- [[doom-package:][org-mime]]* if [[doom-module:][+org]] - [[doom-package:org-mime]]* if [[doom-module:+org]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

2
modules/email/wanderlust/README.org
View file

@ -16,7 +16,7 @@
Enable gmail-specific configuration for mail ~To~ or ~From~ a gmail address. Enable gmail-specific configuration for mail ~To~ or ~From~ a gmail address.
** Packages ** Packages
- [[doom-package:][wanderlust]] - [[doom-package:wanderlust]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

8
modules/input/bidi/README.org
View file

@ -89,8 +89,8 @@ default input method:
** Fonts ** Fonts
Many good English fonts lack good coverage for RTL languages, especially for Many good English fonts lack good coverage for RTL languages, especially for
Hebrew and monospace fonts. To this end, we provide [[var:][+bidi-hebrew-font]] and Hebrew and monospace fonts. To this end, we provide [[var:+bidi-hebrew-font]] and
[[var:][+bidi-arabic-font]] as an easy way to override the default fonts, but only for [[var:+bidi-arabic-font]] as an easy way to override the default fonts, but only for
Hebrew and Arabic characters. They are set by default to =DejaVu Sans=, since it Hebrew and Arabic characters. They are set by default to =DejaVu Sans=, since it
has decent looking Hebrew and Arabic character support. has decent looking Hebrew and Arabic character support.
@ -109,7 +109,7 @@ If you use an RTL language the script of which isn't covered by the =hebrew= or
#+end_src #+end_src
Make sure to use the correct unicode block name, see the documentation of Make sure to use the correct unicode block name, see the documentation of
[[fn:][set-fontset-font]] for more details. [[fn:set-fontset-font]] for more details.
*** Smart Fontify *** Smart Fontify
Since good bidi fonts are often not monospace (as is the default =DejaVu Sans=), Since good bidi fonts are often not monospace (as is the default =DejaVu Sans=),
@ -138,7 +138,7 @@ insert mode after a hebrew character, in LaTeX buffers.
** Nastaliq font display bug ** Nastaliq font display bug
If Emacs is having trouble properly displaying a Nastaliq font, try using one of If Emacs is having trouble properly displaying a Nastaliq font, try using one of
[[https://urdufonts.net/fonts/jameel-noori-nastaleeq-regular][these]] [[https://urdufonts.net/fonts/alvi-nastaleeq-regular][two]] fonts for [[var:][+bidi-arabic-font]]. [[https://urdufonts.net/fonts/jameel-noori-nastaleeq-regular][these]] [[https://urdufonts.net/fonts/alvi-nastaleeq-regular][two]] fonts for [[var:+bidi-arabic-font]].
* Frequently asked questions * Frequently asked questions
/This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]] /This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]

10
modules/input/chinese/README.org
View file

@ -14,11 +14,11 @@ methods: Pinyin and Wubi.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][ace-pinyin]] - [[doom-package:ace-pinyin]]
- [[doom-package:][chinese-wbim]] if [[doom-module:][+wubi]] - [[doom-package:chinese-wbim]] if [[doom-module:+wubi]]
- [[doom-package:][fcitx]] - [[doom-package:fcitx]]
- [[doom-package:][pangu-spacing]] - [[doom-package:pangu-spacing]]
- [[doom-package:][pyim]] unless [[doom-module:][+wubi]] - [[doom-package:pyim]] unless [[doom-module:+wubi]]
** Hacks ** Hacks
- ~org-html-paragraph~ has been modified to join consecutive Chinese lines into - ~org-html-paragraph~ has been modified to join consecutive Chinese lines into

8
modules/input/japanese/README.org
View file

@ -13,10 +13,10 @@ This module adds support for Japanese script.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][avy-migemo]] - [[doom-package:avy-migemo]]
- [[doom-package:][ddskk]] - [[doom-package:ddskk]]
- [[doom-package:][migemo]] - [[doom-package:migemo]]
- [[doom-package:][pangu-spacing]] - [[doom-package:pangu-spacing]]
** Hacks ** Hacks
- ~org-html-paragraph~ has been modified to join consecutive Chinese lines into - ~org-html-paragraph~ has been modified to join consecutive Chinese lines into

6
modules/input/layout/README.org
View file

@ -57,7 +57,7 @@ Support for the bépo layout includes:
- Bind [[kbd:][`~]] functions to [[kbd:][$#]] keys when possible - Bind [[kbd:][`~]] functions to [[kbd:][$#]] keys when possible
*** Easymotion *** Easymotion
If you use [[doom-package:][evil-easymotion]], then all the bindings that were on [[kbd:][gs]] have been If you use [[doom-package:evil-easymotion]], then all the bindings that were on [[kbd:][gs]] have been
moved to [[kbd:][gé]]. moved to [[kbd:][gé]].
In short : [[kbd:][g s j]] -> [[kbd:][g é t]] (~evilem-motion-next-line~). And so on. In short : [[kbd:][g s j]] -> [[kbd:][g é t]] (~evilem-motion-next-line~). And so on.
@ -93,7 +93,7 @@ key in the bépo layout. Finding a way to use [[kbd:][é]] or even [[kbd:][è]]
a welcome change a welcome change
*** Org-mode *** Org-mode
[[doom-package:][evil-org]] allows to define ~evil-org-movement-bindings~ to automatically map [[doom-package:evil-org]] allows to define ~evil-org-movement-bindings~ to automatically map
movement bindings on non-hjkl keys. It maps automatically keys to [[kbd:][C-c]] and [[kbd:][C-r]] in movement bindings on non-hjkl keys. It maps automatically keys to [[kbd:][C-c]] and [[kbd:][C-r]] in
normal and insert states though, and it's not really user friendly in Emacs to normal and insert states though, and it's not really user friendly in Emacs to
remap those. remap those.
@ -123,7 +123,7 @@ key that does not need a curl.
** Outstanding issues (contributions welcome) ** Outstanding issues (contributions welcome)
*** Bépo *** Bépo
- In [[doom-package:][eshell]], the key [[kbd:][c]] is still bound to ~evil-collection-eshell-evil-change~ in - In [[doom-package:eshell]], the key [[kbd:][c]] is still bound to ~evil-collection-eshell-evil-change~ in
normal mode. normal mode.
** How to investigate an issue ? ** How to investigate an issue ?

8
modules/lang/agda/README.org
View file

@ -15,12 +15,12 @@ exists directly in the agda repository, but not in melpa.
Use the =agda-mode= executable that comes with your local =agda= install. Use the =agda-mode= executable that comes with your local =agda= install.
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- unless [[doom-module:][+local]] - unless [[doom-module:+local]]
- [[doom-package:][agda-input]] - [[doom-package:agda-input]]
- [[doom-package:][agda2-mode]] - [[doom-package:agda2-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

6
modules/lang/beancount/README.org
View file

@ -14,15 +14,15 @@ you [[https://plaintextaccounting.org/][manage your money in plain text]].
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~beancount-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~beancount-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/polarmutex/beancount-language-server][beancount-language-server]]). (supports [[https://github.com/polarmutex/beancount-language-server][beancount-language-server]]).
** Packages ** Packages
- [[doom-package:][beancount]] - [[doom-package:beancount]]
** Hacks ** Hacks
- Associates the material =attach_money= icon with =*.beancount= files in the - Associates the material =attach_money= icon with =*.beancount= files in the
[[doom-package:][all-the-icons]] package. [[doom-package:all-the-icons]] package.
** TODO Changelog ** TODO Changelog
# This section will be machine generated. Don't edit it by hand. # This section will be machine generated. Don't edit it by hand.

48
modules/lang/cc/README.org
View file

@ -21,33 +21,33 @@ This module adds support for the C-family of languages: C, C++, and Objective-C.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~c-mode~, ~c++-mode~, and ~objc-mode~. Requires [[doom-module:][:tools Enable LSP support for ~c-mode~, ~c++-mode~, and ~objc-mode~. Requires [[doom-module::tools
lsp]] and a langserver (supports ccls, clangd, and cquery). Replaces irony & lsp]] and a langserver (supports ccls, clangd, and cquery). Replaces irony &
rtags. rtags.
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][cmake-mode]] - [[doom-package:cmake-mode]]
- [[doom-package:][company-glsl]] - [[doom-package:company-glsl]]
- [[doom-package:][cuda-mode]] - [[doom-package:cuda-mode]]
- [[doom-package:][demangle-mode]] - [[doom-package:demangle-mode]]
- [[doom-package:][disaster]] - [[doom-package:disaster]]
- [[doom-package:][glsl-mode]] - [[doom-package:glsl-mode]]
- [[doom-package:][modern-cpp-font-lock]] - [[doom-package:modern-cpp-font-lock]]
- [[doom-package:][opencl-mode]] - [[doom-package:opencl-mode]]
- if [[doom-module:][+lsp]] - if [[doom-module:+lsp]]
- [[doom-package:][ccls]] if [[doom-module:][:tools lsp -eglot]] - [[doom-package:ccls]] if [[doom-module::tools lsp -eglot]]
- else - else
- [[doom-package:][company-irony]] - [[doom-package:company-irony]]
- [[doom-package:][company-irony-c-headers]] - [[doom-package:company-irony-c-headers]]
- [[doom-package:][flycheck-irony]] - [[doom-package:flycheck-irony]]
- [[doom-package:][helm-rtags]] if [[doom-module:][:completion helm]] - [[doom-package:helm-rtags]] if [[doom-module::completion helm]]
- [[doom-package:][irony]] - [[doom-package:irony]]
- [[doom-package:][irony-eldoc]] - [[doom-package:irony-eldoc]]
- [[doom-package:][ivy-rtags]] if [[doom-module:][:completion ivy]] - [[doom-package:ivy-rtags]] if [[doom-module::completion ivy]]
- [[doom-package:][rtags]] - [[doom-package:rtags]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -61,8 +61,8 @@ This module adds support for the C-family of languages: C, C++, and Objective-C.
This module's requirements change depending on how you use it. This module's requirements change depending on how you use it.
- If [[doom-module:][+lsp]] is enabled, you need one of *clangd v9+* or *ccls*. - If [[doom-module:+lsp]] is enabled, you need one of *clangd v9+* or *ccls*.
- If [[doom-module:][+lsp]] is *not* enabled, you need *irony-server* and *rtags*. - If [[doom-module:+lsp]] is *not* enabled, you need *irony-server* and *rtags*.
- Other features in this module depend on: - Other features in this module depend on:
- (optional) glslangValidator, for GLSL completion in ~glsl-mode~ - (optional) glslangValidator, for GLSL completion in ~glsl-mode~
- (optional) cmake, for code completion in ~cmake-mode~ - (optional) cmake, for code completion in ~cmake-mode~
@ -146,7 +146,7 @@ rc -J $PROJECT_ROOT # loads PROJECT_ROOT's compile_commands.json
4. Run ~$ doom sync~ on the command line and restart Emacs. 4. Run ~$ doom sync~ on the command line and restart Emacs.
** Eglot-specific bindings ** Eglot-specific bindings
When using [[doom-module:][+lsp]] and [[doom-module:][:tools lsp +eglot]], [[doom-package:][lsp-mode]] is replaced with [[doom-package:][eglot]], and an When using [[doom-module:+lsp]] and [[doom-module::tools lsp +eglot]], [[doom-package:lsp-mode]] is replaced with [[doom-package:eglot]], and an
additional function to get inheritance type hierarchy is added: additional function to get inheritance type hierarchy is added:
| Binding | Description | | Binding | Description |
|----------------------------+------------------------------------------------| |----------------------------+------------------------------------------------|
@ -219,7 +219,7 @@ Additional info:
** Configure LSP servers ** Configure LSP servers
Search for your combination of =(LSP client package, LSP server)=. You are using Search for your combination of =(LSP client package, LSP server)=. You are using
[[doom-package:][lsp-mode]] by default, [[doom-package:][eglot]] if you have [[doom-module:][:tools lsp +eglot]] active in [[doom-package:lsp-mode]] by default, [[doom-package:eglot]] if you have [[doom-module::tools lsp +eglot]] active in
=$DOOMDIR/init.el= file. =$DOOMDIR/init.el= file.
*** LSP-mode with clangd *** LSP-mode with clangd

10
modules/lang/clojure/README.org
View file

@ -18,13 +18,13 @@ This module adds support for the Clojure(Script) language.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~clojure-mode~ (alongside Cider). Requires [[doom-module:][:tools lsp]] Enable LSP support for ~clojure-mode~ (alongside Cider). Requires [[doom-module::tools lsp]]
and a langserver (supports [[https://clojure-lsp.io/][clojure-lsp]]). and a langserver (supports [[https://clojure-lsp.io/][clojure-lsp]]).
** Packages ** Packages
- [[doom-package:][cider]] - [[doom-package:cider]]
- [[doom-package:][clj-refactor]] - [[doom-package:clj-refactor]]
- [[doom-package:][flycheck-clj-kondo]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-clj-kondo]] if [[doom-module::checkers syntax]]
** Hacks ** Hacks
- Error messages emitted from CIDER are piped into the REPL buffer when it is - Error messages emitted from CIDER are piped into the REPL buffer when it is
@ -42,7 +42,7 @@ This module requires:
- [[https://clojure.org/][clojure]] - [[https://clojure.org/][clojure]]
- [[https://leiningen.org/][leiningen]], for the REPL - [[https://leiningen.org/][leiningen]], for the REPL
- [[https://github.com/borkdude/clj-kondo][clj-kondo]], for linting code - [[https://github.com/borkdude/clj-kondo][clj-kondo]], for linting code
- [[https://clojure-lsp.github.io/clojure-lsp/][clojure-lsp]], for LSP support (if [[doom-module:][+lsp]]) - [[https://clojure-lsp.github.io/clojure-lsp/][clojure-lsp]], for LSP support (if [[doom-module:+lsp]])
* TODO Usage * TODO Usage
#+begin_quote #+begin_quote

10
modules/lang/common-lisp/README.org
View file

@ -4,7 +4,7 @@
#+since: 21.12.0 #+since: 21.12.0
* Description :unfold: * Description :unfold:
This module provides support for [[https://lisp-lang.org/][Common Lisp]] and the [[doom-package:][Sly]] development This module provides support for [[https://lisp-lang.org/][Common Lisp]] and the [[doom-package:Sly]] development
environment. Common Lisp is not a single language but a specification, with many environment. Common Lisp is not a single language but a specification, with many
competing compiler implementations. By default, [[http://www.sbcl.org/][Steel Bank Common Lisp]] (SBCL) is competing compiler implementations. By default, [[http://www.sbcl.org/][Steel Bank Common Lisp]] (SBCL) is
assumed to be installed, but this can be configured. assumed to be installed, but this can be configured.
@ -21,9 +21,9 @@ to run unmodified for a long time.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][sly]] - [[doom-package:sly]]
- [[doom-package:][sly-macrostep]] - [[doom-package:sly-macrostep]]
- [[doom-package:][sly-repl-ansi-color]] - [[doom-package:sly-repl-ansi-color]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -42,7 +42,7 @@ This module requires [[http://www.sbcl.org/][SBCL]].
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
This module does not integrate with [[doom-module:][:tools lsp]]. Sly (and SLIME before it) is This module does not integrate with [[doom-module::tools lsp]]. Sly (and SLIME before it) is
considered the defacto development environment for Common Lisp and provides much considered the defacto development environment for Common Lisp and provides much
of what is normally expected of an LSP, plus tight integration with the REPL and of what is normally expected of an LSP, plus tight integration with the REPL and
Emacs. Emacs.

4
modules/lang/coq/README.org
View file

@ -16,8 +16,8 @@ This module adds [[https://coq.inria.fr][coq]] support, powered by [[https://pro
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][proof-general]] - [[doom-package:proof-general]]
- [[doom-package:][company-coq]] - [[doom-package:company-coq]]
** Hacks ** Hacks
+ Replaces coq-mode abbrevs with yasnippet snippets from doom's snippet library + Replaces coq-mode abbrevs with yasnippet snippets from doom's snippet library

10
modules/lang/crystal/README.org
View file

@ -16,11 +16,11 @@ This module has no dedicated maintainers.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][crystal-mode]] - [[doom-package:crystal-mode]]
- [[doom-package:][inf-crystal]] - [[doom-package:inf-crystal]]
- if [[doom-module:][:checkers syntax]] - if [[doom-module::checkers syntax]]
- [[doom-package:][flycheck-ameba]] - [[doom-package:flycheck-ameba]]
- [[doom-package:][flycheck-crystal]] - [[doom-package:flycheck-crystal]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

16
modules/lang/csharp/README.org
View file

@ -14,21 +14,21 @@ LSP).
- +dotnet :: - +dotnet ::
Enable Dotnet transient interface with Sharper Enable Dotnet transient interface with Sharper
- +lsp :: - +lsp ::
Enable LSP support for ~csharp-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~csharp-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports =omnisharp-roslyn=). (supports =omnisharp-roslyn=).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
- +unity :: - +unity ::
Enable special support for the [[https://unity.com/][Unity game engine]] (particularly, support for Enable special support for the [[https://unity.com/][Unity game engine]] (particularly, support for
HLSL shaders). HLSL shaders).
** Packages ** Packages
- [[doom-package:][csharp-mode]] - [[doom-package:csharp-mode]]
- [[doom-package:][csproj-mode]] - [[doom-package:csproj-mode]]
- [[doom-package:][shader-mode]] if [[doom-module:][+unity]] - [[doom-package:shader-mode]] if [[doom-module:+unity]]
- [[doom-package:][sharper]] if [[doom-module:][+dotnet]] - [[doom-package:sharper]] if [[doom-module:+dotnet]]
- [[doom-package:][sln-mode]] - [[doom-package:sln-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -44,7 +44,7 @@ This module requires:
- Mono (on UNIX platforms) - Mono (on UNIX platforms)
- .NET SDKs (on Windows) - .NET SDKs (on Windows)
- .NET Core 1.X - 3.X or .NET 5 for cross platform - .NET Core 1.X - 3.X or .NET 5 for cross platform
- omnisharp-rosyln (if [[doom-module:][+lsp]]) - omnisharp-rosyln (if [[doom-module:+lsp]])
** TODO MacOS ** TODO MacOS

10
modules/lang/dart/README.org
View file

@ -21,13 +21,13 @@ This module wraps ~dart-mode~, with [[https://microsoft.github.io/language-serve
Enable ~flutter~ integration and some sane defaults for Flutter development Enable ~flutter~ integration and some sane defaults for Flutter development
along with ~hover~ for desktop development. along with ~hover~ for desktop development.
- +lsp :: - +lsp ::
Enable LSP support for ~dart-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~dart-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports flutter). (supports flutter).
** Packages ** Packages
- [[doom-package:][dart-mode]] - [[doom-package:dart-mode]]
- [[doom-package:][flutter.el]] - [[doom-package:flutter.el]]
- [[doom-package:][hover.el]] - [[doom-package:hover.el]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -92,7 +92,7 @@ flutter doctor # for Dependency check and further instructions
- Widget guide lines for Flutter. - Widget guide lines for Flutter.
- Closing labels for constructors. - Closing labels for constructors.
- Run tests interactively. - Run tests interactively.
- Outline support via [[doom-package:][lsp-treemacs]]. - Outline support via [[doom-package:lsp-treemacs]].
- Emacs functions for running and debugging Flutter projects. - Emacs functions for running and debugging Flutter projects.
* TODO Configuration * TODO Configuration

2
modules/lang/data/README.org
View file

@ -13,7 +13,7 @@ This module adds Emacs support for CSV and XML files.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][csv-mode]] - [[doom-package:csv-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

2
modules/lang/dhall/README.org
View file

@ -16,7 +16,7 @@ functions + types + imports.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][dhall-mode]] - [[doom-package:dhall-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

24
modules/lang/elixir/README.org
View file

@ -4,7 +4,7 @@
#+since: 2.0.3 (#83) #+since: 2.0.3 (#83)
* Description :unfold: * Description :unfold:
This module provides support for [[https://elixir-lang.org/][Elixir programming language]] via [[doom-package:][alchemist]] or This module provides support for [[https://elixir-lang.org/][Elixir programming language]] via [[doom-package:alchemist]] or
[[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]]. [[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]].
** Maintainers ** Maintainers
@ -12,17 +12,17 @@ This module provides support for [[https://elixir-lang.org/][Elixir programming
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~elixir-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~elixir-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]]). (supports [[https://github.com/elixir-lsp/elixir-ls/][elixir-ls]]).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][alchemist]] - [[doom-package:alchemist]]
- [[doom-package:][elixir-mode]] - [[doom-package:elixir-mode]]
- [[doom-package:][exunit]] - [[doom-package:exunit]]
- [[doom-package:][flycheck-credo]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-credo]] if [[doom-module::checkers syntax]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -37,7 +37,7 @@ This module provides support for [[https://elixir-lang.org/][Elixir programming
This module requires Elixir. Install it via your distribution's package manager This module requires Elixir. Install it via your distribution's package manager
or a version management tool such as [[https://github.com/asdf-vm/asdf-elixir][asdf]]. or a version management tool such as [[https://github.com/asdf-vm/asdf-elixir][asdf]].
To add LSP support, install [[https://github.com/JakeBecker/elixir-ls/][elixir-ls]] and enable [[doom-module:][:tools lsp]]. To add LSP support, install [[https://github.com/JakeBecker/elixir-ls/][elixir-ls]] and enable [[doom-module::tools lsp]].
To support linting with [[https://github.com/rrrene/credo][credo]], add ~:checkers syntax~ to ~$DOOMDIR/init.el~. To support linting with [[https://github.com/rrrene/credo][credo]], add ~:checkers syntax~ to ~$DOOMDIR/init.el~.
@ -70,12 +70,12 @@ zypper install elixir
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
- Code completion ([[doom-module:][:completion company]]) - Code completion ([[doom-module::completion company]])
- Documentation lookup ([[doom-module:][:tools lookup]]) - Documentation lookup ([[doom-module::tools lookup]])
- Mix integration - Mix integration
- Phoenix support - Phoenix support
- ~iex~ integration ([[doom-module:][:tools eval]]) - ~iex~ integration ([[doom-module::tools eval]])
- Syntax checking ([[doom-module:][:checkers syntax]], using [[doom-package:][flycheck-credo]]) - Syntax checking ([[doom-module::checkers syntax]], using [[doom-package:flycheck-credo]])
** exunit-mode ** exunit-mode
The exunit-mode prefix is [[kbd:][<localleader> t]]. Here is some examples: The exunit-mode prefix is [[kbd:][<localleader> t]]. Here is some examples:

10
modules/lang/elm/README.org
View file

@ -11,15 +11,15 @@ This module adds [[https://elm-lang.org/][Elm]] support to Doom Emacs.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~elm-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~elm-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/elm-tooling/elm-language-server][elm-language-server]]). (supports [[https://github.com/elm-tooling/elm-language-server][elm-language-server]]).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][elm-mode]] - [[doom-package:elm-mode]]
- [[doom-package:][flycheck-elm]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-elm]] if [[doom-module::checkers syntax]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -35,7 +35,7 @@ This module adds [[https://elm-lang.org/][Elm]] support to Doom Emacs.
🔨 /This module's prerequisites are not all documented./ [[doom-contrib-module:][Document them?]] 🔨 /This module's prerequisites are not all documented./ [[doom-contrib-module:][Document them?]]
#+end_quote #+end_quote
- If [[doom-module:][+lsp]] is enabled, [[https://github.com/elm-tooling/elm-language-server][elm-language-server]] is required to be installed and in - If [[doom-module:+lsp]] is enabled, [[https://github.com/elm-tooling/elm-language-server][elm-language-server]] is required to be installed and in
your =$PATH=. your =$PATH=.
* TODO Usage * TODO Usage

18
modules/lang/emacs-lisp/README.org
View file

@ -9,7 +9,7 @@ This module extends support for Emacs Lisp in Doom Emacs.
- Macro expansion - Macro expansion
- Go-to-definitions or references functionality - Go-to-definitions or references functionality
- Syntax highlighting for defined and quoted symbols - Syntax highlighting for defined and quoted symbols
- Replaces the built-in help with the more powerful [[doom-package:][helpful]] - Replaces the built-in help with the more powerful [[doom-package:helpful]]
- Adds function example uses to documentation - Adds function example uses to documentation
** Maintainers ** Maintainers
@ -21,14 +21,14 @@ This module extends support for Emacs Lisp in Doom Emacs.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][buttercup]] - [[doom-package:buttercup]]
- [[doom-package:][elisp-def]] - [[doom-package:elisp-def]]
- [[doom-package:][elisp-demos]] - [[doom-package:elisp-demos]]
- [[doom-package:][flycheck-cask]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-cask]] if [[doom-module::checkers syntax]]
- [[doom-package:][flycheck-package]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-package]] if [[doom-module::checkers syntax]]
- [[doom-package:][highlight-quoted]] - [[doom-package:highlight-quoted]]
- [[doom-package:][macrostep]] - [[doom-package:macrostep]]
- [[doom-package:][overseer]] - [[doom-package:overseer]]
** Hacks ** Hacks
- Symbols that are defined in the current session are highlighted with - Symbols that are defined in the current session are highlighted with

10
modules/lang/erlang/README.org
View file

@ -8,20 +8,20 @@ This module provides support [[https://www.erlang.org/][Erlang programming langu
[[https://github.com/erlang/sourcer][sourcer]] language server is optional. [[https://github.com/erlang/sourcer][sourcer]] language server is optional.
Includes: Includes:
- Code completion ([[doom-module:][+lsp]], [[doom-module:][:completion company]], & [[doom-module:][:completion ivy]]) - Code completion ([[doom-module:+lsp]], [[doom-module::completion company]], & [[doom-module::completion ivy]])
- Syntax checking ([[doom-module:][:checkers syntax]]) - Syntax checking ([[doom-module::checkers syntax]])
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~erlang-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~erlang-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/erlang/sourcer][sourcer]]). (supports [[https://github.com/erlang/sourcer][sourcer]]).
** Packages ** Packages
- [[doom-package:][flycheck-rebar3]] - [[doom-package:flycheck-rebar3]]
- [[doom-package:][ivy-erlang-complete]] - [[doom-package:ivy-erlang-complete]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

20
modules/lang/ess/README.org
View file

@ -15,15 +15,15 @@ SAS, Julia and Stata.
Enable support for ~stan-mode~, including code completion and syntax checking. Enable support for ~stan-mode~, including code completion and syntax checking.
** Packages ** Packages
- [[doom-package:][ess]] - [[doom-package:ess]]
- [[doom-package:][ess-R-data-view]] - [[doom-package:ess-R-data-view]]
- [[doom-package:][polymode]] - [[doom-package:polymode]]
- [[doom-package:][poly-R]] - [[doom-package:poly-R]]
- if [[doom-module:][+stan]] - if [[doom-module:+stan]]
- [[doom-package:][company-stan]] if [[doom-module:][:completion company]] - [[doom-package:company-stan]] if [[doom-module::completion company]]
- [[doom-package:][eldoc-stan]] - [[doom-package:eldoc-stan]]
- [[doom-package:][flycheck-stan]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-stan]] if [[doom-module::checkers syntax]]
- [[doom-package:][stan-mode]] - [[doom-package:stan-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -38,7 +38,7 @@ SAS, Julia and Stata.
This module has several optional dependencies: This module has several optional dependencies:
- [[https://github.com/jimhester/lintr][lintr]]: for R linting. - [[https://github.com/jimhester/lintr][lintr]]: for R linting.
- [[https://github.com/REditorSupport/languageserver][languageserver]]: for LSP support in an R buffer (with [[doom-module:][+lsp]] flag). - [[https://github.com/REditorSupport/languageserver][languageserver]]: for LSP support in an R buffer (with [[doom-module:+lsp]] flag).
* TODO Usage * TODO Usage
#+begin_quote #+begin_quote

2
modules/lang/factor/README.org
View file

@ -5,7 +5,7 @@
* Description :unfold: * Description :unfold:
This module adds support to the [[https://github.com/factor/factor][factor]] programming language and its associated This module adds support to the [[https://github.com/factor/factor][factor]] programming language and its associated
[[doom-package:][fuel]] emacs plugin. [[doom-package:fuel]] emacs plugin.
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]

6
modules/lang/faust/README.org
View file

@ -20,17 +20,17 @@ Add support to [[https://faust.grame.fr/][Faust language]] inside emacs.
shortcuts, etc.) shortcuts, etc.)
- Automatic keyword completion (if Auto-Complete is installed) - Automatic keyword completion (if Auto-Complete is installed)
- Automatic objets (functions, operators, etc.) template insertion with default - Automatic objets (functions, operators, etc.) template insertion with default
sensible values (if [[doom-module:][:editor snippets]] is enabled) sensible values (if [[doom-module::editor snippets]] is enabled)
- Modeline indicator of the state of the code - Modeline indicator of the state of the code
** Maintainers ** Maintainers
*This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]] *This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]]
** Packages ** Packages
- [[doom-package:][faustine]] - [[doom-package:faustine]]
** Hacks ** Hacks
- Both ~faust-mode~ and ~faustine-mode~ are hardcoded to use [[doom-package:][auto-complete]], - Both ~faust-mode~ and ~faustine-mode~ are hardcoded to use [[doom-package:auto-complete]],
which Doom does not use. Its obnoxious 'You really should install and use which Doom does not use. Its obnoxious 'You really should install and use
auto-complete' warnings have been silenced. auto-complete' warnings have been silenced.

6
modules/lang/fortran/README.org
View file

@ -17,7 +17,7 @@ In particular, this module features:
- Auto-formatting via =fprettier=. - Auto-formatting via =fprettier=.
- Integration with the =fpm= package manager. - Integration with the =fpm= package manager.
- LSP support via [[https://github.com/gnikit/fortls][fortls]]. - LSP support via [[https://github.com/gnikit/fortls][fortls]].
- Optional Intel Fortran support via the [[doom-module:][+intel]] flag. - Optional Intel Fortran support via the [[doom-module:+intel]] flag.
#+begin_quote #+begin_quote
💬 After a career of writing Fortran on Mainframes and Windows machines, my 💬 After a career of writing Fortran on Mainframes and Windows machines, my
@ -33,7 +33,7 @@ In particular, this module features:
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~fortran-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~fortran-mode~. Requires [[doom-module::tools lsp]] and a langserver
(fortls). (fortls).
- +intel :: - +intel ::
Use the =ifort= compiler by default. Use the =ifort= compiler by default.
@ -68,7 +68,7 @@ $ sudo aura -A fortran-fpm fortls
#+end_src bash #+end_src bash
** Installing Intel Fortran ** Installing Intel Fortran
Activating the [[doom-module:][+intel]] flag won't automatically install Intel Fortan for you. Activating the [[doom-module:+intel]] flag won't automatically install Intel Fortan for you.
Here's how to do it on *nix systems. Here's how to do it on *nix systems.
You can of course install the entire High-performance Computing kit from Intel, You can of course install the entire High-performance Computing kit from Intel,

6
modules/lang/fsharp/README.org
View file

@ -16,12 +16,12 @@ This module adds [[https://fsharp.org/][F#]] support to Doom Emacs.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~fsharp-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~fsharp-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/emacs-lsp/lsp-mode/blob/master/clients/lsp-fsharp.el][lsp-fsharp]].). (supports [[https://github.com/emacs-lsp/lsp-mode/blob/master/clients/lsp-fsharp.el][lsp-fsharp]].).
** Packages ** Packages
- [[doom-package:][fsharp-mode]] - [[doom-package:fsharp-mode]]
- [[doom-package:][lsp-fsharp]] if [[doom-package:][+lsp]] - [[doom-package:lsp-fsharp]] if [[doom-package:+lsp]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

2
modules/lang/fstar/README.org
View file

@ -20,7 +20,7 @@ This module adds [[https://fstar-lang.org/][F*]] support, powered by [[https://g
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][fstar-mode]] - [[doom-package:fstar-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

8
modules/lang/gdscript/README.org
View file

@ -12,11 +12,11 @@ engine, to Doom Emacs, powered by [[https://github.com/GDQuest/emacs-gdscript-mo
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~gdscript-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~gdscript-mode~. Requires [[doom-module::tools lsp]] and a langserver
(Godot ~3.2.1~ or newer). (Godot ~3.2.1~ or newer).
** Packages ** Packages
- [[doom-package:][gdscript-mode]] - [[doom-package:gdscript-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -47,7 +47,7 @@ pip3 install gdtoolkit
** LSP support ** LSP support
The language server support for GDScript is built into by lsp-mode. As long as The language server support for GDScript is built into by lsp-mode. As long as
you have [[doom-module:][+lsp]] and [[doom-module:][:tools lsp]] enabled, and Godot 3.2.1+ installed, it should work you have [[doom-module:+lsp]] and [[doom-module::tools lsp]] enabled, and Godot 3.2.1+ installed, it should work
out of the box. out of the box.
Godot's language server is built into the game engine, so you need to open your Godot's language server is built into the game engine, so you need to open your
@ -67,7 +67,7 @@ available commands.
[[doom-report:][Report an issue?]] [[doom-report:][Report an issue?]]
- The GDScript language server has known issues causing some errors with - The GDScript language server has known issues causing some errors with
[[doom-package:][lsp-mode]]. They should be addressed in future releases. [[doom-package:lsp-mode]]. They should be addressed in future releases.
* Frequently asked questions * Frequently asked questions
/This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]] /This module has no FAQs yet./ [[doom-suggest-faq:][Ask one?]]

22
modules/lang/go/README.org
View file

@ -12,7 +12,7 @@ This module adds [[https://golang.org][Go]] support, with optional (but recommen
- Eldoc support (~go-eldoc~) - Eldoc support (~go-eldoc~)
- REPL (~gore~) - REPL (~gore~)
- Syntax-checking (~flycheck~) - Syntax-checking (~flycheck~)
- Auto-formatting on save (~gofmt~) (requires [[doom-module:][:editor format +onsave]]) - Auto-formatting on save (~gofmt~) (requires [[doom-module::editor format +onsave]])
- Code navigation & refactoring (~go-guru~) - Code navigation & refactoring (~go-guru~)
- [[../../editor/file-templates/templates/go-mode][File templates]] - [[../../editor/file-templates/templates/go-mode][File templates]]
- [[https://github.com/hlissner/doom-snippets/tree/master/go-mode][Snippets]] - [[https://github.com/hlissner/doom-snippets/tree/master/go-mode][Snippets]]
@ -24,22 +24,22 @@ This module adds [[https://golang.org][Go]] support, with optional (but recommen
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~go-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~go-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports gopls). Highly recommended, as the non-LSP experience is deprecated (supports gopls). Highly recommended, as the non-LSP experience is deprecated
(and poor). (and poor).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][company-go]] if [[doom-module:][:completion company]] (DEPRECATED) - [[doom-package:company-go]] if [[doom-module::completion company]] (DEPRECATED)
- [[doom-package:][flycheck-golangci-lint]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-golangci-lint]] if [[doom-module::checkers syntax]]
- [[doom-package:][go-eldoc]] - [[doom-package:go-eldoc]]
- [[doom-package:][go-gen-test]] - [[doom-package:go-gen-test]]
- [[doom-package:][go-guru]] - [[doom-package:go-guru]]
- [[doom-package:][go-mode]] - [[doom-package:go-mode]]
- [[doom-package:][gorepl-mode]] - [[doom-package:gorepl-mode]]
- [[doom-package:][go-tag]] - [[doom-package:go-tag]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

14
modules/lang/graphql/README.org
View file

@ -8,14 +8,14 @@ This module adds [[https://www.graphql.org][GraphQL]] support to Doom Emacs.
It includes: It includes:
- Code completion - Code completion
- LSP support ([[doom-module:][+lsp]]) - LSP support ([[doom-module:+lsp]])
- Diagnostics (GraphQL syntax linting/validations) (spec-compliant) - Diagnostics (GraphQL syntax linting/validations) (spec-compliant)
- Autocomplete suggestions (spec-compliant) - Autocomplete suggestions (spec-compliant)
- Hyperlink to fragment definitions and named types (type, input, enum) definitions (spec-compliant) - Hyperlink to fragment definitions and named types (type, input, enum) definitions (spec-compliant)
- Outline view support for queries and SDL - Outline view support for queries and SDL
- Symbols support across the workspace - Symbols support across the workspace
- Local schema viewer - Local schema viewer
- Org-babel exporter (requires [[doom-module:][:lang org]]) - Org-babel exporter (requires [[doom-module::lang org]])
** Maintainers ** Maintainers
- [[doom-user:][@elken]] - [[doom-user:][@elken]]
@ -24,16 +24,16 @@ It includes:
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~graphql-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~graphql-mode~. Requires [[doom-module::tools lsp]] and a langserver
([[https://github.com/graphql/graphiql/tree/main/packages/graphql-language-service-cli#readme][graphql-language-service-cli]]). ([[https://github.com/graphql/graphiql/tree/main/packages/graphql-language-service-cli#readme][graphql-language-service-cli]]).
** Packages ** Packages
- [[doom-package:][company-graphql]] unless [[doom-module:][+lsp]] - [[doom-package:company-graphql]] unless [[doom-module:+lsp]]
- [[doom-package:][graphql-mode]] - [[doom-package:graphql-mode]]
- [[doom-package:][graphql-doc]] - [[doom-package:graphql-doc]]
** Hacks ** Hacks
- Added a convenience function [[fn:][+graphql-doc-open-config]] to open schema docs from - Added a convenience function [[fn:+graphql-doc-open-config]] to open schema docs from
a [[https://github.com/jimkyndemeyer/graphql-config-examples][.graphqlconfig]] file. a [[https://github.com/jimkyndemeyer/graphql-config-examples][.graphqlconfig]] file.
** TODO Changelog ** TODO Changelog

6
modules/lang/haskell/README.org
View file

@ -13,12 +13,12 @@ This module adds Haskell support to Doom Emacs.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~haskell-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~haskell-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/haskell/haskell-language-server][haskell-language-server]]). (supports [[https://github.com/haskell/haskell-language-server][haskell-language-server]]).
** Packages ** Packages
- [[doom-package:][haskell-mode]] - [[doom-package:haskell-mode]]
- [[doom-package:][lsp-haskell]] if [[doom-module:][+lsp]] - [[doom-package:lsp-haskell]] if [[doom-module:+lsp]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

2
modules/lang/hy/README.org
View file

@ -13,7 +13,7 @@
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][hy-mode]] - [[doom-package:hy-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

2
modules/lang/idris/README.org
View file

@ -13,7 +13,7 @@ This module adds rudimentary [[https://www.idris-lang.org/][Idris]] support to D
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][idris-mode]] - [[doom-package:idris-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

66
modules/lang/java/README.org
View file

@ -12,23 +12,23 @@ This module adds [[https://www.java.com][Java]] support to Doom Emacs, including
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~java-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~java-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports eclipse.jdt.ls). *Incompatible with [[doom-module:][+meghanada]].* (supports eclipse.jdt.ls). *Incompatible with [[doom-module:+meghanada]].*
- +meghanada :: - +meghanada ::
Enable [[doom-package:][meghanada-mode]]. *Incompatible with [[doom-module:][+lsp]].* Enable [[doom-package:meghanada-mode]]. *Incompatible with [[doom-module:+lsp]].*
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][android-mode]] - [[doom-package:android-mode]]
- [[doom-package:][groovy-mode]] - [[doom-package:groovy-mode]]
- [[doom-package:][meghanada]] if [[doom-module:][+meghanada]] - [[doom-package:meghanada]] if [[doom-module:+meghanada]]
- if [[doom-module:][+eclim]] - if [[doom-module:+eclim]]
- [[doom-package:][eclim]] - [[doom-package:eclim]]
- [[doom-package:][company-emacs-eclim]] if [[doom-module:][:completion company]] - [[doom-package:company-emacs-eclim]] if [[doom-module::completion company]]
- if [[doom-module:][+lsp]] and not [[doom-module:][:tools lsp +eglot]] - if [[doom-module:+lsp]] and not [[doom-module::tools lsp +eglot]]
- [[doom-package:][lsp-java]] - [[doom-package:lsp-java]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -42,7 +42,7 @@ This module adds [[https://www.java.com][Java]] support to Doom Emacs, including
This module requires: This module requires:
- [[https://www.oracle.com/java/technologies/downloads/][Java SDK]] - [[https://www.oracle.com/java/technologies/downloads/][Java SDK]]
- The LSP test runner requires [[doom-module:][:tools debugger +lsp]] (requires [[doom-package:][dap-mode]]) - The LSP test runner requires [[doom-module::tools debugger +lsp]] (requires [[doom-package:dap-mode]])
** OpenJDK 11 ** OpenJDK 11
*** Ubuntu *** Ubuntu
@ -88,14 +88,14 @@ It is common to need support for multiple Java versions. You can use a generic
tool like [[https://github.com/shyiko/jabba][jabba]] to install and manage multiple Java versions on any OS. tool like [[https://github.com/shyiko/jabba][jabba]] to install and manage multiple Java versions on any OS.
To have a different version of Java per-project, it is recommended you use To have a different version of Java per-project, it is recommended you use
[[https://github.com/direnv/direnv][direnv]] and [[doom-module:][:tools direnv]]; create a =.envrc= in the root of the project pointing [[https://github.com/direnv/direnv][direnv]] and [[doom-module::tools direnv]]; create a =.envrc= in the root of the project pointing
to the Java installation: to the Java installation:
#+begin_src sh #+begin_src sh
PATH_add ~/.jabba/jdk/adopt@1.11.0-3 PATH_add ~/.jabba/jdk/adopt@1.11.0-3
JAVA_HOME=~/.jabba/jdk/adopt@1.11.0-3 JAVA_HOME=~/.jabba/jdk/adopt@1.11.0-3
#+end_src #+end_src
And then run ~$ direnv allow .~ in the project directory. The [[doom-module:][:tools direnv]] And then run ~$ direnv allow .~ in the project directory. The [[doom-module::tools direnv]]
module will automatically source this environment before activating LSP servers. module will automatically source this environment before activating LSP servers.
* TODO Usage * TODO Usage
@ -103,23 +103,23 @@ module will automatically source this environment before activating LSP servers.
🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's usage documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
** [[doom-module:][+lsp]] features ** [[doom-module:+lsp]] features
According to [[https://github.com/emacs-lsp/lsp-java]], you get: According to [[https://github.com/emacs-lsp/lsp-java]], you get:
- As you type reporting of parsing and compilation errors (via [[doom-package:][flycheck]] or - As you type reporting of parsing and compilation errors (via [[doom-package:flycheck]] or
[[doom-package:][lsp-ui]]) [[doom-package:lsp-ui]])
- Code completion ([[doom-package:][company-lsp]] or complete-at-point) - Code completion ([[doom-package:company-lsp]] or complete-at-point)
- Javadoc hovers ([[doom-package:][lsp-ui]]) - Javadoc hovers ([[doom-package:lsp-ui]])
- Code actions ([[doom-package:][lsp-ui]]) - Code actions ([[doom-package:lsp-ui]])
- Code outline ([[doom-package:][imenu]]) - Code outline ([[doom-package:imenu]])
- Code navigation ([[doom-package:][xref]]) - Code navigation ([[doom-package:xref]])
- Code lens for references/implementations ([[doom-package:][xref]]) - Code lens for references/implementations ([[doom-package:xref]])
- Highlights - Highlights
- Code formatting - Code formatting
- Maven pom.xml project support - Maven pom.xml project support
- Limited Gradle support - Limited Gradle support
- Visual debugger ([[doom-package:][dap-mode]]) - Visual debugger ([[doom-package:dap-mode]])
- Test runner ([[doom-package:][dap-mode]]) - Test runner ([[doom-package:dap-mode]])
- Project explorer integration ([[doom-package:][treemacs]]) - Project explorer integration ([[doom-package:treemacs]])
- Integration with [[https://start.spring.io/][Spring Initializr]] - Integration with [[https://start.spring.io/][Spring Initializr]]
** =+meghanada= features ** =+meghanada= features
@ -129,14 +129,14 @@ According to [[https://github.com/mopemope/meghanada-emacs/]], you get:
- No need build tool's plugin - No need build tool's plugin
- Run build tool task - Run build tool task
- Compile your project - Compile your project
- Syntax check and analyze java source ([[doom-package:][flycheck-meghanada]]) - Syntax check and analyze java source ([[doom-package:flycheck-meghanada]])
- Support =Generic Types= - Support =Generic Types=
- Code completion with [[doom-package:][company-mode]] ([[doom-package:][company-meghanada]]) - Code completion with [[doom-package:company-mode]] ([[doom-package:company-meghanada]])
- Optimize import and sort - Optimize import and sort
- Jump declaration - Jump declaration
- Run [[http://www.junit.org/][JUnit]] test (include test runner) - Run [[http://www.junit.org/][JUnit]] test (include test runner)
- Diagnostic reporting with [[doom-package:][flycheck]] ([[doom-package:][flycheck-meghanada]]) - Diagnostic reporting with [[doom-package:flycheck]] ([[doom-package:flycheck-meghanada]])
- Show symbol's type info with [[doom-package:][eldoc]] - Show symbol's type info with [[doom-package:eldoc]]
- Search references - Search references
- Full-featured text search - Full-featured text search
@ -145,7 +145,7 @@ According to [[https://github.com/mopemope/meghanada-emacs/]], you get:
🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
** [[doom-module:][+lsp]] ** [[doom-module:+lsp]]
Install the eclipse server by executing ~M-x lsp-install-server~ and selecting Install the eclipse server by executing ~M-x lsp-install-server~ and selecting
=jdtls=. After that any newly opened =java= files should start the LSP server =jdtls=. After that any newly opened =java= files should start the LSP server
automatically. automatically.
@ -156,7 +156,7 @@ Note that if you change Java version you may need to remove the LSP server and
install it again. You can do this with ~M-x +lsp/uninstall-server~ followed by install it again. You can do this with ~M-x +lsp/uninstall-server~ followed by
~M-x lsp-install-server~. ~M-x lsp-install-server~.
Enable the [[doom-module:][:tools debugger +lsp]] module to get test runner support. Enable the [[doom-module::tools debugger +lsp]] module to get test runner support.
* Troubleshooting * Troubleshooting
/There are no known problems with this module./ [[doom-report:][Report one?]] /There are no known problems with this module./ [[doom-report:][Report one?]]

32
modules/lang/javascript/README.org
View file

@ -6,13 +6,13 @@
* Description :unfold: * Description :unfold:
This module adds [[https://www.javascript.com/][JavaScript]] and [[https://www.typescriptlang.org/][TypeScript]] support to Doom Emacs. This module adds [[https://www.javascript.com/][JavaScript]] and [[https://www.typescriptlang.org/][TypeScript]] support to Doom Emacs.
- Code completion ([[doom-package:][tide]]) - Code completion ([[doom-package:tide]])
- REPL support ([[doom-package:][nodejs-repl]]) - REPL support ([[doom-package:nodejs-repl]])
- Refactoring commands ([[doom-package:][js2-refactor]]) - Refactoring commands ([[doom-package:js2-refactor]])
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Browser code injection with [[doom-package:][skewer-mode]] - Browser code injection with [[doom-package:skewer-mode]]
- Coffeescript & JSX support - Coffeescript & JSX support
- Jump-to-definitions and references support ([[doom-package:][xref]]) - Jump-to-definitions and references support ([[doom-package:xref]])
** Maintainers ** Maintainers
- [[doom-user:][@elken]] - [[doom-user:][@elken]]
@ -24,21 +24,21 @@ This module adds [[https://www.javascript.com/][JavaScript]] and [[https://www.t
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~js2-mode~, ~rjsx-mode~, JS in ~web-mode~, and Enable LSP support for ~js2-mode~, ~rjsx-mode~, JS in ~web-mode~, and
~typescript-mode~. Requires [[doom-module:][:tools lsp]] and a langserver (supports ts-ls and ~typescript-mode~. Requires [[doom-module::tools lsp]] and a langserver (supports ts-ls and
deno-ls). deno-ls).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][js2-refactor]] - [[doom-package:js2-refactor]]
- [[doom-package:][nodejs-repl]] - [[doom-package:nodejs-repl]]
- [[doom-package:][npm-mode]] - [[doom-package:npm-mode]]
- [[doom-package:][rjsx-mode]] - [[doom-package:rjsx-mode]]
- [[doom-package:][skewer-mode]] (DEPRECATED) - [[doom-package:skewer-mode]] (DEPRECATED)
- [[doom-package:][tide]] - [[doom-package:tide]]
- [[doom-package:][typescript-mode]] - [[doom-package:typescript-mode]]
- [[doom-package:][xref-js2]] if [[doom-module:][:tools lookup]] - [[doom-package:xref-js2]] if [[doom-module::tools lookup]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

10
modules/lang/json/README.org
View file

@ -11,16 +11,16 @@ This module adds [[https://www.json.org/json-en.html][JSON]] support to Doom Ema
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~json-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~json-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/vscode-langservers/vscode-json-languageserver][vscode-json-languageserver]]). (supports [[https://github.com/vscode-langservers/vscode-json-languageserver][vscode-json-languageserver]]).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][counsel-jq]] if [[doom-module:][:completion ivy]] - [[doom-package:counsel-jq]] if [[doom-module::completion ivy]]
- [[doom-package:][json-mode]] - [[doom-package:json-mode]]
- [[doom-package:][json-snatcher]] - [[doom-package:json-snatcher]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

52
modules/lang/julia/README.org
View file

@ -6,31 +6,31 @@
* Description :unfold: * Description :unfold:
This module adds support for [[https://julialang.org/][the Julia language]] to Doom Emacs. This module adds support for [[https://julialang.org/][the Julia language]] to Doom Emacs.
- Syntax highlighting and latex symbols from [[doom-package:][julia-mode]] - Syntax highlighting and latex symbols from [[doom-package:julia-mode]]
- REPL integration from [[doom-package:][julia-repl]] - REPL integration from [[doom-package:julia-repl]]
- Code completion and syntax checking, requires [[doom-module:][:tools lsp]] and [[doom-module:][+lsp]] - Code completion and syntax checking, requires [[doom-module::tools lsp]] and [[doom-module:+lsp]]
** Maintainers ** Maintainers
/This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]] /This module has no dedicated maintainers./ [[doom-contrib-maintainer:][Become a maintainer?]]
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~julia-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~julia-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports LanguageServer.jl). (supports LanguageServer.jl).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][julia-mode]] - [[doom-package:julia-mode]]
- [[doom-package:][julia-repl]] - [[doom-package:julia-repl]]
- if [[doom-package:][+lsp]] - if [[doom-package:+lsp]]
- if [[doom-module:][:tools lsp]] - if [[doom-module::tools lsp]]
- [[doom-package:][lsp-julia]] - [[doom-package:lsp-julia]]
- [[doom-package:][lsp]] - [[doom-package:lsp]]
- if [[doom-module:][:tools lsp +eglot]] - if [[doom-module::tools lsp +eglot]]
- [[doom-package:][eglot-jl]] - [[doom-package:eglot-jl]]
- [[doom-package:][eglot]] - [[doom-package:eglot]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -42,11 +42,11 @@ This module adds support for [[https://julialang.org/][the Julia language]] to D
* Installation * Installation
[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]] [[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
This module requires [[https://julialang.org/][Julia]] and an language server if [[doom-module:][+lsp]] is enabled. This module requires [[https://julialang.org/][Julia]] and an language server if [[doom-module:+lsp]] is enabled.
** Language Server ** Language Server
[[doom-module:][+lsp]] requires ~LanguageServer.jl~ and ~SymbolServer.jl~. The [[doom-package:][lsp-julia]] and [[doom-module:+lsp]] requires ~LanguageServer.jl~ and ~SymbolServer.jl~. The [[doom-package:lsp-julia]] and
[[doom-package:][eglot-jl]] packages both come bundled with their own versions of these servers, [[doom-package:eglot-jl]] packages both come bundled with their own versions of these servers,
which is used by default. If you're happy with that, no further configuration is which is used by default. If you're happy with that, no further configuration is
necessary. necessary.
@ -58,17 +58,17 @@ Pkg.add("LanguageServer")
Pkg.add("SymbolServer") Pkg.add("SymbolServer")
#+end_src #+end_src
Then configure [[doom-package:][lsp-julia]] or [[doom-package:][eglot-jl]] depending on whether you have enabled Then configure [[doom-package:lsp-julia]] or [[doom-package:eglot-jl]] depending on whether you have enabled
[[doom-module:][:tools lsp]] or [[doom-module:][:tools lsp +eglot]], respectively: [[doom-module::tools lsp]] or [[doom-module::tools lsp +eglot]], respectively:
*** =lsp-julia= *** =lsp-julia=
To instruct [[doom-package:][lsp-julia]] not to use the built-in package: To instruct [[doom-package:lsp-julia]] not to use the built-in package:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; in $DOOMDIR/config.el ;; in $DOOMDIR/config.el
(setq lsp-julia-package-dir nil) (setq lsp-julia-package-dir nil)
#+end_src #+end_src
To find your installation of ~LanguageServer.jl~, [[doom-package:][lsp-julia]] needs to know the To find your installation of ~LanguageServer.jl~, [[doom-package:lsp-julia]] needs to know the
environment in which it is installed. This is set to v1.6 by default as it is environment in which it is installed. This is set to v1.6 by default as it is
the current LTS: the current LTS:
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -78,7 +78,7 @@ the current LTS:
#+end_src #+end_src
*** =eglot-jl= *** =eglot-jl=
To find your installation of ~LanguageServer.jl~, [[doom-package:][eglot-jl]] must know the To find your installation of ~LanguageServer.jl~, [[doom-package:eglot-jl]] must know the
environment in which it is installed. This is set to v1.6 by default as it is environment in which it is installed. This is set to v1.6 by default as it is
the current LTS: the current LTS:
#+begin_src emacs-lisp #+begin_src emacs-lisp
@ -86,7 +86,7 @@ the current LTS:
(setq eglot-jl-language-server-project "~/.julia/environments/v1.6") (setq eglot-jl-language-server-project "~/.julia/environments/v1.6")
#+end_src #+end_src
But to let [[doom-package:][eglot-jl]] use the environment bundled with it, set it to But to let [[doom-package:eglot-jl]] use the environment bundled with it, set it to
~eglot-jl-base~ instead: ~eglot-jl-base~ instead:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; in $DOOMDIR/config.el ;; in $DOOMDIR/config.el
@ -100,8 +100,8 @@ But to let [[doom-package:][eglot-jl]] use the environment bundled with it, set
#+end_quote #+end_quote
** Language Server ** Language Server
[[doom-module:][+lsp]] adds code completion, syntax checking, formatting and other [[doom-package:][lsp-mode]] or [[doom-module:+lsp]] adds code completion, syntax checking, formatting and other [[doom-package:lsp-mode]] or
[[doom-package:][eglot]] features. It requires ~LanguageServer.jl~, the installation of which is [[doom-package:eglot]] features. It requires ~LanguageServer.jl~, the installation of which is
described above. described above.
* TODO Configuration * TODO Configuration
@ -110,7 +110,7 @@ described above.
#+end_quote #+end_quote
** Change the default environment for the Julia language server ** Change the default environment for the Julia language server
[[doom-package:][lsp-julia]] requires a variable be set for the Julia environment. This is set to [[doom-package:lsp-julia]] requires a variable be set for the Julia environment. This is set to
v1.6 by default as it is the current LTS: v1.6 by default as it is the current LTS:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; in $DOOMDIR/config.el ;; in $DOOMDIR/config.el

6
modules/lang/kotlin/README.org
View file

@ -11,12 +11,12 @@ This module adds [[https://kotlinlang.org/][Kotlin]] support to Doom Emacs.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~kotlin-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~kotlin-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/emacs-lsp/lsp-mode][kotlin-language-server]]). (supports [[https://github.com/emacs-lsp/lsp-mode][kotlin-language-server]]).
** Packages ** Packages
- [[doom-package:][flycheck-kotlin]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-kotlin]] if [[doom-module::checkers syntax]]
- [[doom-package:][kotlin-mode]] - [[doom-package:kotlin-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

40
modules/lang/latex/README.org
View file

@ -8,11 +8,11 @@ Provide a helping hand when working with LaTeX documents.
- Sane defaults - Sane defaults
- Fontification of many popular commands - Fontification of many popular commands
- Pretty indentation of wrapped lines using the [[doom-package:][adaptive-wrap]] package - Pretty indentation of wrapped lines using the [[doom-package:adaptive-wrap]] package
- Spell checking with [[doom-package:][flycheck]] - Spell checking with [[doom-package:flycheck]]
- Change PDF viewer to Okular or [[doom-package:][latex-preview-pane]] - Change PDF viewer to Okular or [[doom-package:latex-preview-pane]]
- Bibtex editor - Bibtex editor
- Autocompletion using [[doom-package:][company-mode]] - Autocompletion using [[doom-package:company-mode]]
- Compile your =.tex= code only once using LatexMk - Compile your =.tex= code only once using LatexMk
** Maintainers ** Maintainers
@ -23,27 +23,27 @@ Provide a helping hand when working with LaTeX documents.
** Module flags ** Module flags
- +cdlatex :: - +cdlatex ::
Enable [[doom-package:][cdlatex]] for fast math insertion. Enable [[doom-package:cdlatex]] for fast math insertion.
- +fold :: - +fold ::
Use TeX-fold (from [[doom-package:][auctex]]) to fold LaTeX macros to unicode, and make folding Use TeX-fold (from [[doom-package:auctex]]) to fold LaTeX macros to unicode, and make folding
hook-based and less manual. hook-based and less manual.
- +latexmk :: - +latexmk ::
Use LatexMk instead of LaTeX to compile documents. Use LatexMk instead of LaTeX to compile documents.
- +lsp :: - +lsp ::
Enable LSP support in latex buffers. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support in latex buffers. Requires [[doom-module::tools lsp]] and a langserver
(supports digestif and TexLab). (supports digestif and TexLab).
** Packages ** Packages
- [[doom-package:][adaptive-wrap]] - [[doom-package:adaptive-wrap]]
- [[doom-package:][auctex]] - [[doom-package:auctex]]
- [[doom-package:][auctex-latexmk]] if [[doom-module:][+latexmk]] - [[doom-package:auctex-latexmk]] if [[doom-module:+latexmk]]
- [[doom-package:][cdlatex]] if [[doom-module:][+cdlatex]] - [[doom-package:cdlatex]] if [[doom-module:+cdlatex]]
- [[doom-package:][evil-tex]] if [[doom-module:][:editor evil +everywhere]] - [[doom-package:evil-tex]] if [[doom-module::editor evil +everywhere]]
- [[doom-package:][latex-preview-pane]] - [[doom-package:latex-preview-pane]]
- if [[doom-module:][:completion company]] - if [[doom-module::completion company]]
- [[doom-package:][company-auctex]] - [[doom-package:company-auctex]]
- [[doom-package:][company-math]] - [[doom-package:company-math]]
- [[doom-package:][company-reftex]] - [[doom-package:company-reftex]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote
@ -115,7 +115,7 @@ This module provides integration for four supported pdf viewers. They are
+ Sumatra PDF + Sumatra PDF
+ Zathura + Zathura
+ Okular + Okular
+ pdf-tools (requires [[doom-module:][:tools pdf]] module) + pdf-tools (requires [[doom-module::tools pdf]] module)
They are searched for in this order. See ~+latex-viewers~ to change the order, They are searched for in this order. See ~+latex-viewers~ to change the order,
or remove tools from the search altogether. If you want to exclusively use one or remove tools from the search altogether. If you want to exclusively use one
@ -130,8 +130,8 @@ is used as a fallback. You can use this exclusively by setting ~+latex-viewers~
to ~nil~. to ~nil~.
** Using cdlatex's snippets despite having yasnippet ** Using cdlatex's snippets despite having yasnippet
[[doom-package:][cdlatex]] has a snippet insertion capability which is disabled in favor of [[doom-package:cdlatex]] has a snippet insertion capability which is disabled in favor of
[[doom-package:][yasnippet]] when using [[doom-module:][:editor snippets]]. If you still wanna use it, simply rebind [[doom-package:yasnippet]] when using [[doom-module::editor snippets]]. If you still wanna use it, simply rebind
the [[kbd:][TAB]] key for cdlatex, which takes care of snippet-related stuff: the [[kbd:][TAB]] key for cdlatex, which takes care of snippet-related stuff:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; in $DOOMDIR/config.el ;; in $DOOMDIR/config.el

4
modules/lang/lean/README.org
View file

@ -13,8 +13,8 @@ This module adds support for the [[https://leanprover.github.io/about/][Lean pro
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][lean-mode]] - [[doom-package:lean-mode]]
- [[doom-package:][company-lean]] if [[doom-module:][:completion company]] - [[doom-package:company-lean]] if [[doom-module::completion company]]
** TODO Hacks ** TODO Hacks
#+begin_quote #+begin_quote

6
modules/lang/ledger/README.org
View file

@ -29,9 +29,9 @@ This modules enables the following features:
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][evil-ledger]] if [[doom-module:][:editor evil +everywhere]] - [[doom-package:evil-ledger]] if [[doom-module::editor evil +everywhere]]
- [[doom-package:][flycheck-ledger]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-ledger]] if [[doom-module::checkers syntax]]
- [[doom-package:][ledger-mode]] - [[doom-package:ledger-mode]]
** Hacks ** Hacks
- This module sets ~ledger-clear-whole-transactions~ to ~t~ (default value is - This module sets ~ledger-clear-whole-transactions~ to ~t~ (default value is

20
modules/lang/lua/README.org
View file

@ -20,18 +20,18 @@ This module adds Lua support to Doom Emacs.
- +fennel :: - +fennel ::
Enable support for the Fennel language. Enable support for the Fennel language.
- +lsp :: - +lsp ::
Enable LSP support for ~lua-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~lua-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports EmmyLua, lua-language-server, and lua-lsp). (supports EmmyLua, lua-language-server, and lua-lsp).
- +moonscript :: - +moonscript ::
Enable support for the Moonscript language. Enable support for the Moonscript language.
** Packages ** Packages
- [[doom-package:][company-lua]] if [[doom-module:][:completion company]] - [[doom-package:company-lua]] if [[doom-module::completion company]]
- [[doom-package:][fennel-mode]] if [[doom-module:][+fennel]] - [[doom-package:fennel-mode]] if [[doom-module:+fennel]]
- [[doom-package:][lua-mode]] - [[doom-package:lua-mode]]
- if [[doom-module:][+moonscript]] - if [[doom-module:+moonscript]]
- [[doom-package:][flycheck-moonscript]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-moonscript]] if [[doom-module::checkers syntax]]
- [[doom-package:][moonscript-mode]] - [[doom-package:moonscript-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -48,8 +48,8 @@ fennel and moonscript transpilers. An LSP server is also required for LSP
support. support.
** Language Server Protocol servers ** Language Server Protocol servers
LSP server support depends on which flavor of the [[doom-module:][:tools lsp]] module you have 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]]). installed ([[doom-package:eglot]] or [[doom-package:lsp-mode]]).
*** LSP-mode *** LSP-mode
Three servers are supported, ordered from highest to lowest priority: Three servers are supported, ordered from highest to lowest priority:
@ -81,7 +81,7 @@ Eglot currently only supports one of the above servers out of the box:
🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
- lua-lsp-dir :: This must be set when using [[doom-module:][+lsp]] and using [[https://github.com/sumneko/lua-language-server][lua-language-server]]. - lua-lsp-dir :: This must be set when using [[doom-module:+lsp]] and using [[https://github.com/sumneko/lua-language-server][lua-language-server]].
This controls where the repository has been cloned and built to finish the This controls where the repository has been cloned and built to finish the
configuration of the server. configuration of the server.

16
modules/lang/markdown/README.org
View file

@ -35,14 +35,14 @@ for Markdown's syntax is the format of plain text email. -- John Gruber
previews of your markdown (or org) files. previews of your markdown (or org) files.
** Packages ** Packages
- [[doom-package:][edit-indirect]] - [[doom-package:edit-indirect]]
- [[doom-package:][evil-markdown]] if [[doom-module:][:editor evil +everywhere]] - [[doom-package:evil-markdown]] if [[doom-module::editor evil +everywhere]]
- [[doom-package:][grip-mode]] if [[doom-module:][+grip]] - [[doom-package:grip-mode]] if [[doom-module:+grip]]
- [[doom-package:][markdown-mode]] - [[doom-package:markdown-mode]]
- [[doom-package:][markdown-toc]] - [[doom-package:markdown-toc]]
** Hacks ** Hacks
- [[doom-package:][flyspell]] has been configured not to spell check in code blocks, links, HTML - [[doom-package:flyspell]] has been configured not to spell check in code blocks, links, HTML
tags or references. tags or references.
** TODO Changelog ** TODO Changelog
@ -53,7 +53,7 @@ for Markdown's syntax is the format of plain text email. -- John Gruber
[[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]] [[id:01cffea4-3329-45e2-a892-95a384ab2338][Enable this module in your ~doom!~ block.]]
This module requires: This module requires:
- A linter (requires [[doom-module:][:checkers syntax]]) - A linter (requires [[doom-module::checkers syntax]])
- A markdown compiler, for previewing Markdown - A markdown compiler, for previewing Markdown
** Linters ** Linters
@ -124,7 +124,7 @@ installed through your OS's package manager:
~markdown-preview~ is bound to [[kbd:][<localleader> p]]. This will open a preview of your ~markdown-preview~ is bound to [[kbd:][<localleader> p]]. This will open a preview of your
compiled markdown document in your browser. compiled markdown document in your browser.
Alternatively, you can use ~grip-mode~ through [[doom-module:][+grip]]. Alternatively, you can use ~grip-mode~ through [[doom-module:+grip]].
* Configuration * Configuration
#+begin_quote #+begin_quote

14
modules/lang/nim/README.org
View file

@ -6,9 +6,9 @@
* Description :unfold: * Description :unfold:
This module adds [[https://nim-lang.org][Nim]] support to Doom Emacs. This module adds [[https://nim-lang.org][Nim]] support to Doom Emacs.
- Code completion ([[doom-package:][nimsuggest]] + [[doom-package:][company]]) - Code completion ([[doom-package:nimsuggest]] + [[doom-package:company]])
- Syntax checking ([[doom-package:][nimsuggest]] + [[doom-package:][flycheck]]) - Syntax checking ([[doom-package:nimsuggest]] + [[doom-package:flycheck]])
- Org babel support ([[doom-package:][ob-nim]]) - Org babel support ([[doom-package:ob-nim]])
** Maintainers ** Maintainers
*This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]] *This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]]
@ -17,13 +17,13 @@ This module adds [[https://nim-lang.org][Nim]] support to Doom Emacs.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][flycheck-nim]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-nim]] if [[doom-module::checkers syntax]]
- [[doom-package:][nim-mode]] - [[doom-package:nim-mode]]
** Hacks ** Hacks
- [[doom-package:][nimsuggest]] was modified to strip invalid characters from its temp file paths - [[doom-package:nimsuggest]] was modified to strip invalid characters from its temp file paths
(which would break nimsuggest on Windows systems). (which would break nimsuggest on Windows systems).
- [[doom-package:][nim-mode]] was modified to fail gracefully if =nimsuggest= (the executable) - [[doom-package:nim-mode]] was modified to fail gracefully if =nimsuggest= (the executable)
isn't available. isn't available.
** TODO Changelog ** TODO Changelog

14
modules/lang/nix/README.org
View file

@ -9,7 +9,7 @@ for managing [[https://nixos.org/][Nix(OS)]].
Includes: Includes:
- Syntax highlighting - Syntax highlighting
- Completion through [[doom-package:][company]] and/or [[doom-package:][helm]] - Completion through [[doom-package:company]] and/or [[doom-package:helm]]
- Nix option lookup - Nix option lookup
- Formatting (~nixfmt~) - Formatting (~nixfmt~)
@ -21,13 +21,13 @@ Includes:
** Module flags ** Module flags
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][company-nixos-options]] if [[doom-module:][:completion company]] - [[doom-package:company-nixos-options]] if [[doom-module::completion company]]
- [[doom-package:][helm-nixos-options]] if [[doom-module:][:completion helm]] - [[doom-package:helm-nixos-options]] if [[doom-module::completion helm]]
- [[doom-package:][nix-mode]] - [[doom-package:nix-mode]]
- [[doom-package:][nix-update]] - [[doom-package:nix-update]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -42,7 +42,7 @@ Includes:
This module requires: This module requires:
- [[https://nixos.org/guides/install-nix.html][The Nix package manager]], for a variety of its features (besides syntax - [[https://nixos.org/guides/install-nix.html][The Nix package manager]], for a variety of its features (besides syntax
highlighting). highlighting).
- =nixfmt=, for automatic formatting (requires [[doom-module:][:editor format]]). - =nixfmt=, for automatic formatting (requires [[doom-module::editor format]]).
- *MacOS:* TODO - *MacOS:* TODO
- *Arch Linux:* TODO - *Arch Linux:* TODO

56
modules/lang/ocaml/README.org
View file

@ -4,45 +4,45 @@
#+since: 2.0.4 (#128) #+since: 2.0.4 (#128)
* Description :unfold: * Description :unfold:
This module adds [[https://ocaml.org/][OCaml]] support to Doom Emacs, powered by [[doom-package:][tuareg-mode]]. This module adds [[https://ocaml.org/][OCaml]] support to Doom Emacs, powered by [[doom-package:tuareg-mode]].
- Code completion, documentation look-up, code navigation and refactoring - Code completion, documentation look-up, code navigation and refactoring
([[doom-package:][merlin]]) ([[doom-package:merlin]])
- Type, documentation and function argument display on idle ([[doom-package:][merlin-eldoc]]) - Type, documentation and function argument display on idle ([[doom-package:merlin-eldoc]])
- REPL ([[doom-package:][utop]]) - REPL ([[doom-package:utop]])
- Syntax-checking ([[doom-package:][merlin]] with [[doom-package:][flycheck-ocaml]]) - Syntax-checking ([[doom-package:merlin]] with [[doom-package:flycheck-ocaml]])
- Auto-indentation ([[doom-package:][ocp-indent]]) - Auto-indentation ([[doom-package:ocp-indent]])
- Code formatting ([[doom-package:][ocamlformat]]) - Code formatting ([[doom-package:ocamlformat]])
- Dune file format ([[doom-package:][dune]]) - Dune file format ([[doom-package:dune]])
** Maintainers ** Maintainers
*This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]] *This module needs a maintainer.* [[doom-contrib-maintainer:][Become a maintainer?]]
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~tuareg-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~tuareg-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/freebroccolo/ocaml-language-server][ocaml-language-server]]). (supports [[https://github.com/freebroccolo/ocaml-language-server][ocaml-language-server]]).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][dune]] - [[doom-package:dune]]
- [[doom-package:][ocamlformat]] if [[doom-module:][:editor format]] - [[doom-package:ocamlformat]] if [[doom-module::editor format]]
- [[doom-package:][ocp-indent]] - [[doom-package:ocp-indent]]
- [[doom-package:][tuareg]] - [[doom-package:tuareg]]
- [[doom-package:][utop]] if [[doom-module:][:tools eval]] - [[doom-package:utop]] if [[doom-module::tools eval]]
- unless [[doom-module:][+lsp]] - unless [[doom-module:+lsp]]
- [[doom-package:][flycheck-ocaml]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-ocaml]] if [[doom-module::checkers syntax]]
- [[doom-package:][merlin]] - [[doom-package:merlin]]
- [[doom-package:][merlin-company]] - [[doom-package:merlin-company]]
- [[doom-package:][merlin-eldoc]] - [[doom-package:merlin-eldoc]]
** Hacks ** Hacks
- ~set-ligatures!~ is called with the full tuareg prettify symbol list, this can - ~set-ligatures!~ is called with the full tuareg prettify symbol list, this can
cause columns to change as certain keywords are shortened (e.g. =fun= becomes cause columns to change as certain keywords are shortened (e.g. =fun= becomes
\lambda). \lambda).
- ~tuareg-opam-update-env~ is called the first time [[doom-package:][tuareg]] is loaded - ~tuareg-opam-update-env~ is called the first time [[doom-package:tuareg]] is loaded
** TODO Changelog ** TODO Changelog
# This section will be machine generated. Don't edit it by hand. # This section will be machine generated. Don't edit it by hand.
@ -86,16 +86,16 @@ This module requires the following packages available through [[http://opam.ocam
🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]] 🔨 /This module's configuration documentation is incomplete./ [[doom-contrib-module:][Complete it?]]
#+end_quote #+end_quote
- If [[doom-module:][:completion company]] is enabled then autocomplete is provided by [[doom-package:][merlin]] - If [[doom-module::completion company]] is enabled then autocomplete is provided by [[doom-package:merlin]]
- When [[doom-module:][:checkers syntax]] is enabled then [[doom-package:][flycheck-ocaml]] is activated to do - When [[doom-module::checkers syntax]] is enabled then [[doom-package:flycheck-ocaml]] is activated to do
on-the-fly syntax/type checking via [[doom-package:][merlin]], otherwise this is only done when on-the-fly syntax/type checking via [[doom-package:merlin]], otherwise this is only done when
the file is saved. the file is saved.
- Spell checking is activated in comments if [[doom-module:][:checkers spell]] is active - Spell checking is activated in comments if [[doom-module::checkers spell]] is active
- A REPL is provided if [[doom-package:][utop]] is installed and [[doom-module:][:tools eval]] is active - A REPL is provided if [[doom-package:utop]] is installed and [[doom-module::tools eval]] is active
- If [[doom-module:][:editor format]] is enabled, the =ocamlformat= executable is available and - If [[doom-module::editor format]] is enabled, the =ocamlformat= executable is available and
there is an =.ocamlformat= file present then ~format-all-buffer~ is bound to there is an =.ocamlformat= file present then ~format-all-buffer~ is bound to
=ocamlformat=, otherwise to =ocp-indent= =ocamlformat=, otherwise to =ocp-indent=
- If [[doom-module:][:editor multiple-cursors]] is enabled then identifiers can be refactored with - If [[doom-module::editor multiple-cursors]] is enabled then identifiers can be refactored with
[[kbd:][v R]] and multiple cursors (this correctly matches identifier occurrences [[kbd:][v R]] and multiple cursors (this correctly matches identifier occurrences
according to scope, it is not purely a textual match) according to scope, it is not purely a textual match)

62
modules/lang/org/README.org
View file

@ -18,7 +18,7 @@ intuitive out of the box:
- A configuration for using org-mode for slide-show presentations or exporting - A configuration for using org-mode for slide-show presentations or exporting
org files to reveal.js slideshows. org files to reveal.js slideshows.
- Drag-and-drop support for images (with inline preview) and media files (drops - Drag-and-drop support for images (with inline preview) and media files (drops
a file icon and a short link) (requires [[doom-module:][+dragndrop]] flag). a file icon and a short link) (requires [[doom-module:+dragndrop]] flag).
- Integration with pandoc, ipython, jupyter, reveal.js, beamer, and others - Integration with pandoc, ipython, jupyter, reveal.js, beamer, and others
(requires flags). (requires flags).
- Export-to-clipboard functionality, for copying text into formatted html, - Export-to-clipboard functionality, for copying text into formatted html,
@ -58,12 +58,12 @@ https://www.mfoot.com/blog/2015/11/22/literate-emacs-configuration-with-org-mode
- +ipython :: - +ipython ::
(**DEPRECATED**) Enable ipython integration for babel. (**DEPRECATED**) Enable ipython integration for babel.
- +journal :: - +journal ::
Enable [[doom-package:][org-journal]] integration. Enable [[doom-package:org-journal]] integration.
- +jupyter :: - +jupyter ::
Enable Jupyter integration for babel. Enable Jupyter integration for babel.
- +noter :: - +noter ::
Enable [[doom-package:][org-noter]] integration. Keeps notes in sync with a document. Requires Enable [[doom-package:org-noter]] integration. Keeps notes in sync with a document. Requires
[[doom-module:][:tools pdf]], [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Document-View.html][DocView]], or [[https://github.com/wasamasa/nov.el][nov.el]] to be enabled. [[doom-module::tools pdf]], [[https://www.gnu.org/software/emacs/manual/html_node/emacs/Document-View.html][DocView]], or [[https://github.com/wasamasa/nov.el][nov.el]] to be enabled.
- +pandoc :: - +pandoc ::
Enable pandoc integration into the Org exporter. Enable pandoc integration into the Org exporter.
- +passwords :: - +passwords ::
@ -79,10 +79,10 @@ https://www.mfoot.com/blog/2015/11/22/literate-emacs-configuration-with-org-mode
too slow, it'd be wise to disable this flag. too slow, it'd be wise to disable this flag.
- +roam :: - +roam ::
Enable integration with [[https://github.com/org-roam/org-roam-v1][org-roam v1]]. This requires ~sqlite3~ to be installed Enable integration with [[https://github.com/org-roam/org-roam-v1][org-roam v1]]. This requires ~sqlite3~ to be installed
on your system. /Incompatible with [[doom-module:][+roam2]]./ on your system. /Incompatible with [[doom-module:+roam2]]./
- +roam2 :: - +roam2 ::
Enable integration with [[https://github.com/org-roam/org-roam][org-roam v2]]. This requires ~sqlite3~ to be installed Enable integration with [[https://github.com/org-roam/org-roam][org-roam v2]]. This requires ~sqlite3~ to be installed
on your system. /Incompatible with [[doom-module:][+roam]]./ on your system. /Incompatible with [[doom-module:+roam]]./
** Packages ** Packages
- [[doom-package:][evil-org]] if [[doom-package:][:editor evil]] - [[doom-package:][evil-org]] if [[doom-package:][:editor evil]]
@ -128,16 +128,16 @@ https://www.mfoot.com/blog/2015/11/22/literate-emacs-configuration-with-org-mode
** Hacks ** Hacks
- Adds support for a ~:sync~ parameter for org src blocks. This overrides - Adds support for a ~:sync~ parameter for org src blocks. This overrides
~:async~. ~:async~.
- Gracefully degrades ~:async~ babel blocks to ~:sync~ when [[doom-package:][ob-async]] would cause - Gracefully degrades ~:async~ babel blocks to ~:sync~ when [[doom-package:ob-async]] would cause
errors or issues (such as with a ~:session~ parameter, which [[doom-package:][ob-async]] does not errors or issues (such as with a ~:session~ parameter, which [[doom-package:ob-async]] does not
support, or when exporting org documents). support, or when exporting org documents).
- The window is recentered when following links. - The window is recentered when following links.
- The breadcrumbs displayed in eldoc when hovering over an org headline has been - The breadcrumbs displayed in eldoc when hovering over an org headline has been
reworked to strip out link syntax and normalize font-size disparities. reworked to strip out link syntax and normalize font-size disparities.
- If [[doom-module:][:ui workspaces]] is enabled, persp-mode won't register org agenda buffers - If [[doom-module::ui workspaces]] is enabled, persp-mode won't register org agenda buffers
that are temporarily opened in the background. that are temporarily opened in the background.
- Temporary org agenda files aren't added to recentf. - Temporary org agenda files aren't added to recentf.
- =file:= links are highlighted with the ~error~ face if they are broken. - =file:= links are highlighted with the [[face:error]] face if they are broken.
- TAB was changed to toggle only the visibility state of the current subtree, - TAB was changed to toggle only the visibility state of the current subtree,
rather than cycle through it recursively. This can be reversed with: rather than cycle through it recursively. This can be reversed with:
@ -146,19 +146,19 @@ https://www.mfoot.com/blog/2015/11/22/literate-emacs-configuration-with-org-mode
(remove-hook 'org-tab-first-hook #'+org-cycle-only-current-subtree-h)) (remove-hook 'org-tab-first-hook #'+org-cycle-only-current-subtree-h))
#+end_src #+end_src
- (Evil users) Nearby tables are formatted when exiting insert or replace mode - (Evil users) Nearby tables are formatted when exiting insert or replace mode
(see ~+org-enable-auto-reformat-tables-h~). (see [[fn:+org-enable-auto-reformat-tables-h]]).
- Statistics cookies are updated when saving the buffer of exiting insert mode - Statistics cookies are updated when saving the buffer of exiting insert mode
(see ~+org-enable-auto-update-cookies-h~). (see [[fn:+org-enable-auto-update-cookies-h]]).
- Org-protocol has been lazy loaded (see ~+org-init-protocol-lazy-loader-h~); - Org-protocol has been lazy loaded (see [[fn:+org-init-protocol-lazy-loader-h]]);
loaded when the server receives a request for an org-protocol:// url. loaded when the server receives a request for an =org-protocol://= url.
- Babel and babel plugins are now lazy loaded (see - Babel and babel plugins are now lazy loaded (see
~+org-init-babel-lazy-loader-h~); loaded when a src block is executed. No need [[fn:+org-init-babel-lazy-loader-h]]); loaded when a src block is executed. No need
to use ~org-babel-do-load-languages~ in your config, just install your babel to use [[fn:org-babel-do-load-languages]] in your config, just install your babel
packages to extend language support (and ensure its ~org-babel-execute:*~ packages to extend language support (and ensure its ~org-babel-execute:*~
function is autoloaded). function is autoloaded).
- If a variable is used as a file path in ~org-capture-template~, it will be - If a variable is used as a file path in [[var:org-capture-template]], it will be
resolved relative to ~org-directory~, instead of ~default-directory~ (see resolved relative to [[var:org-directory]], instead of [[var:default-directory]] (see
~+org-capture-expand-variable-file-a~). [[fn:+org--capture-expand-variable-file-a]]).
** TODO Changelog ** TODO Changelog
# This section will be machine generated. Don't edit it by hand. # This section will be machine generated. Don't edit it by hand.
@ -169,14 +169,14 @@ https://www.mfoot.com/blog/2015/11/22/literate-emacs-configuration-with-org-mode
This module has no hard requirements, but these soft requirements are needed to This module has no hard requirements, but these soft requirements are needed to
use Org's more esoteric features: use Org's more esoteric features:
- For inline LaTeX previews, ~latex~ and ~dvipng~ is needed. - For inline LaTeX previews, [[doom-executable:latex]] and [[doom-executable:dvipng]] is needed.
- To render GNUPlot images (with [[doom-module:][+gnuplot]] flag) the ~gnuplot~ program is needed. - To render GNUPlot images (with [[doom-module:+gnuplot]] flag) the [[doom-executable:gnuplot]] program is needed.
- To execute babel code blocks, you need whatever dependencies those languages - To execute babel code blocks, you need whatever dependencies those languages
need. It is recommended you enable the associated [[doom-module:][:lang]] module and ensure its need. It is recommended you enable the associated [[doom-module::lang]] module and ensure its
dependencies are met, e.g. install the =ruby= executable for ruby support. To dependencies are met, e.g. install the [[doom-executable:ruby]] executable for ruby support. To
use ~jupyter kernels~ you need the [[doom-module:][+jupyter]] flag, the associated kernel as use ~jupyter kernels~ you need the [[doom-module:+jupyter]] flag, the associated kernel as
well as the ~jupyter~ program. well as the [[doom-executable:jupyter]] program.
- [[doom-package:][org-roam]] (with [[doom-module:][+roam]] or [[doom-module:][+roam2]] flag) requires =sqlite3= to be installed. - [[doom-package:org-roam]] (with [[doom-module:+roam]] or [[doom-module:+roam2]] flag) requires [[doom-executable:sqlite3]] to be installed.
** MacOS ** MacOS
#+begin_src sh #+begin_src sh
@ -246,7 +246,7 @@ For =evil-mode= users, an overview of org-mode keybindings is provided [[https:/
#+end_quote #+end_quote
** Changing ~org-directory~ ** Changing ~org-directory~
~org-directory~ must be set /before/ [[doom-package:][org]] has loaded: ~org-directory~ must be set /before/ [[doom-package:org]] has loaded:
#+begin_src emacs-lisp #+begin_src emacs-lisp
;; in $DOOMDIR/config.el ;; in $DOOMDIR/config.el
(setq org-directory "~/new/org/location/") (setq org-directory "~/new/org/location/")
@ -263,9 +263,9 @@ For =evil-mode= users, an overview of org-mode keybindings is provided [[https:/
** =org-roam= ** =org-roam=
*** Should I go with =+roam= (v1) or =+roam2= (v2)? *** Should I go with =+roam= (v1) or =+roam2= (v2)?
Long story short: if you're new to [[doom-package:][org-roam]] and haven't used it, then you should Long story short: if you're new to [[doom-package:org-roam]] and haven't used it, then you should
go with [[doom-module:][+roam2]]; if you already have an ~org-roam-directory~ with the v1 files in go with [[doom-module:+roam2]]; if you already have an ~org-roam-directory~ with the v1 files in
it, then you can keep use [[doom-module:][+roam]] for a time being. it, then you can keep use [[doom-module:+roam]] for a time being.
V1 isn't actively maintained anymore and is now basically EOL. This means that V1 isn't actively maintained anymore and is now basically EOL. This means that
the feature disparity between the both will continue to grow, while its existing the feature disparity between the both will continue to grow, while its existing
@ -289,7 +289,7 @@ appear during the migration process. Because of that, *don't forget to backup*
your ~org-roam-directory~ before attempting to migrate. your ~org-roam-directory~ before attempting to migrate.
In order to migrate from v1 to v2 using Doom follow the next steps: In order to migrate from v1 to v2 using Doom follow the next steps:
1. Enable [[doom-module:][+roam2]] flag (and disable [[doom-module:][+roam]] if it was previously enabled) in your 1. Enable [[doom-module:+roam2]] flag (and disable [[doom-module:+roam]] if it was previously enabled) in your
=init.el=. =init.el=.
2. Ensure your ~org-roam-directory~ points to a directory with your v1 files. 2. Ensure your ~org-roam-directory~ points to a directory with your v1 files.
3. Run ~$ doom sync -u~ in your shell. 3. Run ~$ doom sync -u~ in your shell.

28
modules/lang/php/README.org
View file

@ -31,24 +31,24 @@ This module adds support for PHP 5.3+ (including PHP7) to Doom Emacs.
- +hack :: - +hack ::
Add support for the [[https://hacklang.org/][Hack dialect of PHP]] by Facebook. Add support for the [[https://hacklang.org/][Hack dialect of PHP]] by Facebook.
- +lsp :: - +lsp ::
Enable LSP support for ~php-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~php-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://phpactor.readthedocs.io/en/develop/usage/standalone.html][phpactor]] and intelephense). (supports [[https://phpactor.readthedocs.io/en/develop/usage/standalone.html][phpactor]] and intelephense).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][async]] - [[doom-package:async]]
- [[doom-package:][hack-mode]] if [[doom-module:][+hack]] - [[doom-package:hack-mode]] if [[doom-module:+hack]]
- [[doom-package:][php-boris]] - [[doom-package:php-boris]]
- [[doom-package:][php-cs-fixer]] if [[doom-package:][:editor format]] - [[doom-package:php-cs-fixer]] if [[doom-package::editor format]]
- [[doom-package:][php-extras]] - [[doom-package:php-extras]]
- [[doom-package:][php-mode]] - [[doom-package:php-mode]]
- [[doom-package:][php-refactor-mode]] - [[doom-package:php-refactor-mode]]
- [[doom-package:][phpunit]] - [[doom-package:phpunit]]
- if [[doom-module:][+lsp]] - if [[doom-module:+lsp]]
- [[doom-package:][phpactor]] - [[doom-package:phpactor]]
- [[doom-package:][company-phpactor]] - [[doom-package:company-phpactor]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./
@ -62,7 +62,7 @@ This module adds support for PHP 5.3+ (including PHP7) to Doom Emacs.
This module requires ~php~ (5.3+) and ~composer~. This module requires ~php~ (5.3+) and ~composer~.
If [[doom-module:][+lsp]] is enabled, you'll also need one of these LSP servers: If [[doom-module:+lsp]] is enabled, you'll also need one of these LSP servers:
- Phpactor requires ~php~ 7.3+. - Phpactor requires ~php~ 7.3+.
- Intelephense requires ~node~ and ~npm~. - Intelephense requires ~node~ and ~npm~.

4
modules/lang/plantuml/README.org
View file

@ -14,8 +14,8 @@ from plain text.
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][plantuml-mode]] - [[doom-package:plantuml-mode]]
- [[doom-package:][flycheck-plantuml]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-plantuml]] if [[doom-module::checkers syntax]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

8
modules/lang/purescript/README.org
View file

@ -11,13 +11,13 @@ This module adds [[https://www.purescript.org/][Purescript]] support to Doom Ema
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~purescript-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~purescript-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/nwolverson/purescript-language-server][purescript-language-server]]). (supports [[https://github.com/nwolverson/purescript-language-server][purescript-language-server]]).
** Packages ** Packages
- [[doom-package:][psci]] - [[doom-package:psci]]
- [[doom-package:][psc-ide]] - [[doom-package:psc-ide]]
- [[doom-package:][purescript-mode]] - [[doom-package:purescript-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

62
modules/lang/python/README.org
View file

@ -6,10 +6,10 @@
* Description :unfold: * Description :unfold:
This module adds [[https://www.python.org/][Python]] support to Doom Emacs. This module adds [[https://www.python.org/][Python]] support to Doom Emacs.
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Snippets - Snippets
- Run tests ([[doom-package:][nose]], [[doom-package:][pytest]]) - Run tests ([[doom-package:nose]], [[doom-package:pytest]])
- Auto-format (with ~black~, requires [[doom-module:][:editor format]]) - Auto-format (with ~black~, requires [[doom-module::editor format]])
- LSP integration (=mspyls=, =pyls=, or =pyright=) - LSP integration (=mspyls=, =pyls=, or =pyright=)
** Maintainers ** Maintainers
@ -23,7 +23,7 @@ This module adds [[https://www.python.org/][Python]] support to Doom Emacs.
- +cython :: - +cython ::
Enable support for Cython files support. Enable support for Cython files support.
- +lsp :: - +lsp ::
Enable LSP support for ~python-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~python-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports mspyls, pyls, and pyright). (supports mspyls, pyls, and pyright).
- +poetry :: - +poetry ::
Enable Python packaging, dependency management, and virtual environment Enable Python packaging, dependency management, and virtual environment
@ -31,33 +31,33 @@ This module adds [[https://www.python.org/][Python]] support to Doom Emacs.
- +pyenv :: - +pyenv ::
Enable Python virtual environment support via [[https://github.com/pyenv/pyenv][pyenv]] Enable Python virtual environment support via [[https://github.com/pyenv/pyenv][pyenv]]
- +pyright :: - +pyright ::
Use the pyright LSP server instead of mspyls or pyls (requires [[doom-module:][+lsp]]). Use the pyright LSP server instead of mspyls or pyls (requires [[doom-module:+lsp]]).
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][anaconda-mode]] - [[doom-package:anaconda-mode]]
- [[doom-package:][conda]] - [[doom-package:conda]]
- [[doom-package:][nose]] - [[doom-package:nose]]
- [[doom-package:][pipenv]] - [[doom-package:pipenv]]
- [[doom-package:][pip-requirements]] - [[doom-package:pip-requirements]]
- [[doom-package:][poetry]] if [[doom-module:][+poetry]] - [[doom-package:poetry]] if [[doom-module:+poetry]]
- [[doom-package:][pyenv]] - [[doom-package:pyenv]]
- [[doom-package:][pyimport]] - [[doom-package:pyimport]]
- [[doom-package:][py-isort]] - [[doom-package:py-isort]]
- [[doom-package:][python-pytest]] - [[doom-package:python-pytest]]
- if [[doom-module:][+cython]] - if [[doom-module:+cython]]
- [[doom-package:][cython-mode]] - [[doom-package:cython-mode]]
- [[doom-package:][flycheck-cython]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-cython]] if [[doom-module::checkers syntax]]
- if [[doom-module:][+lsp]] - if [[doom-module:+lsp]]
- if [[doom-module:][+pyright]] - if [[doom-module:+pyright]]
- [[doom-package:][lsp-pyright]] - [[doom-package:lsp-pyright]]
- else - else
- [[doom-package:][lsp-python-ms]] - [[doom-package:lsp-python-ms]]
** Hacks ** Hacks
- [[doom-package:][anaconda-mode]] is configured to activate when [[doom-package:][lsp-mode]] (or [[doom-package:][eglot]]) don't -- or - [[doom-package:anaconda-mode]] is configured to activate when [[doom-package:lsp-mode]] (or [[doom-package:eglot]]) don't -- or
fail to. fail to.
** TODO Changelog ** TODO Changelog
@ -71,9 +71,9 @@ This module has no hard requirements, but softly depends on:
- For this module's supported test runners: - For this module's supported test runners:
- ~$ pip install pytest~ - ~$ pip install pytest~
- ~$ pip install nose~ - ~$ pip install nose~
- The [[doom-module:][:editor format]] module uses Black for python files: ~$ pip install black~ - The [[doom-module::editor format]] module uses Black for python files: ~$ pip install black~
- [[doom-package:][pyimport]] requires Python's module ~pyflakes~: ~$ pip install pyflakes~ - [[doom-package:pyimport]] requires Python's module ~pyflakes~: ~$ pip install pyflakes~
- [[doom-package:][py-isort]] requires [[https://github.com/timothycrosley/isort][isort]] to be installed: ~pip install isort~ - [[doom-package:py-isort]] requires [[https://github.com/timothycrosley/isort][isort]] to be installed: ~pip install isort~
- Python virtual environments install instructions at: - Python virtual environments install instructions at:
- [[https://github.com/pyenv/pyenv][pyenv]] - [[https://github.com/pyenv/pyenv][pyenv]]
- [[https://conda.io/en/latest/][Conda]] - [[https://conda.io/en/latest/][Conda]]
@ -82,9 +82,9 @@ This module has no hard requirements, but softly depends on:
- ~cython~ requires [[https://cython.org/][Cython]] - ~cython~ requires [[https://cython.org/][Cython]]
** Language Server Protocol Support ** Language Server Protocol Support
For LSP support the [[doom-module:][:tools lsp]] module must be enabled, along with this module's For LSP support the [[doom-module::tools lsp]] module must be enabled, along with this module's
[[doom-module:][+lsp]] flag. By default, it supports [[doom-package:][mspyls]] and [[doom-package:][pyls]], in that order. With the [[doom-module:+lsp]] flag. By default, it supports [[doom-package:mspyls]] and [[doom-package:pyls]], in that order. With the
[[doom-module:][+pyright]] flag, it will try Pyright first. [[doom-module:+pyright]] flag, it will try Pyright first.
Each of these servers must be installed on your system via your OS package Each of these servers must be installed on your system via your OS package
manager or manually: manager or manually:
@ -101,7 +101,7 @@ manager or manually:
This module supports LSP. It requires installation of [[https://pypi.org/project/python-language-server/][Python Language Server]], This module supports LSP. It requires installation of [[https://pypi.org/project/python-language-server/][Python Language Server]],
[[https://github.com/Microsoft/python-language-server][Microsoft Language Server]], or [[https://github.com/microsoft/pyright][pyright]], see [[Language Server Protocol Support][LSP Support]]. [[https://github.com/Microsoft/python-language-server][Microsoft Language Server]], or [[https://github.com/microsoft/pyright][pyright]], see [[Language Server Protocol Support][LSP Support]].
To enable support for auto-formatting with black enable [[doom-module:][:editor format]]. To enable support for auto-formatting with black enable [[doom-module::editor format]].
** Keybindings ** Keybindings
| Binding | Description | | Binding | Description |

4
modules/lang/qt/README.org
View file

@ -16,8 +16,8 @@ This module provides language functionality for [[https://qt.io][Qt]] specific f
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][qml-mode]] - [[doom-package:qml-mode]]
- [[doom-package:][qt-pro-mode]] - [[doom-package:qt-pro-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

4
modules/lang/racket/README.org
View file

@ -11,14 +11,14 @@ This module adds support for the [[https://www.racket-lang.org/][Racket programm
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable support for ~racket-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable support for ~racket-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://github.com/jeapostrophe/racket-langserver][racket-langserver]]). (supports [[https://github.com/jeapostrophe/racket-langserver][racket-langserver]]).
- +xp :: - +xp ::
Enable the explore mode (~racket-xp-mode~), which "analyzes expanded code to Enable the explore mode (~racket-xp-mode~), which "analyzes expanded code to
explain and explore." explain and explore."
** Packages ** Packages
- [[doom-package:][racket-mode]] - [[doom-package:racket-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

4
modules/lang/raku/README.org
View file

@ -13,8 +13,8 @@ This module adds support for the [[https://www.raku.org/][Raku programming langu
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][raku-mode]] - [[doom-package:raku-mode]]
- [[doom-package:][flycheck-raku]] if [[doom-module:][:checkers syntax]] - [[doom-package:flycheck-raku]] if [[doom-module::checkers syntax]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

12
modules/lang/rest/README.org
View file

@ -29,15 +29,15 @@ This module turns Emacs into a [[https://en.wikipedia.org/wiki/Representational_
*Requires the =jq= command line utility.* *Requires the =jq= command line utility.*
** Packages ** Packages
- [[doom-package:][company-restclient]] if [[doom-module:][:completion company]] - [[doom-package:company-restclient]] if [[doom-module::completion company]]
- [[doom-package:][restclient]] - [[doom-package:restclient]]
- if [[doom-module:][+jq]] - if [[doom-module:+jq]]
- [[doom-package:][restclient-jq]] - [[doom-package:restclient-jq]]
- [[doom-package:][jq-mode]] - [[doom-package:jq-mode]]
** Hacks ** Hacks
- Adds imenu support to ~restclient-mode~. - Adds imenu support to ~restclient-mode~.
- [[doom-package:][restclient]] has been modified not to silently reject self-signed or invalid - [[doom-package:restclient]] has been modified not to silently reject self-signed or invalid
certificates. certificates.
** TODO Changelog ** TODO Changelog

2
modules/lang/rst/README.org
View file

@ -13,7 +13,7 @@ This module adds [[https://docutils.sourceforge.io/rst.html][ReStructured Text]]
/This module has no flags./ /This module has no flags./
** Packages ** Packages
- [[doom-package:][sphinx-mode]] - [[doom-package:sphinx-mode]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

40
modules/lang/ruby/README.org
View file

@ -6,11 +6,11 @@
* Description :unfold: * Description :unfold:
This module add Ruby and optional Ruby on Rails support to Emacs. This module add Ruby and optional Ruby on Rails support to Emacs.
- Code completion ([[doom-package:][robe]]) - Code completion ([[doom-package:robe]])
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- Jump-to-definitions ([[doom-package:][robe]]) - Jump-to-definitions ([[doom-package:robe]])
- Bundler - Bundler
- Rubocop integration ([[doom-package:][flycheck]]) - Rubocop integration ([[doom-package:flycheck]])
** Maintainers ** Maintainers
- [[doom-user:][@hlissner]] - [[doom-user:][@hlissner]]
@ -21,7 +21,7 @@ This module add Ruby and optional Ruby on Rails support to Emacs.
- +chruby :: - +chruby ::
Enable chruby integration. Enable chruby integration.
- +lsp :: - +lsp ::
Enable LSP support for ~ruby-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~ruby-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports solargraph). (supports solargraph).
- +rails :: - +rails ::
Enable rails navigational commands, plus server+console integration. Enable rails navigational commands, plus server+console integration.
@ -31,23 +31,23 @@ This module add Ruby and optional Ruby on Rails support to Emacs.
Enable RVM (Ruby Version Manager) integration. Enable RVM (Ruby Version Manager) integration.
- +tree-sitter :: - +tree-sitter ::
Leverages tree-sitter for better syntax highlighting and structural text Leverages tree-sitter for better syntax highlighting and structural text
editing. Requires [[doom-module:][:tools tree-sitter]]. editing. Requires [[doom-module::tools tree-sitter]].
** Packages ** Packages
- [[doom-package:][bundler]] - [[doom-package:bundler]]
- [[doom-package:][chruby]] if [[doom-module:][+chruby]] - [[doom-package:chruby]] if [[doom-module:+chruby]]
- [[doom-package:][company-inf-ruby]] if :completion company - [[doom-package:company-inf-ruby]] if :completion company
- [[doom-package:][inf-ruby]] - [[doom-package:inf-ruby]]
- [[doom-package:][minitest]] - [[doom-package:minitest]]
- [[doom-package:][rake]] - [[doom-package:rake]]
- [[doom-package:][rbenv]] if [[doom-module:][+rbenv]] - [[doom-package:rbenv]] if [[doom-module:+rbenv]]
- [[doom-package:][robe]] - [[doom-package:robe]]
- [[doom-package:][rspec-mode]] - [[doom-package:rspec-mode]]
- [[doom-package:][rubocop]] - [[doom-package:rubocop]]
- [[doom-package:][rvm]] if [[doom-module:][+rvm]] - [[doom-package:rvm]] if [[doom-module:+rvm]]
- if [[doom-module:][+rails]] - if [[doom-module:+rails]]
- [[doom-package:][inflections]] - [[doom-package:inflections]]
- [[doom-package:][projectile-rails]] - [[doom-package:projectile-rails]]
** Hacks ** Hacks
/No hacks documented for this module./ /No hacks documented for this module./

26
modules/lang/rust/README.org
View file

@ -7,9 +7,9 @@
This module adds support for the Rust language and integration for its tools, This module adds support for the Rust language and integration for its tools,
e.g. ~cargo~. e.g. ~cargo~.
- Code completion ([[doom-package:][racer]] or an LSP server) - Code completion ([[doom-package:racer]] or an LSP server)
- Syntax checking ([[doom-package:][flycheck]]) - Syntax checking ([[doom-package:flycheck]])
- LSP support (for rust-analyzer and rls) ([[doom-package:][rustic]]) - LSP support (for rust-analyzer and rls) ([[doom-package:rustic]])
- Snippets - Snippets
** Maintainers ** Maintainers
@ -19,15 +19,15 @@ e.g. ~cargo~.
** Module flags ** Module flags
- +lsp :: - +lsp ::
Enable LSP support for ~rustic-mode~. Requires [[doom-module:][:tools lsp]] and a langserver Enable LSP support for ~rustic-mode~. Requires [[doom-module::tools lsp]] and a langserver
(supports [[https://rust-analyzer.github.io/][rust-analyzer]] and rls). (supports [[https://rust-analyzer.github.io/][rust-analyzer]] and rls).
** Packages ** Packages
- [[doom-package:][rustic]] - [[doom-package:rustic]]
** Hacks ** Hacks
- rustic has been modified /not/ to automatically install lsp-mode or eglot if - rustic has been modified /not/ to automatically install lsp-mode or eglot if
they're missing. Doom expects you to have enabled the [[doom-module:][:tools lsp]] module they're missing. Doom expects you to have enabled the [[doom-module::tools lsp]] module
yourself. yourself.
** TODO Changelog ** TODO Changelog
@ -49,9 +49,9 @@ rustup update --no-self-update
#+end_src #+end_src
** Other Requirements ** Other Requirements
- If [[doom-module:][:editor format]] is enabled, you'll need =rustfmt=: ~$ rustup component add - If [[doom-module::editor format]] is enabled, you'll need =rustfmt=: ~$ rustup component add
rustfmt-preview~. rustfmt-preview~.
- Users with [[doom-module:][+lsp]] enabled will need [[https://rust-analyzer.github.io/][rust-analyzer]] (rls is supported, but - Users with [[doom-module:+lsp]] enabled will need [[https://rust-analyzer.github.io/][rust-analyzer]] (rls is supported, but
[[https://blog.rust-lang.org/2022/07/01/RLS-deprecation.html][deprecated]]). [[https://blog.rust-lang.org/2022/07/01/RLS-deprecation.html][deprecated]]).
- Using the following commands requires: - Using the following commands requires:
- ~cargo-process-check~: ~$ cargo install cargo-check~ - ~cargo-process-check~: ~$ cargo install cargo-check~
@ -67,11 +67,11 @@ This module supports LSP integration. For it to work you'll need:
1. To install [[https://github.com/rust-analyzer/rust-analyzer][rust-analyzer]] through your OS package manager ([[https://github.com/rust-lang/rls][RLS]] is supported 1. To install [[https://github.com/rust-analyzer/rust-analyzer][rust-analyzer]] through your OS package manager ([[https://github.com/rust-lang/rls][RLS]] is supported
too, but it is [[https://blog.rust-lang.org/2022/07/01/RLS-deprecation.html][deprecated]]). too, but it is [[https://blog.rust-lang.org/2022/07/01/RLS-deprecation.html][deprecated]]).
2. To enable the [[doom-module:][:tools lsp]] module. 2. To enable the [[doom-module::tools lsp]] module.
3. To enable the [[doom-module:][+lsp]] flag on this module. 3. To enable the [[doom-module:+lsp]] flag on this module.
** Format on save ** Format on save
Enable [[doom-module:][:editor format +onsave]] to get formatting on save with =rustfmt=. No Enable [[doom-module::editor format +onsave]] to get formatting on save with =rustfmt=. No
additional configuration is necessary. additional configuration is necessary.
** Keybinds ** Keybinds
@ -95,7 +95,7 @@ additional configuration is necessary.
#+end_quote #+end_quote
** Enabling eglot support for Rust ** Enabling eglot support for Rust
Doom's [[doom-module:][:tools lsp]] module has an [[doom-module:][+eglot]] flag. Enable it and this module will use Doom's [[doom-module::tools lsp]] module has an [[doom-module:+eglot]] flag. Enable it and this module will use
eglot instead. eglot instead.
* Troubleshooting * Troubleshooting
@ -104,7 +104,7 @@ eglot instead.
** error[E0670]: `async fn` is not permitted in the 2015 edition ** error[E0670]: `async fn` is not permitted in the 2015 edition
You may be seeing this error, despite having ~edition = "2018"~ in your You may be seeing this error, despite having ~edition = "2018"~ in your
=Cargo.toml=. This error actually originates from ~rustfmt~, which the LSP =Cargo.toml=. This error actually originates from ~rustfmt~, which the LSP
server tries to invoke on save (if you have ~rustic-format-trigger~ or [[doom-module:][:editor server tries to invoke on save (if you have ~rustic-format-trigger~ or [[doom-module::editor
format]] enabled). format]] enabled).
To fix this your project needs a =rustfmt.toml= with ~edition = "2018"~ in it. To fix this your project needs a =rustfmt.toml= with ~edition = "2018"~ in it.

Some files were not shown because too many files have changed in this diff Show more