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-unsubscr...@hadoop.apache.org
For additional commands, e-mail: common-dev-h...@hadoop.apache.org

Reply via email to