Package: lintian Version: 2.4.3 Severity: wishlist
Here is a small patch against Git c5f2aa7 2010-08-26 to order options alphabetically, similar to ssh(1), cp(1) etc. -- System Information: Debian Release: squeeze/sid APT prefers testing APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental') Architecture: amd64 (x86_64) Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores) Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages lintian depends on: ii binutils 2.20.1-15 The GNU assembler, linker and bina ii diffstat 1.53-1 produces graph of changes introduc ii dpkg-dev 1.15.8.5 Debian package development tools ii file 5.04-5 Determines file type using "magic" ii gettext 0.18.1.1-3 GNU Internationalization utilities ii intltool-debian 0.35.0+20060710.1 Help i18n of RFC822 compliant conf ii libapt-pkg-perl 0.1.24+b1 Perl interface to libapt-pkg ii libclass-accessor-perl 0.34-1 Perl module that automatically gen ii libipc-run-perl 0.89-1 Perl module for running processes ii libparse-debianchangel 1.1.1-2.1 parse Debian changelogs and output ii libtimedate-perl 1.2000-1 collection of modules to manipulat ii liburi-perl 1.54-1 module to manipulate and access UR ii locales 2.11.2-6 Embedded GNU C Library: National L ii man-db 2.5.7-4 on-line manual pager ii perl [libdigest-sha-pe 5.10.1-15 Larry Wall's Practical Extraction lintian recommends no packages. Versions of packages lintian suggests: pn binutils-multiarch <none> (no description available) ii libtext-template-perl 1.45-1 Text::Template perl module ii man-db 2.5.7-4 on-line manual pager -- no debconf information
>From b5bd7c965213f1b59008c554955c9479ae39b071 Mon Sep 17 00:00:00 2001 From: Jari Aalto <jari.aa...@cante.net> Date: Thu, 21 Oct 2010 11:41:22 +0300 Subject: [PATCH] man/lintian.1: order options alphabetically Organization: Private Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit Signed-off-by: Jari Aalto <jari.aa...@cante.net> --- man/lintian.1 | 294 ++++++++++++++++++++++++++++---------------------------- 1 files changed, 147 insertions(+), 147 deletions(-) diff --git a/man/lintian.1 b/man/lintian.1 index 7270545..bfacd1f 100644 --- a/man/lintian.1 +++ b/man/lintian.1 @@ -69,14 +69,6 @@ Actions of the command: (Only one action can be specified per invocation) .TP -.BR \-S ", " \-\-setup\-lab -Set up or update the laboratory. - -.TP -.BR \-R ", " \-\-remove\-lab -Remove the laboratory directory. - -.TP .BR \-c ", " \-\-check Run all checks over the specified packages. This is the default action. @@ -88,6 +80,28 @@ name of the check script or the abbreviation. For details, see the CHECKS section below. .TP +.BR \-F ", " \-\-ftp\-master\-rejects +Run only the checks that issue tags that result in automatic rejects from +the Debian upload queue. The list of such tags is refreshed with each +Lintian release, so may be slightly out of date if it has changed +recently. This option does not, as yet, ignore overrides for fatal tags +for which overrides aren't allowed. + +.TP +.BR \-r ", " \-\-remove +Clean up the lintian directory of the specified packages up to +the current unpack level. The default unpack level is 0 for +this option. + +.TP +.BR \-R ", " \-\-remove\-lab +Remove the laboratory directory. + +.TP +.BR \-S ", " \-\-setup\-lab +Set up or update the laboratory. + +.TP .BR \-T " tag1,tag2,..., " \-\-tags " tag1,tag2,..." Run only the checks that issue the requested tags. The tests for other tags within the check scripts will be run but the tags will @@ -102,67 +116,84 @@ with # are ignored. All other lines are taken to be tag names or comma-separated lists of tag names to (potentially) issue. .TP -.BR \-F ", " \-\-ftp\-master\-rejects -Run only the checks that issue tags that result in automatic rejects from -the Debian upload queue. The list of such tags is refreshed with each -Lintian release, so may be slightly out of date if it has changed -recently. This option does not, as yet, ignore overrides for fatal tags -for which overrides aren't allowed. - -.TP -.BR \-X " chk1,chk2,..., " \-\-dont\-check\-part " chk1,chk2,..." -Run all but the the specified checks. You can either specify -the name of the check script or the abbreviation. -For details, see the CHECKS section below. - -.TP .BR \-u ", " \-\-unpack Unpack the specified packages up to the current unpack level. The default and only unpack level is 1 for this option. See the UNPACK LEVELS section below. .TP -.BR \-r ", " \-\-remove -Clean up the lintian directory of the specified packages up to -the current unpack level. The default unpack level is 0 for -this option. +.BR \-X " chk1,chk2,..., " \-\-dont\-check\-part " chk1,chk2,..." +Run all but the the specified checks. You can either specify +the name of the check script or the abbreviation. +For details, see the CHECKS section below. .PP General options: .TP -.BR \-h ", " \-\-help -Display usage information and exit. +.BR \-d ", " \-\-debug +Display debugging messages. (Implies +.BR \-v ). .TP -.BR \-V ", " \-\-version -Display lintian version number and exit. +.BR \-h ", " \-\-help +Display usage information and exit. .TP .BR \-\-print\-version Print unadorned version number and exit. .TP -.BR \-v ", " \-\-verbose -Display verbose messages. - -.TP -.BR \-d ", " \-\-debug -Display debugging messages. (Implies -.BR \-v ). - -.TP .BR \-q ", " \-\-quiet Suppress all informational messages. Currently, the only message this suppresses is the message at the end of the run giving the total count of overrides. +.TP +.BR \-v ", " \-\-verbose +Display verbose messages. + +.TP +.BR \-V ", " \-\-version +Display lintian version number and exit. + .PP Behaviour options for .BR lintian . .TP +.BR \-\-allow\-root +Override +.BR lintian 's +warning when it is run with superuser privileges. + +.TP +.BR \-\-color " (never|always|auto|html)" +Whether to colorize tags in lintian output based on their severity. The +default is "never", which never uses color. "always" will always use +color, "auto" will use color only if the output is going to a terminal, +and "html" will use HTML <span> tags with a color style attribute (instead +of ANSI color escape sequences). + +.TP +.BR \-E ", " \-\-display\-experimental +Display experimental ("X:") tags as well. They are normally suppressed. + +If a tag is marked experimental, this means that the code that generates +this message is not as well tested as the rest of Lintian, and might still +give surprising results. Feel free to ignore Experimental messages that +do not seem to make sense, though of course bug reports are always +welcomed (particularly if they include fixes). + +.TP +.BR \-\-fail\-on\-warnings +By default, +.B lintian +exits with 0 status if only warnings were found. If this flag is given, +exit with a status of 1 if either warnings or errors are found. + +.TP .BR \-i ", " \-\-info Print explanatory information about each problem discovered in addition to the lintian error tags. To print a long tag description without running @@ -176,14 +207,38 @@ Display informational ("I:") tags as well. They are normally suppressed. .BR \-L " \(dq>=wishlist\(dq)." .TP -.BR \-E ", " \-\-display\-experimental -Display experimental ("X:") tags as well. They are normally suppressed. +.BR \-\-keep\-lab +By default, temporary labs will be removed after lintian is finished. +Specifying this options will leave the lab behind, which might be +useful for debugging purposes. You can find out where the temporary +lab is located by running lintian with the +.B \-\-verbose +option. Implies +.B \-\-unpack\-level=2 +unless another unpack level is specified directly. -If a tag is marked experimental, this means that the code that generates -this message is not as well tested as the rest of Lintian, and might still -give surprising results. Feel free to ignore Experimental messages that -do not seem to make sense, though of course bug reports are always -welcomed (particularly if they include fixes). +.TP +.BR \-l " n, " \-\-unpack\-level " n" +Set unpack level to +.IR n . +See the UNPACK LEVELS section, below. + +.TP +.BR \-L " [+|-|=][>=|>|<|<=][S|C|S/C], " \-\-display\-level " [+|-|=][>=|>|<|<=][S|C|S/C]" +Fine-grained selection of tags to be displayed. It is possible to add, remove +or set the levels to display, specifying a severity (S: serious, important, +normal, minor, wishlist), a certainty (C: certain, possible, wild-guess), or +both (S/C). The default settings are equivalent to +.BR \-L " \(dq>=important\(dq " \-L " \(dq+>=normal/possible\(dq " \-L " +minor/certain)." + +.TP +.BR \-m ", " \-\-md5sums ", " \-\-checksums +Check checksums when processing a .changes file. Normally, Lintian only +checks the checksums for .dsc files when processing a .changes file. + +.TP +.BR \-o ", " \-\-no\-override +Don't use the overrides file. .TP .BR \-\-pedantic @@ -196,12 +251,8 @@ useful if you use this option. Adding overrides for pedantic tags is probably not worth the effort. .TP -.BR \-L " [+|-|=][>=|>|<|<=][S|C|S/C], " \-\-display\-level " [+|-|=][>=|>|<|<=][S|C|S/C]" -Fine-grained selection of tags to be displayed. It is possible to add, remove -or set the levels to display, specifying a severity (S: serious, important, -normal, minor, wishlist), a certainty (C: certain, possible, wild-guess), or -both (S/C). The default settings are equivalent to -.BR \-L " \(dq>=important\(dq " \-L " \(dq+>=normal/possible\(dq " \-L " +minor/certain)." +.BR \-\-show\-overrides +Output tags that have been overridden. .TP .BR \-\-suppress\-tags " tag1,tag2,..." @@ -217,82 +268,31 @@ will not be reported if they occur and will not affect the exit status of Lintian. .TP -.BR \-l " n, " \-\-unpack\-level " n" -Set unpack level to -.IR n . -See the UNPACK LEVELS section, below. - -.TP -.BR \-o ", " \-\-no\-override -Don't use the overrides file. - -.TP -.BR \-\-show\-overrides -Output tags that have been overridden. - -.TP -.BR \-\-color " (never|always|auto|html)" -Whether to colorize tags in lintian output based on their severity. The -default is "never", which never uses color. "always" will always use -color, "auto" will use color only if the output is going to a terminal, -and "html" will use HTML <span> tags with a color style attribute (instead -of ANSI color escape sequences). - -.TP .BR \-U " info1,info2,..., " \-\-unpack\-info " info1,info2,..." Collect information info1, info2, etc. even if these are not required by the checks. -.TP -.BR \-m ", " \-\-md5sums ", " \-\-checksums -Check checksums when processing a .changes file. Normally, Lintian only -checks the checksums for .dsc files when processing a .changes file. - -.TP -.BR \-\-allow\-root -Override -.BR lintian 's -warning when it is run with superuser privileges. - -.TP -.BR \-\-fail\-on\-warnings -By default, -.B lintian -exits with 0 status if only warnings were found. If this flag is given, -exit with a status of 1 if either warnings or errors are found. - -.TP -.BR \-\-keep\-lab -By default, temporary labs will be removed after lintian is finished. -Specifying this options will leave the lab behind, which might be -useful for debugging purposes. You can find out where the temporary -lab is located by running lintian with the -.B \-\-verbose -option. Implies -.B \-\-unpack\-level=2 -unless another unpack level is specified directly. - .PP Configuration options: .TP -.BR \-\-cfg " configfile" -Read the configuration from -.IR configfile -rather than the default locations. This option overrides the -.B LINTIAN_CFG -environment variable. +.BR \-\-arch " arch" +When scanning for packages in the distdir, select only packages for +architecture +.IR arch . +This option overrides the +.B LINTIAN_ARCH +environment variable and the configuration file entry of the same name. .TP -.BR \-\-lab " labdir" -Use -.IR labdir -as the permanent laboratory. This is where Lintian keeps information about -the packages it checks. This option overrides the -.B LINTIAN_LAB -environment variable and the configuration file entry of the same -name. +.BR \-\-area " area" +When scanning for packages in the distdir, select only packages from +the comma-separated list of archive areas +.IR areas +(e.g. main, contrib). This option overrides the +.B LINTIAN_AREA +environment variable and the configuration file entry of the same name. .TP .BR \-\-archivedir " archivedir" @@ -305,6 +305,14 @@ environment variable and the configuration file entry of the same name. .TP +.BR \-\-cfg " configfile" +Read the configuration from +.IR configfile +rather than the default locations. This option overrides the +.B LINTIAN_CFG +environment variable. + +.TP .BR \-\-dist " distdir" Scan for packages in the .IR distdir @@ -316,28 +324,14 @@ environment variable and the configuration file entry of the same name. .TP -.BR \-\-area " area" -When scanning for packages in the distdir, select only packages from -the comma-separated list of archive areas -.IR areas -(e.g. main, contrib). This option overrides the -.B LINTIAN_AREA -environment variable and the configuration file entry of the same name. - -.TP -.BR \-\-section " area" -This is an old name for the -.B \-\-area -option and accepted as a synonym for that option. - -.TP -.BR \-\-arch " arch" -When scanning for packages in the distdir, select only packages for -architecture -.IR arch . -This option overrides the -.B LINTIAN_ARCH -environment variable and the configuration file entry of the same name. +.BR \-\-lab " labdir" +Use +.IR labdir +as the permanent laboratory. This is where Lintian keeps information about +the packages it checks. This option overrides the +.B LINTIAN_LAB +environment variable and the configuration file entry of the same +name. .TP .BR \-\-root " rootdir" @@ -350,6 +344,12 @@ This overrides the environment variable. The default location is .IR /usr/share/lintian . +.TP +.BR \-\-section " area" +This is an old name for the +.B \-\-area +option and accepted as a synonym for that option. + .PP Package selection options: @@ -364,14 +364,6 @@ LINTIAN_DIST variable is defined in the configuration file.) The following packages listed on the command line are binary packages. .TP -.BR \-s ", " \-\-source -The following packages listed on the command line are source packages. - -.TP -.BR \-\-udeb -The following packages listed on the command line are udeb packages. - -.TP .BR \-p ", " \-\-packages\-file " X" Process all packages which are listed in file .BR X . @@ -389,6 +381,14 @@ is the package's version, and .B file is the package file name (absolute path specification). +.TP +.BR \-s ", " \-\-source +The following packages listed on the command line are source packages. + +.TP +.BR \-\-udeb +The following packages listed on the command line are udeb packages. + .SH "UNPACK LEVELS" .TP .B "0 (none)" -- 1.7.1