[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/transient daa22e7632 317/366: manual: Downcase keywords
From: |
Jonas Bernoulli |
Subject: |
[elpa] externals/transient daa22e7632 317/366: manual: Downcase keywords |
Date: |
Tue, 25 Jan 2022 18:54:51 -0500 (EST) |
branch: externals/transient
commit daa22e7632e90b44513d1babc83e159b0b32e8a8
Author: Jonas Bernoulli <jonas@bernoul.li>
Commit: Jonas Bernoulli <jonas@bernoul.li>
manual: Downcase keywords
---
docs/transient.org | 82 +++++++++++++++++++++++++++---------------------------
1 file changed, 41 insertions(+), 41 deletions(-)
diff --git a/docs/transient.org b/docs/transient.org
index 04aedc739d..319768c8db 100644
--- a/docs/transient.org
+++ b/docs/transient.org
@@ -1,20 +1,20 @@
-#+TITLE: Transient User and Developer Manual
+#+title: Transient User and Developer Manual
:PREAMBLE:
-#+AUTHOR: Jonas Bernoulli
-#+EMAIL: jonas@bernoul.li
-#+DATE: 2018-{{{year}}}
-#+LANGUAGE: en
-
-#+TEXINFO_DIR_CATEGORY: Emacs
-#+TEXINFO_DIR_TITLE: Transient: (transient).
-#+TEXINFO_DIR_DESC: Transient Commands
-#+SUBTITLE: for version {{{version}}}
-
-#+TEXINFO_DEFFN: t
-#+OPTIONS: H:4 num:4 toc:2
-#+PROPERTY: header-args :eval never
-#+MACRO: version (eval (ox-texinfo+-get-version 'mixed))
-#+MACRO: year (eval (format-time-string "%Y"))
+#+author: Jonas Bernoulli
+#+email: jonas@bernoul.li
+#+date: 2018-{{{year}}}
+#+language: en
+
+#+texinfo_dir_category: Emacs
+#+texinfo_dir_title: Transient: (transient).
+#+texinfo_dir_desc: Transient Commands
+#+subtitle: for version {{{version}}}
+
+#+texinfo_deffn: t
+#+options: H:4 num:4 toc:2
+#+property: header-args :eval never
+#+macro: version (eval (ox-texinfo+-get-version 'mixed))
+#+macro: year (eval (format-time-string "%Y"))
Taking inspiration from prefix keys and prefix arguments, Transient
implements a similar abstraction involving a prefix command, infix
@@ -36,10 +36,10 @@ reading a new value in the minibuffer.
Calling a suffix command usually causes the transient to be exited
but suffix commands can also be configured to not exit the transient.
-#+TEXINFO: @noindent
+#+texinfo: @noindent
This manual is for Transient version {{{version}}}.
-#+BEGIN_QUOTE
+#+begin_quote
Copyright (C) 2018-{{{year}}} Jonas Bernoulli <jonas@bernoul.li>
You can redistribute this document and/or modify it under the terms
@@ -51,7 +51,7 @@ This document is distributed in the hope that it will be
useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
-#+END_QUOTE
+#+end_quote
:END:
* Introduction
@@ -62,7 +62,7 @@ arguments and suffix commands. We could call this
abstraction a
commands (a prefix and a suffix) we prefer to call it just a
"transient".
-#+BEGIN_QUOTE
+#+begin_quote
Transient keymaps are a feature provided by Emacs. Transients as
implemented by this package involve the use of transient keymaps.
@@ -71,7 +71,7 @@ talk about "prefix commands" in this manual, then we mean our
own kind
of "prefix commands", unless specified otherwise. To avoid ambiguity
we sometimes use the terms "transient prefix command" for our kind and
"regular prefix command" for Emacs' kind.
-#+END_QUOTE
+#+end_quote
When the user calls a transient prefix command, then a transient
(temporary) keymap is activated, which binds the transient's infix and
@@ -106,7 +106,7 @@ arguments have been set using a command such as
~universal-argument~.
The information shown in the popup buffer while a transient is active
looks a bit like this:
-#+BEGIN_EXAMPLE
+#+begin_example
,-----------------------------------------
|Arguments
| -f Force (--force)
@@ -116,15 +116,15 @@ looks a bit like this:
| t tag
| r release
`-----------------------------------------
-#+END_EXAMPLE
+#+end_example
-#+BEGIN_QUOTE
+#+begin_quote
This is a simplified version of ~magit-tag~. Info manuals do not
support images or colored text, so the above "screenshot" lacks some
information; in practice you would be able to tell whether the
arguments ~--force~ and ~--annotate~ are enabled or not based on their
color.
-#+END_QUOTE
+#+end_quote
Transient can be used to implement simple "command dispatchers". The
main benefit then is that the user can see all the available commands
@@ -800,9 +800,9 @@ brackets to do the latter.
Group specifications then have this form:
-#+BEGIN_SRC emacs-lisp
+#+begin_src emacs-lisp
[{LEVEL} {DESCRIPTION} {KEYWORD VALUE}... ELEMENT...]
-#+END_SRC
+#+end_src
The LEVEL is optional and defaults to 4. See [[*Enabling and Disabling
Suffixes]].
@@ -895,9 +895,9 @@ suffixes". Here it means the former.
Suffix specifications have this form:
-#+BEGIN_SRC emacs-lisp
+#+begin_src emacs-lisp
([LEVEL] [KEY] [DESCRIPTION] COMMAND|ARGUMENT [KEYWORD VALUE]...)
-#+END_SRC
+#+end_src
LEVEL, KEY and DESCRIPTION can also be specified using the KEYWORDs
~:level~, ~:key~ and ~:description~. If the object that is associated with
@@ -1754,13 +1754,13 @@ The following diagrams illustrate some of the
differences.
See [[info:elisp#Prefix Keys]].
-#+BEGIN_EXAMPLE
+#+begin_example
,--> command1 --> (c)
|
(c)-(+)-> prefix command or key --+--> command2 --> (c)
|
`--> command3 --> (c)
-#+END_EXAMPLE
+#+end_example
*** Regular Prefix Arguments
:PROPERTIES:
@@ -1769,7 +1769,7 @@ See [[info:elisp#Prefix Keys]].
See [[info:elisp#Prefix Command Arguments]].
-#+BEGIN_EXAMPLE
+#+begin_example
,----------------------------------,
| |
v |
@@ -1783,7 +1783,7 @@ See [[info:elisp#Prefix Command Arguments]].
^ |
| |
`-------- discards --------'
-#+END_EXAMPLE
+#+end_example
*** Transients
:PROPERTIES:
@@ -1794,7 +1794,7 @@ See [[info:elisp#Prefix Command Arguments]].
This diagram ignores the infix value and external state:
-#+BEGIN_EXAMPLE
+#+begin_example
(c)
| ,- {stay} ------<-,-<------------<-,-<---,
(+) | | | |
@@ -1818,12 +1818,12 @@ This diagram ignores the infix value and external state:
|--> {call} -->--'
|
`------------------> {exit} --> (c)
-#+END_EXAMPLE
+#+end_example
This diagram takes the infix value into account to an extend, while
still ignoring external state:
-#+BEGIN_EXAMPLE
+#+begin_example
(c)
| ,- {stay} ------<-,-<------------<-,-<---,
(+) | | | |
@@ -1863,12 +1863,12 @@ still ignoring external state:
|--> {call} -->--' ^
| |
`------------------> {exit} --> (c)
-#+END_EXAMPLE
+#+end_example
This diagram provides more information about the infix value
and also takes external state into account.
-#+BEGIN_EXAMPLE
+#+begin_example
,----sets--- "anything"
|
v
@@ -1922,7 +1922,7 @@ and also takes external state into account.
|--> {call} -->--' ^
| |
`------------------> {exit} --> (c)
-#+END_EXAMPLE
+#+end_example
- ~{1}~ Transients can be configured to be exited when a suffix command
is invoked. The default is to do so for all suffixes except for
@@ -2147,7 +2147,7 @@ necessary changes. See its doc string for more
information.
:COPYING: t
:END:
-#+BEGIN_QUOTE
+#+begin_quote
Copyright (C) 2018-{{{year}}} Jonas Bernoulli <jonas@bernoul.li>
You can redistribute this document and/or modify it under the terms
@@ -2159,7 +2159,7 @@ This document is distributed in the hope that it will be
useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
-#+END_QUOTE
+#+end_quote
# LocalWords: ARGLIST ARGS DOCSTRING ELEMENTs EVAL GROUPs Infixes
# LocalWords: Infixes KEYWORDs LOC LocalWords MERCHANTABILITY Magit
- [elpa] externals/transient e90481000f 271/366: Explicitly call transient--pre-command in button action, (continued)
- [elpa] externals/transient e90481000f 271/366: Explicitly call transient--pre-command in button action, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient efdf91980a 273/366: transient--goto-button: Anchor headings, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient e17e2b2f6d 276/366: transient-show-help: Tweak self-suffixes, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient be119ee43f 278/366: Export variables for transient non-infix suffixes, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 022f20e958 283/366: Explicitly require edmacro, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 09c911e621 299/366: transient--show-manual: New function, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 222637523a 302/366: transient-show-help: Refactor and improve, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient c9ab648e5b 304/366: transient--show-help: Update doc-strings, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 349116159f 308/366: manual: Use Org macros, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient e57d1e176b 313/366: make: Cosmetics, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient daa22e7632 317/366: manual: Downcase keywords,
Jonas Bernoulli <=
- [elpa] externals/transient 1cdadfddf8 340/366: manual: Use source block, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient c2875e705a 362/366: transient--delay-post-command: Add debug statement, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient e0b57679f7 359/366: transient--debug: Re-align output, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 73694be44a 179/366: transient-infix-read: Support use by regular commands, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient e2fee19879 204/366: Support using variables in group and suffix specifications, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 9b17afb9a0 214/366: transient-infix-set: Remove outdated claim from doc-string, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient cbc078d84c 215/366: transient--with-emergency-exit: Re-signal errors directly, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient d555d26004 221/366: transient-format-description(lisp-variable): Return string, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient 9a1d62699f 222/366: transient-force-fixed-pitch: Fix doc-string, Jonas Bernoulli, 2022/01/25
- [elpa] externals/transient d85eb790e8 235/366: transient-read-directory: Pass read value through file-local-name, Jonas Bernoulli, 2022/01/25