README file for Lintian
=======================

Disclaimer
----------

IMPORTANT NOTES ABOUT THE USE OF 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.

  2. 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.

  3. Please DO NOT use Lintian to file bug reports (neither single ones nor
    mass bug reports). This is done by 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.

  4. Any feedback about Lintian is welcomed! Please send your comments to
    <lintian-maint@debian.org>.


Running Lintian for the first time
----------------------------------

Here is what you have to do at minimum to get lintian up and running:

  1. Install the `lintian' package

  2. Run lintian over your packages:

        $ lintian <something>.deb
        $ lintian <something>.udeb
        $ lintian <something>.dsc
        $ lintian <something>.changes

(Yes, Lintian is really easy to use! ;-)


Command line options of the lintian command
-------------------------------------------

  Syntax: lintian [action] [options] [--] [packages] ...

  (Please refer to the manual page lintian(1) for details.)

%LINTIAN_HELP%


Where to find more information
------------------------------

Details about the `lintian' and the `lintian-info' commands can be
found in the manual pages lintian(1) and lintian-info(1),
respectively.

General information about Lintian and how to use it can be found in
the `Lintian User's Manual' at
file:/usr/share/doc/lintian/lintian.html/index.html

Weekly updated Lintian reports from all packages in the Debian
distribution can be found at the Lintian home page at

      http://www.debian.org/lintian/


Feedback
--------

Any comments, critics, or suggestions about Lintian or related topics
are highly appreciated by the authors! Please contact
<lintian-maint@debian.org>.  Thanks!



Christian Schwarz <schwarz@debian.org>, Mar 14, 1998.
Updated by Frank Lichtenheld, Apr 14, 2004 (Lintian 1.23.0).
