log4j-api: Incomplete/unclear description (simple implementation)

[Chealer]

log4j-api has the following name and description:

  <name>Apache Log4j API</name>
  <description>The Apache Log4j API</description>

This is at least incomplete, as shown by this discussion. Log4j developer Piotr P. Karwasz indicates that log4j-api provides a simple Log4j provider, SimpleLogger. I did not verify that and it is pretty much undocumented, but it is reportedly equivalent to slf4j-simple, except for being built in log4j-api.

I know little about Log4j, but considering that, I suggest replacing log4j-api's description with the following would make it much more complete/accurate:

Apache Log4j's logging facade API specification. A simple implementation (SimpleLogger) is built-in.

[rgoers]

Why? I read the discussion and I doubt that the name and the description in the pom.xml are going to make any difference to anyone who cares.

What would really help is completely separating the documentation for Log4j-API from the documentation for the rest of Log4j.

[vy]

@Chealer, thanks so much for the report. Fixed in 5a0262d. We will improve the situation further in:

• Create a Using a logging API guide #2509
• Create a Concepts page #2508
• Revamp the API page #2535

[Chealer]

Thanks to you @vy
I commented the change and would suggest a small tuning:

This package contains 2 components of the Apache Log4j project's API, through which applications and libraries can log:

• its specification
• and its simple built-in implementation (SimpleLogger) for trivial use cases. A fully-fledged implementation, such as Log4j Core, should be preferred for production applications.

[vy]

I think the current state is good enough. We better spend our effort elsewhere.