otty / dotfiles

All tools/Universal Ctags

Universal Ctags

ctags

Generate an index (or tag) file of language objects found in source files.

Detected by ctags | macOS, Linux, Windows |ctags.io

Sync it ctags.toml

Sync rules

What travels, what stays, what never leaves

Universal Ctags in your home directory Every rule on this page, by file

· ~/.config/ctags/ Sync

· ~/.ctags.d/ Sync

· ~/ctags.d/ Sync

· ~/.ctags Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/ctags.tomlThe file this page is generated from

id = "ctags"

name = "Universal Ctags"

homepage = "https://ctags.io/"

description = "Generate an index (or tag) file of language objects found in source files."

# The green tag mark the Universal Ctags organisation uses as its avatar;

# the project publishes no separate logo file.

icon = "https://github.com/universal-ctags.png"

detect = ["ctags"]

# https://docs.ctags.io/en/latest/option-file.html: "At start-up time, ctags

# loads files having .ctags as a file extension under the following statically

# defined directories:

# 1. $XDG_CONFIG_HOME/ctags/, or $HOME/.config/ctags/ if $XDG_CONFIG_HOME is

# not defined

# 2. $HOME/.ctags.d/

# 3. $HOMEDRIVE$HOMEPATH/ctags.d/ (on Windows)"

# The first reads the variable itself, so it is [configHome]. The other two are

# home-directory directories; $HOMEDRIVE$HOMEPATH is the Windows user profile,

# which resolves to the same place as ~. The remaining two entries on that list,

# ./.ctags.d/ and ./ctags.d/, are per-project and not user level.

# The same page says Universal Ctags "doesn't load any of the files Exuberant

# Ctags loads at start-up", so ~/.ctags is Exuberant Ctags' file — its man page

# (https://ctags.sourceforge.net/ctags.html, FILES) lists $HOME/.ctags — and it

# is here because on many machines the binary called `ctags` is still Exuberant.

paths = [

"[configHome]/ctags/",

"~/.ctags.d/",

"~/ctags.d/",

"~/.ctags",

]

# ctags writes nothing back into these directories; the tags file it produces

# goes wherever the user asked for it.

exclude = []

secret = []

# ctags reads these files once per run and exits, so rewriting one between runs

# cannot disturb anything.

side_effect = false

# No machine_lines: these files hold --langdef, --regex-<LANG> and --exclude

# options, which are the definitions a user wants on every machine. An

# --options=/absolute/path line exists but is rare, and a prefix rule on

# "--options" would strand the common relative form with it.

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/ctags. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.