From 36c190d0569aa5640ac649ed359cb893872afd2a Mon Sep 17 00:00:00 2001 From: Tslil Clingman Date: Mon, 9 Jul 2018 10:36:13 +0200 Subject: Better defaults, explicit call, fixed history/default --- README.md | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 467819a..7cdaa0f 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,15 @@ An emacs minor mode to surround the region with smart delimiters interactively. ![siege-mode.gif](siege-mode.gif) ## Lay siege to the region from both sides! -### (with the power of regular expressions) +#### (with the power of regular expressions) -When the region is active, all input is redirected to the minibuffer and treated -as a delimiter for the region. The input is used as the left delimiter from -which the right one is derived using `siege-transform-regexs` applied to tokens -generated by `siege-boundary-list` and `siege-block-*`. If such derivations are -not desired they may be disabled via "C-c a" in the minibuffer or by default -(`siege-default-derive`). +When the region is active, most input¹ is redirected to the minibuffer and +treated as a delimiter for the region. The input is used as the left delimiter +from which the right one is derived using `siege-transform-regexs` applied to +tokens generated by `siege-boundary-list' and `siege-block-*`. If such +derivations are not desired they may be disabled via "C-c a" in the minibuffer +or by default (`siege-default-derive`). This process may be explicitly invoked +by calling `siege-explicit-call`, bound to "M-s M-s". All changes are dynamically displayed in the buffer (see `siege-preview-face`) and may be committed by "Ret" in the minibuffer. It is also possible to commit @@ -25,3 +26,10 @@ pair both `_{` and `^{` with `}` by default. ## License GPL v3+ + +## Technical note + +¹ siege-mode remaps `self-insert-command` so that key-presses which would +otherwise simply insert a character trigger delimiter input. This would seem to +be the best compromise between usability and unobtrusiveness, but the author is +certainly open to suggestion. -- cgit v1.3.1