[ Abstract ] [ Copyright Notice ] [ Contents ] [ next ]

Lintian User's Manual
Chapter 1 Introduction


1.1 About Lintian

Lintian is a Debian package checker. It can be used to check binary and source packages for compliance with the Debian policy and for other common packaging errors.

Lintian uses an archive directory, called laboratory, in which it stores information about the packages it examines. It can keep this information between multiple invocations in order to avoid repeating expensive data-collection operations. It's also possible to check the complete Debian archive for bugs -- in a timely manner.


1.2 The intention of Lintian

Packaging has become complicated--not because dpkg is complicated (indeed, dpkg-deb is very simple to use) but because of the high requirements of our policy. If a developer releases a new package, she has to consider hundreds of guidelines to make the package `policy compliant.'

All parts of our policy have been introduced by the same procedure: Some developer has a good idea how to make packages more `unique' with respect to a certain aspect--then the idea is discussed and a policy proposal is prepared. If we have a consensus about the policy change, it's introduced in our manuals.

Therefore, our policy is not designed to make life harder for the maintainers! The intention is to make Debian the best Linux distribution out there. With this in mind, lots of policy changes are discussed on the mailing lists each week.

But changing the policy is only a small part of the story: Just having some statement included in the manual does not make Debian any better. What's needed is for that policy to become `real life,' i.e., it's implemented in our packages. And this is where Lintian comes in: Lintian checks packages and reports possible policy violations. (Of course, not everything can be checked mechanically -- but a lot of things can and this is what Lintian is for.)

Thus, Lintian has the following goals:



1.3 Design issues

There are three fields of application for Lintian:

The authors of Lintian decided to use a very modular design to achieve the following goals:



1.4 Disclaimer

Here is a list of important notes on how to use Lintian:

  1. Lintian is not finished yet and will probably never be. Please don't use Lintian as a reference for Debian policy. Lintian might miss a lot of policy violations while it might also report some violations by mistake. If in doubt, please check out the policy manuals.
  1. The Debian policy gives the maintainers a lot of freedom. In most cases, the guidelines included in the manuals allow exceptions. Thus, if Lintian reports a policy violation on a package and you think this is such an exception (or if you think Lintian has a bug itself) please contact the authors of Lintian about this. There is an `override' file which tells Lintian about policy exceptions.
  1. Please DO NOT use Lintian to file bug reports (neither single ones nor mass bug reports). This is done by the authors of Lintian already and duplication of efforts and bug reports should be avoided! If you think a certain bug is `critical', and should be reported/fixed immediately, please contact the maintainer of the corresponding package and/or the Lintian maintainers.
  1. Any feedback about Lintian is welcomed! Please send your comments to the lintian maintainers lintian-maint@debian.org.


[ Abstract ] [ Copyright Notice ] [ Contents ] [ next ]
Lintian User's Manual
version 0.3.3, 6 September 2000
Christian Schwarz schwarz@debian.org
Richard Braakman dark@xs4all.nl
Sean 'Shaleh' Perry shaleh@debian.org
Contact address: lintian-maint@debian.org