Debian Bug report logs - #623890
debhelper: [PATCH] debhelper.1 manpage -- Order items alohabetically (patch set)

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Jari Aalto <jari.aalto@cante.net>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: debhelper: [PATCH] debhelper.1 manpage -- Order items alohabetically (patch set)

Date: Sun, 24 Apr 2011 11:13:17 +0300

[Message part 1 (text/plain, inline)]

Package: debhelper
Version: 8.1.3
Severity: wishlist


Here are minor patches to lay out the manual page similarly as in
cp(1), mv(1), ssh(1) etc.

The alphabetical order works well while searching; no oriantation
problems regardless of tools; even when you print on paper when you
don't have any computerized aids to help your search.

The patches are against Git:

  e45627b 2011-04-22 16:27:24 -0400 releasing version 8.1.4

-- System Information:
Debian Release: wheezy/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.38-1-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 debhelper depends on:
ii  binutils               2.21.0.20110327-3 The GNU assembler, linker and bina
ii  dpkg-dev               1.16.0.2          Debian package development tools
ii  file                   5.04-5+b1         Determines file type using "magic"
ii  html2text              1.3.2a-15         advanced HTML to text converter
ii  man-db                 2.5.9-4           on-line manual pager
ii  perl                   5.10.1-19         Larry Wall's Practical Extraction 
ii  perl-base              5.10.1-19         minimal Perl system
ii  po-debconf             1.0.16+nmu1       tool for managing templates file t

debhelper recommends no packages.

Versions of packages debhelper suggests:
ii  dh-make                       0.58       tool that converts source archives

-- no debconf information

[0002-debhelper.pod-COMMON-DEBHELPER-OPTIONS-Order-items-a.patch (text/x-news, attachment)]

[0004-debhelper.pod-ENVIRONMENT-Order-items-alphabetically.patch (text/x-news, attachment)]

[0003-debhelper.pod-BUILD-SYSTEM-OPTIONS-Order-items-alpha.patch (text/x-news, attachment)]

[0001-debhelper.pod-SHARED-DEBHELPER-OPTIONS-Order-items-a.patch (text/x-news, attachment)]

Message #10 received at 623890@bugs.debian.org (full text, mbox, reply):

From: Joey Hess <joeyh@debian.org>

To: Jari Aalto <jari.aalto@cante.net>, 623890@bugs.debian.org

Subject: Re: Bug#623890: debhelper: [PATCH] debhelper.1 manpage -- Order items alohabetically (patch set)

Date: Sun, 24 Apr 2011 11:16:19 -0400

[Message part 1 (text/plain, inline)]

Jari Aalto wrote:
> Here are minor patches to lay out the manual page similarly as in
> cp(1), mv(1), ssh(1) etc.
> 
> The alphabetical order works well while searching; no oriantation
> problems regardless of tools; even when you print on paper when you
> don't have any computerized aids to help your search.

The ordering in the current man pages is not random. Alphabetizing
destroys the value of eg, placing related options together, and more
often used options first. I hate that people keep wasting effort on
alphabetizing my man pages, but I have to reject such patches.

-- 
see shy jo

[signature.asc (application/pgp-signature, inline)]

Message #15 received at 623890-done@bugs.debian.org (full text, mbox, reply):

From: Joey Hess <joeyh@debian.org>

To: 623890-done@bugs.debian.org

Subject: Re: Bug#623890: debhelper: [PATCH] debhelper.1 manpage -- Order items alohabetically (patch set)

Date: Sun, 24 Apr 2011 11:24:23 -0400

[Message part 1 (text/plain, inline)]

Joey Hess wrote:
> Jari Aalto wrote:
> > Here are minor patches to lay out the manual page similarly as in
> > cp(1), mv(1), ssh(1) etc.
> > 
> > The alphabetical order works well while searching; no oriantation
> > problems regardless of tools; even when you print on paper when you
> > don't have any computerized aids to help your search.
> 
> The ordering in the current man pages is not random. Alphabetizing
> destroys the value of eg, placing related options together, and more
> often used options first. I hate that people keep wasting effort on
> alphabetizing my man pages, but I have to reject such patches.

But, I feel less bad about it after I see that it's only you doing it,
and that I already *demolished* your arguments about cp, mv, ln, etc
being good example man pages.

#include http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=561017#10

-- 
see shy jo

[signature.asc (application/pgp-signature, inline)]

Send a report that this bug log contains spam.