Subject: Re: bug#31055: Document ls -Ur -fr

From: Assaf Gordon <[email-masked]>
Date: Sun, 30 Dec 2018 12:39:42 -0700

Hello,

On 2018-04-03 6:03 p.m., 積丹尼 Dan Jacobson wrote:
> (info "(coreutils) Sorting the output") says
> 
> ‘-r’
> ‘--reverse’
>       Reverse whatever the sorting method is—e.g., list files in reverse
>       alphabetical order, youngest first, smallest first, or whatever.
> 
> OK but mention 'whatever' doesn't mean -U, -f, because they are sorted
> in "unsorted" order. In fact perhaps trigger an error.

Attached a small patch to clarify this point in the manual.

regards,
  -assaf
>From 0ffd6cdc5457fdedac997c9f66e3255278cabba5 Mon Sep 17 00:00:00 2001
From: Assaf Gordon <[email-masked]>
Date: Sun, 30 Dec 2018 12:37:11 -0700
Subject: [PATCH] doc: ls: mention --reverse/-r has no effecrt with -U/-f

Suggested by Dan Jacobson <[email-masked]> in
https://bugs.gnu.org/31055 .

* doc/coreutils.text (Sorting the output): Expand -r/--reverse item.
---
 doc/coreutils.texi | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index e05b34ab1..fd6d578ac 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7996,6 +7996,8 @@ were specified before the @option{-f}).
 @cindex reverse sorting
 Reverse whatever the sorting method is---e.g., list files in reverse
 alphabetical order, youngest first, smallest first, or whatever.
+@option{-r/--reverse} has no effect when using @option{--sort=none/-U} or
+@option{-f}.
 
 @item -S
 @itemx --sort=size
-- 
2.11.0