--- /dev/null
+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
+ --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).