The following commit has been merged in the master branch: commit 4a7b37126a128c3494106aefd6bef935f50a31d7 Author: Niels Thykier <ni...@thykier.net> Date: Fri Jul 8 01:19:19 2011 +0200
Updated the Lintian User Manual diff --git a/debian/changelog b/debian/changelog index 0089b71..99c3b1f 100644 --- a/debian/changelog +++ b/debian/changelog @@ -97,6 +97,9 @@ lintian (2.5.2) UNRELEASED; urgency=low * doc/lintian.xml: + [NT] Added information about the new Vendor profiles. + + [NT] Improved various parts of the User Manual. Especially + mention that Lintian can be run on changes files and this + processes all packages related to the changes file. * frontend/{lintian,lintian-info}: + [NT] Added profile support (new option --profile), please diff --git a/doc/lintian.xml b/doc/lintian.xml index 94d2965..8468e64 100644 --- a/doc/lintian.xml +++ b/doc/lintian.xml @@ -279,13 +279,26 @@ the <systemitem role="package">lintian</systemitem> Debian package. </para> + <para> + Alternatively you can checkout Lintian from the source + repository and use that directly. By setting LINTIAN_ROOT (or + using the --root option) lintian can be run from the source + directory as if it had been installed on your system. + </para> + <para> + The only known caveat of using Lintian from the source + directory is that Lintian requires a C.UTF-8 (or en_US.UTF-8) + locale to correctly process some files. + The <systemitem role="package">lintian</systemitem> Debian + package will set up this locale during installation. + </para> </sect1> <sect1 label="2.2" id="section-2.2"> <title>Running lintian</title> <para> - After that, you can run Lintian over any Debian binary, udeb - or source packages like this: + After that, you can run Lintian on a changes file or any + Debian binary, udeb or source packages like this: </para> <screen> $ lintian libc5_5.4.38-1.deb @@ -299,16 +312,28 @@ E: libc5: shlib-missing-in-control-file libgnumalloc usr/lib/libgnumalloc.so.5.4 $ </screen> <para> - As you can see, Lintian uses a special format for all its - error and warning messages. With that, its very easy to write - other programs which run Lintian and interpret the displayed - messages. + Please note that some checks are cross-package checks and can + only be (accurately) performed if the binary packages and the + source are processed together. If Lintian is passed a changes + file, it will attempt to process all packages listed in the + changes file. + </para> + <para> + Lintian supports a number of command line options, which are + documented in the manpage of lintian(1). Some of the options + may appear in the lintianrc file (without the leading dashes) + in Lintian 2.5.1 (or newer). </para> </sect1> <sect1 label="2.3" id="section-2.3"> <title>Lintian Tags</title> <para> + Lintian uses a special format for all its error and warning + messages. With that it is very easy to write other programs + which run Lintian and interpret the displayed messages. + </para> + <para> The first character of each line indicates the type of message. Currently, the following types are supported: </para> @@ -472,12 +497,19 @@ $ sure the problem is not actually a bug in Lintian or an error in the author's reading of policy. Please do not override bugs in lintian, they should rather be fixed than overridden. + </para> + <para> Once it has been decided that an override is needed, you can easily add one by supplying an overrides file. If the override is for a binary or udeb package, you have to place it at <filename>/usr/share/lintian/overrides/<replaceable><package></replaceable></filename> - inside the package. If the override is for a source package, - you have to place it + inside the package. The tool <command>dh_lintian</command> + from the Debian + package <systemitem role="package">debhelper</systemitem> may + be useful for this purpose. + </para> + <para> + If the override is for a source package, you have to place it at <filename>debian/source/lintian-overrides</filename> or <filename>debian/source.lintian-overrides</filename> (the former path is preferred). With that, Lintian will know about -- Debian package checker -- To UNSUBSCRIBE, email to debian-lint-maint-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/e1qexuh-0005zy...@vasks.debian.org