[ 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