linenoise: submit and stay in history.

* linenoise/linenoise.c (struct lino_state): New member
save_hist_idx.
(edit): If save_hist_idx is set, jump to that history position
and clear it.  Handle ENTER in extended (Ctrl-X) mode
similarly to regular ENTER, but setting save_hist_idx.

* txr.1: Documented.

1 files changed, 14 insertions, 0 deletions

diff --git a/txr.1 b/txr.1
index bff5c833..9cf5c862 100644
--- a/txr.1
+++ b/txr.1
@@ -38256,6 +38256,20 @@ Navigating to a history line manually using the up and down arrow keys (or
 Ctrl-P/Ctrl-N) has the same net effect same as locating that line using
 Ctrl-R search.
 
+.NP* Submit and Stay in History
+
+Normally when the Enter key is used on a recalled history line,
+the next time the listener is re-entered, it jumps back to the
+newest history position where a new line is about to be composed.
+
+The alternative command sequence Ctrl-X, Enter provides a useful alternative
+behavior. After the submitted line is processed, the listener doesn't jump to
+the newest history position. Instead, it stays in the history, advancing
+forward by one position to the successor of the submitted line.
+
+Ctrl-X, Enter can be used to conveniently submit a range of lines
+from the history, one by one, in their original order.
+
 .NP* Insert Previous Word
 
 The equivalent command sequences Ctrl-X, w and Ctrl-X, Ctrl-W insert