Return-Path: <common-issues-return-121702-archive-asf-public=cust-asf.ponee.io@hadoop.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id 227A6200BB9
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Mon,  7 Nov 2016 19:58:00 +0100 (CET)
Received: by cust-asf.ponee.io (Postfix)
	id 211FD160B10; Mon,  7 Nov 2016 18:58:00 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id 69329160AE0
	for <archive-asf-public@cust-asf.ponee.io>; Mon,  7 Nov 2016 19:57:59 +0100 (CET)
Received: (qmail 62780 invoked by uid 500); 7 Nov 2016 18:57:58 -0000
Mailing-List: contact common-issues-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:common-issues-help@hadoop.apache.org>
List-Unsubscribe: <mailto:common-issues-unsubscribe@hadoop.apache.org>
List-Post: <mailto:common-issues@hadoop.apache.org>
List-Id: <common-issues.hadoop.apache.org>
Delivered-To: mailing list common-issues@hadoop.apache.org
Received: (qmail 62769 invoked by uid 99); 7 Nov 2016 18:57:58 -0000
Received: from arcas.apache.org (HELO arcas) (140.211.11.28)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 07 Nov 2016 18:57:58 +0000
Received: from arcas.apache.org (localhost [127.0.0.1])
	by arcas (Postfix) with ESMTP id 610822C1F56
	for <common-issues@hadoop.apache.org>; Mon,  7 Nov 2016 18:57:58 +0000 (UTC)
Date: Mon, 7 Nov 2016 18:57:58 +0000 (UTC)
From: "Mingliang Liu (JIRA)" <jira@apache.org>
To: common-issues@hadoop.apache.org
Message-ID: <JIRA.13018937.1478543493000.212603.1478545078394@Atlassian.JIRA>
In-Reply-To: <JIRA.13018937.1478543493000@Atlassian.JIRA>
References: <JIRA.13018937.1478543493000@Atlassian.JIRA> <JIRA.13018937.1478543493941@arcas>
Subject: [jira] [Commented] (HADOOP-13802) Make generic options help more
 consistent, and aligned
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394
archived-at: Mon, 07 Nov 2016 18:58:00 -0000


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

Mingliang Liu commented on HADOOP-13802:
----------------------------------------

{quote}
My only nit on this is adding the ":" at the end of "The general command line syntax is:".
{quote}
...and the option/description is aligned?

> Make generic options help more consistent, and aligned
> ------------------------------------------------------
>
>                 Key: HADOOP-13802
>                 URL: https://issues.apache.org/jira/browse/HADOOP-13802
>             Project: Hadoop Common
>          Issue Type: Improvement
>    Affects Versions: 2.6.0
>            Reporter: Grant Sohn
>            Priority: Trivial
>
> The generic options have always been this:
> {noformat}
> Generic options supported are
> -conf <configuration file>     specify an application configuration file
> -D <property=value>            use value for given property
> -fs <local|namenode:port>      specify a namenode
> -jt <local|resourcemanager:port>    specify a ResourceManager
> -files <comma separated list of files>    specify comma separated files to be copied to the map reduce cluster
> -libjars <comma separated list of jars>    specify comma separated jar files to include in the classpath.
> -archives <comma separated list of archives>    specify comma separated archives to be unarchived on the compute machines.
> The general command line syntax is
> bin/hadoop command [genericOptions] [commandOptions]
> {noformat}
> However, almost all the hadoop command help follow an unwritten style which is similar to man page descriptions.
> This is the proposed improvement.
> {noformat}
> Generic options supported are:
> -conf <configuration file>     specify an application configuration file
> -D <property=value>            define a value for given property
> -fs <local|namenode:port>      specify a namenode
> -jt <local|jobtracker:port>    specify a job tracker
> -files <file1,...>             specify a comma-separated list of files to be copied to the map reduce cluster
> -libjars <jar1,...>            specify a comma-separated list of jar files to be included in the classpath
> -archives <archive1,...>       specify a comma-separated list of archives to be unarchived on the compute machines
> {noformat}



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

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