[ https://issues.apache.org/jira/browse/YARN-5820?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15646654#comment-15646654 ]
Grant Sohn commented on YARN-5820: ---------------------------------- [~naganarasimha...@apache.org], by showing the hadoop command usage, I was only trying to point out that usage lines are never split in the middle of some option as was done with <NodeId>, even when the options and parameters gets quite long like hadoop fs -setfacl. I'm fine with the YARN style of usage, I was just trying to make the content clearer. Apologies for the confusion, I'll try to be less ambiguous. > yarn node CLI help should be clearer > ------------------------------------ > > Key: YARN-5820 > URL: https://issues.apache.org/jira/browse/YARN-5820 > Project: Hadoop YARN > Issue Type: Bug > Components: client > Affects Versions: 2.6.0 > Reporter: Grant Sohn > Assignee: Ajith S > Priority: Trivial > Attachments: YARN-5820.01.patch, YARN-5820.02.patch, > YARN-5820.03.patch, YARN-5820.04.patch > > > Current message is: > {noformat} > usage: node > -all Works with -list to list all nodes. > -list List all running nodes. Supports optional use of > -states to filter nodes based on node state, all -all > to list all nodes. > -states <States> Works with -list to filter nodes based on input > comma-separated list of node states. > -status <NodeId> Prints the status report of the node. > {noformat} > It should be either this: > {noformat} > usage: yarn node [-list [-states <States>|-all] | -status <NodeId>] > -all Works with -list to list all nodes. > -list List all running nodes. Supports optional use of > -states to filter nodes based on node state, all -all > to list all nodes. > -states <States> Works with -list to filter nodes based on input > comma-separated list of node states. > -status <NodeId> Prints the status report of the node. > {noformat} > or that. > {noformat} > usage: yarn node -list [-states <States>|-all] > yarn node -status <NodeId> > -all Works with -list to list all nodes. > -list List all running nodes. Supports optional use of > -states to filter nodes based on node state, all -all > to list all nodes. > -states <States> Works with -list to filter nodes based on input > comma-separated list of node states. > -status <NodeId> Prints the status report of the node. > {noformat} > The latter is the least ambiguous. -- This message was sent by Atlassian JIRA (v6.3.4#6332) --------------------------------------------------------------------- To unsubscribe, e-mail: yarn-issues-unsubscr...@hadoop.apache.org For additional commands, e-mail: yarn-issues-h...@hadoop.apache.org