HADOOP-7192. Update fs -stat docs to reflect the format features. Contributed by Harsh J Chouraria.

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/trunk@1102951 13f79535-47bb-0310-9956-ffa450edef68

CHANGES.txt

@@ -456,6 +456,9 @@ Release 0.22.0 - Unreleased
     HADOOP-7189. Add ability to enable 'debug' property in JAAS configuration.
     (Ted Yu via todd)
 
+    HADOOP-7192. Update fs -stat docs to reflect the format features. (Harsh
+    J Chouraria via todd)
+
   OPTIMIZATIONS
 
     HADOOP-6884. Add LOG.isDebugEnabled() guard for each LOG.debug(..).

src/docs/src/documentation/content/xdocs/file_system_shell.xml

@@ -482,15 +482,28 @@
 		<section>
 			<title> stat </title>
 			<p>
-				<code>Usage: hdfs dfs -stat URI [URI &#x2026;]</code>
+				<code>Usage: hdfs dfs -stat [format] URI [URI &#x2026;]</code>
-			</p>
-			<p>
-	   Returns the stat information on the path.
 			</p>
+			<p>Print statistics about the file/directory matching the given URI pattern in the specified format.</p>
+			<p>Format accepts:</p>
+			  <ul>
+			    <li>filesize in blocks (%b)</li>
+			    <li>filename (%n)</li>
+		      <li>block size (%o)</li>
+		      <li>replication (%r)</li>
+		      <li>modification date, formatted as Y-M-D H:M:S (%y)</li>
+		      <li>modification date, in epoch seconds (%Y)</li>
+        </ul>
 			<p>Example:</p>
 			<ul>
         <li>
           <code> hdfs dfs -stat path </code>
+        </li>
+				<li>
+					<code> hdfs dfs -stat %y path </code>
+				</li>
+        <li>
+          <code> hdfs dfs -stat '%b %r' path </code>
         </li>
 			</ul>
 			<p>Exit Code:<br/>