branch: elpa/go-mode
commit a13b8146bfde207513327d95e5e85cefadf99832
Author: Peter Gardfjäll <[email protected]>
Commit: Peter Sanford <[email protected]>
Add option to reuse a single buffer for godoc
This introduces a customization variable 'godoc-reuse-buffer' which, when
non-nil, makes godoc-at-point reuse the same ("*godoc*") buffer to write
output
from all invocations. The default behavior (when nil), is still to write
each
output to a separate buffer (*godoc <path>*).
Closes: #295 [via git-merge-pr]
---
go-mode.el | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/go-mode.el b/go-mode.el
index 853de70..a5a6890 100644
--- a/go-mode.el
+++ b/go-mode.el
@@ -239,6 +239,12 @@ Only really desirable when using `godoc' instead of `go
doc'."
:type 'boolean
:group 'godoc)
+(defcustom godoc-reuse-buffer nil
+ "Reuse a single *godoc* buffer to display godoc-at-point calls.
+The default behavior is to open a separate buffer for each call."
+ :type 'boolean
+ :group 'godoc)
+
(defcustom godoc-at-point-function #'godoc-and-godef
"Function to call to display the documentation for an
identifier at a given position.
@@ -1694,9 +1700,15 @@ you save any file, kind of defeating the point of
autoloading."
(go-packages) nil nil nil 'go-godoc-history)
(read-from-minibuffer "godoc: " nil nil nil 'go-godoc-history)))
+(defun godoc--buffer-name (query)
+ "Determine the name to use for the output buffer of a given godoc QUERY."
+ (if godoc-reuse-buffer
+ "*godoc*"
+ (concat "*godoc " query "*")))
+
(defun godoc--get-buffer (query)
"Get an empty buffer for a godoc QUERY."
- (let* ((buffer-name (concat "*godoc " query "*"))
+ (let* ((buffer-name (godoc--buffer-name query))
(buffer (get-buffer buffer-name)))
;; Kill the existing buffer if it already exists.
(when buffer (kill-buffer buffer))
