=encoding UTF-8

=head1 NAME

adequate - Debian package quality testing tool

=head1 SYNOPSIS

=over 1

=item B<adequate> [I<options>] I<package-name>...

=item B<adequate> [I<options>] --all

=item B<adequate> [I<options>] --apt-preinst

=item B<adequate> [I<options>] --pending

=item B<adequate> --help

=back

=head1 DESCRIPTION

B<adequate> checks packages installed on the system and reports bugs and policy
violations.

=head1 OPTIONS

=over 4

=item B<--all>

Run checks against all the installed packages.

=item B<--tags> I<tag1>[,I<tag2>...]

Emit only these tags.

=item B<--tags> -I<tag1>[,I<tag2>...]

Don't emit these tags.

=item B<--debconf>

Report issues via L<debconf(7)>.

=item B<--root> I<directory>

Change the root directory (using L<chroot(2)>).

=item B<--user> I<user>[:I<group>]

Switch user and group before running any checks.
This is most useful together with B<--root> or B<--pending>, which require
superuser privileges.

=item B<--apt-preinst>

Read APT configuration and F<.deb> filenames from stdin, and append packages
names to F</var/lib/adequate/pending> for later processing (see B<--pending>).

This option is used internally by the APT hook.
The hook is disabled by default; please edit F</etc/apt/apt.conf.d/20adequate> to enable it.

=item B<--pending>

Run checks against packages listed in F</var/lib/adequate/pending>,
then empty the file.

=item B<--help>

Display help and exit.

=back

=head1 TAGS

=head1 EXAMPLES

=over 4

=item B<C<adequate coreutils>>

Check the B<coreutils> package.

=item B<C<adequate --tags obsolete-conffile --all>>

Check all the packages for obsolete conffiles.

=item B<C<adequate --tags -py-file-not-bytecompiled,pyshared-file-not-bytecompiled --all>>

Check all the packages, ignoring Python bytecompilation issues.

=back

=head1 REPORTING BUGS

If you report a bug that was found by adequate, please use the following usertags:

=over 4

=item Z<>

=over

=item User: debian-qa@lists.debian.org

=item Usertags: adequate I<tag-name>

=back

=back

Please keep in mind that adequate is not perfect; therefore false positives are
possible. Don't report the bug unless you understand the underlying problem.
When in doubt, please ask at I<debian-qa@lists.debian.org> first.

=head1 SEE ALSO

Debian Policy:
F</usr/share/doc/debian-policy/policy.txt.gz>
or L<https://www.debian.org/doc/debian-policy/>

Python Policy:
F</usr/share/doc/python/python-policy.txt.gz>
or L<https://www.debian.org/doc/packaging-manuals/python-policy/>

L<lintian(1)>, L<piuparts(1)>

=for comment
pod-date:2015-07-15
vim:ft=pod
