Mailing-List: contact common-issues-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
Date: Mon, 24 Oct 2016 18:17:59 +0000 (UTC)
From: "Steve Loughran (JIRA)" <jira@apache.org>
To: common-issues@hadoop.apache.org
Message-ID: <JIRA.13004673.1473790278000.69943.1477333079821@Atlassian.JIRA>
In-Reply-To: <JIRA.13004673.1473790278000@Atlassian.JIRA>
References: <JIRA.13004673.1473790278000@Atlassian.JIRA> <JIRA.13004673.1473790278600@arcas>
Subject: [jira] [Updated] (HADOOP-13605) Clean up FileSystem javadocs,
 logging; improve diagnostics on FS load
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
archived-at: Mon, 24 Oct 2016 18:18:06 -0000


     [ https://issues.apache.org/jira/browse/HADOOP-13605?page=3Dcom.atlass=
ian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Steve Loughran updated HADOOP-13605:
------------------------------------
    Status: Open  (was: Patch Available)

> 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
>         Attachments: HADOOP-13605-branch-2-001.patch, HADOOP-13605-branch=
-2-002.patch
>
>
> We can't easily debug FS instantiation problems as there isn't much detai=
l in what was going on.
> We can add more logging, but cannot simply switch {{FileSystem.LOG}} to S=
LF4J =E2=80=94the class is used in too many places, including tests which c=
ast it. Instead, add a new private SLF4J Logger, {{LOGGER}} and switch logg=
ing to it.=20
> 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 thr=
ow UnsupportedOperationExceptions
> # cut bits in the comments which are not true
> The outcome of this patch is that IDEs shouldn't highlight most of the fi=
le as flawed in some way or another


--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: common-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-issues-help@hadoop.apache.org