[nongnu] elpa/go-mode 9af89df 006/495: add docstrings to go-goto-imports, go-play-region and go-play-buffer

[ELPA Syncer]

branch: elpa/go-mode
commit 9af89df9eeeaeb6ca83b0e33d87e631b3f1adecd
Author: Dominik Honnef <dominikh@fork-bomb.org>
Commit: Dominik Honnef <dominikh@fork-bomb.org>

    add docstrings to go-goto-imports, go-play-region and go-play-buffer
---
 go-mode.el | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/go-mode.el b/go-mode.el
index 0ae5b2e..6935d72 100644
--- a/go-mode.el
+++ b/go-mode.el
@@ -443,6 +443,26 @@ Replace the current buffer on success; display errors on 
failure."
     nil))
 
 (defun go-goto-imports ()
+  "Move point to the block of imports.
+
+If using
+
+  import (
+    \"foo\"
+    \"bar\"
+  )
+
+it will move point directly behind the last import.
+
+If using
+
+  import \"foo\"
+  import \"bar\"
+
+it will move point to the next line after the last import.
+
+If no imports can be found, point will be moved after the package
+declaration."
   (interactive)
   ;; FIXME if there's a block-commented import before the real
   ;; imports, we'll jump to that one.
@@ -462,10 +482,13 @@ Replace the current buffer on success; display errors on 
failure."
 
 
 (defun go-play-buffer ()
+  "Like `go-play-region', but acts on the entire buffer."
   (interactive)
   (go-play-region (point-min) (point-max)))
 
 (defun go-play-region (start end)
+  "Send the region to the Playground and stores the resulting
+link in the kill ring."
   (interactive "r")
   (let* ((url-request-method "POST")
          (url-request-extra-headers