[ 
https://issues.apache.org/jira/browse/HDFS-3994?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Colin Patrick McCabe resolved HDFS-3994.
----------------------------------------

    Resolution: Won't Fix

I looked at this again, and I think the intention is just that you use 
{{CommonConfigurationKeys}} throughout your code, since that inherits a bunch 
of constants from {{CommonConfigurationKeysPublic}}
                
> misleading comment in CommonConfigurationKeysPublic
> ---------------------------------------------------
>
>                 Key: HDFS-3994
>                 URL: https://issues.apache.org/jira/browse/HDFS-3994
>             Project: Hadoop HDFS
>          Issue Type: Bug
>          Components: hdfs-client
>    Affects Versions: 2.0.3-alpha
>            Reporter: Colin Patrick McCabe
>            Priority: Trivial
>
> {{CommonConfigurationKeysPublic}} contains a potentially misleading comment:
> {code}
> /** 
>  * This class contains constants for configuration keys used
>  * in the common code.
>  *
>  * It includes all publicly documented configuration keys. In general
>  * this class should not be used directly (use CommonConfigurationKeys
>  * instead)
>  */
> {code}
> This comment suggests that the user use {{CommonConfigurationKeys}}, despite 
> the fact that that class is {{InterfaceAudience.private}} whereas 
> {{CommonConfigurationKeysPublic}} is {{InterfaceAudience.public}}.  Perhaps 
> this should be rephrased.

--
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