You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by ma...@apache.org on 2014/09/25 06:03:50 UTC

[1/5] git commit: Ignored exceptions names.

Repository: logging-log4j2
Updated Branches:
  refs/heads/master 310e0c45e -> e4a9d7f9d


Ignored exceptions names.


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/2366a718
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/2366a718
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/2366a718

Branch: refs/heads/master
Commit: 2366a71831f4a9c471a1805f83be33717bbdac52
Parents: 268d9df
Author: Matt Sicker <ma...@apache.org>
Authored: Wed Sep 24 22:30:36 2014 -0500
Committer: Matt Sicker <ma...@apache.org>
Committed: Wed Sep 24 23:03:31 2014 -0500

----------------------------------------------------------------------
 .../org/apache/logging/log4j/message/FormattedMessage.java     | 4 ++--
 .../java/org/apache/logging/log4j/util/PropertiesUtil.java     | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2366a718/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessage.java
----------------------------------------------------------------------
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessage.java b/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessage.java
index c59147f..54905d0 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessage.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/message/FormattedMessage.java
@@ -115,14 +115,14 @@ public class FormattedMessage implements Message {
             if (formats != null && formats.length > 0) {
                 return new MessageFormatMessage(msgPattern, args);
             }
-        } catch (final Exception ex) {
+        } catch (final Exception ignored) {
             // Obviously, the message is not a proper pattern for MessageFormat.
         }
         try {
             if (MSG_PATTERN.matcher(msgPattern).find()) {
                 return new StringFormattedMessage(msgPattern, args);
             }
-        } catch (final Exception ex) {
+        } catch (final Exception ignored) {
             // Also not properly formatted.
         }
         return new ParameterizedMessage(msgPattern, args, throwable);

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2366a718/log4j-api/src/main/java/org/apache/logging/log4j/util/PropertiesUtil.java
----------------------------------------------------------------------
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/PropertiesUtil.java b/log4j-api/src/main/java/org/apache/logging/log4j/util/PropertiesUtil.java
index 0683766..3d74db5 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/PropertiesUtil.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/PropertiesUtil.java
@@ -98,7 +98,7 @@ public final class PropertiesUtil {
                     try {
                         properties.load(in);
                     } catch (final IOException ioe) {
-                        LOGGER.error("Unable to read {}", url.toString());
+                        LOGGER.error("Unable to read {}", url.toString(), ioe);
                     } finally {
                         try {
                             in.close();
@@ -161,7 +161,7 @@ public final class PropertiesUtil {
         if (prop != null) {
             try {
                 return Integer.parseInt(prop);
-            } catch (final Exception ex) {
+            } catch (final Exception ignored) {
                 return defaultValue;
             }
         }
@@ -189,7 +189,7 @@ public final class PropertiesUtil {
         if (prop != null) {
             try {
                 return Long.parseLong(prop);
-            } catch (final Exception ex) {
+            } catch (final Exception ignored) {
                 return defaultValue;
             }
         }


[4/5] git commit: Javadoc 8 fix.

Posted by ma...@apache.org.
Javadoc 8 fix.


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/ac628002
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/ac628002
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/ac628002

Branch: refs/heads/master
Commit: ac628002ee1a60b62ace5784db7ef2d597c7f11b
Parents: 934fd6c
Author: Matt Sicker <ma...@apache.org>
Authored: Wed Sep 24 22:54:12 2014 -0500
Committer: Matt Sicker <ma...@apache.org>
Committed: Wed Sep 24 23:03:32 2014 -0500

----------------------------------------------------------------------
 .../apache/logging/log4j/core/selector/JndiContextSelector.java    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ac628002/log4j-core/src/main/java/org/apache/logging/log4j/core/selector/JndiContextSelector.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/selector/JndiContextSelector.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/selector/JndiContextSelector.java
index 236d0f5..3a79c45 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/selector/JndiContextSelector.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/selector/JndiContextSelector.java
@@ -45,7 +45,7 @@ import org.apache.logging.log4j.status.StatusLogger;
  *  which is looked up by this class is
  * <code>java:comp/env/log4j/context-name</code>.
  *
- * <p>Here is an example of an <code>env-entry<code>:
+ * <p>Here is an example of an <code>env-entry</code>:
  * <blockquote>
  * <pre>
  * &lt;env-entry&gt;


[2/5] git commit: Add license header.

Posted by ma...@apache.org.
Add license header.


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/268d9df4
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/268d9df4
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/268d9df4

Branch: refs/heads/master
Commit: 268d9df487fb7249e940f1a9b641e179c9bd97fe
Parents: 310e0c4
Author: Matt Sicker <ma...@apache.org>
Authored: Wed Sep 24 22:18:05 2014 -0500
Committer: Matt Sicker <ma...@apache.org>
Committed: Wed Sep 24 23:03:31 2014 -0500

----------------------------------------------------------------------
 .../org/apache/logging/log4j/spi/LoggerAdapter.java | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/268d9df4/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerAdapter.java
----------------------------------------------------------------------
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerAdapter.java b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerAdapter.java
index 26f2dcf..6bac9bd 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerAdapter.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/spi/LoggerAdapter.java
@@ -1,3 +1,19 @@
+/*
+ * 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.
+ */
 package org.apache.logging.log4j.spi;
 
 import java.io.Closeable;


[3/5] git commit: Use HTML entities in javadocs.

Posted by ma...@apache.org.
Use HTML entities in javadocs.


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/934fd6ce
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/934fd6ce
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/934fd6ce

Branch: refs/heads/master
Commit: 934fd6ce68e211b1a46e6977b24ce77c630c6a37
Parents: 2366a71
Author: Matt Sicker <ma...@apache.org>
Authored: Wed Sep 24 22:50:53 2014 -0500
Committer: Matt Sicker <ma...@apache.org>
Committed: Wed Sep 24 23:03:32 2014 -0500

----------------------------------------------------------------------
 .../logging/log4j/core/util/Transform.java      | 40 ++++++++++----------
 1 file changed, 20 insertions(+), 20 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/934fd6ce/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Transform.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Transform.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Transform.java
index de97900..60176b5 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Transform.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Transform.java
@@ -36,7 +36,7 @@ public final class Transform {
     /**
      * This method takes a string which may contain HTML tags (ie,
      * &lt;b&gt;, &lt;table&gt;, etc) and replaces any
-     * '<',  '>' , '&' or '"'
+     * '&lt;',  '&gt;' , '&amp;' or '&quot;'
      * characters with respective predefined entity references.
      *
      * @param input The text to be converted.
@@ -81,11 +81,11 @@ public final class Transform {
     }
 
     /**
-     * Ensures that embedded CDEnd strings (]]>) are handled properly
+     * Ensures that embedded CDEnd strings (]]&gt;) are handled properly
      * within message, NDC and throwable tag text.
      *
      * @param buf StringBuilder holding the XML data to this point.  The
-     *            initial CDStart (<![CDATA[) and final CDEnd (]]>) of the CDATA
+     *            initial CDStart (&lt;![CDATA[) and final CDEnd (]]&gt;) of the CDATA
      *            section are the responsibility of the calling method.
      * @param str The String that is inserted into an existing CDATA Section within buf.
      */
@@ -112,7 +112,7 @@ public final class Transform {
     }
 
     /**
-     * This method takes a string which may contain JSON reserved chars and 
+     * This method takes a string which may contain JSON reserved chars and
      * escapes them.
      *
      * @param input The text to be converted.
@@ -121,9 +121,9 @@ public final class Transform {
     public static String escapeJsonControlCharacters(final String input) {
         // Check if the string is null, zero length or devoid of special characters
         // if so, return what was sent in.
-    
+
         // TODO: escaped Unicode chars.
-        
+
         if (Strings.isEmpty(input)
             || (input.indexOf('"') == -1 &&
             input.indexOf('\\') == -1 &&
@@ -131,13 +131,13 @@ public final class Transform {
             input.indexOf('\b') == -1 &&
             input.indexOf('\f') == -1 &&
             input.indexOf('\n') == -1 &&
-            input.indexOf('\r') == -1 && 
+            input.indexOf('\r') == -1 &&
             input.indexOf('\t') == -1)) {
             return input;
         }
-    
+
         final StringBuilder buf = new StringBuilder(input.length() + 6);
-        
+
         final int len = input.length();
         for (int i = 0; i < len; i++) {
             final char ch = input.charAt(i);
@@ -145,39 +145,39 @@ public final class Transform {
             switch (ch) {
             case '"':
                 buf.append(escBs);
-                buf.append(ch);                
+                buf.append(ch);
                 break;
             case '\\':
                 buf.append(escBs);
-                buf.append(ch);                
+                buf.append(ch);
                 break;
             case '/':
                 buf.append(escBs);
-                buf.append(ch);                
+                buf.append(ch);
                 break;
             case '\b':
                 buf.append(escBs);
-                buf.append('b');                
+                buf.append('b');
                 break;
             case '\f':
                 buf.append(escBs);
-                buf.append('f');                
+                buf.append('f');
                 break;
             case '\n':
                 buf.append(escBs);
-                buf.append('n');                
+                buf.append('n');
                 break;
             case '\r':
                 buf.append(escBs);
-                buf.append('r');                
+                buf.append('r');
                 break;
             case '\t':
                 buf.append(escBs);
-                buf.append('t');                
+                buf.append('t');
                 break;
-            default: 
-                buf.append(ch);                
-            } 
+            default:
+                buf.append(ch);
+            }
         }
         return buf.toString();
     }


[5/5] git commit: Add missing package-info.java and javadocs.

Posted by ma...@apache.org.
Add missing package-info.java and javadocs.


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/e4a9d7f9
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/e4a9d7f9
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/e4a9d7f9

Branch: refs/heads/master
Commit: e4a9d7f9d901730c2f2759c45816426003d13421
Parents: ac62800
Author: Matt Sicker <ma...@apache.org>
Authored: Wed Sep 24 23:02:31 2014 -0500
Committer: Matt Sicker <ma...@apache.org>
Committed: Wed Sep 24 23:03:32 2014 -0500

----------------------------------------------------------------------
 .../log4j/core/appender/mom/package-info.java   | 23 +++++++++++++++++++
 .../config/plugins/convert/package-info.java    | 22 ++++++++++++++++++
 .../validation/constraints/package-info.java    | 23 +++++++++++++++++++
 .../config/plugins/validation/package-info.java | 23 +++++++++++++++++++
 .../validation/validators/package-info.java     | 23 +++++++++++++++++++
 .../log4j/core/config/status/package-info.java  | 21 +++++++++++++++++
 .../log4j/core/net/server/package-info.java     | 24 ++++++++++++++++++++
 7 files changed, 159 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/mom/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/mom/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/mom/package-info.java
new file mode 100644
index 0000000..866b689
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/mom/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ * Message oriented middleware appenders.
+ *
+ * @since 2.1
+ */
+package org.apache.logging.log4j.core.appender.mom;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/convert/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/convert/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/convert/package-info.java
new file mode 100644
index 0000000..32e534f
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/convert/package-info.java
@@ -0,0 +1,22 @@
+/*
+ * 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.
+ */
+
+/**
+ * TypeConverter plugins for converter strings into various types. These plugins are used for parsing plugin
+ * attributes in plugin factory methods.
+ */
+package org.apache.logging.log4j.core.config.plugins.convert;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/constraints/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/constraints/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/constraints/package-info.java
new file mode 100644
index 0000000..f22ba49
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/constraints/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ * Validation annotations.
+ *
+ * @since 2.1
+ */
+package org.apache.logging.log4j.core.config.plugins.validation.constraints;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/package-info.java
new file mode 100644
index 0000000..171b25a
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ * Constraint validators for plugin factory methods.
+ *
+ * @since 2.1
+ */
+package org.apache.logging.log4j.core.config.plugins.validation;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/validators/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/validators/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/validators/package-info.java
new file mode 100644
index 0000000..a8ac560
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/validation/validators/package-info.java
@@ -0,0 +1,23 @@
+/*
+ * 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.
+ */
+
+/**
+ * ConstraintValidator implementations for the constraint annotations.
+ *
+ * @since 2.1
+ */
+package org.apache.logging.log4j.core.config.plugins.validation.validators;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/config/status/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/status/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/status/package-info.java
new file mode 100644
index 0000000..d756b2c
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/status/package-info.java
@@ -0,0 +1,21 @@
+/*
+ * 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.
+ */
+
+/**
+ * Configuration classes for the {@link org.apache.logging.log4j.status.StatusLogger} API.
+ */
+package org.apache.logging.log4j.core.config.status;

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e4a9d7f9/log4j-core/src/main/java/org/apache/logging/log4j/core/net/server/package-info.java
----------------------------------------------------------------------
diff --git a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/server/package-info.java b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/server/package-info.java
new file mode 100644
index 0000000..0d9d027
--- /dev/null
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/server/package-info.java
@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+
+/**
+ * Standalone server classes for consuming log events over a network. Each of the various servers should be used with
+ * another Log4j configuration to handle incoming {@link org.apache.logging.log4j.core.LogEvent}s. It is recommended
+ * to consider using the <a href="../../../../../../../../../manual/appenders.html#FlumeAppender">Flume Appender</a>
+ * for highly reliable networked logging.
+ */
+package org.apache.logging.log4j.core.net.server;