.\" -*- 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-EXPLAIN-TAGS 1"
.TH LINTIAN-EXPLAIN-TAGS 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\-explain\-tags \- offer more information about Lintian's tags
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBlintian-explain-tags\fR \fB\-\-tags\fR \fItag\fR ...
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBlintian-explain-tags\fR command explains the named tags given on
the command line.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-l\fR, \fB\-\-list\-tags\fR" 4
.IX Item "-l, --list-tags"
List all tags Lintian knows about in sorted order.
.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-explain-tags\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, \fBlintian-explain-tags\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\-t\fR, \fB\-\-tag\fR, \fB\-\-tags\fR" 4
.IX Item "-t, --tag, --tags"
This option has no effect. It exists for historical reasons.
.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 "EXIT STATUS"
.IX Header "EXIT STATUS"
If any of the tags specified were not found in the specified profile
(or in the default profile), this command returns with exit code 1.
.PP
When all requested tags were found, it returns with exit code 0.
.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>