.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "LINTIAN-ANNOTATE-HINTS 1"
.TH LINTIAN-ANNOTATE-HINTS 1 2024-02-05 "Lintian v2.117.0" "Debian Package Checker"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
lintian\-annotate\-hints \- give detailed information about Lintian's error tags
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBlintian-annotate-hints\fR [\fIlog-file\fR...]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBlintian-annotate-hints\fR command parses the EWI output of the
\&\fBlintian\fR command and gives verbose information about the listed
Lintian tags, or parses a Lintian override file and gives verbose
information about the tags included.
.PP
If no log-file is specified on the command line, this command expects
its input on stdin. Thus, the output of \fBlintian\fR can either be piped
through \fBlintian-annotate-hints\fR or a log file produced by \fBlintian\fR can be
processed with this command.
.PP
(Note, though, that the \fBlintian\fR command has a command line option
\&\fB\-i\fR to display the same results as \fBlintian-annotate-hints\fR, so you
normally do not need to pipe the output of \fBlintian\fR through this
command to see the extra information.)
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-a\fR, \fB\-\-annotate\fR" 4
.IX Item "-a, --annotate"
Read from standard input or any files specified on the command line
and search the input for lines formatted like Lintian override
entries.  For each one that was found, display verbose information
about that tag.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Display usage information and exit.
.IP "\fB\-\-include\-dir\fR dir" 4
.IX Item "--include-dir dir"
Use dir as an additional "Lintian root".  The directory is expected
have a similar layout to the LINTIAN_BASE (if it exists), but does not
need to be a full self-contained root.
.Sp
Unlike \fBlintian\fR, \fBlintian-annotate-hints\fR will \fInot\fR load any code from
these additional directories.
.Sp
This option may appear more than once; each time adding an additional
directory.
.IP "\fB\-\-profile\fR prof" 4
.IX Item "--profile prof"
Use the severities from the vendor profile prof when displaying tags.
If the profile name does not contain a slash, the default profile for
that vendor is chosen.
.Sp
If not specified, \fBannotate-lintian-hint\fR loads the best profile for the
current vendor.
.Sp
Please Refer to the Lintian User Manual for the full documentation of
profiles.
.IP "\fB\-\-user\-dirs\fR, \fB\-\-no\-user\-dirs\fR" 4
.IX Item "--user-dirs, --no-user-dirs"
By default, \fBlintian\fR will check \fR\f(CI$HOME\fR\fI\fR and \fI/etc\fR for files
supplied by the user or the local sysadmin (e.g. profiles).  This
default can be disabled (and re-enabled) by using \fB\-\-no\-user\-dirs\fR
(and \fB\-\-user\-dirs\fR, respectively).
.Sp
These option can appear multiple times, in which case the of them
to appear determines the result.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBlintian\fR\|(1)
.SH AUTHORS
.IX Header "AUTHORS"
Niels Thykier <niels@thykier.net>
.PP
Richard Braakman <dark@xs4all.nl>
.PP
Christian Schwarz <schwarz@monet.m.isar.de>