1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123
|
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
-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)
-l X, --unpack-level X set default unpack level to X
-o, --no-override ignore overrides
--show-overrides output tags that have been overriden
-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).
|