diff options
| author | Jonas Bernoulli <jonas@bernoul.li> | 2025-02-15 23:57:48 +0100 |
|---|---|---|
| committer | Jonas Bernoulli <jonas@bernoul.li> | 2025-02-15 23:57:48 +0100 |
| commit | 04dab99dc9bc8788ed17473118421e6ee291091d (patch) | |
| tree | 7ed9129a0d61348d0b26b6ec05c1283c1f9a04c7 /docs/transient.org | |
| parent | 73178e00b645be29c9282aafc0b8e7a6c4851ec6 (diff) | |
transient-display-buffer-action: Discourage dropping alist elements
Re #358, but others have made the same mistake before.
Diffstat (limited to 'docs/transient.org')
| -rw-r--r-- | docs/transient.org | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/transient.org b/docs/transient.org index 64e546d..5eba758 100644 --- a/docs/transient.org +++ b/docs/transient.org @@ -621,6 +621,11 @@ Also see [[* Common Suffix Commands]]. For alternatives see [[info:elisp#Buffer Display Action Functions]], and [[info:elisp#Buffer Display Action Alists]]. + When you switch to a different ACTION, you should keep the ALIST + entries for ~dedicated~ and ~inhibit-same-window~ in most cases. + Do not drop them because you are unsure whether they are needed; + if you are unsure, then keep them. + Note that the buffer that was current before the transient buffer is shown should remain the current buffer. Many suffix commands act on the thing at point, if appropriate, and if the transient |