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

  actions:
    -S, --setup-lab           set up static lab
    -R, --removed-lab         remove static lab
    -c, --check               check packages (default action)
    -C X, --check-part X      check only certain aspects
    -u, --unpack              only unpack packages in the lab
    -U X, --unpack-info X     only unpack and collect some info
    -r, --remove              remove package from the lab

  general options:
    -h, --help                display short help text
    -v, --verbose             verbose messages
    -V, --version             display Lintian version and exit
    -d, --debug               turn Lintian's debug messages ON

  configuration options:
    -i, --info                give detailed info about tags
    -l X, --unpack-level X    set default unpack level to X
    -o, --no-override         ignore overrides

  package selection options:
    -a, --all                 process all packages in distribution
    -b, --binary              process only binary packages
    -s, --source              process only source packages


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.