Re: Add --dereference option to df

[Bernhard Voelker]

On 12/05/2013 02:26 PM, Pádraig Brady wrote:
> On 12/05/2013 01:21 PM, Bernhard Voelker wrote:
>> df now also works better with relative paths to the source
>> device, [...]

>> And as this was a user-visible change, it should probably
>> be mentioned in the NEWS file.  WDYT?
> 
> We might as well adjust the second df item in NEWS to
> mention that case too.

What about the following?

Have a nice day,
Berny

>From 34582a1aedae0d7002b76a64a14dc3143198ced0 Mon Sep 17 00:00:00 2001
From: Bernhard Voelker <address@hidden>
Date: Fri, 6 Dec 2013 00:59:36 +0100
Subject: [PATCH] doc: clarify that df now generally processes special files
 correctly

Since v8.21-172-g33660b4, df not only treats symbolic link arguments
differently, as stated there, but now generally processes special file
arguments in a non-canonicalized form correctly:

  $ cd /dev && df-old sdb
  Filesystem     1K-blocks  Used Available Use% Mounted on
  devtmpfs         1014572    48   1014524   1% /dev

  $ cd /dev && df-new sdb
  Filesystem     1K-blocks    Used Available Use% Mounted on
  /dev/sdb        10190136 6039532   3609932  63% /home

Document df's new behavior.

* doc/coreutils.texi (df invocation): In the paragraph describing
df's behavior regarding special file arguments, relax the condition
for such special files from "... is an absolute name of ..." to
"... resolves to ...".
* NEWS (Bug fixes): Mention the new behavior also here.
---
 NEWS               | 5 +++--
 doc/coreutils.texi | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/NEWS b/NEWS
index e0cd540..529c54b 100644
--- a/NEWS
+++ b/NEWS
@@ -8,8 +8,9 @@ GNU coreutils NEWS                                    -*- 
outline -*-
   mount points.  Previously it may have failed to output some mount points.
   [bug introduced in coreutils-8.21]

-  df now processes symbolic links to disk device nodes correctly.  Previously
-  df displayed the symlink's device rather than that for the device node.
+  df now processes symbolic links and relative paths to special files 
containing
+  a mounted file system correctly.  Previously df displayed the statistics 
about
+  the file system the file is stored on rather than the one inside.
   [This bug was present in "the beginning".]

   df now processes disk device nodes correctly in the presence of bind mounts.
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index c818a1e..74d5025 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -11108,7 +11108,7 @@ not shown per default when already the real root device 
has been mounted.

 @cindex disk device file
 @cindex device file, disk
-If an argument @var{file} is an absolute name of a disk device node containing
+If an argument @var{file} resolves to a special file containing
 a mounted file system, @command{df} shows the space available on that
 file system rather than on the file system containing the device node.
 GNU @command{df} does not attempt to determine the disk usage
-- 
1.8.3.1