Your message dated Fri, 23 Dec 2005 14:48:44 +0100
with message-id <[EMAIL PROTECTED]>
and subject line Done
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--------------------------------------
Received: (at submit) by bugs.debian.org; 9 Feb 2005 10:55:59 +0000
>From [EMAIL PROTECTED] Wed Feb 09 02:55:59 2005
Return-path: <[EMAIL PROTECTED]>
Received: from fep02-0.kolumbus.fi (fep02-app.kolumbus.fi) [193.229.0.44] 
        by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
        id 1CypVm-0007Uz-00; Wed, 09 Feb 2005 02:55:58 -0800
Received: from bongo.cante.net ([81.197.3.110]) by fep02-app.kolumbus.fi
          with ESMTP
          id <[EMAIL PROTECTED]>
          for <[EMAIL PROTECTED]>; Wed, 9 Feb 2005 12:55:56 +0200
Received: from fw.cante.net ([192.168.1.3]:36204 helo=cante.cante.net)
        by bongo.cante.net with esmtp (Exim 4.34)
        id 1CypVk-0005B3-8K; Wed, 09 Feb 2005 12:55:56 +0200
Received: from jaalto by cante.cante.net with local (Exim 4.44)
        id 1CypW8-0001DW-2M; Wed, 09 Feb 2005 12:56:20 +0200
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Jari Aalto <[EMAIL PROTECTED]>
To: Debian Bug Tracking System <[EMAIL PROTECTED]>
Subject: coreutils: [sort] Insufficient manual page information for option -k
X-Mailer: reportbug 3.7.1
Date: Wed, 09 Feb 2005 12:56:19 +0200
Message-Id: <[EMAIL PROTECTED]>
Delivered-To: [EMAIL PROTECTED]
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
        (1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-8.0 required=4.0 tests=BAYES_00,HAS_PACKAGE 
        autolearn=no version=2.60-bugs.debian.org_2005_01_02
X-Spam-Level: 

Package: coreutils
Version: 5.2.1-2
Severity: minor


Manual page and info page for sort(1) reads:

       -k, --key=POS1[,POS2]
              start a key at POS1, end it at POS 2 (origin 1)

       POS  is  F[.C][OPTS],  where  F is the field number and C the character
       position in the field.  OPTS is  one  or  more  single-letter  ordering
       options,  which  override  global ordering options for that key.  If no
       key is given, use the entire line as the key.

And "info coreutils sort" reads:

    7.1 `sort': Sort text files
    ===========================
    ...                         
    `-k POS1[,POS2]'
    `--key=POS1[,POS2]'
         Specify a sort field that consists of the part of the line between
         POS1 and POS2 (or the end of the line, if POS2 is omitted),
         _inclusive_.  Fields and character positions are numbered starting
         with 1.  So to sort on the second field, you'd use `--key=2,2'
         (`-k 2,2').  See below for more examples.

but this is silent about OPTS referred in manual page. The basic manual
page further does not give must rope to understand -k. 

PROBLEMS

The manual page, as it is now, does not give sufficient details how to
use -k option. The OPTS part is not explained well. 

The manual page also would better refer to "info coreutils sort" than
"info sort".

SUGGESTION

I suggestest that something similar what appers in following page, is
added to the manual so that ad hoc questions "man sort" would give
enough details for day to day operation. 

    http://www.opengroup.org/onlinepubs/009695399/utilities/sort.html

    -k  keydef

        The keydef argument is a restricted sort key field definition.
        The format of this definition is:

        field_start[type][,field_end[type]]

        where field_start and field_end define a key field restricted to a
        portion of the line (see the EXTENDED DESCRIPTION section), and
        type is a modifier from the list of characters 'b', 'd', 'f', 'i',
        'n', 'r'. The 'b' modifier shall behave like the -b option, but
        shall apply only to the field_start or field_end to which it is
        attached. The other modifiers shall behave like the corresponding
        options, but shall apply only to the key field to which they are
        attached; they shall have this effect if specified with
        field_start, field_end, or both. If any modifier is attached to a
        field_start or to a field_end, no option shall apply to either.
        Implementations shall support at least nine occurrences of the -k
        option, which shall be significant in command line order. If no -k
        option is specified, a default sort key of the entire line shall
        be used.

-- System Information:
Debian Release: 3.1
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.9-1-686
Locale: LANG=C, LC_CTYPE=C (charmap=ISO-8859-1) (ignored: LC_ALL set to en_US)

Versions of packages coreutils depends on:
ii  libacl1                     2.2.29-1     Access control list shared library
ii  libc6                       2.3.2.ds1-20 GNU C Library: Shared libraries an

-- no debconf information

---------------------------------------
Received: (at 294350-done) by bugs.debian.org; 23 Dec 2005 13:49:23 +0000
>From [EMAIL PROTECTED] Fri Dec 23 05:49:23 2005
Return-path: <[EMAIL PROTECTED]>
Received: from mailservice.tudelft.nl ([130.161.131.5])
        by spohr.debian.org with esmtp (Exim 4.50)
        id 1EpnIR-0007Bc-J6
        for [EMAIL PROTECTED]; Fri, 23 Dec 2005 05:49:23 -0800
Received: from localhost (localhost [127.0.0.1])
        by rav.antivirus (Postfix) with ESMTP id D0E3822F1E1
        for <[EMAIL PROTECTED]>; Fri, 23 Dec 2005 14:48:52 +0100 (CET)
Received: from 82-171-132-56.dsl.ip.tiscali.nl (x084.decis.nl [130.161.177.84])
        by mx1.tudelft.nl (Postfix) with ESMTP id 3B56D22F160
        for <[EMAIL PROTECTED]>; Fri, 23 Dec 2005 14:48:52 +0100 (CET)
Received: from [127.0.0.1] (localhost [127.0.0.1])
        by 82-171-132-56.dsl.ip.tiscali.nl (Postfix) with ESMTP id 388CCBFA67
        for <[EMAIL PROTECTED]>; Fri, 23 Dec 2005 14:48:45 +0100 (CET)
Message-ID: <[EMAIL PROTECTED]>
Date: Fri, 23 Dec 2005 14:48:44 +0100
From: Thomas Hood <[EMAIL PROTECTED]>
User-Agent: Mozilla Thunderbird 1.0.7 (X11/20051013)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: [EMAIL PROTECTED]
Subject: Done
X-Enigmail-Version: 0.92.1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-Virus-Scanned: by amavisd-new at tudelft.nl
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02 
        (1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Level: 
X-Spam-Status: No, hits=-2.0 required=4.0 tests=BAYES_00,ONEWORD autolearn=no 
        version=2.60-bugs.debian.org_2005_01_02

5.93-5 contains the typo fix and the info node gives a good
description of the syntax of -k.

-- 
Thomas Hood


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

Reply via email to