Universal-Ctags packaged as an installable snap for Linux
Ctags parses source code to produce an index file, mapping the names of
symbols, like functions, classes, and variables, to the locations where
they are defined. This index is used by editors like Vim and Emacs
to enable features like 'go to definition'.
Universal Ctags (https://ctags.io/) is an active fork of the venerable
Exuberant Ctags (http://ctags.sourceforge.net/, last release 2009), that
adds additional features, including support for more languages.
This is the snap package of universal-ctags
(https://snapcraft.io/universal-ctags),
which installs the application binary on any Linux distribution.
Usage
When installed, this snap provides executable universal-ctags
,
and alias ctags
.
ctags [options] [target files or directories]
eg. ctags -R .
(-R
or --recurse
to recursively search directories),
or ctags -R --languages=python --exclude=.git src/
.
This snap does not install the man pages. See the online universal-ctags man
pages at http://docs.ctags.io/en/latest/man/ctags.1.html
for options and usage details.
Limitations
Compared to universal-ctags installed using apt, or compiled from source,
this snap has some limitations, introduced by snap security restrictions.
Source files cannot be scanned if they are:
- Outside the user's $HOME directory, or
- In a top-level hidden directory in $HOME, eg.
~/.src
.
Lower-level hidden directories, eg. ~/proj/.src
, can be scanned.
Ctags usually reads config from the following directories:
- The user's
~/.ctags.d/
is read as expected.
- The current directory's
ctags.d
is not read by default,
but the '--options' arg can be used to read from it.
- The current directory's
.ctags.d
cannot be read.
Configuration in other places, specified using --options
or --options-maybe
, will not be read if they are outside the
user's HOME, or in a top-level hidden directory.
Tag files written using '-f' options or similar may not be outside
the user's $HOME directory, nor in a top-level hidden file or directory.
You may be able to work around this by using -f -
and redirecting stdout
to the required location.
The universal-ctags man pages are not installed. But you can see them
online at http://docs.ctags.io/en/latest/man/ctags.1.html
The 'etags' executable alias (which defaults to Emacs style tags files)
is not installed. Use ctags --output-format=etags
or ctags -e
instead.
If these or other issues cause you problems, please
file an issue at https://github.com/universal-ctags/ctags-snap/issues.