emenel/doomemacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
doomemacs/modules/editor/lispy
History
Henrik Lissner 037b018cdd
feat: add .doommodule files 
These optional dotfiles indicate the root of a module or module
group (:lang), and will later contain module metadata. They will also
serve as an alternative to packages.el and doctor.el, and will aide the
parts of the v3.0 module API concerned with resolving the current module
from a path (`doom-module-from-path`), which currently rely too heavily
on parsing path strings.

For now, however, they're simply placeholders.
2024-09-14 20:47:39 -04:00
..
.doommodule feat: add .doommodule files 2024-09-14 20:47:39 -04:00
config.el feat(emacs-lisp,lispy): recognize ;;* outline headings 2022-10-29 01:57:43 +02:00
packages.el bump: :editor lispy parinfer snippets word-wrap 2023-09-14 01:04:09 +02:00
README.org docs(*): replace all-the-icons with nerd-icons 2023-09-16 20:19:11 +02:00

README.org

:editor lispy

Description   unfold

This module adds a keybind scheme for navigating and editing S-expressions in Lisps; including S-exp awareness for Evil users. This affects the following languages:

  • Common Lisp
  • Emacs Lisp
  • Scheme
  • Racket
  • Hy
  • LFE
  • Clojure
  • Fennel

Maintainers

This module needs a maintainer. Become a maintainer?

Module flags

This module has no flags.

Packages

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module has no external requirements.

TODO Usage

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

If doom-module::editor evil is enabled, doom-package:lispyville would also be activated for every mode where doom-package:lispy is active.

TODO Configuration

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

The default key themes that are set are as follows:

'((operators normal)
  c-w
  (prettify insert)
  (atom-movement normal visual)
  slurp/barf-lispy
  additional
  additional-insert)

To change the key themes set lispyville-key-theme. Think of lispyville-key-theme as the equivalent of parinfer-extensions. See lispyville's README for more info on the specific keybindings of each key theme (starting here).

Working with Brackets

By default, [ and ] are bound to lispyville-previous-opening and lispyville-next-closing respectively. If you use a language which makes frequent use of brackets (e.g. Clojure, Racket, Scheme), you can insert a bracket pair [] by typing {. If you prefer to use the bracket keys for input, you can rebind them like below:

;; in $DOOMDIR/config.el

(map! :after (lispy lispyville)
      :map lispy-mode-map-lispy
      ;; unbind individual bracket keys
      "[" nil
      "]" nil
      ;; re-bind commands bound to bracket keys by default
      "M-[" #'lispyville-previous-opening
      "M-]" #'lispyville.next-opening)

Troubleshooting

Report an issue?

Mouse wheel and wrap=/=additional-wrap key themes in TTY Emacs (#2573)

lispyville binds M-[ to lispyville-wrap-brackets when the wrap or additional-wrap key themes are enabled. In terminal Emacs, this is the key Emacs receives when you scroll with your mouse wheel.

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

󱌣 This module has no appendix yet. Write one?