hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From a..@apache.org
Subject [01/12] git commit: HADOOP-8808. Update FsShell documentation to mention deprecation of some of the commands, and mention alternatives (Akira AJISAKA via aw)
Date Fri, 26 Sep 2014 23:31:31 GMT
Repository: hadoop
Updated Branches:
  refs/heads/HDFS-6581 7060502ed -> d96396627


HADOOP-8808. Update FsShell documentation to mention deprecation of some of the commands,
and mention alternatives (Akira AJISAKA via aw)


Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo
Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/df5fed5c
Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/df5fed5c
Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/df5fed5c

Branch: refs/heads/HDFS-6581
Commit: df5fed5c0e5ef1e850bc6db7beb1beffd269e1ab
Parents: ac70c27
Author: Allen Wittenauer <aw@apache.org>
Authored: Fri Sep 26 11:10:51 2014 -0700
Committer: Allen Wittenauer <aw@apache.org>
Committed: Fri Sep 26 11:10:51 2014 -0700

----------------------------------------------------------------------
 hadoop-common-project/hadoop-common/CHANGES.txt |  3 ++
 .../src/site/apt/FileSystemShell.apt.vm         | 51 +++++++++++---------
 2 files changed, 32 insertions(+), 22 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hadoop/blob/df5fed5c/hadoop-common-project/hadoop-common/CHANGES.txt
----------------------------------------------------------------------
diff --git a/hadoop-common-project/hadoop-common/CHANGES.txt b/hadoop-common-project/hadoop-common/CHANGES.txt
index 6dc8e17..c706bd6 100644
--- a/hadoop-common-project/hadoop-common/CHANGES.txt
+++ b/hadoop-common-project/hadoop-common/CHANGES.txt
@@ -548,6 +548,9 @@ Release 2.6.0 - UNRELEASED
     HADOOP-11101. How about inputstream close statement from catch block to
     finally block in FileContext#copy() ( skrho via vinayakumarb )
 
+    HADOOP-8808. Update FsShell documentation to mention deprecation of some of
+    the commands, and mention alternatives (Akira AJISAKA via aw)
+
   OPTIMIZATIONS
 
     HADOOP-10838. Byte array native checksumming. (James Thomas via todd)

http://git-wip-us.apache.org/repos/asf/hadoop/blob/df5fed5c/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
----------------------------------------------------------------------
diff --git a/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm b/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
index 53e42cb..9317c66 100644
--- a/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
+++ b/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
@@ -221,7 +221,9 @@ dus
 
    Usage: <<<hdfs dfs -dus <args> >>>
 
-   Displays a summary of file lengths. This is an alternate form of hdfs dfs -du -s.
+   Displays a summary of file lengths.
+
+   <<Note:>> This command is deprecated. Instead use <<<hdfs dfs -du
-s>>>.
 
 expunge
 
@@ -311,7 +313,12 @@ getmerge
 
 ls
 
-   Usage: <<<hdfs dfs -ls <args> >>>
+   Usage: <<<hdfs dfs -ls [-R] <args> >>>
+
+   Options:
+
+     * The -R option will return stat recursively through the directory
+       structure.
 
    For a file returns stat on the file with the following format:
 
@@ -337,7 +344,9 @@ lsr
 
    Usage: <<<hdfs dfs -lsr <args> >>>
 
-   Recursive version of ls. Similar to Unix ls -R.
+   Recursive version of ls.
+
+   <<Note:>> This command is deprecated. Instead use <<<hdfs dfs -ls
-R>>>
 
 mkdir
 
@@ -413,13 +422,22 @@ put
 
 rm
 
-   Usage: <<<hdfs dfs -rm [-skipTrash] URI [URI ...]>>>
+   Usage: <<<hdfs dfs -rm [-f] [-r|-R] [-skipTrash] URI [URI ...]>>>
+
+   Delete files specified as args.
+
+   Options:
+
+    * The -f option will not display a diagnostic message or modify the exit
+      status to reflect an error if the file does not exist.
 
-   Delete files specified as args. Only deletes non empty directory and files.
-   If the -skipTrash option is specified, the trash, if enabled, will be
-   bypassed and the specified file(s) deleted immediately. This can be useful
-   when it is necessary to delete files from an over-quota directory. Refer to
-   rmr for recursive deletes.
+    * The -R option deletes the directory and any content under it recursively.
+
+    * The -r option is equivalent to -R.
+
+    * The -skipTrash option will bypass trash, if enabled, and delete the
+      specified file(s) immediately. This can be useful when it is necessary
+      to delete files from an over-quota directory.
 
    Example:
 
@@ -433,20 +451,9 @@ rmr
 
    Usage: <<<hdfs dfs -rmr [-skipTrash] URI [URI ...]>>>
 
-   Recursive version of delete. If the -skipTrash option is specified, the
-   trash, if enabled, will be bypassed and the specified file(s) deleted
-   immediately. This can be useful when it is necessary to delete files from an
-   over-quota directory.
-
-   Example:
-
-     * <<<hdfs dfs -rmr /user/hadoop/dir>>>
+   Recursive version of delete.
 
-     * <<<hdfs dfs -rmr hdfs://nn.example.com/user/hadoop/dir>>>
-
-   Exit Code:
-
-   Returns 0 on success and -1 on error.
+   <<Note:>> This command is deprecated. Instead use <<<hdfs dfs -rm
-r>>>
 
 setfacl
 


Mime
View raw message