HADOOP-12686. Update FileSystemShell documentation to mention the meaning of each columns of fs -du. Contributed by Daisuke Kobayashi.

(cherry picked from commit 1af2917856f8da3ad76bb6cbbc511627a647e091)
(cherry picked from commit 40b41ac8fc1aed679d2cd45794c4fb47bdafa9b2)

hadoop-common-project/hadoop-common/CHANGES.txt

@@ -364,6 +364,9 @@ Release 2.8.0 - UNRELEASED
     HADOOP-12570. HDFS Secure Mode Documentation updates.
     (Arpit Agarwal via cnauroth)
 
+    HADOOP-12686. Update FileSystemShell documentation to mention the meaning
+    of each columns of fs -du. (Daisuke Kobayashi via aajisaka)
+
   OPTIMIZATIONS
 
     HADOOP-11785. Reduce the number of listStatus operation in distcp

hadoop-common-project/hadoop-common/src/site/markdown/FileSystemShell.md

@@ -251,6 +251,10 @@ Options:
 * The -s option will result in an aggregate summary of file lengths being displayed, rather than the individual files.
 * The -h option will format file sizes in a "human-readable" fashion (e.g 64.0m instead of 67108864)
 
+The du returns three columns with the following format:
+
+    size disk_space_consumed_with_all_replicas full_path_name
+
 Example:
 
 * `hadoop fs -du /user/hadoop/dir1 /user/hadoop/file1 hdfs://nn.example.com/user/hadoop/dir1`