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

szetszwo edited comment on HADOOP-2984 at 6/11/08 3:49 PM:
-------------------------------------------------------------------------

- Provide the full class name of DispCp in the beginning of the document.

- Add a line to explain the name distcp

- Some examples have long-single-line-commands.  These 
long-single-line-commands got wrapped up in the document, 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}


      was (Author: szetszwo):
    - 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.

Reply via email to