Bug#370799: rsync: [manual] option names should be listed alphabetically

2006-06-06 Thread Jari Aalto 
Package: rsync
Version: 2.6.8-2
Severity: minor

Manual page reads:

  OPTIONS SUMMARY

   Here is a short summary of the options available in
   rsync. Please refer to the detailed description below for a
   complete description.

-v, --verbose   increase verbosity
-q, --quiet suppress non-error messages
-c, --checksum  skip based on checksum, not mod-time  size
-a, --archive   archive mode; same as -rlptgoD (no -H)


The problem is that browsing the listing to search for specific option
is difficult (option mention in script, web page, referred by in this
page)

SUGGESTION

It would be better of the manual were organized to list the options in
alphabetical order.

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/dash
Kernel: Linux 2.6.16-2-686
Locale: LANG=C, LC_CTYPE=C (charmap=ISO-8859-1) (ignored: LC_ALL set to en_US)

Versions of packages rsync depends on:
ii  libc6 2.3.6-13   GNU C Library: Shared libraries
ii  libpopt0  1.10-1 lib for parsing cmdline parameters

rsync recommends no packages.

-- debconf-show failed


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]

Bug#370799: rsync: [manual] option names should be listed alphabetically

2006-06-06 Thread Wayne Davison 
Alphabetical order only helps someone to scan by eye for a known name,
not to find a useful option by what function it performs.  The current
idea is to group options together that perform similar functions, which
(hopefully) helps people to find options by their concept (however, the
list could certainly be improved to make this clustering better).

If someone already knows the name of an option, instead of scanning a
sorted list by eye, I'd suggest searching for it using a pager.

Thus, I don't see the benefit of having the options in alphabetical
order.

..wayne..


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]