Bug#600906: lintian: [PATCH] order options alphabetically in manual page
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.aalto@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.aalto@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
Reply to: