[jira] [Created] (LOG4J2-2504) Missing JavaDoc in ThrowablePatternConverter newInstance(Configuration, String[])

["Juri Berlanda (JIRA)" <ji...@apache.org>]

Juri Berlanda created LOG4J2-2504:
-------------------------------------

             Summary: Missing JavaDoc in ThrowablePatternConverter newInstance(Configuration, String[])
                 Key: LOG4J2-2504
                 URL: https://issues.apache.org/jira/browse/LOG4J2-2504
             Project: Log4j 2
          Issue Type: Documentation
          Components: Pattern Converters
    Affects Versions: 2.11.1, 2.8.2
            Reporter: Juri Berlanda


While upgrading from Log4j 2.7 to the most recent 2.11.1 I noticed, that the API for {{{color:#333333}ThrowablePatternConverter{color}}} changed.

It used to be (up until 2.8.1):

{{{color:#333333}ThrowablePatternConverter newInstance(final String[] options)
{color}}}

{color:#333333}but starting from 2.8.2 it is:{color}

{{{color:#333333}ThrowablePatternConverter newInstance(final Configuration config, final String[] options)
{color}}}

{color:#333333}The new Parameter is not described in JavaDoc and I cannot figure out how I would get a {{Configuration}} object which would cause it to behave the same as with 2.7.{color}

{color:#333333}In addition: I think it would be a good idea to add a convenience {{ThrowablePatternConverter newInstance(final String[] options)}} which uses said default {{Configuration}} both to easy upgrades, and to allow backwards compatibility for stuff compiled against 2.7 (in my case a {color}LogEventPatternConverter {color:#333333}deployed toTomcat).{color}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)