Mailing-List: contact core-dev-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Reply-To: core-dev@hadoop.apache.org
Message-ID: <1388482043.1213223445250.JavaMail.jira@brutus>
Date: Wed, 11 Jun 2008 15:30:45 -0700 (PDT)
From: "Tsz Wo (Nicholas), SZE (JIRA)" <jira@apache.org>
To: core-dev@hadoop.apache.org
Subject: [jira] Commented: (HADOOP-2984) Distcp should have forrest
 documentation
In-Reply-To: <948935687.1205159986366.JavaMail.jira@brutus>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/HADOOP-2984?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12604367#action_12604367 ] 

Tsz Wo (Nicholas), SZE commented on HADOOP-2984:
------------------------------------------------

- Provide the full class name for DispCp once in the beginning for the document.

- Add a line to explain the command name distcp

- Some examples have long single line commands.  These long single line commands got wrapped up in the docoument, especially in the pdf.  It is good to use \ to break the long command into several lines.  e.g.
Use
{noformat}
hadoop distcp               \
    hdfs://nn1:8020/foo/a   \
    hdfs://nn1:8020/foo/b   \
    hdfs://nn2:8020/bar/foo
{noformat}
instead of
{noformat}
hadoop distcp hdfs://nn1:8020/foo/a hdfs://nn1:8020/foo/b hdfs://nn2:8020/bar/foo
{noformat}

- I think it is more clear to add a command prompt for shell commands
e.g.
{noformat}
bash$ hadoop distcp ...
{noformat}


> Distcp should have forrest documentation
> ----------------------------------------
>
>                 Key: HADOOP-2984
>                 URL: https://issues.apache.org/jira/browse/HADOOP-2984
>             Project: Hadoop Core
>          Issue Type: Task
>          Components: util
>            Reporter: Owen O'Malley
>            Assignee: Chris Douglas
>            Priority: Blocker
>             Fix For: 0.18.0
>
>         Attachments: 2984-0.patch, 2984-1.patch
>
>
> We really should have a page on how to use distcp.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.