Visit Our UNIX and Linux User Community

UPDATE-OTAGS(8) 					  System administration commands					   UPDATE-OTAGS(8)

NAME
update-otags - update system-wide tags tables SYNOPSIS
update-otags DESCRIPTION
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-ta- ble-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. /usr/share/otags/hints Directory for parsing hints. Packages that install files in non-standard syntax can install a parser hints file for otags in this directory, see option -parser-hints in the otags(1) manual. BUGS
Camlp4 (and therefore otags too) cannot parse all legal OCaml sources. Most notably, camlp4 dies on pervasives.mli (see bug #5495). There- fore, none of the core library functions are tagged. Various files in the system-wide OCaml directory are written in the revised syntax or require other syntax extensions. In principle these files can all be properly tagged, but the dumb update-otags script tries to parse all files with the original syntax. 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. AUTHOR
Hendrik Tews <otags at askra.de> SEE ALSO
otags(1) OTAGS
January 2012 UPDATE-OTAGS(8)

Featured Tech Videos