/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements. See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache license, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License. You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the license for the specific language governing permissions and
 * limitations under the license.
 */
/**
 * Public API for Log4j 2.0.
 */
package org.apache.logging.log4j;

@@ -828,10 +828,777 @@
 j 2.
-0.
+%0A *%0A * %3Cp%3E%0A *     The main entry point into Log4j is the %7B@link org.apache.logging.log4j.LogManager%7D class which can be used to%0A *     obtain %7B@link org.apache.logging.log4j.Logger%7D objects, the current%0A *     %7B@link org.apache.logging.log4j.spi.LoggerContext%7D, a new %7B@code LoggerContext%7D, and the current%0A *     %7B@link org.apache.logging.log4j.spi.LoggerContextFactory%7D.%0A * %3C/p%3E%0A * %3Cp%3E%0A *     %7B@link org.apache.logging.log4j.Marker%7D objects can be obtained through the%0A *     %7B@link org.apache.logging.log4j.MarkerManager%7D. The %3Cabbr title=%22Mapped Diagnostic Context%22%3EMDC%3C/abbr%3E can be%0A *     used through the %7B@link org.apache.logging.log4j.ThreadContext%7D class.%0A * %3C/p%3E%0A *%0A * @see %3Ca href=%22http://logging.apache.org/log4j/2.x/manual/api.html%22%3ELog4j 2 API manual%3C/a%3E
 %0A */

Expand on the top level package-info javadoc.