bug#10013: man ls

[Eric Blake]

[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 <address@hidden>
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   address@hidden    +1-801-349-2682
Libvirt virtualization library http://libvirt.org