branch: master
commit cbfa182ddf11eac3dbe1470e7a5d9dbadb6dfef0
Author: rocky <ro...@gnu.org>
Commit: rocky <ro...@gnu.org>
Improve realgud:run-process docstring
---
realgud/common/run.el | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/realgud/common/run.el b/realgud/common/run.el
index 580216c..ff428f9 100644
--- a/realgud/common/run.el
+++ b/realgud/common/run.el
@@ -111,10 +111,17 @@ Note that path elements have been expanded via
`expand-file-name'.
minibuffer-history
&optional no-reset)
"Runs `realgud-exec-shell' with DEBUGGER-NAME SCRIPT-FILENAME
-and CMD-ARGS If this succeeds, we save CMD-ARGS in command-buffer
+and CMD-ARGS. If this succeeds, we save CMD-ARGS in command-buffer
for use if we want to restart. If we don't succeed in running
the program, we will switch to the command buffer which shows
-details of the error. The command buffer or nil is returned."
+details of the error. The command buffer or nil is returned.
+
+Normally command buffers are reused when the same debugger is
+reinvoked inside a command buffer with a similar command. If we
+discover that the buffer has prior command-buffer information and
+NO-RESET is nil, then that information which may point into other
+buffers and source buffers which may contain marks and fringe or
+marginal icons is reset."
(let ((cmd-buf))
(setq cmd-buf
