You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-dev@hadoop.apache.org by "Steve Loughran (JIRA)" <ji...@apache.org> on 2016/09/13 18:11:21 UTC
[jira] [Created] (HADOOP-13605) Clean up FileSystem javadocs,
logging; improve diagnostics on FS load
Steve Loughran created HADOOP-13605:
---------------------------------------
Summary: Clean up FileSystem javadocs, logging; improve diagnostics on FS load
Key: HADOOP-13605
URL: https://issues.apache.org/jira/browse/HADOOP-13605
Project: Hadoop Common
Issue Type: Improvement
Components: fs
Affects Versions: 2.8.0
Reporter: Steve Loughran
Assignee: Steve Loughran
We can't easily debug FS instantiation problems as there isn't much detail in what was going on.
We can add more logging, but cannot simply switch {{FileSystem.LOG}} to SLF4J —the class is used in too many places, including tests which cast it. Instead, add a new private SLF4J Logger, {{LOGGER}} and switch logging to it.
While working in the base FileSystem class, take the opportunity to clean up javadocs and comments
# add the list of exceptions, including indicating which base classes throw UnsupportedOperationExceptions
# cut bits in the comments which are not true
The outcome of this patch is that IDEs shouldn't highlight most of the file as flawed in some way or another
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: common-dev-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-dev-help@hadoop.apache.org