[nongnu] elpa/go-mode d9a9e51731 5/7: Deprecate functions and customization pertaining to GOPATH

[ELPA Syncer]

branch: elpa/go-mode
commit d9a9e517313855b62f56eb55b739073eb862cefe
Author: Dominik Honnef <dominik@honnef.co>
Commit: Dominik Honnef <dominik@honnef.co>

    Deprecate functions and customization pertaining to GOPATH
    
    Updates: gh-174
---
 README.md  | 9 ---------
 go-mode.el | 9 +++++++--
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 283cfb7a67..e8f985237c 100644
--- a/README.md
+++ b/README.md
@@ -61,15 +61,6 @@ the following extra features to provide an improved 
experience:
 
   All of these functions accept a prefix argument (`C-u`), causing
   them to skip anonymous functions.
-- GOPATH detection – the function `go-guess-gopath` will guess a
-  suitable value for GOPATH, based on gb or wgo projects, Godeps and
-  src folders for plain GOPATH workspaces. The command
-  `go-set-project` uses the return value of `go-guess-gopath` to set
-  the GOPATH environment variable.
-
-  You can either call `go-set-project` manually, or integrate it with
-  Projectile's project switching hooks, or any other means of
-  switching projects you may employ.
 
 # Installation
 
diff --git a/go-mode.el b/go-mode.el
index 2dc253462b..ba4dcc8b36 100644
--- a/go-mode.el
+++ b/go-mode.el
@@ -214,6 +214,8 @@ look like others."
   :type '(repeat function)
   :group 'go)
 
+(make-obsolete-variable 'go-guess-gopath-functions "GOPATH has been deprecated 
in favour of Go modules." "1.7.0")
+
 (defcustom go-confirm-playground-uploads t
   "Ask before uploading code to the public Go Playground.
 
@@ -1749,8 +1751,6 @@ The following extra functions are defined:
 - `go-download-play'
 - `godef-describe' and `godef-jump'
 - `go-coverage'
-- `go-set-project'
-- `go-reset-gopath'
 
 If you want to automatically run `gofmt' before saving a file,
 add the following hook to your Emacs configuration:
@@ -2760,6 +2760,7 @@ returned."
 
 (defun go-guess-gopath (&optional buffer)
   "Determine a suitable GOPATH for BUFFER, or the current buffer if BUFFER is 
nil."
+  (declare (obsolete "GOPATH has been deprecated in favour of Go modules." 
"1.7.0"))
   (with-current-buffer (or buffer (current-buffer))
     (let ((gopath (cl-some (lambda (el) (funcall el))
                            go-guess-gopath-functions)))
@@ -2772,6 +2773,7 @@ returned."
 (defun go-plain-gopath ()
   "Detect a normal GOPATH, by looking for the first `src'
 directory up the directory tree."
+  (declare (obsolete "GOPATH has been deprecated in favour of Go modules." 
"1.7.0"))
   (let ((d (locate-dominating-file buffer-file-name "src")))
     (if d
         (list d))))
@@ -2787,6 +2789,7 @@ of when Emacs was started.
 This function can for example be used as a
 projectile-switch-project-hook, or simply be called manually when
 switching projects."
+  (declare (obsolete "GOPATH has been deprecated in favour of Go modules." 
"1.7.0"))
   (interactive)
   (let ((gopath (or (go-guess-gopath buffer)
                     (go-original-gopath))))
@@ -2795,6 +2798,7 @@ switching projects."
 
 (defun go-reset-gopath ()
   "Reset GOPATH to the value it had when Emacs started."
+  (declare (obsolete "GOPATH has been deprecated in favour of Go modules." 
"1.7.0"))
   (interactive)
   (let ((gopath (go-original-gopath)))
     (setenv "GOPATH" gopath)
@@ -2802,6 +2806,7 @@ switching projects."
 
 (defun go-original-gopath ()
   "Return the original value of GOPATH from when Emacs was started."
+  (declare (obsolete "GOPATH has been deprecated in favour of Go modules." 
"1.7.0"))
   (let ((process-environment initial-environment)) (getenv "GOPATH")))
 
 (defun go--insert-modified-files ()