[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/tempel f7990f528b 11/82: README update
From: |
ELPA Syncer |
Subject: |
[elpa] externals/tempel f7990f528b 11/82: README update |
Date: |
Sun, 9 Jan 2022 20:58:41 -0500 (EST) |
branch: externals/tempel
commit f7990f528b552c59f0bc787a1d88620aba53e064
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
README update
---
README.org | 22 +++++++++++++---------
1 file changed, 13 insertions(+), 9 deletions(-)
diff --git a/README.org b/README.org
index dd3b720f4f..5c26d4e9f9 100644
--- a/README.org
+++ b/README.org
@@ -24,9 +24,9 @@ keys ~M-left/right~ as defined in the ~tempel-map~ keymap. 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 your snippet and templating requirements
-are limited and if you like tiny and simple packages. Tempel took inspiration
-from the [[https://nschum.de/src/emacs/tempo-snippets/][Tempo-Snippets]]
package by Nikolaj Schumacher
([[https://github.com/nschum/tempo-snippets.el][GitHub link]]).
+YASnippet library. Try Tempel only if you like tiny and simple packages and if
+you want to write templates in Lisp syntax. Tempel took inspiration from the
+[[https://nschum.de/src/emacs/tempo-snippets/][Tempo-Snippets]] package by
Nikolaj Schumacher ([[https://github.com/nschum/tempo-snippets.el][GitHub
link]]).
* Quick start
@@ -47,9 +47,9 @@ and has to be installed manually with ~package-install-file~.
* Template file format
-The template file format is a lisp file =templates= which is stored by default
in
+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
+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.
@@ -84,14 +84,14 @@ org-mode
* Template syntax
-All the syntax elements of ~tempo-define-template~ are supported. We document
-the important ones here:
+All the Tempo syntax elements are fully supported. The syntax elements are
+described in detail in ~tempo-define-template~ are supported. We document the
+important ones here:
- "string" :: Inserts a string literal.
- ~p~ :: Inserts an unnamed prompt field.
- ~r~ :: Inserts the current region.
- ~(s NAME)~ :: Inserts a named field.
- - ~(q PROMPT NAME)~ :: Query the user via ~read-string~, store variable
~NAME~.
- ~n~ :: Inserts a newline.
- ~>~ :: Indents with ~indent-according-to-mode~.
- ~r>~ :: The region, but indented.
@@ -99,5 +99,9 @@ the important ones here:
- ~&~ :: Insert newline if there is only whitespace between line start and
point.
- ~%~ :: Insert newline if there is only whitespace between point and line
end.
- ~o~ :: Like ~%~ but leaves the point before newline.
- - ~(form ...)~ :: Other lisp forms are evaluated. Named fields are lexically
bound.
+
+Furthermore Tempel supports two syntax extensions:
+
+ - ~(q PROMPT NAME)~ :: Query the user via ~read-string~ and store the result
in variable ~NAME~.
+ - ~(form ...)~ :: Other Lisp forms are evaluated. Named fields are lexically
bound.
Use caution with templates which execute code!
- [elpa] externals/tempel 52d8556c05 57/82: Improve annotation function, (continued)
- [elpa] externals/tempel 52d8556c05 57/82: Improve annotation function, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 675e759bde 64/82: Add special prompt treatment, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel e6aa1892af 14/82: README: Simplify template, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 2ba940809a 42/82: Add temple-abort (Fix #2), ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 5521546f48 10/82: README: Add header, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel d2d5566282 65/82: Improve description of PROMPT/DEFAULT value, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel e529887d5d 70/82: tempel-expand: Fix exit function, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 349e9735ac 08/82: Remove global temple-region variable, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel bdf04d8c48 05/82: Improved field movement, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 76a5ab120b 15/82: Add customization variables, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel f7990f528b 11/82: README update,
ELPA Syncer <=
- [elpa] externals/tempel 5807ca4d28 33/82: Use remappings, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 9291904a84 24/82: Simplify overlay updates, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 5e1a864123 68/82: Add tempel-abbrev to define an abbrev, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 6c288c32a2 80/82: README: Document Capf setup (Fix #14), ELPA Syncer, 2022/01/09
- [elpa] externals/tempel b5cea7ac67 03/82: Add template markers, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 545b929a28 45/82: README: Fix formatting, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 1ef2d76dd1 35/82: Add screenshots, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel fcfb19e134 47/82: Improve undo, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel 36a7977702 62/82: Use cyan color for default values, ELPA Syncer, 2022/01/09
- [elpa] externals/tempel bcf135f993 66/82: Bind lexical environment for prompt eval, ELPA Syncer, 2022/01/09