You are viewing a plain text version of this content. The canonical link for it is here.

Posted to common-dev@hadoop.apache.org by "Owen O'Malley (JIRA)" <ji...@apache.org> on 2008/03/10 15:39:46 UTC

[jira] Created: (HADOOP-2984) Distcp should have forrest documentation

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


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.

[jira] Commented: (HADOOP-2984) Distcp should have forrest documentation

Posted by "Tsz Wo (Nicholas), SZE (JIRA)" <ji...@apache.org>.

    [ 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.

[jira] Issue Comment Edited: (HADOOP-2984) Distcp should have forrest documentation

Posted by "Tsz Wo (Nicholas), SZE (JIRA)" <ji...@apache.org>.

    [ 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.

[jira] Updated: (HADOOP-2984) Distcp should have forrest documentation

Posted by "Robert Chansler (JIRA)" <ji...@apache.org>.

     [ https://issues.apache.org/jira/browse/HADOOP-2984?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Chansler updated HADOOP-2984:
------------------------------------

         Priority: Blocker  (was: Major)
    Fix Version/s: 0.18.0
         Assignee: Chris Douglas

> 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
>
>
> 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.

[jira] Commented: (HADOOP-2984) Distcp should have forrest documentation

Posted by "Hadoop QA (JIRA)" <ji...@apache.org>.

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

Hadoop QA commented on HADOOP-2984:
-----------------------------------

-1 overall.  Here are the results of testing the latest attachment 
  http://issues.apache.org/jira/secure/attachment/12383764/2984-1.patch
  against trunk revision 666056.

    +1 @author.  The patch does not contain any @author tags.

    -1 tests included.  The patch doesn't appear to include any new or modified tests.
                        Please justify why no tests are needed for this patch.

    +1 javadoc.  The javadoc tool did not generate any warning messages.

    +1 javac.  The applied patch does not increase the total number of javac compiler warnings.

    +1 findbugs.  The patch does not introduce any new Findbugs warnings.

    -1 release audit.  The applied patch generated 202 release audit warnings (more than the trunk's current 201 warnings).

    +1 core tests.  The patch passed core unit tests.

    +1 contrib tests.  The patch passed contrib unit tests.

Test results: http://hudson.zones.apache.org/hudson/job/Hadoop-Patch/2632/testReport/
Release audit warnings: http://hudson.zones.apache.org/hudson/job/Hadoop-Patch/2632/artifact/trunk/current/releaseAuditDiffWarnings.txt
Findbugs warnings: http://hudson.zones.apache.org/hudson/job/Hadoop-Patch/2632/artifact/trunk/build/test/findbugs/newPatchFindbugsWarnings.html
Checkstyle results: http://hudson.zones.apache.org/hudson/job/Hadoop-Patch/2632/artifact/trunk/build/test/checkstyle-errors.html
Console output: http://hudson.zones.apache.org/hudson/job/Hadoop-Patch/2632/console

This message is automatically generated.

> 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.