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

Suresh Srinivas commented on HDFS-4322:
---------------------------------------

bq. Help text is hardcoded into each command class. This should be replaced by 
resource files to allow internationalisation.
+1. Hadoop code needs a lot of improvement in this area. If we are planning to 
do this, lets create subtasks under this jira and fix all the commands.

bq. Line breaks are hardcoded into the help text. The help text should be 
auto-formatted at display time.
I am not sure how this helps. How would it change during auto-formatting at 
display time compared line breaks in the text itself?



                
> Tidy up fs -help
> ----------------
>
>                 Key: HDFS-4322
>                 URL: https://issues.apache.org/jira/browse/HDFS-4322
>             Project: Hadoop HDFS
>          Issue Type: Improvement
>            Reporter: Jonathan Allen
>            Assignee: Jonathan Allen
>            Priority: Minor
>
> There are a number of issues with the current fs -help implementation that 
> could do with tidying up.
> 1) Running 'hadoop fs -help' displays the full detailed help for all 
> commands.  This produces a large amount of text and makes it hard to find 
> what you're looking for.  Better functionality would be:
> - hadoop fs -usage : shows the basic usage information for all commands
> - hadoop fs -help : shows usage and brief summary (couple of lines) for all 
> commands
> - hadoop fs -help <command> : shows full description of the specified command
> 2) Help text is hardcoded into each command class. This should be replaced by 
> resource files to allow internationalisation.
> 3) Line breaks are hardcoded into the help text. The help text should be 
> auto-formatted at display time.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Reply via email to