show the actual description when it is too short
tidy up reporting/html_reports
d/postrm: Remove the "changes" in /var/spool/lintian in purge

Signed-off-by: Niels Thykier <niels@thykier.net>
Stop installing and clean up /var/spool/lintian on upgrade

Signed-off-by: Niels Thykier <niels@thykier.net>
t/.../pod-spelling.t: Whitelist "init" (parameter name)

Apparently it was accepted in Jessie by default, but not in Wheezy.

Signed-off-by: Niels Thykier <niels@thykier.net>
Simplify and merge some "my" declarations

Remove explicit assignments on declaration of "my" variables, when
Perl would normally have initialise them to the same value in its
absence.  This makes Perl produce a slightly simplier OP-code graph[1],
but also allows us/Perl to merge declarations.  Finally, it makes our
declarations consistent across the entire codebase.

[1] This may seem weird at first, but Perl insists on keeping the
assignment. The assignment lead to semantically different behaviour
when people use "goto label;".  This is a practise not found in the
Lintian codebase, so we can safely remove the assignments.

Signed-off-by: Niels Thykier <niels@thykier.net>
d/lintian.install: Install Lintian::Tutorial POD docs

Signed-off-by: Niels Thykier <niels@thykier.net>
L::Path: Add support for fetching the underlying FS object

Signed-off-by: Niels Thykier <niels@thykier.net>
c/{infofiles,testsuite}.pm: Use new L::Path features

Signed-off-by: Niels Thykier <niels@thykier.net>
L::Path: Accept optional "layer" argument in the open method

Signed-off-by: Niels Thykier <niels@thykier.net>
c/files.pm: Migrate to new Lintian::Path features

Signed-off-by: Niels Thykier <niels@thykier.net>
checks: Migrate some more checks to use new L::Path API

Signed-off-by: Niels Thykier <niels@thykier.net>
c/menu-format.pm: Minor refactor of verify_desktop_file

Signed-off-by: Niels Thykier <niels@thykier.net>
c/apache2.pm: Minor refactoring

Signed-off-by: Niels Thykier <niels@thykier.net>
c/cruft.pm: Migrate to L::Path API

Signed-off-by: Niels Thykier <niels@thykier.net>
c/*.pm: Update some checks to (partially) use Lintian::Path

Update some checks to use the new Lintian::Path API for accessing
control files.

Signed-off-by: Niels Thykier <niels@thykier.net>
doc: Show the new Lintian::Path API in the tutorial

In the tutorial, prefer showing the new Lintian::Path API for
accessing/opening files inside the package to using "unpacked" (et
al) directly.

Signed-off-by: Niels Thykier <niels@thykier.net>
pod-spelling.t: Add runtime as stopword (for stable)

Signed-off-by: Niels Thykier <niels@thykier.net>
L::Path: Add "child(BASENAME)" method

Add a method "child" for looking up a named child of a directory.
Note that BASENAME never ends with a slash (even for directories).

Signed-off-by: Niels Thykier <niels@thykier.net>
L::Path: Add parent_dir and root_dir methods

Signed-off-by: Niels Thykier <niels@thykier.net>