[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Inaccurate/incorrect description of the -b option in man ls(1)
From: |
Eric Blake |
Subject: |
Re: Inaccurate/incorrect description of the -b option in man ls(1) |
Date: |
Thu, 18 Mar 2010 08:11:47 -0600 |
User-agent: |
Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1.8) Gecko/20100301 Fedora/3.0.3-1.fc12 Lightning/1.0b1 Thunderbird/3.0.3 |
On 03/18/2010 02:34 AM, Jim Meyering wrote:
> address@hidden wrote:
>> In the manpage for ls(1), the description of the -b option says,
>> "print octal escapes for nongraphic characters"
> Note that the authoritative documentation for GNU ls is not the
> man page (which is merely the massaged output of ls --help)
> but rather the info doc, i.e., what you get when you run
> "info coreutils ls". Its "Formatting the file names" section says this:
>
> `-b'
> `--escape'
> `--quoting-style=escape'
> Quote nongraphic characters in file names using alphabetic and
> octal backslash sequences like those used in C.
>
> which is consistent with GNU ls's behavior.
How about a patch that shortens the --help output:
s/octal //
or maybe slightly longer, but still legible:
s/octal /c-style/
Either way, it's a one-liner that makes --help match reality.
--
Eric Blake address@hidden +1-801-349-2682
Libvirt virtualization library http://libvirt.org
signature.asc
Description: OpenPGP digital signature