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)
Check Out this Related Man Page
RC-ALERT(1) General Commands Manual RC-ALERT(1)NAME
rc-alert - check for installed packages with release-critical bugs
SYNOPSIS
rc-alert [inclusion options] [--debtags [tag[,tag ...]] [--popcon] [package ...]
rc-alert --help|--version
DESCRIPTION
rc-alert downloads the list of release-critical bugs from the Debian BTS webpages, and then outputs a list of packages installed on the
system, or given on the command-line, which are in that list.
If the directory ~/.devscripts_cache exists or the --cache option is given, then the (sizable) downloaded list will be cached, and will
only be downloaded again on a second invocation if it has changed.
OPTIONS --cache
Force the creation of the ~/.devscripts_cache cache directory.
--help, -h
Show a summary of options.
--version, -v
Show version and copyright information.
It is also possible to filter the list of bugs reported based on the tags and distributions associated with the package. The filtering
options are:
--include-tags, -f
A list of tags which the bug must have, in the format used for output. For example, to include bugs tagged security or help wanted,
use "SH".
--include-tag-op, -t
If set to and, a bug must have all of the tags specified by --include-tags.
--exclude-tags
A list of tags which the bug must not have, in the same format as --include-tags.
--exclude-tag-op
If set to and, a bug must have none of the tags specified by --exclude-tags. By default, the bug will be excluded if any tag
matches.
--include-dists, -d
A list of distributions which the bug must apply to, in the format used for output. For example, to include bugs affecting testing
or unstable, use "TU".
--include-dist-op, -o
If set to and, a bug must apply to all of the specified distributions in order to be included.
--exclude-dists
A list of distributions to which the bug must not apply, in the same format as --include-dists.
--exclude-dist-op
If set to and, a bug must apply to all of the specified distributions in order to be excluded. By default the bug will be excluded
if it applies to any of the listed distributions.
It is also possible to only list bugs which have specific debtags set. Note that you need to have debtags installed and also that it's not
mandatory for maintainers to set proper debtags. The produced list will thus probably be incomplete.
--debtags
Match packages based on the listed tags. Each package is matched only if it has all the listed tags; in the case of multiple tags
within the same facet, a package is matched if it has any of the listed tags within the facet.
--debtags-database
Use a non-standard debtags database. The default is /var/lib/debtags/packages-tags.
Popularity-contest collects data about installation and usage of Debian packages. You can additionally sort the bugs by the popcon rank of
the related packages.
--popcon
Sort bugs by the popcon rank of the package the bug belongs to.
--pc-vote
By default, packages are sorted according to the number of people who have the package installed. This option enables sorting by the
number of people regularly using the package instead. This option has no effect in combination with --pc-local.
--pc-local
Instead of requesting remote data the information from the last popcon run is used (/var/log/popularity-contest).
EXAMPLES --include-dists OS
The bug must apply to at least one of oldstable or stable
--include-dists TU --include-dist-op and
The bug must apply to both testing and unstable
--include-dists O --include-tags S --exclude-tags +
The bug must apply to oldstable and be tagged security but not patch
--exclude-dists SOT --include-tags R
The bug must apply to only unstable or experimental (or both) and be tagged unreproducible
--debtags implemented-in::perl,role::plugin,implemented-in::python
The bug must apply to packages matching the specified debtags, i.e. the match will only include packages that have the 'role::plug-
in' tag and that have either of the tags 'implemented-in::perl' or 'implemented-in::python'.
--popcon --pc-local
Read /var/log/popularity-contest and sort bugs by your personal popcon ranking (which is basically the atime of your packages' bina-
ries).
BUGS
It is not possible to say "does not apply only to unstable"
SEE ALSO debtags(1)popbugs(1)popularity-contest(8)AUTHOR
rc-alert was written by Anthony DeRobertis and modified by Julian Gilbey <jdg@debian.org> and Adam D. Barratt <adam@adam-barratt.org.uk>
for the devscripts package. Debtags and popcon functionality was added by Jan Hauke Rahm <info@jhr-online.de>.
DEBIAN Debian Utilities RC-ALERT(1)