[jira] [Created] (MAPREDUCE-6807) mapred pipes usage is non-standard and redundant

["Grant Sohn (JIRA)" <ji...@apache.org>]

Grant Sohn created MAPREDUCE-6807:
-------------------------------------

             Summary: mapred pipes usage is non-standard and redundant
                 Key: MAPREDUCE-6807
                 URL: https://issues.apache.org/jira/browse/MAPREDUCE-6807
             Project: Hadoop Map/Reduce
          Issue Type: Bug
          Components: client, mrv1
    Affects Versions: 2.6.0
            Reporter: Grant Sohn
            Priority: Trivial


Running "mapred pipes" returns:

{noformat}
bin/hadoop pipes
  [-input <path>] // Input directory
  [-output <path>] // Output directory
  [-jar <jar file> // jar filename
  [-inputformat <class>] // InputFormat class
  [-map <class>] // Java Map class
  [-partitioner <class>] // Java Partitioner
  [-reduce <class>] // Java Reduce class
  [-writer <class>] // Java RecordWriter
  [-program <executable>] // executable URI
  [-reduces <num>] // number of reduces
  [-lazyOutput <true/false>] // createOutputLazily
{noformat}

No Hadoop CLI uses // comments in the help.  Most of them follow the
pattern similar to UNIX/Linux man page styling:
{noformat}
usage: CMD OPTIONS
OPTIONS/SUBCMD-BLOCK

OPTION/SUBCMD-DEFINITION-BLOCK
{noformat}

It should be look like this since the comments are really redundant:

{noformat}
usage: bin/mapred pipes
  [-input <path>] 
  [-output <path>] 
  [-jar <jar file>]
  [-inputformat <class>] 
  [-map <class>] 
  [-partitioner <class>] 
  [-reduce <class>] 
  [-writer <class>] 
  [-program <executable URI>] 
  [-reduces <num>] 
  [-lazyOutput <true/false>] 
{noformat}

then the parameters can be expanded upon in the section below.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: mapreduce-dev-unsubscribe@hadoop.apache.org
For additional commands, e-mail: mapreduce-dev-help@hadoop.apache.org