hadoop-hdfs-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Suresh Srinivas (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HDFS-4322) Tidy up fs -help
Date Tue, 18 Dec 2012 14:32:13 GMT

    [ 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

Mime
View raw message