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

  Actions:
    -S, --setup-lab            set up static lab
    -R, --remove-lab           remove static lab
    -c, --check                check packages (default action)
    -C X, --check-part X       check only certain aspects
    -X X, --dont-check-part X  don't check certain aspects
    -T X, --tags X             only run checks needed for requested tags
    --tags-from-file X         like --tags, but read list from file
    -u, --unpack               only unpack packages in the lab
    -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
    --print-version            print unadorned version number and exit
  Behaviour options:
    -i, --info                 give detailed info about tags
    -I, --display-info         display "I:" tags (normally suppressed)
    -E, --display-experimental display "X:" tags (normally suppressed)
    -l X, --unpack-level X     set default unpack level to X
    -o, --no-override          ignore overrides
    --show-overrides           output tags that have been overriden
    --color never/always/auto   disable, enable, or enable color for TTY
    -U X, --unpack-info X      specify which info should be collected
    -m, --md5sums              check md5sums when processing a .changes file
    --allow-root               suppress lintian's warning when run as root
  Configuration options:
    --cfg CONFIGFILE           read CONFIGFILE for configuration
    --lab LABDIR               use LABDIR as permanent laboratory
    --archivedir ARCHIVEDIR    location of Debian archive to scan for packages
    --dist DIST                scan packages in this distribution (e.g. sid)
    --section RELEASE          scan packages in this section (e.g. main)
    --arch ARCH                scan packages with architecture ARCH
    --root ROOTDIR             use ROOTDIR instead of /usr/share/lintian
  Package selection options:
    -a, --all                  process all packages in distribution
    -b, --binary               process only binary packages
    -s, --source               process only source packages
    --udeb                     process only udeb packages
    -p X, --packages-file X    process all files in file (special syntax!)


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