Introduction

Ctags generates an index (or tag) file of language objects found in source files that allows these items to be quickly and easily located by a text editor or other utility. A tag signifies a language object for which an index entry is available. Vim is the official editor of ctags (No vim plugin required). Plain and simple: ctags lets us jump around our source code using tags and a stack. Ctags (specifically Exuberant Ctags, not the BSD version shipped with OS X) indexes source code to make it easy to jump to functions, variables, classes, and other identifiers in (among other editors) Vim (see :help tags).

Homebrew’s package index. Homebrew Formulae. Install command: brew install vim. Vi 'workalike' with many additional features. Vim -with-gui: 7. Brew install macvim -with-override-system-vim override is to connect to mvim by enter vim at command line. In the stuation vim needs to be installed as well.

Prerequisites

Any Linux based OS with vim
Source code in any of the ctags supported programming languages

Installation

Ubuntu
CentOS
MacOS
Windows

How to generate tags file?

cd to the root directory of your source code
Run Ctags recursively over the entire source code to generate the tags file
Command to generate tags:

It would be silly to specify the long command in every source code directory.~/.ctags file to our rescue! Just list all the commonly used arguments ofctags and place it in your home directory and call it .ctags
If we have a ~/.ctags file, we can just enter our source code directory andgenerate a tags file using:

NOTE:

Feel free to exclude any other directories you don’t wish to search.
Feel free to explore and use the wealth of ctags command options

How to use tags?

To search for a specific tag and open Vim with its definition, run the following command in your shell: $ vim -t <tag>

Demo:

Open any source file in Vim and use the following basic commands:

Keyboard command	Action
`Ctrl + ]` OR `g]` OR `:ta[g] Ctrl+rw`	Jump to the tag underneath the cursor using the information in the tags file(s)
`:ts[elect] <tag_name>`	List the tags that match `<tag_name>`, using the information in the tags file(s). When `<tag_name>` is not given, the last tag name from the tag stack is used
`:pts[elect] <tag_name>`	Does `:tselect` and shows the new tag in a “Preview” window (horizontal split) without moving the cursor
`Ctrl + w }` OR `:ptag Ctrl+rw`	Opens a preview window with the location of the tag definition. The cursor does not change its position, so tag stack is not updated
`Ctrl + wz` OR `:pc`	Close preview window created by the command `Ctrl+w }`
`Ctrl + w Ctrl + ]`	Open the definition in a horizontal split
`:tn`	Jump to next matching tag (If there are multiple matches)
`:tp`	Jump to previous matching tag (If there are multiple matches)
`Ctrl-t`	Jump back up in the tag stack
`:tags`	Show the contents of the tag stack. The active entry is marked with a `>`

Ctrl+rw pastes the word under cursor in command mode. It’s just a quick copy paste command in vim

Demo

NOTE: vim commands will appear in the bottom left of the screen. Watching the demo in full screen is recommended for laptops.

NOTE:

I’ve just listed the basic shortcuts and commands that make sense to me and fit my typing speed. There are tons of other shortcuts and similar looking commands in :help tag . Feel free to use anything that suits your speed/workflow
Of course there are plenty of plugins out there with bells and whistles. I just don’t like plugins.

tag-regexp

The tag commands also accept a regular expression argument. When using a pattern, case is ignored. If you want to match case, use C in the pattern. When the argument starts with /, it is used as a regex pattern. If the argument does not start with /, it is taken literally, as a full tag name.Examples:

:tag main jumps directly to the tag “main”
:tag /^get jumps to the tag that starts with “get”
:tag /Final$ jumps to the tag that ends with “Final”
:tag /norm lists all the tags that contain “norm”, including “id_norm”
:tag /Final$C lists all the tags that end with “Final” (Doesn’t match “Cipher_final” or “SHA_FINAL”)

When the argument both exists literally, and match when used as a regexp, a literal match has a higher priority. For example, :tag /open matches “open” before “open_file” and “file_open”.

Demo:

Notes:

People have written whole books just for regex.This demo doesn’t cover the complex patterns
This demo covers the regular expressions that I use frequently and are simple to remember
Feel free to try out your complex regex (regex101)

Sample regex searches with vim

Requirement	Command
Search tags containing ‘aes’	`vim -t '/aes'`
Search tags ending with ‘sha1’	`vim -t '/sha1$'`
Search tags beginning with ‘evp’ and ending with ‘sha1’	`vim -t '/^evpw+sha1$'`
Search tags beginning with ‘EVP’ and ending with ‘sha1’(case sensitive)	`vim -t '/^EVPw+sha1$C'`
Search tags beginning with ‘evp’, ending with ‘sha1’ and containing ‘aes_xxx’ in between	`vim -t '/^evpw+aes_dddw+sha1$'`
Search tags beginning with alphabets (no numbers) and ending with ‘sha1’	`vim -t '/^[a-zA-Z]w+sha1$'`

Keeping the index file up-to-date

The major downside to Ctags is having to manually rebuild that index all the time. There are multiple ways of automating this stuff:

However, here’s an easy one using vim autocommands:Add the following lines to your ~/.vimrc file.

Create a ~/.vimrc if it doesn’t exist

Where,

Example

If you’re in openssl source code directory, add the following lines to crypto/aes/aes_cbc.c and exit the file using vim command :wq!

Verify tags file:

Of course it’s going to rebuild the entire index and take a lotof time for large projects. Remember, I said it’s easy (not quick)

References:

Credits

I’ve compiled a list of essential Vim commands that I use every day. I have then given a few instructions on how to make Vim as great as it should be, because it’s painful without configuration.

Essentials

Cursor movement (Normal/Visual Mode)

hjkl - Arrow keys
w / b - Next/previous word
W / B - Next/previous word (space seperated)
e / ge - Next/previous end of word
0 / $ - Start/End of line
^ - First non-blank character of line (same as 0w)

Editing text

i / a - Start insert mode at/after cursor
I / A - Start insert mode at the beginning/end of the line
o / O - Add blank line below/above current line
Esc or Ctrl+[ - Exit insert mode
d - Delete
dd - Delete line
c - Delete, then start insert mode

Brew Vim