[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/tempel 1222c59b30 39/82: Update README
From: |
ELPA Syncer |
Subject: |
[elpa] externals/tempel 1222c59b30 39/82: Update README |
Date: |
Sun, 9 Jan 2022 20:58:43 -0500 (EST) |
branch: externals/tempel
commit 1222c59b308d2d396ecc544fbab3eab21bdcc698
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
Update README
---
README.org | 35 ++++++++++++++++++-----------------
1 file changed, 18 insertions(+), 17 deletions(-)
diff --git a/README.org b/README.org
index c4a02371f5..816f461475 100644
--- a/README.org
+++ b/README.org
@@ -9,22 +9,23 @@
* Introduction
-Tempel is a tiny template package for Emacs, which uses the syntax of the
-Emacs Tempo library. Tempo is an ancient temple. It is 27 years old, but still
-in good shape since it successfully resisted change over the decades. Tempel
-is a modernized implementation of Tempo, in the form of two commands:
+Tempel is a tiny template package for Emacs, which uses the syntax of the Emacs
+Tempo library. Tempo is an ancient temple. It is 27 years old, but still in
good
+shape since it successfully resisted change over the decades. However it may
+look a bit dusty here and there. Therefore I present to you, Tempel, a
+modernized implementation of Tempo, in the form of two commands:
-+ ~tempel-expand~: Expand a template at point in the buffer. If called
++ ~tempel-expand~ expands a template at point in the buffer. If called
non-interactively the function behaves like a completion-at-point-function
- (Capf). You may want to use my [[https://github.com/minad/corfu][Corfu]]
completion at point UI.
-+ ~tempel-insert~: Select a template by name and insert it into the current
buffer.
+ (Capf). You may want to give my [[https://github.com/minad/corfu][Corfu]]
completion at point UI a try.
++ ~tempel-insert~ selects a template by name and insert it into the current
buffer.
-After inserting a template you can move between the visible template fields
with
-the keys ~M-{~, ~M-}~ or ~C-up/down~ which are normally bound to
-~forward/backward-paragraph~. Tempel remaps them to ~tempel-next~ and
-~tempel-previous~. The keys are defined in the ~tempel-map~ keymap, you can
change
-them there. As soon as you move before (behind) the first (last) field, the
-fields are removed.
+After inserting the template you can move between the visible template fields
+with the keys ~M-{~, ~M-}~ or ~C-up/down,~ which are normally bound to
+~forward/backward-paragraph~. Tempel temporarily remaps these commands to
+~tempel-next~ and ~tempel-previous~. The key bindings are defined in the
~tempel-map~
+keymap. You can customize them there. As soon as you move before (behind) the
+first (last) field, the fields are removed.
Note that this package is not a competitor to the mature and widely used
YASnippet library. Try Tempel only if you like small and simple packages. With
@@ -55,9 +56,9 @@ and has to be installed manually with ~package-install-file~.
The template file format is a Lisp file =templates= which is stored by default
in
the ~user-emacs-directory~ (=~/.config/emacs/templates=). The templates are
defined
-as Lisp expressions in the concise form of the Emacs Tempo package. The first
-element of the list is the name of the template. After the name the Tempo
-elements follow.
+as Lisp expressions in the concise form of the Emacs Tempo syntax. The first
+element of the list is the name of the template. Behind the name, the Tempo
+syntax elements follow.
#+begin_src emacs-lisp
;; -*- mode: lisp -*-
@@ -126,4 +127,4 @@ Furthermore Tempel supports syntax extensions:
- ~(p (FORM ...) <NAME>)~ Execute ~FORM~ and insert the result, optionally
bind to ~NAME~.
- ~(FORM ...)~ Other Lisp forms are evaluated. Named fields are lexically
bound.
-Use caution with templates which execute code!
+Use caution with templates which execute arbitrary code!
- [elpa] externals/tempel 09a0e3bfb0 19/82: Improve annotations, (continued)
- [elpa] externals/tempel 09a0e3bfb0 19/82: Improve annotations, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 16b0fa274a 09/82: Rename commands, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 73cee5feb6 12/82: Update comments, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel b54036f1fa 21/82: Add comment, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 11cfbe239d 36/82: Fix undo, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel ffdf2c792a 77/82: Document the abbrev modes (See #14), ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 460f8fe806 81/82: Fix the MELPA issues, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel aec4f10253 82/82: Addition to GNU ELPA, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel d4bd649645 59/82: Minor renaming, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 2cff879181 30/82: Do not call modification hooks from forms, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 1222c59b30 39/82: Update README,
ELPA Syncer <=
- [elpa] externals/tempel 07d16fded7 67/82: Update fields when new field is inserted, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel f0df571f66 17/82: Respect derived modes, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel bf95b3f1c2 31/82: Add support for (q (FORM ...) var), ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 64f896d782 44/82: Fix jump to first field, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 9948c6889d 43/82: Add tempel-form-prefix and tempel-field-prefix, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel ad71c25632 32/82: Add syntax extension (p (FORM...) <NAME>), ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 5dbdc76eb2 74/82: Specify the completion category tempel, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 65a3eb0458 76/82: Improve abbreviation expansion, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 57bbc5e681 78/82: README update, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel ac3df540a4 69/82: Remove underlines from faces, ELPA Syncer, 2022/01/09