carta
update-otags(8)

update-otags8

Update system-wide tags tables

Usage

update-otags

Overview

update-otags runs otags on the system-wide installed OCaml files (in ocamlc -where). This makes it possible to use the tag-features of vi/vim and Emacs to jump to the declarations of library functions in the system-wide installed .mli files to read the documentation that is hopefully embedded in those files.

To use the system-wide tags table in Emacs, use M-x visit-tags-table <RET> /var/lib/otags/TAGS. To load it by default, customize tags-table-list to contain /var/lib/otags (by using M-x customize-variable, for instance).

For vim use :set tags=/var/lib/otags/tags or add set tags=/var/lib/otags/tags to your .vimrc.

One would typically update the system-wide tags tables with a cron-job once per week or day.

Files

/var/lib/otags/{TAGS,tags}

System-wide tags table for Emacs and vi/vim.

Credits

update-otags appeared first in Debian Etch (see Debian bug #341939). It has been added to the contrib directory with an improved man page in otags 3.12.2.

History

  • Debian 12 (Bookworm) to Debian 10 (Buster): the text shown here
  • Debian 9 (Stretch)
  • Debian 8 (Jessie) to Debian 7 (Wheezy)
  • Debian 6.0 (Squeeze)

Bugs

See the sections KNOWN PROBLEMS and MISSING FEATURES in the otags(1) manual.

Author

Hendrik Tews <otags at askra.de>

From otags 4.05.1-3 in Debian 12 (Bookworm). Parsed by carta from the page's man source.