Subject: bug#10013: man ls

From: Eric Blake <[email-masked]>
Date: Thu, 10 Nov 2011 14:33:26 -0700

[re-adding the list]

On 11/10/2011 02:21 PM, Ian Bruntlett wrote:
>
> Hi Eric,
>
>> Reads a bit long.  Maybe:
>>
>> The 'ls' program stands for "list sorted".  It lists information about
>> files (of any type, including directories), typically in a sorted order.
>>    Options and file arguments...
>
> Cool :) I much prefer your version.

I'm glad you like it, but we still have to turn it into a formal patch 
approved by the primary maintainers.  How about:

 From 4ef41ac0146c1a2d9b92b2304ab6cf6e6470f730 Mon Sep 17 00:00:00 2001
From: Eric Blake <[email-masked]>
Date: Thu, 10 Nov 2011 14:32:40 -0700
Subject: [PATCH] doc: mention mnemonic

* doc/coreutils.texi (ls invocation): Mention "list sorted".
Suggested by Ian Bruntlett.
---
  doc/coreutils.texi |    5 +++--
  1 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 2c33fe8..3831364 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6368,8 +6368,9 @@ ls invocation
  @pindex ls
  @cindex directory listing

-The @command{ls} program lists information about files (of any type,
-including directories).  Options and file arguments can be intermixed
+The @command{ls} program stands for ``list sorted''.  It lists
+information about files (of any type, including directories),
+typically in a sorted order.  Options and file arguments can be intermixed
  arbitrarily, as usual.

  For non-option command-line arguments that are directories, by default
-- 
1.7.4.4

-- 
Eric Blake   [email-masked]    +1-801-349-2682
Libvirt virtualization library http://libvirt.org