ivalkeen / vim-ctrlp-tjump Goto Github PK

CtrlP extension for fuzzy-search in tag matches (:tjump replacement).

Vim Script 100.00%

vim ctrlp-extension ctags ctrlp ctrlp-tjump viml

vim-ctrlp-tjump's Introduction

CtrlP tjump

CtrlP extension for fuzzy-search in tag matches. May be used instead of :tjump or :tselect for IDE-like Goto declaration functionality, which jumps to the declaration in case of one match, and shows quick-search window in case of multiple matches.

Two vim commands are created by this plugin:

CtrlPtjump - go to declaration of the identifier supplied as an argument, if not use the word under cursor
CtrlPtjumpVisual - go to declaration of the visual selected text

Prerequisites

CtrlP should be installed
Tags should already work with :tag, :tselect and :tjump commands. More information on that here.

Installation

Use your favorite method (I prefer Vundle)

(Optional) Create mapping

nnoremap <c-]> :CtrlPtjump<cr>
vnoremap <c-]> :CtrlPtjumpVisual<cr>

Basic Usage

Move cursor to the Class/Method usage in your code
Press c-] (if you have created mapping) or just execute :CtrlPtjump (or :CtrlPtjumpVisual in visual mode) in the command line.

Or provide the symbol as an argument:

:CtrlPtjump MyFavoriteClass

Configuration

It is possible to configure shortener for filenames, that will be displayed in CtrlP window. In the example below, RegExp '/home/.*/gems/' will be substituted by string '.../'. This may be useful if filename (with path) of generated tag is long and you want to make it shorter.

let g:ctrlp_tjump_shortener = ['/home/.*/gems/', '.../']

If there is only one tag found, it is possible to open it without opening CtrlP window:

let g:ctrlp_tjump_only_silent = 1

The tag name itself takes valuable screen estate and can be disabled by:

let g:ctrlp_tjump_skip_tag_name = 1

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

Self-Promotion

If you like this project, please follow the repository on GitHub and vote for it on vim.org. Also, you might consider visiting my blog and following me on Twitter and Github.

vim-ctrlp-tjump's People

Contributors

Stargazers

Watchers

Forkers

larrylv pjkack qianchenglong justinburke backes dummyunit seto1 zeero

vim-ctrlp-tjump's Issues

Provide more context about tag

https://www.tkalin.com/blog_posts/ide-like-go-to-declaration-in-vim/#disqus_thread

Check if it's possible to sort tags by priority and provide at least class name and maybe some additional info.

The default :tjump command runs after :CtrlPtjump

When I use the :CtrlPtjump command, the nice CtrlP window is displayed with the tag locations, but when I select one of them, the CtrlP window closes and then the default :tjump command apparently runs and displays the normal tags menu (where you select a tag by number). Do I need to disable some default behavior to prevent the second window from displaying?

Suggestion when only one candidate

When there's only one candidate, it would be better if CtrlPtjump would just pick it instead of showing you the CtrlP dialog.

bugs: search warning and no history

I've got VIM configured to restore last position in file (http://vim.wikia.com/wiki/Restore_cursor_to_file_position_in_previous_editing_session) and whenever I jump I get warning that search reached the end of document and blah-blah-blah. It would be awesome if you either silent search command or just move to first line of file before it.
History is not maintained. Whenever I try to get back () like with usual tags I'm getting wrong buffer.

CtrlP keys do not work with tjump

I can't open tags in vertical of split windows, or tabs, as I can open files in CtrlP. Can you fix this issue?

Respect `g:ctrlp_open_single_match` option of CtrlP

Currently there is a separate option for that in vim-ctrlp-tjump plugin. Consider removing it in favour of just respecting CtrlP's g:ctrlp_open_single_match

some error

Error detected while processing function <SNR>141_AcceptSelection..ctrlp#tjump#accept..<SNR>169_open_tag:
line    1:
E687: Less targets than List items
line    2:
E121: Undefined variable: idx
E116: Invalid arguments for function feedkeys

tag files:

https://dl.dropboxusercontent.com/u/185589/tags.tar.bz2

file itself:

https://dl.dropboxusercontent.com/u/185589/Application.php

in detail:

go to line 225 of Application.php, then try to jump at detectWebEnvironment
error above is shown. I first didn't notice that its a next method, but managed to reproduce same error in similar situation (tag in same file, 2 tag files).

tselect and tjump count differ

For some tags, :1tag differs from :tselect 1. Thus, :CtrlPtjump 1 (that uses taglist() which matches the output of tselect) differs from tselect 1 and :CtrlPtjump does not jump to the chosen tag.

This offset might be a Vim bug and happens over here for large TeX files, dunno if this issue is known in other cases as well.

CtrlP shows no entries but tjump shows matches

Seems to jump straight to the declaration when there is only one match, but if there are more it shows CtrlP window with == NO ENTRIES ==

However if I use :tjump at the same position I get the old list of matches which I can jump to by entering the number.

My ctags file is generated by a git hook: https://github.com/greg0ire/git_template/blob/master/hooks/php/ctags/update-ctags

Doest it need to install package ctags first?

Doest it need to install package ctags first? Then vim-ctrlp-tjump should work?

let g:ctrlp_tjump_only_silent = 0

Supposedly

" Skip selection window if only one match found
let g:ctrlp_tjump_only_silent = 0

should be moved from the autoload to the plugin folder to avoid the value set in .vimrc being overwritten.

unable to open tag in tab with ctrl-T

normally in ctrlp I can open a given file in a tab with ctrl-T. I'm not able to do that for some reason in this plugin.

CtrlP shows only one tag or does not show tjump mode at all

I've just encountered the problem similar to the issue #3 :

Latest versions of CtrlP and CtrlP-TJump installed via Pathogen
set tags=/absolute/path/to/tags
Default mapping created to C-]
:tjump and :tselect work properly
setting cursor on a name and pressing C-] shows CtrlP dialog with tjump mode and proper tag selected

However, if I press the C-P for the CtrlP dialog there is no tjump mode.
If I go to some tag via C-] first, then tjump mode appears in CtrlP, but it only contains the tag I've opened via C-].