Ctags: Difference between revisions
→Etags: add see also |
Rescuing 1 sources and tagging 0 as dead. #IABot (v1.5beta) |
||
Line 29: | Line 29: | ||
* [[EmEditor|EmEditor Professional]] |
* [[EmEditor|EmEditor Professional]] |
||
* [[Geany]] |
* [[Geany]] |
||
* [[Gedit]] (via gedit-symbol-browser-plugin found on [http://www.micahcarrick.com/11-14-2007/gedit-symbol-browser-plugin.html]) |
* [[Gedit]] (via gedit-symbol-browser-plugin found on [https://web.archive.org/web/20080117145432/http://www.micahcarrick.com/11-14-2007/gedit-symbol-browser-plugin.html]) |
||
* Gnome Builder |
* Gnome Builder |
||
* [[JED (text editor)|JED]] |
* [[JED (text editor)|JED]] |
Revision as of 04:55, 15 August 2017
This article needs additional citations for verification. (November 2011) |
Developer(s) | Ken Arnold |
---|---|
Repository | |
Type | Programming tool (Specifically: Code navigation tool) |
Ctags is a programming tool that generates an index (or tag) file of names found in source and header files of various programming languages. Depending on the language, functions, variables, class members, macros and so on may be indexed. These tags allow definitions to be quickly and easily located by a text editor or other utility. Alternatively, there is also an output mode that generates a cross reference file, listing information about various names found in a set of language files in human-readable form.
The original Ctags was introduced in BSD Unix and was written by Ken Arnold, with Fortran support by Jim Kleckner and Pascal support by Bill Joy.
Editors that support ctags
Tag index files are supported by many source code editors, including:
- Atom
- BBEdit 8+
- CodeLite (as its tag indexer for code completion)
- Cloud9 IDE (uses it internally but does not expose it)
- EditPlus
- Emacs and XEmacs
- EmEditor Professional
- Geany
- Gedit (via gedit-symbol-browser-plugin found on [1])
- Gnome Builder
- JED
- jEdit (via plugins CodeBrowser, Tags, ClassBrowser, CtagsSideKick, and Jump)
- JOE
- KDevelop
- Kate
- mcedit (Midnight Commander builtin editor) [2]
- NEdit
- Notepad++ (via OpenCTags plug-in)
- Programmer's Notepad
- QDevelop
- Scratch
- TSE (via macro)
- Sublime Text (via plugin found on [3])
- TextMate (via CodeBrowser-PlugIn)
- UltraEdit
- TextPad
- VEDIT
- vi (and derivatives such as Elvis, Nvi, Vim, vile, etc.)
- Xedit (X11)
Variants of ctags
There are a few variations of the ctags program:
Etags
Etags is the ctags utility that comes with Emacs. For those options which only make sense for vi style tag files produced by ctags, etags could not recognize them and would ignore them.
![]() | This section needs expansion. You can help by adding to it. (June 2008) |
Exuberant Ctags
Exuberant Ctags, written and maintained by Darren Hiebert, was initially distributed with Vim, but became a separate project upon the release of Vim 6.[1] It includes support for Emacs compatibility.
Exuberant Ctags includes support for over 40 programming languages with the ability to add support for even more using regular expressions.
Hasktags
Hasktags creates ctags compatible tag files for Haskell source files.[2] It includes support for creating Emacs etags files.[3]
jsctags
jsctags is a ctags-compatible code indexing solution for JavaScript.[4] It is specialized for JavaScript and its packaging system CommonJS and outperforms Exuberant Ctags for JavaScript code, finding more tags than the latter.[5]
Universal Ctags
Universal Ctags is a fork of Exuberant Ctags, Universal-ctags has the objective of continuing the development from Exuberant Ctags. Github exuberant-ctags repository was started by Reza Jelveh and was later moved to the Universal-ctags organization. The goal of the project is preparing and maintaining common/unified space where people interested in making Ctags better can work together.
Tags file formats
There are multiple tag file formats. Some of them are described below. In the following, <\x##> represents the byte with hexadecimal representation ##.
Ctags and Exuberant Ctags
The original ctags and Exuberant Ctags have similar file formats:[6]
Ctags
This is the format used by vi and various clones. The tags file is normally named "tags".
The tags file is a list of lines, each line in the format:
{tagname}<Tab>{tagfile}<Tab>{tagaddress}
The fields are specified as follows:
- {tagname} – Any identifier, not containing white space
- <Tab> – Exactly one tab character, although many versions of vi can handle any amount of white space
- {tagfile} – The name of the file where {tagname} is defined, relative to the current directory
- {tagaddress} – An ex mode command that will take the editor to the location of the tag. For POSIX implementations of vi this may only be a search or a line number.
The tags file is sorted on the {tagname} field which allows for fast searching of the tags file.
Exuberant Ctags
This is the format used by Vim. It can generate an original ctags file format or an extended format that attempts to retain backward compatibility.
The fields are specified as follows:
{tagname}<Tab>{tagfile}<Tab>{tagaddress}[;"<Tab>{tagfield}...]
The fields up to and including {tagaddress} are the same as for ctags above.
Optional additional fields are indicated by square brackets ("[...]") and include:
- ;" – semicolon + double quote: Ends the {tagaddress} in a way that looks like the start of a comment to vi.
- {tagfield}
Extended format extends the {tagaddress} field under certain circumstances to include a set of extension fields embedded in an ex comment immediately appended to the ex command, which leaves it backward-compatible with original vi implementations. These extension fields are tab separated "key:value" pairs, documented in the ctags manual.
Etags
This is the format used by Emacs etags. The tags file is normally named "TAGS".
The etags files consists of multiple sections—one section per input source file. Sections are plain-text with several non-printable ascii characters used for special purposes. These characters are represented as bracketed hexadecimal codes below.
A section starts with a two line header, one line containing a single <\x0c> character, followed by a line which consists of:
{src_file},{size_of_tag_definition_data_in_bytes}
The header is followed by tag definitions, one definition per line, with the format:
{tag_definition_text}<\x7f>{tagname}<\x01>{line_number},{byte_offset}
{tagname} (along with <\x01>) can be omitted if the name of the tag can be deduced from the text at the tag definition.
Example
Given a single line test.c source code:
#define CCC(x)
The TAGS file would look like this:
<\x0c> test.c,21 #define CCC(<\x7f>CCC<\x01>1,0
See also
References
- ^ "Vim documentation: version6: ctags-gone". Retrieved 2007-04-28.
- ^ "GHC documentation: Other Haskell utility programs". Retrieved 2010-03-05.
- ^ "hasktags: Produces ctags "tags" and etags "TAGS" files for Haskell programs". Retrieved 2010-03-05.
- ^ "pcwalton github repository for jsctags".
- ^ Patrick Walton. "Introducing jsctags". Retrieved 2010-05-25.
- ^ "Proposal for extended Vi tags file format". Retrieved 2007-06-30.
External links
- The Single UNIX Specification, Version 4 from The Open Group : create a tags file – Shell and Utilities Reference,
- Universal Ctags on Github
- Exuberant ctags homepage
- Ctags on VMS
- source code for Emacs vtags.el module