Guru PointsTo

CHANGELOG.md

@@ -1,5 +1,19 @@
 ## unplanned
 
+## unplanned
+
+FEATURES:
+
+* Add `:GoPointsTo` to show all variables to which the pointer under the cursor
+  may point to.
+  [[GH-1751]](https://github.com/fatih/vim-go/pull/1751)
+
+IMPROVEMENTS:
+
+BUG FIXES:
+
+BACKWARDS INCOMPATIBILITIES:
+
 ## 1.17 - (March 27, 2018)
 
 FEATURES:

autoload/go/guru.vim

@@ -156,7 +156,6 @@ function! s:async_guru(args) abort
     return
   endif
 
-
   if !has_key(a:args, 'disable_progress')
     if a:args.needs_scope
       call go#util#EchoProgress("analysing with scope " . result.scope .
@@ -262,6 +261,18 @@ function! go#guru#Implements(selected) abort
   call s:run_guru(args)
 endfunction
 
+" Shows the set of possible objects to which a pointer may point.
+function! go#guru#PointsTo(selected) abort
+  let l:args = {
+        \ 'mode': 'pointsto',
+        \ 'format': 'plain',
+        \ 'selected': a:selected,
+        \ 'needs_scope': 1,
+        \ }
+
+  call s:run_guru(l:args)
+endfunction
+
 " Report the possible constants, global variables, and concrete types that may
 " appear in a value of type error
 function! go#guru#Whicherrs(selected) abort

doc/vim-go.txt

@@ -676,6 +676,12 @@ CTRL-t
         \| command! -bang AS call go#alternate#Switch(<bang>0, 'split')
     augroup END
 <
+
+                                                                 *:GoPointsTo*
+:GoPointsTo
+
+    Show all variables to which the pointer under the cursor may point to.
+
                                                                 *:GoWhicherrs*
 :GoWhicherrs
 
@@ -1030,6 +1036,10 @@ Show send/receive corresponding to selected channel op
 
 Show all refs to entity denoted by selected identifier
 
+                                                               *(go-pointsto)*
+
+Show all variables to which the pointer under the cursor may point to.
+
                                                              *(go-metalinter)*
 
 Calls `go-metalinter` for the current directory

ftplugin/go/commands.vim

@@ -4,6 +4,7 @@ command! -nargs=? -complete=customlist,go#rename#Complete GoRename call go#renam
 " -- guru
 command! -nargs=* -complete=customlist,go#package#Complete GoGuruScope call go#guru#Scope(<f-args>)
 command! -range=% GoImplements call go#guru#Implements(<count>)
+command! -range=% GoPointsTo call go#guru#PointsTo(<count>)
 command! -range=% GoWhicherrs call go#guru#Whicherrs(<count>)
 command! -range=% GoCallees call go#guru#Callees(<count>)
 command! -range=% GoDescribe call go#guru#Describe(<count>)

ftplugin/go/mappings.vim

@@ -44,6 +44,7 @@ xnoremap <silent> <Plug>(go-freevars) :<C-u>call go#guru#Freevars(0)<CR>
 nnoremap <silent> <Plug>(go-channelpeers) :<C-u>call go#guru#ChannelPeers(-1)<CR>
 nnoremap <silent> <Plug>(go-referrers) :<C-u>call go#guru#Referrers(-1)<CR>
 nnoremap <silent> <Plug>(go-sameids) :<C-u>call go#guru#SameIds()<CR>
+nnoremap <silent> <Plug>(go-pointsto) :<C-u>call go#guru#PointsTo(-1)<CR>
 nnoremap <silent> <Plug>(go-whicherrs) :<C-u>call go#guru#Whicherrs(-1)<CR>
 nnoremap <silent> <Plug>(go-sameids-toggle) :<C-u>call go#guru#ToggleSameIds()<CR>