findtags(1p) [debian man page]

FINDTAGS(1p)						User Contributed Perl Documentation					      FINDTAGS(1p)

NAME

       findtags - find tags in Interchange catalogs and directories

SYNOPSIS

	 findtags -a -d lib/UI
	 findtags -a -d lib/UI -t -u
	 findtags -a -u -t

DESCRIPTION

       Find tags in Interchange catalogs and directories -- intended to develop a list for TagInclude.

       WARNING: This is not 100%, for developing tag names from Variable definitions and other sources can fool it. If you include all
       directories, make sure you don't include documentation files or the usertags themselves.

       With the standard distribution, this should find just about all tags needed:

	       findtags -a -d lib/UI

       To develop a TagInclude statement which excludes unused tags, try:

	       findtags -a -d lib/UI -t -u

       If you don't want to use the UI, then do:

	       findtags -a -u -t

OPTIONS

       -a  Look in all catalogs.

       -c CAT
	   Only look in catalog CAT.

       -d DIR1 DIR2 ....
	   Look in given directories.

       -f FILE
	   Use alternate interchange.cfg file FILE.

       -h  Display help.

       -n  Don't report system tags.

       -t  Output suitable for TagInclude directive.

       -u  Report unseen tags.

       -v  Slightly verbose, report directories scanned.

       -x DIR1 DIR2 ....
	   Exclude given directories from scanning. Default is session and tmp.

perl v5.14.2							    2012-01-23							      FINDTAGS(1p)

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)