Package: lintian
Version: 2.117.0
Severity: normal
Hello. Here're two patches to document the previously undocumented
--debug option and to more clearly note what to do with changes and
dbgsym overrides.
Also, I tried to push into a branch on salsa to create an MR instead,
but I didn't have the rights to do that. Maybe at least all DDs should
be allowed to push to their own branches?
Thanks!
>From 155d9c964f5c7ba661c7fca7e80bc004b858d520 Mon Sep 17 00:00:00 2001
From: Dima Kogan <dko...@debian.org>
Date: Thu, 1 Aug 2024 12:14:33 +0900
Subject: [PATCH 1/2] Documented --debug
---
bin/lintian | 1 +
man/lintian.pod | 7 +++++++
2 files changed, 8 insertions(+)
diff --git a/bin/lintian b/bin/lintian
index 4f44e6fc1..2d65dd50c 100755
--- a/bin/lintian
+++ b/bin/lintian
@@ -1010,6 +1010,7 @@ General options:
--print-version print unadorned version number and exit
-q, --quiet suppress all informational messages
-v, --verbose verbose messages
+ -d, --debug extra-verbose messages
-V, --version display Lintian version and exit
Behavior options:
--color never/always/auto disable, enable, or enable color for TTY
diff --git a/man/lintian.pod b/man/lintian.pod
index 5204aeeb6..cf7967b4f 100644
--- a/man/lintian.pod
+++ b/man/lintian.pod
@@ -137,6 +137,13 @@ In the configuration file, this option is enabled by using B<verbose>
variable. The B<verbose> and B<quiet> variables may not both appear
in the config file.
+=item B<-d>, B<--debug>
+
+Display extra-verbose messages.
+
+This is a deeper B<--verbose>, and implies B<--verbose>. Pass >= 3 times to get
+memory-usage information as well
+
=item B<-V>, B<--version>
Display lintian version number and exit.
--
2.42.0
>From 5951e508517acd55f313a00a70204beb101d3aff Mon Sep 17 00:00:00 2001
From: Dima Kogan <dko...@debian.org>
Date: Thu, 1 Aug 2024 12:18:39 +0900
Subject: [PATCH 2/2] Improved documentation for lintian-override files
---
man/lintian.pod | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/man/lintian.pod b/man/lintian.pod
index cf7967b4f..6a3997702 100644
--- a/man/lintian.pod
+++ b/man/lintian.pod
@@ -569,14 +569,20 @@ Utility scripts used by the other lintian scripts.
=back
For binary packages, Lintian looks for overrides in a file named
-I<usr/share/lintian/overrides/E<lt>packageE<gt>> inside the binary
-package, where I<E<lt>packageE<gt>> is the name of the binary
-package. For source packages, Lintian looks for overrides in
+I<usr/share/lintian/overrides/E<lt>packageE<gt>> inside the binary package,
+where I<E<lt>packageE<gt>> is the name of the binary package. This is usually
+created automatically by debhelper from the
+I<debian/E<lt>packageE<gt>.lintian-overrides> file.
+
+For source packages, Lintian looks for overrides in
I<debian/source/lintian-overrides> and then in
I<debian/source.lintian-overrides> if the first file is not found.
The first path is preferred. See the Lintian User's Manual for the
syntax of overrides.
+Lintian errors in automatically-generated packages (such as I<xxx-dbgsym>) and
+in the I<changes> file are currently not overrideable.
+
=head1 CONFIGURATION FILE
The configuration file can be used to specify default values for some
--
2.42.0
