1 files changed, 112 insertions, 0 deletions
diff --git a/man/lintian-annotate-hints.pod b/man/lintian-annotate-hints.pod
new file mode 100644
index 0000000..2e49b2d
--- /dev/null
+++ b/man/lintian-annotate-hints.pod
@@ -0,0 +1,112 @@
+# Copyright (C) 2010 Niels Thykier
+# Copyright (C) 2017 Chris Lamb <lamby@debian.org>
+# Copyright (C) 2020 Felix Lechner
+#  - based on the work Richard Braakman and Christian
+#    Schwarz (copyrighted 1998).
+#
+# This manual page is free software.  It is distributed under the
+# terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your
+# option) any later version.
+#
+# This manual page is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this manual page; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301
+# USA
+#
+
+=head1 NAME
+
+lintian-annotate-hints - give detailed information about Lintian's error tags
+
+=head1 SYNOPSIS
+
+B<lintian-annotate-hints> [I<log-file>...]
+
+=head1 DESCRIPTION
+
+The B<lintian-annotate-hints> command parses the EWI output of the
+B<lintian> command and gives verbose information about the listed
+Lintian tags, or parses a Lintian override file and gives verbose
+information about the tags included.
+
+If no log-file is specified on the command line, this command expects
+its input on stdin. Thus, the output of B<lintian> can either be piped
+through B<lintian-annotate-hints> or a log file produced by B<lintian> can be
+processed with this command.
+
+(Note, though, that the B<lintian> command has a command line option
+B<-i> to display the same results as B<lintian-annotate-hints>, so you
+normally do not need to pipe the output of B<lintian> through this
+command to see the extra information.)
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-a>, B<--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.
+
+=item B<-h>, B<--help>
+
+Display usage information and exit.
+
+=item B<--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.
+
+Unlike B<lintian>, B<lintian-annotate-hints> will I<not> load any code from
+these additional directories.
+
+This option may appear more than once; each time adding an additional
+directory.
+
+=item B<--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.
+
+If not specified, B<annotate-lintian-hint> loads the best profile for the
+current vendor.
+
+Please Refer to the Lintian User Manual for the full documentation of
+profiles.
+
+=item B<--user-dirs>, B<--no-user-dirs>
+
+By default, B<lintian> will check I<$HOME> and I</etc> for files
+supplied by the user or the local sysadmin (e.g. profiles).  This
+default can be disabled (and re-enabled) by using B<--no-user-dirs>
+(and B<--user-dirs>, respectively).
+
+These option can appear multiple times, in which case the of them
+to appear determines the result.
+
+=back
+
+=head1 SEE ALSO
+
+L<lintian(1)>
+
+=head1 AUTHORS
+
+Niels Thykier <niels@thykier.net>
+
+Richard Braakman <dark@xs4all.nl>
+
+Christian Schwarz <schwarz@monet.m.isar.de>
+
+=cut
+