GNU bug report logs - #10013
[ls] document origin of name

Previous Next

Full log

Message #17 received at 10013 <at> debbugs.gnu.org (full text, mbox):

From: Eric Blake <eblake <at> redhat.com>
To: Ian Bruntlett <ianbruntlett <at> hotmail.com>, 10013 <at> debbugs.gnu.org
Subject: Re: bug#10013: man ls
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 <eblake <at> redhat.com>
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   eblake <at> redhat.com    +1-801-349-2682
Libvirt virtualization library http://libvirt.org

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.