logging-log4j2 git commit: Javadoc fix.

2018-11-05 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master bbb76cd64 -> 13f6642e3


Javadoc 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/13f6642e
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/13f6642e
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/13f6642e

Branch: refs/heads/master
Commit: 13f6642e3890cf831d4ff35bde7cea1d5c9b2aab
Parents: bbb76cd
Author: Gary Gregory 
Authored: Mon Nov 5 12:27:44 2018 -0700
Committer: Gary Gregory 
Committed: Mon Nov 5 12:27:44 2018 -0700

--
 .../main/java/org/apache/logging/log4j/jms/appender/JmsManager.java | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/13f6642e/log4j-jms/src/main/java/org/apache/logging/log4j/jms/appender/JmsManager.java
--
diff --git 
a/log4j-jms/src/main/java/org/apache/logging/log4j/jms/appender/JmsManager.java 
b/log4j-jms/src/main/java/org/apache/logging/log4j/jms/appender/JmsManager.java
index 521bb09..5194278 100644
--- 
a/log4j-jms/src/main/java/org/apache/logging/log4j/jms/appender/JmsManager.java
+++ 
b/log4j-jms/src/main/java/org/apache/logging/log4j/jms/appender/JmsManager.java
@@ -204,6 +204,7 @@ public class JmsManager extends AbstractManager {
  * Gets a JmsManager using the specified configuration parameters.
  *
  * @param name The name to use for this JmsManager.
+ * @param jndiProperties JNDI properties.
  * @param connectionFactoryName The binding name for the {@link 
javax.jms.ConnectionFactory}.
  * @param destinationName The binding name for the {@link 
javax.jms.Destination}.
  * @param userName The userName to connect with or {@code null} for no 
authentication.



logging-log4j2 git commit: Javadoc.

2018-11-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x 341f77254 -> c739443da


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: c739443da0004e61e24b8634020af6be0435c6cd
Parents: 341f772
Author: Gary Gregory 
Authored: Sun Nov 4 10:02:02 2018 -0700
Committer: Gary Gregory 
Committed: Sun Nov 4 10:02:02 2018 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LogEvent.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c739443d/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
index 0aa77a0..d49acab 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
@@ -133,14 +133,14 @@ public interface LogEvent extends Serializable {
 long getTimeMillis();
 
 /**
- * Returns the timestamp when the message was logged.
+ * Returns the Instant when the message was logged.
  * 
  * Caution: if this {@code LogEvent} implementation is mutable and 
reused for multiple consecutive log messages,
  * then the {@code Instant} object returned by this method is also mutable 
and reused.
  * Client code should not keep a reference to the returned object but make 
a copy instead.
  * 
  *
- * @return the {@code Instant} holding timestamp details for this log event
+ * @return the {@code Instant} holding Instant details for this log event
  * @since 2.11
  */
 Instant getInstant();



logging-log4j2 git commit: Javadoc.

2018-11-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master cd04ac2be -> e35d930b6


Javadoc.

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

Branch: refs/heads/master
Commit: e35d930b625f84b1fda0ad4eb48d5c9c5959fed3
Parents: cd04ac2
Author: Gary Gregory 
Authored: Sun Nov 4 10:01:19 2018 -0700
Committer: Gary Gregory 
Committed: Sun Nov 4 10:01:19 2018 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LogEvent.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/e35d930b/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
index 5af80fa..c41606b 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LogEvent.java
@@ -117,14 +117,14 @@ public interface LogEvent extends Serializable {
 long getTimeMillis();
 
 /**
- * Returns the timestamp when the message was logged.
+ * Returns the Instant when the message was logged.
  * 
  * Caution: if this {@code LogEvent} implementation is mutable and 
reused for multiple consecutive log messages,
  * then the {@code Instant} object returned by this method is also mutable 
and reused.
  * Client code should not keep a reference to the returned object but make 
a copy instead.
  * 
  *
- * @return the {@code Instant} holding timestamp details for this log event
+ * @return the {@code Instant} holding Instant details for this log event
  * @since 2.11.0
  */
 Instant getInstant();



logging-log4j2 git commit: Javadoc format nits.

2018-11-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 13f003c22 -> d5bd8fd7c


Javadoc format nits.

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

Branch: refs/heads/master
Commit: d5bd8fd7c40ab2fde49539761cdfd8ca12b183e3
Parents: 13f003c
Author: Gary Gregory 
Authored: Sun Nov 4 09:26:42 2018 -0700
Committer: Gary Gregory 
Committed: Sun Nov 4 09:26:42 2018 -0700

--
 .../main/java/org/apache/logging/log4j/core/filter/TimeFilter.java | 2 ++
 1 file changed, 2 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/d5bd8fd7/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
index 2b3728a..c093ae6 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
@@ -62,10 +62,12 @@ public final class TimeFilter extends AbstractFilter {
  * Starting offset from midnight in milliseconds.
  */
 private final long start;
+
 /**
  * Ending offset from midnight in milliseconds.
  */
 private final long end;
+
 /**
  * Timezone.
  */



logging-log4j2 git commit: Javadoc format nits.

2018-11-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x f48200d4e -> b744643d2


Javadoc format nits.

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

Branch: refs/heads/release-2.x
Commit: b744643d2fb5089f0434f32c33c5a16109102c1f
Parents: f48200d
Author: Gary Gregory 
Authored: Sun Nov 4 09:26:06 2018 -0700
Committer: Gary Gregory 
Committed: Sun Nov 4 09:26:06 2018 -0700

--
 .../main/java/org/apache/logging/log4j/core/filter/TimeFilter.java | 2 ++
 1 file changed, 2 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/b744643d/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
index b979ad4..11aa69f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/TimeFilter.java
@@ -62,10 +62,12 @@ public final class TimeFilter extends AbstractFilter {
  * Starting offset from midnight in milliseconds.
  */
 private final long start;
+
 /**
  * Ending offset from midnight in milliseconds.
  */
 private final long end;
+
 /**
  * Timezone.
  */



logging-log4j2 git commit: Javadoc fix.

2018-10-22 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master e8e3d224a -> 09a211757


Javadoc 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/09a21175
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/09a21175
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/09a21175

Branch: refs/heads/master
Commit: 09a211757e4bded20192754682b41b9a00afd69a
Parents: e8e3d22
Author: Gary Gregory 
Authored: Mon Oct 22 18:56:34 2018 -0600
Committer: Gary Gregory 
Committed: Mon Oct 22 18:56:34 2018 -0600

--
 .../java/org/apache/logging/log4j/core/appender/FileManager.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/09a21175/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
index 2898c7f..0906534 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
@@ -164,7 +164,7 @@ public class FileManager extends OutputStreamManager {
  * @param bufferSize buffer size for buffered IO
  * @param filePermissions File permissions
  * @param fileOwner File owner
- * @param fileOwner File group
+ * @param fileGroup File group
  * @param configuration The configuration.
  * @return A FileManager for the File.
  */



logging-log4j2 git commit: Javadoc fix.

2018-10-22 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x b9d4578de -> 733ff9acd


Javadoc 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/733ff9ac
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/733ff9ac
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/733ff9ac

Branch: refs/heads/release-2.x
Commit: 733ff9acd14d0e823f652384186ca9486d28a61b
Parents: b9d4578
Author: Gary Gregory 
Authored: Mon Oct 22 18:55:54 2018 -0600
Committer: Gary Gregory 
Committed: Mon Oct 22 18:55:54 2018 -0600

--
 .../java/org/apache/logging/log4j/core/appender/FileManager.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/733ff9ac/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
index 2898c7f..0906534 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/FileManager.java
@@ -164,7 +164,7 @@ public class FileManager extends OutputStreamManager {
  * @param bufferSize buffer size for buffered IO
  * @param filePermissions File permissions
  * @param fileOwner File owner
- * @param fileOwner File group
+ * @param fileGroup File group
  * @param configuration The configuration.
  * @return A FileManager for the File.
  */



logging-log4j2 git commit: Javadoc.

2018-10-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master fbc5fd844 -> 6870e4022


Javadoc.

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

Branch: refs/heads/master
Commit: 6870e4022527de709c6a695c041fd0e93f69a05f
Parents: fbc5fd8
Author: Gary Gregory 
Authored: Tue Oct 16 12:00:27 2018 -0600
Committer: Gary Gregory 
Committed: Tue Oct 16 12:00:27 2018 -0600

--
 .../java/org/apache/logging/log4j/core/config/Configuration.java  | 3 ++-
 .../org/apache/logging/log4j/core/config/ConfigurationSource.java | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6870e402/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
index b2e5cb7..dbbb96d 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
@@ -135,7 +135,8 @@ public interface Configuration extends Filterable {
 /**
  * Returns the source of this configuration.
  *
- * @return the source of this configuration
+ * @return the source of this configuration, never {@code null}, but may be
+ * {@link 
org.apache.logging.log4j.core.config.ConfigurationSource#NULL_SOURCE}.
  */
 ConfigurationSource getConfigurationSource();
 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6870e402/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
index 7848d6a..f8ad604 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
@@ -39,6 +39,7 @@ import org.apache.logging.log4j.util.LoaderUtil;
  * Represents the source for the logging configuration.
  */
 public class ConfigurationSource {
+
 /**
  * ConfigurationSource to use with Configurations that do not require a 
"real" configuration source.
  */



logging-log4j2 git commit: Javadoc.

2018-10-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x c491570c3 -> 669caaf36


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: 669caaf364b59c6d7b148bd07f6f6a0624ec6324
Parents: c491570
Author: Gary Gregory 
Authored: Tue Oct 16 11:59:40 2018 -0600
Committer: Gary Gregory 
Committed: Tue Oct 16 11:59:40 2018 -0600

--
 .../apache/logging/log4j/core/config/Configuration.java  | 11 ++-
 .../logging/log4j/core/config/ConfigurationSource.java   |  1 +
 2 files changed, 7 insertions(+), 5 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/669caaf3/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
index 95e6edc..9d7632f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/Configuration.java
@@ -132,11 +132,12 @@ public interface Configuration extends Filterable {
 
 ConfigurationScheduler getScheduler();
 
-/**
- * Returns the source of this configuration.
- *
- * @return the source of this configuration
- */
+   /**
+* Returns the source of this configuration.
+*
+* @return the source of this configuration, never {@code null}, but 
may be
+* {@link 
org.apache.logging.log4j.core.config.ConfigurationSource#NULL_SOURCE}.
+*/
 ConfigurationSource getConfigurationSource();
 
 /**

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/669caaf3/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
index 7848d6a..3c87695 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationSource.java
@@ -39,6 +39,7 @@ import org.apache.logging.log4j.util.LoaderUtil;
  * Represents the source for the logging configuration.
  */
 public class ConfigurationSource {
+
 /**
  * ConfigurationSource to use with Configurations that do not require a 
"real" configuration source.
  */



logging-log4j2 git commit: Javadoc.

2018-10-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x fef702689 -> c491570c3


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: c491570c3b060898c6a9ff40ae52295d32df9d2f
Parents: fef7026
Author: Gary Gregory 
Authored: Tue Oct 16 11:55:00 2018 -0600
Committer: Gary Gregory 
Committed: Tue Oct 16 11:55:00 2018 -0600

--
 .../apache/logging/log4j/core/LoggerContext.java   | 17 +
 1 file changed, 9 insertions(+), 8 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c491570c/log4j-core/src/main/java/org/apache/logging/log4j/core/LoggerContext.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LoggerContext.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LoggerContext.java
index a29eda8..2a9343c 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LoggerContext.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LoggerContext.java
@@ -490,14 +490,15 @@ public class LoggerContext extends AbstractLifeCycle
 return loggerRegistry.hasLogger(name, messageFactoryClass);
 }
 
-/**
- * Returns the current Configuration. The Configuration will be replaced 
when a reconfigure occurs.
- *
- * @return The Configuration.
- */
-public Configuration getConfiguration() {
-return configuration;
-}
+   /**
+* Returns the current Configuration. The Configuration will be 
replaced when a reconfigure occurs.
+*
+* @return The current Configuration, never {@code null}, but may be
+* {@link org.apache.logging.log4j.core.config.NullConfiguration}.
+*/
+   public Configuration getConfiguration() {
+   return configuration;
+   }
 
 /**
  * Adds a Filter to the Configuration. Filters that are added through the 
API will be lost when a reconfigure



logging-log4j2 git commit: Javadoc.

2018-10-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 6e90a6979 -> 1ff58d7b8


Javadoc.

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

Branch: refs/heads/master
Commit: 1ff58d7b809351575a57688e01f323fc0d696f70
Parents: 6e90a69
Author: Gary Gregory 
Authored: Tue Oct 16 08:18:01 2018 -0600
Committer: Gary Gregory 
Committed: Tue Oct 16 08:18:01 2018 -0600

--
 .../org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java  | 3 +++
 1 file changed, 3 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/1ff58d7b/log4j-jdbc/src/test/java/org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java
--
diff --git 
a/log4j-jdbc/src/test/java/org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java
 
b/log4j-jdbc/src/test/java/org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java
index 9eb2713..046cf0e 100644
--- 
a/log4j-jdbc/src/test/java/org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java
+++ 
b/log4j-jdbc/src/test/java/org/apache/logging/log4j/jdbc/appender/JdbcH2TestHelper.java
@@ -25,6 +25,9 @@ import 
org.apache.logging.log4j.jdbc.appender.ConnectionSource;
 
 public class JdbcH2TestHelper {
 
+/**
+ * A JDBC connection string for an H2 in-memory database.
+ */
 public static final String CONNECTION_STRING = "jdbc:h2:mem:Log4j";
 public static final String USER_NAME = "sa";
 public static final String PASSWORD = "";



logging-log4j2 git commit: Javadoc.

2018-10-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x 1c261c877 -> baaa6cb78


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: baaa6cb78446f09a79062c156a141c810bcbe47b
Parents: 1c261c8
Author: Gary Gregory 
Authored: Tue Oct 16 08:17:18 2018 -0600
Committer: Gary Gregory 
Committed: Tue Oct 16 08:17:18 2018 -0600

--
 .../logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java | 3 +++
 1 file changed, 3 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/baaa6cb7/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java
--
diff --git 
a/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java
 
b/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java
index 1bb1f37..1c289a0 100644
--- 
a/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java
+++ 
b/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/db/jdbc/JdbcH2TestHelper.java
@@ -22,6 +22,9 @@ import java.sql.SQLException;
 
 public class JdbcH2TestHelper {
 
+   /**
+* A JDBC connection string for an H2 in-memory database.
+*/
 static final String CONNECTION_STRING = "jdbc:h2:mem:Log4j";
 static final String USER_NAME = "sa";
 static final String PASSWORD = "";



logging-log4j2 git commit: Javadoc.

2018-10-03 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 47d2f975e -> aa3878ddb


Javadoc.

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

Branch: refs/heads/master
Commit: aa3878ddbbebd6a19909210db14e1a133151b983
Parents: 47d2f97
Author: Gary Gregory 
Authored: Wed Oct 3 09:49:24 2018 -0600
Committer: Gary Gregory 
Committed: Wed Oct 3 09:49:24 2018 -0600

--
 .../org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/aa3878dd/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
--
diff --git 
a/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
 
b/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
index 7bcce98..561cfaf 100644
--- 
a/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
+++ 
b/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
@@ -25,7 +25,7 @@ import org.eclipse.jetty.util.log.AbstractLogger;
 import org.eclipse.jetty.util.log.Logger;
 
 /**
- * Provides a native Apache Log4j 2 for Eclipse Jetty logging.
+ * Provides a native Apache Log4j 2 logger for Eclipse Jetty logging.
  * 
  * 
  * To direct Jetty to use this class, set the system property 
{{org.eclipse.jetty.util.log.class}} to this class name.



logging-log4j2 git commit: Javadoc.

2018-10-03 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x 1ec871287 -> 41bf54ecc


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: 41bf54eccf66056daba3751c3cd3efcbf4e60fb9
Parents: 1ec8712
Author: Gary Gregory 
Authored: Wed Oct 3 09:47:15 2018 -0600
Committer: Gary Gregory 
Committed: Wed Oct 3 09:47:15 2018 -0600

--
 .../org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/41bf54ec/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
--
diff --git 
a/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
 
b/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
index 7bcce98..561cfaf 100644
--- 
a/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
+++ 
b/log4j-appserver/src/main/java/org/apache/logging/log4j/appserver/jetty/Log4j2Logger.java
@@ -25,7 +25,7 @@ import org.eclipse.jetty.util.log.AbstractLogger;
 import org.eclipse.jetty.util.log.Logger;
 
 /**
- * Provides a native Apache Log4j 2 for Eclipse Jetty logging.
+ * Provides a native Apache Log4j 2 logger for Eclipse Jetty logging.
  * 
  * 
  * To direct Jetty to use this class, set the system property 
{{org.eclipse.jetty.util.log.class}} to this class name.



logging-log4j2 git commit: Javadoc.

2018-09-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/release-2.x 58fecf818 -> fd5b34ed4


Javadoc.

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

Branch: refs/heads/release-2.x
Commit: fd5b34ed47598f823cb1225124738cd497d09ae5
Parents: 58fecf8
Author: Gary Gregory 
Authored: Sat Sep 15 16:45:02 2018 -0600
Committer: Gary Gregory 
Committed: Sat Sep 15 16:45:02 2018 -0600

--
 .../java/org/apache/logging/log4j/core/appender/NullAppender.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/fd5b34ed/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
index 3978f05..b37b637 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
@@ -24,7 +24,7 @@ import 
org.apache.logging.log4j.core.config.plugins.PluginAttribute;
 import org.apache.logging.log4j.core.config.plugins.PluginFactory;
 
 /**
- * An Appender that ignores log events. Use for compatibility with version 1.2.
+ * An Appender that ignores log events. Use for compatibility with version 1.2 
and handy for composing a {@link ScriptAppenderSelector}.
  */
 @Plugin(name = NullAppender.PLUGIN_NAME, category = Core.CATEGORY_NAME, 
elementType = Appender.ELEMENT_TYPE, printObject = true)
 public class NullAppender extends AbstractAppender {



logging-log4j2 git commit: Javadoc.

2018-09-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master d00954d09 -> 9cba89950


Javadoc.

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

Branch: refs/heads/master
Commit: 9cba899507096ef562a546cfcae30aab1b7e8d9d
Parents: d00954d
Author: Gary Gregory 
Authored: Sat Sep 15 16:44:28 2018 -0600
Committer: Gary Gregory 
Committed: Sat Sep 15 16:44:28 2018 -0600

--
 .../java/org/apache/logging/log4j/core/appender/NullAppender.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/9cba8995/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
index 3978f05..b37b637 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/NullAppender.java
@@ -24,7 +24,7 @@ import 
org.apache.logging.log4j.core.config.plugins.PluginAttribute;
 import org.apache.logging.log4j.core.config.plugins.PluginFactory;
 
 /**
- * An Appender that ignores log events. Use for compatibility with version 1.2.
+ * An Appender that ignores log events. Use for compatibility with version 1.2 
and handy for composing a {@link ScriptAppenderSelector}.
  */
 @Plugin(name = NullAppender.PLUGIN_NAME, category = Core.CATEGORY_NAME, 
elementType = Appender.ELEMENT_TYPE, printObject = true)
 public class NullAppender extends AbstractAppender {



logging-log4j2 git commit: Javadoc fix.

2018-02-10 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master f8158646d -> 9eb14d414


Javadoc 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/9eb14d41
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/9eb14d41
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/9eb14d41

Branch: refs/heads/master
Commit: 9eb14d414fa92ad145a1ac2a469de708b155c4d6
Parents: f815864
Author: Gary Gregory 
Authored: Sat Feb 10 11:32:26 2018 -0700
Committer: Gary Gregory 
Committed: Sat Feb 10 11:32:26 2018 -0700

--
 .../main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/9eb14d41/log4j-core/src/main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java
index 08e3885..4b230f9 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/lookup/JavaLookup.java
@@ -89,7 +89,7 @@ public class JavaLookup extends AbstractLookup {
 }
 
 /**
- * Looks up the value of the environment variable.
+ * Looks up the value of the Java platform key.
  *
  * @param event
  *The current LogEvent (is ignored by this StrLookup).



logging-log4j2 git commit: Javadoc.

2018-02-07 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 9774e05ec -> c7c7aaa46


Javadoc.

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

Branch: refs/heads/master
Commit: c7c7aaa460ba0f387abf9079415c0ad9576d2fd3
Parents: 9774e05
Author: Gary Gregory 
Authored: Wed Feb 7 11:51:55 2018 -0700
Committer: Gary Gregory 
Committed: Wed Feb 7 11:51:55 2018 -0700

--
 .../java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c7c7aaa4/log4j-osgi/src/test/java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java
--
diff --git 
a/log4j-osgi/src/test/java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java
 
b/log4j-osgi/src/test/java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java
index bd47a89..a717c46 100644
--- 
a/log4j-osgi/src/test/java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java
+++ 
b/log4j-osgi/src/test/java/org/apache/logging/log4j/osgi/tests/AbstractOsgiTest.java
@@ -27,7 +27,7 @@ import org.osgi.framework.BundleContext;
 import org.osgi.framework.launch.FrameworkFactory;
 
 /**
- * Tests a basic Log4J 'setup' in an OSGi container.
+ * Subclasses can tests a basic setup in an OSGi container.
  */
 public abstract class AbstractOsgiTest {
 



logging-log4j2 git commit: Javadoc tweaks.

2018-01-28 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 2f3724591 -> 2deb32280


Javadoc tweaks.

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

Branch: refs/heads/master
Commit: 2deb32280549966205f8a9d5cbb8f0e7b937880f
Parents: 2f37245
Author: Gary Gregory 
Authored: Sun Jan 28 11:13:17 2018 -0700
Committer: Gary Gregory 
Committed: Sun Jan 28 11:13:17 2018 -0700

--
 .../java/org/apache/logging/log4j/core/util/Instant.java | 2 +-
 .../org/apache/logging/log4j/core/util/MutableInstant.java   | 2 +-
 .../org/apache/logging/log4j/core/util/PreciseClock.java | 4 ++--
 .../java/org/apache/logging/log4j/core/util/SystemClock.java | 2 +-
 .../main/java/org/apache/logging/log4j/core/LogEvent.java| 2 +-
 .../org/apache/logging/log4j/core/impl/Log4jLogEvent.java| 2 +-
 .../java/org/apache/logging/log4j/core/time/Instant.java | 8 +---
 .../org/apache/logging/log4j/core/time/MutableInstant.java   | 2 +-
 .../org/apache/logging/log4j/core/time/PreciseClock.java | 4 ++--
 .../logging/log4j/core/time/internal/FixedPreciseClock.java  | 2 +-
 .../logging/log4j/core/time/internal/SystemMillisClock.java  | 2 +-
 .../org/apache/logging/log4j/flume/appender/FlumeEvent.java  | 2 +-
 12 files changed, 18 insertions(+), 16 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2deb3228/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/Instant.java
--
diff --git 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/Instant.java
 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/Instant.java
index cd4ac9d..829e486 100644
--- 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/Instant.java
+++ 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/Instant.java
@@ -32,7 +32,7 @@ package org.apache.logging.log4j.core.util;
  * 
  * This class bridges these two time APIs.
  * 
- * @since 2.11
+ * @since 2.11.0
  */
 public interface Instant {
 /**

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2deb3228/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/MutableInstant.java
--
diff --git 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/MutableInstant.java
 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/MutableInstant.java
index 8960fc5..a885101 100644
--- 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/MutableInstant.java
+++ 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/MutableInstant.java
@@ -31,7 +31,7 @@ import java.io.Serializable;
  * Instances of this class are not thread-safe and should not be 
shared between threads.
  * 
  *
- * @since 2.11
+ * @since 2.11.0
  */
 @PerformanceSensitive("allocation")
 public class MutableInstant implements Instant, Serializable {

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2deb3228/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/PreciseClock.java
--
diff --git 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/PreciseClock.java
 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/PreciseClock.java
index 3d1f314..7dc0700 100644
--- 
a/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/PreciseClock.java
+++ 
b/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/PreciseClock.java
@@ -23,14 +23,14 @@ package org.apache.logging.log4j.core.util;
  * Extension of the {@link Clock} interface that is able to provide more 
accurate time information than milliseconds
  * since the epoch. {@code PreciseClock} implementations are free to return 
millisecond-precision time
  * if that is the most accurate time information available on this platform.
- * @since 2.11
+ * @since 2.11.0
  */
 public interface PreciseClock extends Clock {
 
 /**
  * Initializes the specified instant with time information as accurate as 
available on this platform.
  * @param mutableInstant the container to be initialized with the accurate 
time information
- * @since 2.11
+ * @since 2.11.0
  */
 void init(final MutableInstant mutableInstant);
 }

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2deb3228/log4j-core-java9/src/main/java/org/apache/logging/log4j/core/util/SystemClock.java

logging-log4j2 git commit: Javadoc: Use the active voice.

2018-01-24 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master d3d7f756f -> ef8bbf979


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: ef8bbf9794ecb9a11a65995b29068a76196f33b2
Parents: d3d7f75
Author: Gary Gregory 
Authored: Wed Jan 24 13:53:45 2018 -0700
Committer: Gary Gregory 
Committed: Wed Jan 24 13:53:45 2018 -0700

--
 .../java/org/apache/logging/log4j/core/filter/CompositeFilter.java | 2 +-
 .../org/apache/logging/log4j/core/filter/LevelRangeFilter.java | 2 +-
 .../java/org/apache/logging/log4j/core/filter/RegexFilter.java | 2 +-
 .../org/apache/logging/log4j/core/filter/StructuredDataFilter.java | 2 +-
 .../java/org/apache/logging/log4j/core/filter/ThresholdFilter.java | 2 +-
 .../main/java/org/apache/logging/log4j/core/filter/TimeFilter.java | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ef8bbf97/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/CompositeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/CompositeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/CompositeFilter.java
index c61bf57..5394bfb 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/CompositeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/CompositeFilter.java
@@ -614,7 +614,7 @@ public final class CompositeFilter extends 
AbstractLifeCycle implements Iterable
 }
 
 /**
- * Create a CompositeFilter.
+ * Creates a CompositeFilter.
  *
  * @param filters
  *An array of Filters to call.

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ef8bbf97/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
index 461998d..0e79b85 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
@@ -43,7 +43,7 @@ import org.apache.logging.log4j.util.PerformanceSensitive;
 public final class LevelRangeFilter extends AbstractFilter {
 
 /**
- * Create a ThresholdFilter.
+ * Creates a ThresholdFilter.
  *
  * @param minLevel
  *The minimum log Level.

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ef8bbf97/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/RegexFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/RegexFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/RegexFilter.java
index bef9888..6b18b6b 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/RegexFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/RegexFilter.java
@@ -102,7 +102,7 @@ public final class RegexFilter extends AbstractFilter {
 }
 
 /**
- * Create a Filter that matches a regular expression.
+ * Creates a Filter that matches a regular expression.
  *
  * @param regex
  *The regular expression to match.

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ef8bbf97/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/StructuredDataFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/StructuredDataFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/StructuredDataFilter.java
index 01015d4..91a9924 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/StructuredDataFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/StructuredDataFilter.java
@@ -147,7 +147,7 @@ public final class StructuredDataFilter extends MapFilter {
 }
 
 /**
- * Create the StructuredDataFilter.
+ * Creates the StructuredDataFilter.
  * @param pairs Key and value pairs.
  * @param oper The operator to perform. If not "or" the operation will be 
an "and".
  * @param match The 

logging-log4j2 git commit: Javadoc: Use the active voice.

2018-01-23 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 31b390e39 -> 612d3f92e


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 612d3f92ee673fb5ef4a31326aa0c8187d34e011
Parents: 31b390e
Author: Gary Gregory 
Authored: Tue Jan 23 22:19:22 2018 -0700
Committer: Gary Gregory 
Committed: Tue Jan 23 22:19:22 2018 -0700

--
 .../java/org/apache/logging/log4j/core/filter/MarkerFilter.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/612d3f92/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/MarkerFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/MarkerFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/MarkerFilter.java
index d56b603..69b6cc8 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/MarkerFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/MarkerFilter.java
@@ -145,7 +145,7 @@ public final class MarkerFilter extends AbstractFilter {
 }
 
 /**
- * Create the MarkerFilter.
+ * Creates the MarkerFilter.
  * @param marker The Marker name to match.
  * @param match The action to take if a match occurs.
  * @param mismatch The action to take if no match occurs.



logging-log4j2 git commit: Javadoc: Fix generics.

2018-01-21 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master aa452fc13 -> 7da5499a2


Javadoc: Fix generics.

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

Branch: refs/heads/master
Commit: 7da5499a20716d75216c6a571d84d465b55c9aa3
Parents: aa452fc
Author: Gary Gregory 
Authored: Sun Jan 21 16:40:48 2018 -0700
Committer: Gary Gregory 
Committed: Sun Jan 21 16:40:48 2018 -0700

--
 .../log4j/core/appender/nosql/AbstractNoSqlConnection.java   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7da5499a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/AbstractNoSqlConnection.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/AbstractNoSqlConnection.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/AbstractNoSqlConnection.java
index 965dc1e..67145c6 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/AbstractNoSqlConnection.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/AbstractNoSqlConnection.java
@@ -24,8 +24,8 @@ import java.util.concurrent.atomic.AtomicBoolean;
  *
  * @param 
  *See {@link NoSqlConnection}.
- * @param See
- *{@link NoSqlConnection}.
+ * @param 
+ *See {@link NoSqlConnection}.
  */
 public abstract class AbstractNoSqlConnection 
implements NoSqlConnection {
 



logging-log4j2 git commit: Javadoc.

2018-01-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 9abc76e9e -> 526db0e4a


Javadoc.

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

Branch: refs/heads/master
Commit: 526db0e4af239c6dff5beeb05e325481a71db771
Parents: 9abc76e
Author: Gary Gregory 
Authored: Tue Jan 16 14:21:59 2018 -0700
Committer: Gary Gregory 
Committed: Tue Jan 16 14:21:59 2018 -0700

--
 .../logging/log4j/core/appender/RollingFileAppender.java  | 7 +++
 1 file changed, 7 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/526db0e4/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/RollingFileAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/RollingFileAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/RollingFileAppender.java
index bcba88f..def63a4 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/RollingFileAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/RollingFileAppender.java
@@ -56,6 +56,7 @@ public final class RollingFileAppender extends 
AbstractOutputStreamAppender
  *The type to build
+ * @since 2.7
  */
 public static class Builder> extends 
AbstractOutputStreamAppender.Builder
 implements 
org.apache.logging.log4j.core.util.Builder {
@@ -398,6 +399,12 @@ public final class RollingFileAppender extends 
AbstractOutputStreamAppender> B newBuilder() {
 return new Builder().asBuilder();



logging-log4j2 git commit: Javadoc typos.

2018-01-13 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master e46567de3 -> 46347ea03


Javadoc typos.

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

Branch: refs/heads/master
Commit: 46347ea03670378fd57aaacfb5025b5e59504c6d
Parents: e46567d
Author: Gary Gregory 
Authored: Sat Jan 13 14:45:54 2018 -0700
Committer: Gary Gregory 
Committed: Sat Jan 13 14:45:54 2018 -0700

--
 log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/46347ea0/log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java
--
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java
index ce115c9..c6642ea 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/Chars.java
@@ -43,7 +43,7 @@ public final class Chars {
 public static final char TAB = '\t';
 
 /**
- * Converts a digit into an uppercase hexadecimal character or the null 
character if invalid.
+ * Converts a digit into an upper-case hexadecimal character or the null 
character if invalid.
  *
  * @param digit a number 0 - 15
  * @return the hex character for that digit or '\0' if invalid
@@ -56,7 +56,7 @@ public final class Chars {
 }
 
 /**
- * Converts a digit into an lowercase hexadecimal character or the null 
character if invalid.
+ * Converts a digit into an lower-case hexadecimal character or the null 
character if invalid.
  *
  * @param digit a number 0 - 15
  * @return the hex character for that digit or '\0' if invalid



logging-log4j2 git commit: Javadoc.

2018-01-12 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 215d8aabd -> bf52b1444


Javadoc.

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

Branch: refs/heads/master
Commit: bf52b144421fc12e9e107a6cfe0fed09a9989f5a
Parents: 215d8aa
Author: Gary Gregory 
Authored: Fri Jan 12 23:27:31 2018 -0700
Committer: Gary Gregory 
Committed: Fri Jan 12 23:27:31 2018 -0700

--
 .../java/org/apache/logging/log4j/core/layout/MessageLayout.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bf52b144/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/MessageLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/MessageLayout.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/MessageLayout.java
index f446cb1..4a16f80 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/MessageLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/MessageLayout.java
@@ -28,8 +28,8 @@ import org.apache.logging.log4j.message.Message;
 /**
  * Formats a {@link LogEvent} in its {@link Message} form.
  * 
- * Useful in combination with a JMS Appender to map a Log4j {@link 
org.apache.logging.log4j.message.StringMapMessage} to a JMS
- * {@link javax.jms.MapMessage}.
+ * Useful in combination with a JMS Appender to map a Log4j {@link 
org.apache.logging.log4j.message.MapMessage} or
+ * {@link org.apache.logging.log4j.message.StringMapMessage} to a JMS {@link 
javax.jms.MapMessage}.
  * 
  */
 @Plugin(name = "MessageLayout", category = Node.CATEGORY, elementType = 
Layout.ELEMENT_TYPE, printObject = true)



logging-log4j2 git commit: Javadoc.

2018-01-12 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 41f5dfb98 -> 7570e3f45


Javadoc.

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

Branch: refs/heads/master
Commit: 7570e3f45a90d7a455d93633e9fb0f51fd1dab1e
Parents: 41f5dfb
Author: Gary Gregory 
Authored: Fri Jan 12 10:45:12 2018 -0700
Committer: Gary Gregory 
Committed: Fri Jan 12 10:45:12 2018 -0700

--
 .../logging/log4j/message/MapMessage.java   | 21 
 1 file changed, 21 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7570e3f4/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
--
diff --git 
a/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
index 114ce17..38319d2 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/message/MapMessage.java
@@ -485,7 +485,10 @@ public class MapMessage, V> 
implements MultiFormatStr
 public Throwable getThrowable() {
 return null;
 }
+
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final boolean value) {
@@ -493,6 +496,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final byte value) {
@@ -500,6 +505,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final char value) {
@@ -507,6 +514,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final double value) {
@@ -514,6 +523,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final float value) {
@@ -521,6 +532,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final int value) {
@@ -528,6 +541,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final long value) {
@@ -535,6 +550,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final Object value) {
@@ -542,6 +559,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final short value) {
@@ -549,6 +568,8 @@ public class MapMessage, V> 
implements MultiFormatStr
 }
 
 /**
+ * Default implementation does nothing.
+ * 
  * @since 2.9
  */
 protected void validate(final String key, final String value) {



logging-log4j2 git commit: Javadoc: add missing tag.

2018-01-10 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master e19e96305 -> 398962a0d


Javadoc: add missing tag.

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

Branch: refs/heads/master
Commit: 398962a0de18194c5eace2e316a8ec2900bb848e
Parents: e19e963
Author: Gary Gregory 
Authored: Wed Jan 10 16:19:11 2018 -0700
Committer: Gary Gregory 
Committed: Wed Jan 10 16:19:11 2018 -0700

--
 .../apache/logging/log4j/core/appender/nosql/NoSqlAppender.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/398962a0/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/NoSqlAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/NoSqlAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/NoSqlAppender.java
index 3200b3e..cad9b84 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/NoSqlAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/nosql/NoSqlAppender.java
@@ -30,7 +30,7 @@ import org.apache.logging.log4j.core.util.Booleans;
  * This Appender writes logging events to a NoSQL database using a configured 
NoSQL provider. It requires
  * implementations of {@link NoSqlObject}, {@link NoSqlConnection}, and {@link 
NoSqlProvider} to "know" how to write
  * events to the chosen NoSQL database.
- * 
+ * 
  * For examples on how to write your own NoSQL provider, see the simple source 
code for the MongoDB and CouchDB
  * providers.
  * 



logging-log4j2 git commit: Javadoc.

2018-01-08 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 569389ac7 -> 7fcbb0398


Javadoc.

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

Branch: refs/heads/master
Commit: 7fcbb0398660ce6b80909d68c0b925952c4a232c
Parents: 569389a
Author: Gary Gregory 
Authored: Mon Jan 8 14:50:31 2018 -0700
Committer: Gary Gregory 
Committed: Mon Jan 8 14:50:31 2018 -0700

--
 .../logging/log4j/util/ReadOnlyStringMap.java   | 24 ++--
 1 file changed, 12 insertions(+), 12 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7fcbb039/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
--
diff --git 
a/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
index 3695aa4..df9a1c8 100644
--- 
a/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
+++ 
b/log4j-api/src/main/java/org/apache/logging/log4j/util/ReadOnlyStringMap.java
@@ -29,7 +29,7 @@ public interface ReadOnlyStringMap extends Serializable {
 /**
  * Returns a non-{@code null} mutable {@code Map} 
containing a snapshot of this data structure.
  *
- * @return a mutable copy of this data structure in {@code Map} form
+ * @return a mutable copy of this data structure in {@code Map} form.
  */
 Map toMap();
 
@@ -37,7 +37,7 @@ public interface ReadOnlyStringMap extends Serializable {
  * Returns {@code true} if this data structure contains the specified key, 
{@code false} otherwise.
  *
  * @param key the key whose presence to check. May be {@code null}.
- * @return {@code true} if this data structure contains the specified key, 
{@code false} otherwise
+ * @return {@code true} if this data structure contains the specified key, 
{@code false} otherwise.
  */
 boolean containsKey(String key);
 
@@ -51,8 +51,8 @@ public interface ReadOnlyStringMap extends Serializable {
  * {@code ConcurrentModificationException} to be thrown.
  * 
  *
- * @param action The action to be performed for each key-value pair in 
this collection
- * @param  type of the value
+ * @param action The action to be performed for each key-value pair in 
this collection.
+ * @param  type of the value.
  * @throws java.util.ConcurrentModificationException some implementations 
may not support structural modifications
  *  to this data structure while iterating over the contents with 
{@link #forEach(BiConsumer)} or
  *  {@link #forEach(TriConsumer, Object)}.
@@ -73,11 +73,11 @@ public interface ReadOnlyStringMap extends Serializable {
  * {@code ConcurrentModificationException} to be thrown.
  * 
  *
- * @param action The action to be performed for each key-value pair in 
this collection
+ * @param action The action to be performed for each key-value pair in 
this collection.
  * @param state the object to be passed as the third parameter to each 
invocation on the specified
- *  triconsumer
- * @param  type of the value
- * @param  type of the third parameter
+ *  triconsumer.
+ * @param  type of the value.
+ * @param  type of the third parameter.
  * @throws java.util.ConcurrentModificationException some implementations 
may not support structural modifications
  *  to this data structure while iterating over the contents with 
{@link #forEach(BiConsumer)} or
  *  {@link #forEach(TriConsumer, Object)}.
@@ -87,21 +87,21 @@ public interface ReadOnlyStringMap extends Serializable {
 /**
  * Returns the value for the specified key, or {@code null} if the 
specified key does not exist in this collection.
  *
- * @param key the key whose value to return
- * @return the value for the specified key or {@code null}
+ * @param key the key whose value to return.
+ * @return the value for the specified key or {@code null}.
  */
  V getValue(final String key);
 
 /**
  * Returns {@code true} if this collection is empty (size is zero), {@code 
false} otherwise.
- * @return {@code true} if this collection is empty (size is zero)
+ * @return {@code true} if this collection is empty (size is zero).
  */
 boolean isEmpty();
 
 /**
  * Returns the number of key-value pairs in this collection.
  *
- 

logging-log4j2 git commit: Javadoc: Use the active voice.

2018-01-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master aae3cc8f8 -> ff663d71e


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: ff663d71e02849015e921d8b69be7f8ae11a3389
Parents: aae3cc8
Author: Gary Gregory 
Authored: Thu Jan 4 12:39:51 2018 -0700
Committer: Gary Gregory 
Committed: Thu Jan 4 12:39:51 2018 -0700

--
 .../log4j/core/appender/rewrite/PropertiesRewritePolicy.java  | 7 ---
 1 file changed, 4 insertions(+), 3 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ff663d71/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rewrite/PropertiesRewritePolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rewrite/PropertiesRewritePolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rewrite/PropertiesRewritePolicy.java
index 097d63d..64da294 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rewrite/PropertiesRewritePolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rewrite/PropertiesRewritePolicy.java
@@ -38,8 +38,9 @@ import org.apache.logging.log4j.status.StatusLogger;
  */
 @Plugin(name = "PropertiesRewritePolicy", category = Core.CATEGORY_NAME, 
elementType = "rewritePolicy", printObject = true)
 public final class PropertiesRewritePolicy implements RewritePolicy {
+
 /**
- * Allow subclasses access to the status logger without creating another 
instance.
+ * Allows subclasses access to the status logger without creating another 
instance.
  */
 protected static final Logger LOGGER = StatusLogger.getLogger();
 
@@ -57,7 +58,7 @@ public final class PropertiesRewritePolicy implements 
RewritePolicy {
 }
 
 /**
- * Rewrite the event.
+ * Rewrites the event.
  * @param source a logging event that may be returned or
  * used to create a new logging event.
  * @return The LogEvent after rewriting.
@@ -93,7 +94,7 @@ public final class PropertiesRewritePolicy implements 
RewritePolicy {
 }
 
 /**
- * The factory method to create the PropertiesRewritePolicy.
+ * Creates a PropertiesRewritePolicy.
  * @param config The Configuration.
  * @param props key/value pairs for the new keys and values.
  * @return The PropertiesRewritePolicy.



logging-log4j2 git commit: Javadoc: Use the active voice.

2018-01-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master cbdd5fc6f -> aae3cc8f8


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: aae3cc8f80a832eeed13b75d76f94c38fc59a707
Parents: cbdd5fc
Author: Gary Gregory 
Authored: Thu Jan 4 12:37:23 2018 -0700
Committer: Gary Gregory 
Committed: Thu Jan 4 12:37:23 2018 -0700

--
 .../src/main/java/org/apache/logging/log4j/util/StringMap.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/aae3cc8f/log4j-api/src/main/java/org/apache/logging/log4j/util/StringMap.java
--
diff --git 
a/log4j-api/src/main/java/org/apache/logging/log4j/util/StringMap.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/util/StringMap.java
index 43ea71c..e4ce7e8 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/util/StringMap.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/util/StringMap.java
@@ -64,7 +64,7 @@ public interface StringMap extends ReadOnlyStringMap {
 boolean isFrozen();
 
 /**
- * Copy all key-value pairs from the specified {@code ReadOnlyStringMap} 
into this {@code StringMap}.
+ * Copies all key-value pairs from the specified {@code ReadOnlyStringMap} 
into this {@code StringMap}.
  * @param source the {@code ReadOnlyStringMap} to copy key-value pairs from
  * @throws java.util.ConcurrentModificationException some implementations 
may not support structural modifications
  *  to this data structure while iterating over the contents with 
{@link #forEach(BiConsumer)} or



logging-log4j2 git commit: Javadoc: Use the active voice.

2018-01-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master b0d748c7f -> 9e44c7ac8


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 9e44c7ac8202f387bd778879c8c5a3798a124f76
Parents: b0d748c
Author: Gary Gregory 
Authored: Thu Jan 4 12:16:46 2018 -0700
Committer: Gary Gregory 
Committed: Thu Jan 4 12:16:46 2018 -0700

--
 .../java/org/apache/logging/log4j/message/ThreadInformation.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/9e44c7ac/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadInformation.java
--
diff --git 
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadInformation.java
 
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadInformation.java
index f16b3aa..f3b4080 100644
--- 
a/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadInformation.java
+++ 
b/log4j-api/src/main/java/org/apache/logging/log4j/message/ThreadInformation.java
@@ -22,13 +22,13 @@ package org.apache.logging.log4j.message;
 public interface ThreadInformation {
 
 /**
- * Format the thread information into the provided StringBuilder.
+ * Formats the thread information into the provided StringBuilder.
  * @param sb The StringBuilder.
  */
 void printThreadInfo(StringBuilder sb);
 
 /**
- * Format the stack trace into the provided StringBuilder.
+ * Formats the stack trace into the provided StringBuilder.
  * @param sb The StringBuilder.
  * @param trace The stack trace element array to format.
  */



logging-log4j2 git commit: Javadoc.

2017-08-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 2a7165899 -> beff6bc33


Javadoc.

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

Branch: refs/heads/master
Commit: beff6bc336cb9e994c1766c2cb2173cd5e0892a3
Parents: 2a71658
Author: Gary Gregory 
Authored: Tue Aug 15 14:34:56 2017 -0600
Committer: Gary Gregory 
Committed: Tue Aug 15 14:34:56 2017 -0600

--
 .../appender/net/SecureSocketAppenderConnectPostStartupIT.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/beff6bc3/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SecureSocketAppenderConnectPostStartupIT.java
--
diff --git 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SecureSocketAppenderConnectPostStartupIT.java
 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SecureSocketAppenderConnectPostStartupIT.java
index 5d63388..18fe5c2 100644
--- 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SecureSocketAppenderConnectPostStartupIT.java
+++ 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SecureSocketAppenderConnectPostStartupIT.java
@@ -31,7 +31,7 @@ import org.junit.Before;
 import org.junit.Test;
 
 /**
- * Tests that a Socket Appender starts when there is no broker and connect the 
broker when it is started later..
+ * Tests that a Secure Socket Appender starts when there is no broker and 
connect the broker when it is started later.
  * 
  * LOG4J2-1311 SocketAppender will lost first several logs after re-connection 
to log servers.
  * 



logging-log4j2 git commit: Javadoc.

2017-08-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 48a9fb61d -> 2a7165899


Javadoc.

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

Branch: refs/heads/master
Commit: 2a716589997c2ffbf2c651d7edeeba22561ce696
Parents: 48a9fb6
Author: Gary Gregory 
Authored: Tue Aug 15 14:32:51 2017 -0600
Committer: Gary Gregory 
Committed: Tue Aug 15 14:32:51 2017 -0600

--
 .../core/appender/net/SocketAppenderConnectPostStartupIT.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2a716589/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
--
diff --git 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
index 0e86dab..a9263cb 100644
--- 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
+++ 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
@@ -26,7 +26,7 @@ import org.junit.Assert;
 import org.junit.Test;
 
 /**
- * Tests that a Socket Appender starts when there is no broker and connect the 
broker when it is started later..
+ * Tests that a Socket Appender starts when there is no broker and connect the 
broker when it is started later.
  * 
  * LOG4J2-1311 SocketAppender will lost first several logs after re-connection 
to log servers.
  * 



logging-log4j2 git commit: Javadoc.

2017-08-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 03a5e071b -> eceaaae88


Javadoc.

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

Branch: refs/heads/master
Commit: eceaaae88e962163accdd9d2b48905a035eafed3
Parents: 03a5e07
Author: Gary Gregory 
Authored: Tue Aug 15 13:41:04 2017 -0600
Committer: Gary Gregory 
Committed: Tue Aug 15 13:41:04 2017 -0600

--
 .../core/appender/net/SocketAppenderConnectPostStartupIT.java | 7 +--
 .../core/appender/net/SocketAppenderConnectReConnectIT.java   | 6 +-
 2 files changed, 10 insertions(+), 3 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/eceaaae8/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
--
diff --git 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
index 7f781dc..0e86dab 100644
--- 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
+++ 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectPostStartupIT.java
@@ -26,9 +26,12 @@ import org.junit.Assert;
 import org.junit.Test;
 
 /**
- * Tests that a JMS Appender start when there is no broker and connect the 
broker when it is started later..
+ * Tests that a Socket Appender starts when there is no broker and connect the 
broker when it is started later..
  * 
- * LOG4J2-1934 JMS Appender does not know how to recover from a broken 
connection. See
+ * LOG4J2-1311 SocketAppender will lost first several logs after re-connection 
to log servers.
+ * 
+ * 
+ * See also LOG4J2-1934 JMS Appender does not know how to recover from a 
broken connection. See
  * https://issues.apache.org/jira/browse/LOG4J2-1934
  * 
  * 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/eceaaae8/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectReConnectIT.java
--
diff --git 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectReConnectIT.java
 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectReConnectIT.java
index a39baa7..359689d 100644
--- 
a/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectReConnectIT.java
+++ 
b/log4j-core-its/src/test/java/org/apache/logging/log4j/core/appender/net/SocketAppenderConnectReConnectIT.java
@@ -29,7 +29,11 @@ import org.junit.Test;
 /**
  * Tests that a Socket Appender can reconnect to a server after it has been 
recycled.
  * 
- * LOG4J2-1311 SocketAppender will lost first serveral logs after 
re-connection to log servers.
+ * LOG4J2-1311 SocketAppender will lost first several logs after re-connection 
to log servers.
+ * 
+ * 
+ * See also LOG4J2-1934 JMS Appender does not know how to recover from a 
broken connection. See
+ * https://issues.apache.org/jira/browse/LOG4J2-1934
  * 
  * 
  * This test class' single test method performs the following:



logging-log4j2 git commit: Javadoc.

2017-08-13 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 6dd56d0f7 -> 7f116d6ac


Javadoc.

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

Branch: refs/heads/master
Commit: 7f116d6ac099f64217cfe56b4588f6c6dec5aa95
Parents: 6dd56d0
Author: Gary Gregory 
Authored: Sun Aug 13 19:44:27 2017 -0600
Committer: Gary Gregory 
Committed: Sun Aug 13 19:44:27 2017 -0600

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


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7f116d6a/log4j-core/src/main/java/org/apache/logging/log4j/core/DefaultLoggerContextAccessor.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/DefaultLoggerContextAccessor.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/DefaultLoggerContextAccessor.java
index 6ad5c1f..4401247 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/DefaultLoggerContextAccessor.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/DefaultLoggerContextAccessor.java
@@ -23,7 +23,7 @@ package org.apache.logging.log4j.core;
 public class DefaultLoggerContextAccessor implements LoggerContextAccessor {
 
 /**
- * Singleton insstamce.
+ * Singleton instance.
  */
 public static DefaultLoggerContextAccessor INSTANCE = new 
DefaultLoggerContextAccessor();
 



logging-log4j2 git commit: Javadoc.

2017-08-10 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 1c0c48653 -> fb71895a6


Javadoc.

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

Branch: refs/heads/master
Commit: fb71895a617a7cec96ec74e4102edf136b28b8b3
Parents: 1c0c486
Author: Gary Gregory 
Authored: Thu Aug 10 15:05:33 2017 -0600
Committer: Gary Gregory 
Committed: Thu Aug 10 15:05:33 2017 -0600

--
 .../apache/logging/log4j/core/appender/ConsoleAppender.java  | 8 +---
 1 file changed, 5 insertions(+), 3 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/fb71895a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
index e8fe1bc..6243944 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
@@ -45,9 +45,11 @@ import org.apache.logging.log4j.util.PropertiesUtil;
  * Appends log events to System.out or System.err 
using a layout specified by the user. The
  * default target is System.out.
  * 
- * TODO accessing System.out or .err as a byte stream instead of a writer 
bypasses the JVM's knowledge of the proper
- * encoding. (RG) Encoding is handled within the Layout. Typically, a Layout 
will generate a String and then call
- * getBytes which may use a configured encoding or the system default. OTOH, a 
Writer cannot print byte streams.
+ * TODO Accessing System.out or System.err as a byte 
stream instead of a writer bypasses the
+ * JVM's knowledge of the proper encoding. (RG) Encoding is handled within the 
Layout. Typically, a Layout will generate
+ * a String and then call getBytes which may use a configured encoding or the 
system default. OTOH, a Writer cannot
+ * print byte streams.
+ * 
  */
 @Plugin(name = ConsoleAppender.PLUGIN_NAME, category = Core.CATEGORY_NAME, 
elementType = Appender.ELEMENT_TYPE, printObject = true)
 public final class ConsoleAppender extends 
AbstractOutputStreamAppender {



logging-log4j2 git commit: Javadoc: Use the active voice.

2017-07-27 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 9833e280b -> 2c15220f1


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 2c15220f1db9deefd93d1d605bd898f3319817d0
Parents: 9833e28
Author: Gary Gregory 
Authored: Thu Jul 27 20:25:32 2017 -0700
Committer: Gary Gregory 
Committed: Thu Jul 27 20:25:32 2017 -0700

--
 .../org/apache/logging/log4j/core/parser/JsonLogEventParser.java  | 2 +-
 .../org/apache/logging/log4j/core/parser/TextLogEventParser.java  | 3 ++-
 .../org/apache/logging/log4j/core/parser/XmlLogEventParser.java   | 2 +-
 .../org/apache/logging/log4j/core/parser/YamlLogEventParser.java  | 2 +-
 4 files changed, 5 insertions(+), 4 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2c15220f/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/JsonLogEventParser.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/JsonLogEventParser.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/JsonLogEventParser.java
index 02240e2..084ca4c 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/JsonLogEventParser.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/JsonLogEventParser.java
@@ -20,7 +20,7 @@ import org.apache.logging.log4j.core.LogEvent;
 import org.apache.logging.log4j.core.jackson.Log4jJsonObjectMapper;
 
 /**
- * Parse the output from JsonLayout layout into instances of {@link LogEvent}.
+ * Parses the output from JsonLayout layout into instances of {@link LogEvent}.
  */
 public class JsonLogEventParser extends AbstractJacksonLogEventParser {
 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2c15220f/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/TextLogEventParser.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/TextLogEventParser.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/TextLogEventParser.java
index e7e366f..ca20335 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/TextLogEventParser.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/TextLogEventParser.java
@@ -19,9 +19,10 @@ package org.apache.logging.log4j.core.parser;
 import org.apache.logging.log4j.core.LogEvent;
 
 /**
- * Parse the output from a text based layout into instances of {@link 
LogEvent}.
+ * Parses the output from a text based layout into instances of {@link 
LogEvent}.
  */
 public interface TextLogEventParser extends LogEventParser {
+
 /**
  * Parses a String, which is expected to contain exactly one log event.
  *

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2c15220f/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/XmlLogEventParser.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/XmlLogEventParser.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/XmlLogEventParser.java
index 89b71d9..e5b5a3a 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/XmlLogEventParser.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/XmlLogEventParser.java
@@ -20,7 +20,7 @@ import org.apache.logging.log4j.core.LogEvent;
 import org.apache.logging.log4j.core.jackson.Log4jXmlObjectMapper;
 
 /**
- * Parse the output from XmlLayout layout into instances of {@link LogEvent}.
+ * Parses the output from XmlLayout layout into instances of {@link LogEvent}.
  */
 public class XmlLogEventParser extends AbstractJacksonLogEventParser {
 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2c15220f/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/YamlLogEventParser.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/YamlLogEventParser.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/YamlLogEventParser.java
index 05ba3f8..3efe662 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/YamlLogEventParser.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/parser/YamlLogEventParser.java
@@ -20,7 +20,7 @@ import org.apache.logging.log4j.core.LogEvent;
 import 

[35/51] [abbrv] logging-log4j2 git commit: Javadoc: Be as specific as possible in describing the levels.

2017-07-16 Thread ggregory
Javadoc: Be as specific as possible in describing the levels.

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

Branch: refs/heads/Lucene5
Commit: 241c702aa41ce879556f6b890ccd9b7f0fff1b08
Parents: bcaa2a4
Author: Gary Gregory 
Authored: Wed Jul 12 14:14:42 2017 -0700
Committer: Gary Gregory 
Committed: Wed Jul 12 14:14:42 2017 -0700

--
 .../src/main/java/org/apache/logging/log4j/Level.java | 10 ++
 1 file changed, 6 insertions(+), 4 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/241c702a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
--
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
index 4375118..05d0655 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
@@ -159,12 +159,14 @@ public final class Level implements Comparable, 
Serializable {
  * Compares this level against the level passed as an argument and returns 
true if this level is the same or is less
  * specific.
  * 
- * Concretely, {@link #TRACE} is less specific than {@link #DEBUG}, which 
is less specific than {@link #INFO},
- * etc., until {@link #FATAL}, and finally {@link #OFF}, which is the most 
specific standard level.
- * The least specific level is {@link #ALL}.
+ * Concretely, {@link #ALL} is less specific than {@link #TRACE}, which is 
less specific than {@link #DEBUG}, which
+ * is less specific than {@link #INFO}, which is less specific than {@link 
#WARN}, which is less specific than
+ * {@link #ERROR}, which is less specific than {@link #FATAL}, and finally 
{@link #OFF}, which is the most specific
+ * standard level.
  * 
  *
- * @param level The level to test.
+ * @param level
+ *The level to test.
  * @return True if this level Level is less specific or the same as the 
given Level.
  */
 public boolean isLessSpecificThan(final Level level) {



[50/51] [abbrv] logging-log4j2 git commit: Javadoc.

2017-07-16 Thread ggregory
Javadoc.

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

Branch: refs/heads/Lucene5
Commit: 3afab3622a960e9bd3cae4a5a2b05ec32a5461ab
Parents: f163199
Author: Gary Gregory 
Authored: Sun Jul 16 19:58:04 2017 -0700
Committer: Gary Gregory 
Committed: Sun Jul 16 19:58:04 2017 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LifeCycle2.java   | 3 +++
 1 file changed, 3 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/3afab362/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
index 71c6fad..0046a62 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
@@ -20,6 +20,9 @@ import java.util.concurrent.TimeUnit;
 
 /**
  * Extends the LifeCycle interface.
+ * 
+ *  This interface should be merged with the super-interface in 3.0.
+ * 
  * @since 2.7
  */
 public interface LifeCycle2 extends LifeCycle {



logging-log4j2 git commit: Javadoc.

2017-07-16 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master f163199d9 -> 3afab3622


Javadoc.

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

Branch: refs/heads/master
Commit: 3afab3622a960e9bd3cae4a5a2b05ec32a5461ab
Parents: f163199
Author: Gary Gregory 
Authored: Sun Jul 16 19:58:04 2017 -0700
Committer: Gary Gregory 
Committed: Sun Jul 16 19:58:04 2017 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LifeCycle2.java   | 3 +++
 1 file changed, 3 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/3afab362/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
index 71c6fad..0046a62 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle2.java
@@ -20,6 +20,9 @@ import java.util.concurrent.TimeUnit;
 
 /**
  * Extends the LifeCycle interface.
+ * 
+ *  This interface should be merged with the super-interface in 3.0.
+ * 
  * @since 2.7
  */
 public interface LifeCycle2 extends LifeCycle {



logging-log4j2 git commit: Javadoc: Be as specific as possible in describing the levels.

2017-07-12 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master bcaa2a40a -> 241c702aa


Javadoc: Be as specific as possible in describing the levels.

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

Branch: refs/heads/master
Commit: 241c702aa41ce879556f6b890ccd9b7f0fff1b08
Parents: bcaa2a4
Author: Gary Gregory 
Authored: Wed Jul 12 14:14:42 2017 -0700
Committer: Gary Gregory 
Committed: Wed Jul 12 14:14:42 2017 -0700

--
 .../src/main/java/org/apache/logging/log4j/Level.java | 10 ++
 1 file changed, 6 insertions(+), 4 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/241c702a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
--
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
index 4375118..05d0655 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/Level.java
@@ -159,12 +159,14 @@ public final class Level implements Comparable, 
Serializable {
  * Compares this level against the level passed as an argument and returns 
true if this level is the same or is less
  * specific.
  * 
- * Concretely, {@link #TRACE} is less specific than {@link #DEBUG}, which 
is less specific than {@link #INFO},
- * etc., until {@link #FATAL}, and finally {@link #OFF}, which is the most 
specific standard level.
- * The least specific level is {@link #ALL}.
+ * Concretely, {@link #ALL} is less specific than {@link #TRACE}, which is 
less specific than {@link #DEBUG}, which
+ * is less specific than {@link #INFO}, which is less specific than {@link 
#WARN}, which is less specific than
+ * {@link #ERROR}, which is less specific than {@link #FATAL}, and finally 
{@link #OFF}, which is the most specific
+ * standard level.
  * 
  *
- * @param level The level to test.
+ * @param level
+ *The level to test.
  * @return True if this level Level is less specific or the same as the 
given Level.
  */
 public boolean isLessSpecificThan(final Level level) {



logging-log4j2 git commit: Javadoc tweak.

2017-07-04 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 03ca82a97 -> 02f9767c9


Javadoc tweak.

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

Branch: refs/heads/master
Commit: 02f9767c998eaf510eac147e1f3e18f4782e2691
Parents: 03ca82a
Author: Gary Gregory 
Authored: Tue Jul 4 09:31:11 2017 -0700
Committer: Gary Gregory 
Committed: Tue Jul 4 09:31:11 2017 -0700

--
 .../log4j/core/pattern/ExtendedThrowablePatternConverter.java   | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/02f9767c/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/ExtendedThrowablePatternConverter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/ExtendedThrowablePatternConverter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/ExtendedThrowablePatternConverter.java
index 4cd0725..abbe338 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/ExtendedThrowablePatternConverter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/ExtendedThrowablePatternConverter.java
@@ -36,6 +36,7 @@ public final class ExtendedThrowablePatternConverter extends 
ThrowablePatternCon
 
 /**
  * Private constructor.
+ * 
  * @param config
  * @param options options, may be null.
  */



[2/2] logging-log4j2 git commit: Javadoc.

2017-01-10 Thread ggregory
Javadoc.

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

Branch: refs/heads/master
Commit: 3ebc6b06d27c9b6c7c320b13835cadfa248a9257
Parents: 9ec95fc
Author: Gary Gregory 
Authored: Tue Jan 10 13:20:29 2017 -0800
Committer: Gary Gregory 
Committed: Tue Jan 10 13:20:29 2017 -0800

--
 .../java/org/apache/logging/log4j/junit/CleanFiles.java | 9 +
 1 file changed, 9 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/3ebc6b06/log4j-core/src/test/java/org/apache/logging/log4j/junit/CleanFiles.java
--
diff --git 
a/log4j-core/src/test/java/org/apache/logging/log4j/junit/CleanFiles.java 
b/log4j-core/src/test/java/org/apache/logging/log4j/junit/CleanFiles.java
index 917416e..a73be99 100644
--- a/log4j-core/src/test/java/org/apache/logging/log4j/junit/CleanFiles.java
+++ b/log4j-core/src/test/java/org/apache/logging/log4j/junit/CleanFiles.java
@@ -23,6 +23,15 @@ import java.nio.file.Path;
 
 /**
  * A JUnit test rule to automatically delete files after a test is run.
+ * 
+ * For example:
+ * 
+ * 
+ * 
+ * Rule
+ * public CleanFiles files = new CleanFiles("path/to/file.txt");
+ * 
+ *
  */
 public class CleanFiles extends AbstractExternalFileCleaner {
 private static final int MAX_TRIES = 10;



logging-log4j2 git commit: Javadoc tweaks.

2016-12-12 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 5513abe87 -> 2f927d9ee


Javadoc tweaks.

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

Branch: refs/heads/master
Commit: 2f927d9eefd49ae84b52510de0f8a30c80a01976
Parents: 5513abe
Author: Gary Gregory 
Authored: Mon Dec 12 13:31:34 2016 -0800
Committer: Gary Gregory 
Committed: Mon Dec 12 13:31:34 2016 -0800

--
 .../logging/log4j/core/net/Rfc1349TrafficClass.java  | 11 +--
 1 file changed, 5 insertions(+), 6 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/2f927d9e/log4j-core/src/main/java/org/apache/logging/log4j/core/net/Rfc1349TrafficClass.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/Rfc1349TrafficClass.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/Rfc1349TrafficClass.java
index cb071e4..8144e45 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/Rfc1349TrafficClass.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/Rfc1349TrafficClass.java
@@ -18,14 +18,13 @@
 package org.apache.logging.log4j.core.net;
 
 /**
- * Enumerates the RFC 1349 TOS field.
+ * Enumerates the https://tools.ietf.org/html/rfc1349;>RFC 1349 
TOS field.
  * 
  * 
- * 1000 -- minimize delay
- * 0100 -- maximize throughput
- * 0010 -- maximize reliability
- * 0001 -- minimize monetary cost
- *  -- normal service
+ * IPTOS_LOWCOST (0x02)
+ * IPTOS_RELIABILITY (0x04)
+ * IPTOS_THROUGHPUT (0x08)
+ * IPTOS_LOWDELAY (0x10)
  * 
  */
 public enum Rfc1349TrafficClass {



logging-log4j2 git commit: Javadoc: Use the active voice. Add blank line.

2016-11-27 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master d73d85758 -> 286d8b380


Javadoc: Use the active voice. Add blank line.

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

Branch: refs/heads/master
Commit: 286d8b380aecde6f72c4fb4e3cf85d11d2717e32
Parents: d73d857
Author: Gary Gregory 
Authored: Sun Nov 27 02:29:24 2016 -0800
Committer: Gary Gregory 
Committed: Sun Nov 27 02:29:24 2016 -0800

--
 .../java/org/apache/logging/log4j/core/layout/SyslogLayout.java   | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/286d8b38/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/SyslogLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/SyslogLayout.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/SyslogLayout.java
index 5d20c31..c3fc840 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/SyslogLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/SyslogLayout.java
@@ -56,6 +56,7 @@ public final class SyslogLayout extends AbstractStringLayout {
  * Date format used if header = true.
  */
 private final SimpleDateFormat dateFormat = new SimpleDateFormat("MMM dd 
HH:mm:ss", Locale.ENGLISH);
+
 /**
  * Host name used to identify messages from this appender.
  */
@@ -130,7 +131,7 @@ public final class SyslogLayout extends 
AbstractStringLayout {
 }
 
 /**
- * Create a SyslogLayout.
+ * Creates a SyslogLayout.
  * @param facility The Facility is used to try to classify the message.
  * @param includeNewLine If true a newline will be appended to the result.
  * @param escapeNL Pattern to use for replacing newlines.



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-11-27 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master c961deaea -> f31970b0d


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: f31970b0de4cddfc7ffbdfb5baa780c9be3c4f4c
Parents: c961dea
Author: Gary Gregory 
Authored: Sun Nov 27 00:31:29 2016 -0800
Committer: Gary Gregory 
Committed: Sun Nov 27 00:31:29 2016 -0800

--
 .../log4j/core/pattern/VariablesNotEmptyReplacementConverter.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f31970b0/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.java
index 8824f9e..33cc49e 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/pattern/VariablesNotEmptyReplacementConverter.java
@@ -33,7 +33,7 @@ public final class VariablesNotEmptyReplacementConverter 
extends LogEventPattern
 private final List formatters;
 
 /**
- * Construct the converter.
+ * Constructs the converter.
  * 
  * @param formatters
  *The PatternFormatters to generate the text to manipulate.



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-11-13 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 912c7b3bf -> 7d62d6bb2


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 7d62d6bb2e32c12361f01aff90d029dc7f8f7e9d
Parents: 912c7b3
Author: Gary Gregory 
Authored: Sun Nov 13 18:34:57 2016 -0800
Committer: Gary Gregory 
Committed: Sun Nov 13 18:34:57 2016 -0800

--
 .../java/org/apache/logging/log4j/core/net/TcpSocketManager.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7d62d6bb/log4j-core/src/main/java/org/apache/logging/log4j/core/net/TcpSocketManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/TcpSocketManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/TcpSocketManager.java
index 891f5ac..1e43cee 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/TcpSocketManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/TcpSocketManager.java
@@ -93,7 +93,7 @@ public class TcpSocketManager extends AbstractSocketManager {
 }
 
 /**
- * Obtain a TcpSocketManager.
+ * Obtains a TcpSocketManager.
  * @param host The host to connect to.
  * @param port The port on the host.
  * @param connectTimeoutMillis the connect timeout in milliseconds



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-11-13 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 22c294cc7 -> 912c7b3bf


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 912c7b3bf6b89a45fbd23249d53695e27c96482d
Parents: 22c294c
Author: Gary Gregory 
Authored: Sun Nov 13 17:47:03 2016 -0800
Committer: Gary Gregory 
Committed: Sun Nov 13 17:47:03 2016 -0800

--
 .../org/apache/logging/log4j/core/appender/SyslogAppender.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/912c7b3b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/SyslogAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/SyslogAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/SyslogAppender.java
index 1f3cc7d..bfe7e3a 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/SyslogAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/SyslogAppender.java
@@ -57,7 +57,7 @@ public class SyslogAppender extends SocketAppender {
 }
 
 /**
- * Create a SyslogAppender.
+ * Creates a SyslogAppender.
  * @param host The name of the host to connect to.
  * @param port The port to connect to on the target host.
  * @param protocolStr The Protocol to use.



logging-log4j2 git commit: Javadoc: Close tag.

2016-11-11 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 4577ee40a -> a5e0a1e67


Javadoc: Close tag.

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

Branch: refs/heads/master
Commit: a5e0a1e6727399359df1a82dd74b09062df3a050
Parents: 4577ee4
Author: Gary Gregory 
Authored: Fri Nov 11 16:47:23 2016 -0800
Committer: Gary Gregory 
Committed: Fri Nov 11 16:47:23 2016 -0800

--
 .../org/apache/logging/log4j/core/layout/AbstractStringLayout.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/a5e0a1e6/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/AbstractStringLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/AbstractStringLayout.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/AbstractStringLayout.java
index 52ca082..1072733 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/AbstractStringLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/AbstractStringLayout.java
@@ -35,6 +35,7 @@ import java.nio.charset.StandardCharsets;
  * 
  * Since 2.4.1, this class has custom logic to convert ISO-8859-1 or US-ASCII 
Strings to byte[] arrays to improve
  * performance: all characters are simply cast to bytes.
+ * 
  */
 /*
  * Implementation note: prefer String.getBytes(String) to 
String.getBytes(Charset) for performance reasons. See



logging-log4j2 git commit: Javadoc typos.

2016-11-03 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 71cec25ee -> 7106800fa


Javadoc typos.

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

Branch: refs/heads/master
Commit: 7106800fa2c00de9196a1acda6b14baf04e9e882
Parents: 71cec25
Author: Gary Gregory 
Authored: Thu Nov 3 21:54:20 2016 -0700
Committer: Gary Gregory 
Committed: Thu Nov 3 21:54:20 2016 -0700

--
 .../logging/log4j/core/config/plugins/util/ResolverUtil.java | 8 
 1 file changed, 4 insertions(+), 4 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7106800f/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/util/ResolverUtil.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/util/ResolverUtil.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/util/ResolverUtil.java
index d9e3594..1aaa228 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/util/ResolverUtil.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/plugins/util/ResolverUtil.java
@@ -120,7 +120,7 @@ public class ResolverUtil {
 }
 
 /**
- * Returns the classloader that will be used for scanning for classes. If 
no explicit ClassLoader has been set by
+ * Returns the ClassLoader that will be used for scanning for classes. If 
no explicit ClassLoader has been set by
  * the calling, the context class loader will be used.
  *
  * @return the ClassLoader that will be used to scan for classes
@@ -131,7 +131,7 @@ public class ResolverUtil {
 
 /**
  * Sets an explicit ClassLoader that should be used when scanning for 
classes. If none is set then the context
- * classloader will be used.
+ * ClassLoader will be used.
  *
  * @param aClassloader
  *a ClassLoader to use when scanning for classes
@@ -218,7 +218,7 @@ public class ResolverUtil {
 }
 }
 } catch (final IOException | URISyntaxException ioe) {
-LOGGER.warn("could not read entries", ioe);
+LOGGER.warn("Could not read entries", ioe);
 }
 }
 }
@@ -266,7 +266,7 @@ public class ResolverUtil {
 }
 
 /**
- * Finds matches in a physical directory on a filesystem. Examines all 
files within a directory - if the File object
+ * Finds matches in a physical directory on a file system. Examines all 
files within a directory - if the File object
  * is not a directory, and ends with .class the file is loaded and 
tested to see if it is acceptable
  * according to the Test. Operates recursively to find classes within a 
folder structure matching the package
  * structure.



[28/50] [abbrv] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-24 Thread mikes
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1390
Commit: 1e322e4f2b51dc72f12eafea9e12335c65f59e59
Parents: ce86130
Author: Gary Gregory 
Authored: Wed Oct 5 11:29:11 2016 -0700
Committer: Gary Gregory 
Committed: Wed Oct 5 11:29:11 2016 -0700

--
 .../java/org/apache/logging/log4j/core/util/CyclicBuffer.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/1e322e4f/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
index 35b7eb5..0edc65e 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
@@ -31,7 +31,7 @@ public final class CyclicBuffer {
 private final Class clazz;
 
 /**
- * Instantiate a new CyclicBuffer of at most maxSize events.
+ * Instantiates a new CyclicBuffer of at most maxSize events.
  * @param clazz The Class associate with the type of object in the buffer.
  * @param size The number of items in the buffer.
  * @throws IllegalArgumentException if the size is negative.
@@ -50,7 +50,7 @@ public final class CyclicBuffer {
 }
 
 /**
- * Add an item as the last event in the buffer.
+ * Adds an item as the last event in the buffer.
  * @param item The item to add to the buffer.
  */
 public synchronized void add(final T item) {



[35/50] [abbrv] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-24 Thread mikes
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1390
Commit: eed7c07182384a7530268891d2b26a0368181eaa
Parents: 118abf4
Author: Gary Gregory 
Authored: Fri Oct 7 15:15:43 2016 -0700
Committer: Gary Gregory 
Committed: Fri Oct 7 15:15:43 2016 -0700

--
 .../java/org/apache/logging/log4j/core/layout/HtmlLayout.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/eed7c071/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
index 2acf335..6cd64d3 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
@@ -132,7 +132,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Format as a String.
+ * Formats as a String.
  *
  * @param event The Logging Event.
  * @return A String containing the LogEvent as HTML.
@@ -325,7 +325,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Create an HTML Layout.
+ * Creates an HTML Layout.
  * @param locationInfo If "true", location information will be included. 
The default is false.
  * @param title The title to include in the file header. If none is 
specified the default title will be used.
  * @param contentType The content type. Defaults to "text/html".



[2/9] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-17 Thread mikes
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1623
Commit: eed7c07182384a7530268891d2b26a0368181eaa
Parents: 118abf4
Author: Gary Gregory 
Authored: Fri Oct 7 15:15:43 2016 -0700
Committer: Gary Gregory 
Committed: Fri Oct 7 15:15:43 2016 -0700

--
 .../java/org/apache/logging/log4j/core/layout/HtmlLayout.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/eed7c071/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
index 2acf335..6cd64d3 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
@@ -132,7 +132,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Format as a String.
+ * Formats as a String.
  *
  * @param event The Logging Event.
  * @return A String containing the LogEvent as HTML.
@@ -325,7 +325,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Create an HTML Layout.
+ * Creates an HTML Layout.
  * @param locationInfo If "true", location information will be included. 
The default is false.
  * @param title The title to include in the file header. If none is 
specified the default title will be used.
  * @param contentType The content type. Defaults to "text/html".



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-07 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 118abf471 -> eed7c0718


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: eed7c07182384a7530268891d2b26a0368181eaa
Parents: 118abf4
Author: Gary Gregory 
Authored: Fri Oct 7 15:15:43 2016 -0700
Committer: Gary Gregory 
Committed: Fri Oct 7 15:15:43 2016 -0700

--
 .../java/org/apache/logging/log4j/core/layout/HtmlLayout.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/eed7c071/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
index 2acf335..6cd64d3 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/layout/HtmlLayout.java
@@ -132,7 +132,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Format as a String.
+ * Formats as a String.
  *
  * @param event The Logging Event.
  * @return A String containing the LogEvent as HTML.
@@ -325,7 +325,7 @@ public final class HtmlLayout extends AbstractStringLayout {
 }
 
 /**
- * Create an HTML Layout.
+ * Creates an HTML Layout.
  * @param locationInfo If "true", location information will be included. 
The default is false.
  * @param title The title to include in the file header. If none is 
specified the default title will be used.
  * @param contentType The content type. Defaults to "text/html".



[1/5] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-06 Thread mikes
Repository: logging-log4j2
Updated Branches:
  refs/heads/LOG4J2-1623 c92c327c3 -> 3064471ea


Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1623
Commit: 1e322e4f2b51dc72f12eafea9e12335c65f59e59
Parents: ce86130
Author: Gary Gregory 
Authored: Wed Oct 5 11:29:11 2016 -0700
Committer: Gary Gregory 
Committed: Wed Oct 5 11:29:11 2016 -0700

--
 .../java/org/apache/logging/log4j/core/util/CyclicBuffer.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/1e322e4f/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
index 35b7eb5..0edc65e 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
@@ -31,7 +31,7 @@ public final class CyclicBuffer {
 private final Class clazz;
 
 /**
- * Instantiate a new CyclicBuffer of at most maxSize events.
+ * Instantiates a new CyclicBuffer of at most maxSize events.
  * @param clazz The Class associate with the type of object in the buffer.
  * @param size The number of items in the buffer.
  * @throws IllegalArgumentException if the size is negative.
@@ -50,7 +50,7 @@ public final class CyclicBuffer {
 }
 
 /**
- * Add an item as the last event in the buffer.
+ * Adds an item as the last event in the buffer.
  * @param item The item to add to the buffer.
  */
 public synchronized void add(final T item) {



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-10-05 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master ce8613039 -> 1e322e4f2


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 1e322e4f2b51dc72f12eafea9e12335c65f59e59
Parents: ce86130
Author: Gary Gregory 
Authored: Wed Oct 5 11:29:11 2016 -0700
Committer: Gary Gregory 
Committed: Wed Oct 5 11:29:11 2016 -0700

--
 .../java/org/apache/logging/log4j/core/util/CyclicBuffer.java| 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/1e322e4f/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
index 35b7eb5..0edc65e 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/CyclicBuffer.java
@@ -31,7 +31,7 @@ public final class CyclicBuffer {
 private final Class clazz;
 
 /**
- * Instantiate a new CyclicBuffer of at most maxSize events.
+ * Instantiates a new CyclicBuffer of at most maxSize events.
  * @param clazz The Class associate with the type of object in the buffer.
  * @param size The number of items in the buffer.
  * @throws IllegalArgumentException if the size is negative.
@@ -50,7 +50,7 @@ public final class CyclicBuffer {
 }
 
 /**
- * Add an item as the last event in the buffer.
+ * Adds an item as the last event in the buffer.
  * @param item The item to add to the buffer.
  */
 public synchronized void add(final T item) {



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-09-26 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 233c2b524 -> f465d4ae6


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: f465d4ae6cfa755c3c523082decb43d3934938cf
Parents: 233c2b5
Author: Gary Gregory 
Authored: Mon Sep 26 16:57:35 2016 -0700
Committer: Gary Gregory 
Committed: Mon Sep 26 16:57:35 2016 -0700

--
 .../apache/logging/log4j/flume/appender/FlumeEventFactory.java| 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f465d4ae/log4j-flume-ng/src/main/java/org/apache/logging/log4j/flume/appender/FlumeEventFactory.java
--
diff --git 
a/log4j-flume-ng/src/main/java/org/apache/logging/log4j/flume/appender/FlumeEventFactory.java
 
b/log4j-flume-ng/src/main/java/org/apache/logging/log4j/flume/appender/FlumeEventFactory.java
index b93ee89..a95fd6b 100644
--- 
a/log4j-flume-ng/src/main/java/org/apache/logging/log4j/flume/appender/FlumeEventFactory.java
+++ 
b/log4j-flume-ng/src/main/java/org/apache/logging/log4j/flume/appender/FlumeEventFactory.java
@@ -22,8 +22,9 @@ import org.apache.logging.log4j.core.LogEvent;
  * Factory to create Flume events.
  */
 public interface FlumeEventFactory {
+
 /**
- * Create a Flume event.
+ * Creates a Flume event.
  * @param event The Log4j LogEvent.
  * @param includes A comma separated list of MDC elements to include.
  * @param excludes A comma separated list of MDC elements to exclude.



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-09-23 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 7a409d4a6 -> fc2a2edd7


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: fc2a2edd7b8f97c97218e8c8e4eb9e8446aa485e
Parents: 7a409d4
Author: Gary Gregory 
Authored: Fri Sep 23 15:51:47 2016 -0700
Committer: Gary Gregory 
Committed: Fri Sep 23 15:51:47 2016 -0700

--
 .../logging/log4j/core/config/ConfigurationException.java  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/fc2a2edd/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationException.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationException.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationException.java
index 06f777e..830cdcf 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationException.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationException.java
@@ -25,7 +25,7 @@ public class ConfigurationException extends RuntimeException {
 private static final long serialVersionUID = -2413951820300775294L;
 
 /**
- * Construct an exception with a message.
+ * Constructs an exception with a message.
  *
  * @param message The reason for the exception
  */
@@ -34,7 +34,7 @@ public class ConfigurationException extends RuntimeException {
 }
 
 /**
- * Construct an exception with a message and underlying cause.
+ * Constructs an exception with a message and underlying cause.
  *
  * @param message The reason for the exception
  * @param cause The underlying cause of the exception
@@ -44,7 +44,7 @@ public class ConfigurationException extends RuntimeException {
 }
 
 /**
- * Construct an exception with a message and underlying cause.
+ * Constructs an exception with a message and underlying cause.
  *
  * @param cause The underlying cause of the exception
  */



logging-log4j2 git commit: Javadoc @throws StoreConfigurationException May be thrown by subclasses.

2016-09-20 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 995e3c3bc -> 50b7956b1


Javadoc @throws StoreConfigurationException May be thrown by subclasses.

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

Branch: refs/heads/master
Commit: 50b7956b18e3c57ac4d4142e64d84a38ac8b2d44
Parents: 995e3c3
Author: Gary Gregory 
Authored: Tue Sep 20 15:57:11 2016 -0700
Committer: Gary Gregory 
Committed: Tue Sep 20 15:57:11 2016 -0700

--
 .../org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java | 3 +++
 1 file changed, 3 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/50b7956b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java
index fd51e40..f342fd5 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/net/ssl/StoreConfiguration.java
@@ -52,6 +52,9 @@ public class StoreConfiguration {
 this.password = password;
 }
 
+/**
+ * @throws StoreConfigurationException May be thrown by subclasses 
+ */
 protected T load() throws StoreConfigurationException {
 return null;
 }



logging-log4j2 git commit: Javadoc: This appender is not thread-safe.

2016-09-15 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 53d3eda0c -> dd943975b


Javadoc: This appender is not thread-safe.

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

Branch: refs/heads/master
Commit: dd943975b7c809c3d302237cecf7116c9c9e9ea2
Parents: 53d3eda
Author: Gary Gregory 
Authored: Thu Sep 15 12:40:14 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 15 12:40:14 2016 -0700

--
 .../java/org/apache/logging/log4j/test/appender/ListAppender.java  | 2 ++
 1 file changed, 2 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/dd943975/log4j-core/src/test/java/org/apache/logging/log4j/test/appender/ListAppender.java
--
diff --git 
a/log4j-core/src/test/java/org/apache/logging/log4j/test/appender/ListAppender.java
 
b/log4j-core/src/test/java/org/apache/logging/log4j/test/appender/ListAppender.java
index 2efaaca..0d24420 100644
--- 
a/log4j-core/src/test/java/org/apache/logging/log4j/test/appender/ListAppender.java
+++ 
b/log4j-core/src/test/java/org/apache/logging/log4j/test/appender/ListAppender.java
@@ -39,6 +39,8 @@ import org.apache.logging.log4j.core.layout.SerializedLayout;
 /**
  * This appender is primarily used for testing. Use in a real environment is 
discouraged as the
  * List could eventually grow to cause an OutOfMemoryError.
+ * 
+ * This appender is not thread-safe.
  *
  * This appender will use {@link Layout#toByteArray(LogEvent)}.
  *



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-09-13 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master d8eb69d24 -> 82cd54656


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: 82cd5465623f63d7ab931c1f5a3470b8f1716f08
Parents: d8eb69d
Author: Gary Gregory 
Authored: Tue Sep 13 00:50:59 2016 -0700
Committer: Gary Gregory 
Committed: Tue Sep 13 00:50:59 2016 -0700

--
 .../core/appender/routing/RoutingAppenderWithPurgingTest.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/82cd5465/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/routing/RoutingAppenderWithPurgingTest.java
--
diff --git 
a/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/routing/RoutingAppenderWithPurgingTest.java
 
b/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/routing/RoutingAppenderWithPurgingTest.java
index dd41839..ef89c35 100644
--- 
a/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/routing/RoutingAppenderWithPurgingTest.java
+++ 
b/log4j-core/src/test/java/org/apache/logging/log4j/core/appender/routing/RoutingAppenderWithPurgingTest.java
@@ -35,7 +35,7 @@ import org.junit.Test;
 import org.junit.rules.RuleChain;
 
 /**
- * Testing Routing appender purge facilities
+ * Tests Routing appender purge facilities
  */
 public class RoutingAppenderWithPurgingTest {
 private static final String CONFIG = "log4j-routing-purge.xml";



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-09-12 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master cb47c4da5 -> c03e36632


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: c03e366321cd636c76afb563e83e9491e4d6c6ee
Parents: cb47c4d
Author: Gary Gregory 
Authored: Mon Sep 12 20:34:54 2016 -0700
Committer: Gary Gregory 
Committed: Mon Sep 12 20:34:54 2016 -0700

--
 .../logging/log4j/core/appender/routing/RoutingAppender.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c03e3663/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/RoutingAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/RoutingAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/RoutingAppender.java
index fbe431e..69e2d66 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/RoutingAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/RoutingAppender.java
@@ -181,7 +181,7 @@ public final class RoutingAppender extends AbstractAppender 
{
 }
 
 /**
- * Delete specified appender
+ * Deletes the specified appender.
  *
  * @param key The appender's key
  */
@@ -197,7 +197,7 @@ public final class RoutingAppender extends AbstractAppender 
{
 }
 
 /**
- * Create a RoutingAppender.
+ * Creates a RoutingAppender.
  * @param name The name of the Appender.
  * @param ignore If {@code "true"} (default) exceptions encountered when 
appending events are logged; otherwise
  *   they are propagated to the caller.



[19/21] logging-log4j2 git commit: Javadoc.

2016-09-09 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 74f5976352cab95f6bad5db9987b063084d54f1c
Parents: 40fbc2a
Author: Gary Gregory 
Authored: Fri Sep 9 09:01:35 2016 -0700
Committer: Gary Gregory 
Committed: Fri Sep 9 09:01:35 2016 -0700

--
 .../org/apache/logging/log4j/core/appender/ConsoleAppender.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/74f59763/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
index e2d9452..195ecbc 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
@@ -84,7 +84,7 @@ public final class ConsoleAppender extends 
AbstractOutputStreamAppender layout,
@@ -119,7 +119,7 @@ public final class ConsoleAppender extends 
AbstractOutputStreamAppender

[06/21] logging-log4j2 git commit: Javadoc.

2016-09-09 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 5d79669753c954a57f81a74b44efc32b0567f278
Parents: 21581e2
Author: Gary Gregory 
Authored: Thu Sep 8 11:52:28 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 11:52:28 2016 -0700

--
 .../java/org/apache/logging/log4j/core/config/LoggerConfig.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/5d796697/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
index 12f8615..886b78d 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
@@ -408,7 +408,7 @@ public class LoggerConfig extends AbstractFilterable {
  * @param config The Configuration.
  * @param filter A Filter.
  * @return A new LoggerConfig.
- * @deprecated Use {@link #createLogger(boolean, Level, String, String, 
AppenderRef[], Property[], Configuration, Filter)}
+ * @deprecated Deprecated in 2.7; use {@link #createLogger(boolean, Level, 
String, String, AppenderRef[], Property[], Configuration, Filter)}
  */
 @Deprecated
 public static LoggerConfig createLogger(final String additivity,



logging-log4j2 git commit: Javadoc.

2016-09-09 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 40fbc2a20 -> 74f597635


Javadoc.

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

Branch: refs/heads/master
Commit: 74f5976352cab95f6bad5db9987b063084d54f1c
Parents: 40fbc2a
Author: Gary Gregory 
Authored: Fri Sep 9 09:01:35 2016 -0700
Committer: Gary Gregory 
Committed: Fri Sep 9 09:01:35 2016 -0700

--
 .../org/apache/logging/log4j/core/appender/ConsoleAppender.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/74f59763/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
index e2d9452..195ecbc 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/ConsoleAppender.java
@@ -84,7 +84,7 @@ public final class ConsoleAppender extends 
AbstractOutputStreamAppender layout,
@@ -119,7 +119,7 @@ public final class ConsoleAppender extends 
AbstractOutputStreamAppender

[2/3] logging-log4j2 git commit: Javadoc.

2016-09-08 Thread ggregory
Javadoc.

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

Branch: refs/heads/master
Commit: 5d79669753c954a57f81a74b44efc32b0567f278
Parents: 21581e2
Author: Gary Gregory 
Authored: Thu Sep 8 11:52:28 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 11:52:28 2016 -0700

--
 .../java/org/apache/logging/log4j/core/config/LoggerConfig.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/5d796697/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
index 12f8615..886b78d 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
@@ -408,7 +408,7 @@ public class LoggerConfig extends AbstractFilterable {
  * @param config The Configuration.
  * @param filter A Filter.
  * @return A new LoggerConfig.
- * @deprecated Use {@link #createLogger(boolean, Level, String, String, 
AppenderRef[], Property[], Configuration, Filter)}
+ * @deprecated Deprecated in 2.7; use {@link #createLogger(boolean, Level, 
String, String, AppenderRef[], Property[], Configuration, Filter)}
  */
 @Deprecated
 public static LoggerConfig createLogger(final String additivity,



[24/35] logging-log4j2 git commit: Javadoc: add @see tags.

2016-09-08 Thread rpopma
Javadoc: add @see tags.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 6b80565b51f9ba146e5822cbb7643e57d4026a81
Parents: 48e6ea0
Author: Gary Gregory 
Authored: Thu Sep 8 00:27:22 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:27:22 2016 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LifeCycle.java | 2 ++
 .../logging/log4j/core/appender/rolling/TriggeringPolicy.java  | 2 ++
 2 files changed, 4 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6b80565b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
index e6e5a10..7dc1a94 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
@@ -28,6 +28,8 @@ import java.util.concurrent.TimeUnit;
  * stopped, this goes into the {@link State#STOPPED} state. In most 
circumstances, implementation classes should
  * store their {@link State} in a {@code volatile} field or inside an
  * {@link java.util.concurrent.atomic.AtomicReference} dependent on 
synchronization and concurrency requirements.
+ * 
+ * @see AbstractLifeCycle
  */
 public interface LifeCycle {
 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6b80565b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
index 0b032d6..f6fea59 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
@@ -23,6 +23,8 @@ import org.apache.logging.log4j.core.LogEvent;
  * A TriggeringPolicy controls the conditions under which rollover
  * occurs. Such conditions include time of day, file size, an
  * external event, the log request or a combination thereof.
+ * 
+ * @see AbstractTriggeringPolicy
  */
 public interface TriggeringPolicy extends LifeCycle {
 



[30/35] logging-log4j2 git commit: Javadoc nits.

2016-09-08 Thread rpopma
Javadoc nits.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: ab63bc900d42602b6573cd6df3ae6c66124a26cf
Parents: 36e6fd3
Author: Gary Gregory 
Authored: Thu Sep 8 00:52:03 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:52:03 2016 -0700

--
 .../apache/logging/log4j/core/appender/routing/PurgePolicy.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ab63bc90/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
index 2f7e100..b0c8c61 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
@@ -24,7 +24,7 @@ import org.apache.logging.log4j.core.LogEvent;
 public interface PurgePolicy {
 
/**
-* Activate purging appenders
+* Activates purging appenders
 */
void purge();

@@ -36,7 +36,7 @@ public interface PurgePolicy {
void update(String key, LogEvent event);
 
/**
-* Initialize with routing appender
+* Initializes with routing appender
 * 
 * @param routingAppender
 */



[12/35] logging-log4j2 git commit: Javadoc.

2016-09-08 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: f2a7f74ec4a438a5ae6d66940aa75292941a5281
Parents: 35a1a72
Author: Gary Gregory 
Authored: Wed Sep 7 20:56:19 2016 -0700
Committer: Gary Gregory 
Committed: Wed Sep 7 20:56:19 2016 -0700

--
 .../org/apache/logging/log4j/core/util/NullOutputStream.java| 5 +
 1 file changed, 5 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f2a7f74e/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
index b97ca6e..7403215 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
@@ -39,6 +39,11 @@ public class NullOutputStream extends OutputStream {
 @Deprecated
 public static final NullOutputStream NULL_OUTPUT_STREAM = INSTANCE;
 
+/**
+ * Gets the singleton instance.
+ * 
+ * @return the singleton instance.
+ */
 public static NullOutputStream getInstance() {
 return INSTANCE;
 }



[29/35] logging-log4j2 git commit: Javadoc format nit.

2016-09-08 Thread rpopma
Javadoc format nit.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 36e6fd36929c65c41c02741a6322662644c6126f
Parents: 95d55e5
Author: Gary Gregory 
Authored: Thu Sep 8 00:51:37 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:51:37 2016 -0700

--
 .../apache/logging/log4j/core/appender/routing/PurgePolicy.java| 2 --
 1 file changed, 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/36e6fd36/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
index a90b6a8..2f7e100 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
@@ -19,9 +19,7 @@ package org.apache.logging.log4j.core.appender.routing;
 import org.apache.logging.log4j.core.LogEvent;
 
 /**
- * 
  * Policy for purging routed appenders
- *
  */
 public interface PurgePolicy {
 



[23/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-09-08 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: c513f13335895d89b455358e3eba8237626efe35
Parents: 0d201ad
Author: Gary Gregory 
Authored: Tue Sep 6 22:29:52 2016 -0400
Committer: Gary Gregory 
Committed: Tue Sep 6 22:29:52 2016 -0400

--
 .../logging/log4j/core/filter/LevelRangeFilter.java | 12 ++--
 1 file changed, 6 insertions(+), 6 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c513f133/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
index ff4ff26..fd78433 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
@@ -28,13 +28,13 @@ import 
org.apache.logging.log4j.core.config.plugins.PluginFactory;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * This filter returns the onMatch result if the level in the LogEvent is in 
the
- * range of the configured min and max levels, otherwise it returns onMismatch
- * value . For example, if the filter is configured with Level ERROR and Level
- * INFO and the LogEvent contains Level WARN then the onMatch value will be
- * returned since WARN events are in between ERROR and INFO.
+ * This filter returns the {@code onMatch} result if the level in the {@code 
LogEvent} is in the range of the configured
+ * min and max levels, otherwise it returns {@code onMismatch} value . For 
example, if the filter is configured with
+ * {@link Level#ERROR} and {@link Level#INFO} and the LogEvent contains {@link 
Level#WARN} then the onMatch value will
+ * be returned since {@link Level#WARN WARN} events are in between {@link 
Level#ERROR ERROR} and {@link Level#INFO
+ * INFO}.
  * 
- * The default Levels are both ERROR.
+ * The default Levels are both {@link Level#ERROR ERROR}.
  * 
  */
 @Plugin(name = "LevelRangeFilter", category = Node.CATEGORY, elementType = 
Filter.ELEMENT_TYPE, printObject = true)



[22/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-09-08 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 0d201adc02bc0768f1bc2f78e9665a434a902e8d
Parents: c24b2b1
Author: Gary Gregory 
Authored: Tue Sep 6 22:26:56 2016 -0400
Committer: Gary Gregory 
Committed: Tue Sep 6 22:26:56 2016 -0400

--
 .../org/apache/logging/log4j/core/filter/LevelRangeFilter.java| 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/0d201adc/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
index 2530c41..ff4ff26 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
@@ -33,8 +33,9 @@ import org.apache.logging.log4j.message.Message;
  * value . For example, if the filter is configured with Level ERROR and Level
  * INFO and the LogEvent contains Level WARN then the onMatch value will be
  * returned since WARN events are in between ERROR and INFO.
- *
+ * 
  * The default Levels are both ERROR.
+ * 
  */
 @Plugin(name = "LevelRangeFilter", category = Node.CATEGORY, elementType = 
Filter.ELEMENT_TYPE, printObject = true)
 public final class LevelRangeFilter extends AbstractFilter {



[37/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-09-08 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: f6bb2c3af967de70dbf8cde6498e996eaea67071
Parents: a559d5c
Author: ggregory 
Authored: Wed Sep 7 12:23:36 2016 -0400
Committer: ggregory 
Committed: Wed Sep 7 12:23:36 2016 -0400

--
 .../log4j/core/appender/AbstractManager.java| 424 +--
 1 file changed, 212 insertions(+), 212 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f6bb2c3a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
index edd82a2..acd2759 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
@@ -1,212 +1,212 @@
-/*
- * 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.core.appender;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.locks.Lock;
-import java.util.concurrent.locks.ReentrantLock;
-
-import org.apache.logging.log4j.Level;
-import org.apache.logging.log4j.Logger;
-import org.apache.logging.log4j.core.AbstractLifeCycle;
-import org.apache.logging.log4j.core.LoggerContext;
-import org.apache.logging.log4j.message.Message;
-import org.apache.logging.log4j.status.StatusLogger;
-
-/**
- * Abstract base class used to register managers.
- * 
- * This class implements {@link AutoCloseable} mostly to allow unit tests to 
be written safely and succinctly. While
- * managers do need to allocate resources (usually on construction) and then 
free these resources, a manager is longer
- * lived than other auto-closeable objects like streams. None the less, making 
a manager AutoCloseable forces readers to
- * be aware of the the pattern: allocate resources on construction and call 
{@link #close()} at some point.
- * 
- */
-public abstract class AbstractManager implements AutoCloseable {
-
-/**
- * Allow subclasses access to the status logger without creating another 
instance.
- */
-protected static final Logger LOGGER = StatusLogger.getLogger();
-
-// Need to lock that map instead of using a ConcurrentMap due to stop 
removing the
-// manager from the map and closing the stream, requiring the whole stop 
method to be locked.
-private static final Map MAP = new HashMap<>();
-
-private static final Lock LOCK = new ReentrantLock();
-
-/**
- * Number of Appenders using this manager.
- */
-protected int count;
-
-private final String name;
-
-private final LoggerContext loggerContext;
-
-protected AbstractManager(final LoggerContext loggerContext, final String 
name) {
-this.loggerContext = loggerContext;
-this.name = name;
-LOGGER.debug("Starting {} {}", this.getClass().getSimpleName(), name);
-}
-
-/**
- * Called to signify that this Manager is no longer required by an 
Appender.
- */
-@Override
-public void close() {
-stop(AbstractLifeCycle.DEFAULT_STOP_TIMEOUT, 
AbstractLifeCycle.DEFAULT_STOP_TIMEUNIT);
-}
-
-public void stop(final long timeout, final TimeUnit timeUnit) {
-LOCK.lock();
-try {
---count;
-if (count <= 0) {
-MAP.remove(name);
-LOGGER.debug("Shutting down {} {}", 
this.getClass().getSimpleName(), getName());
-

logging-log4j2 git commit: Javadoc nits.

2016-09-08 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 36e6fd369 -> ab63bc900


Javadoc nits.

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

Branch: refs/heads/master
Commit: ab63bc900d42602b6573cd6df3ae6c66124a26cf
Parents: 36e6fd3
Author: Gary Gregory 
Authored: Thu Sep 8 00:52:03 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:52:03 2016 -0700

--
 .../apache/logging/log4j/core/appender/routing/PurgePolicy.java  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/ab63bc90/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
index 2f7e100..b0c8c61 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
@@ -24,7 +24,7 @@ import org.apache.logging.log4j.core.LogEvent;
 public interface PurgePolicy {
 
/**
-* Activate purging appenders
+* Activates purging appenders
 */
void purge();

@@ -36,7 +36,7 @@ public interface PurgePolicy {
void update(String key, LogEvent event);
 
/**
-* Initialize with routing appender
+* Initializes with routing appender
 * 
 * @param routingAppender
 */



logging-log4j2 git commit: Javadoc format nit.

2016-09-08 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 95d55e5eb -> 36e6fd369


Javadoc format nit.

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

Branch: refs/heads/master
Commit: 36e6fd36929c65c41c02741a6322662644c6126f
Parents: 95d55e5
Author: Gary Gregory 
Authored: Thu Sep 8 00:51:37 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:51:37 2016 -0700

--
 .../apache/logging/log4j/core/appender/routing/PurgePolicy.java| 2 --
 1 file changed, 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/36e6fd36/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
index a90b6a8..2f7e100 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/routing/PurgePolicy.java
@@ -19,9 +19,7 @@ package org.apache.logging.log4j.core.appender.routing;
 import org.apache.logging.log4j.core.LogEvent;
 
 /**
- * 
  * Policy for purging routed appenders
- *
  */
 public interface PurgePolicy {
 



logging-log4j2 git commit: Javadoc: add @see tags.

2016-09-08 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 48e6ea0c1 -> 6b80565b5


Javadoc: add @see tags.

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

Branch: refs/heads/master
Commit: 6b80565b51f9ba146e5822cbb7643e57d4026a81
Parents: 48e6ea0
Author: Gary Gregory 
Authored: Thu Sep 8 00:27:22 2016 -0700
Committer: Gary Gregory 
Committed: Thu Sep 8 00:27:22 2016 -0700

--
 .../src/main/java/org/apache/logging/log4j/core/LifeCycle.java | 2 ++
 .../logging/log4j/core/appender/rolling/TriggeringPolicy.java  | 2 ++
 2 files changed, 4 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6b80565b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
index e6e5a10..7dc1a94 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
@@ -28,6 +28,8 @@ import java.util.concurrent.TimeUnit;
  * stopped, this goes into the {@link State#STOPPED} state. In most 
circumstances, implementation classes should
  * store their {@link State} in a {@code volatile} field or inside an
  * {@link java.util.concurrent.atomic.AtomicReference} dependent on 
synchronization and concurrency requirements.
+ * 
+ * @see AbstractLifeCycle
  */
 public interface LifeCycle {
 

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6b80565b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
index 0b032d6..f6fea59 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
@@ -23,6 +23,8 @@ import org.apache.logging.log4j.core.LogEvent;
  * A TriggeringPolicy controls the conditions under which rollover
  * occurs. Such conditions include time of day, file size, an
  * external event, the log request or a combination thereof.
+ * 
+ * @see AbstractTriggeringPolicy
  */
 public interface TriggeringPolicy extends LifeCycle {
 



logging-log4j2 git commit: Javadoc.

2016-09-07 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 35a1a72e2 -> f2a7f74ec


Javadoc.

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

Branch: refs/heads/master
Commit: f2a7f74ec4a438a5ae6d66940aa75292941a5281
Parents: 35a1a72
Author: Gary Gregory 
Authored: Wed Sep 7 20:56:19 2016 -0700
Committer: Gary Gregory 
Committed: Wed Sep 7 20:56:19 2016 -0700

--
 .../org/apache/logging/log4j/core/util/NullOutputStream.java| 5 +
 1 file changed, 5 insertions(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f2a7f74e/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
index b97ca6e..7403215 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/NullOutputStream.java
@@ -39,6 +39,11 @@ public class NullOutputStream extends OutputStream {
 @Deprecated
 public static final NullOutputStream NULL_OUTPUT_STREAM = INSTANCE;
 
+/**
+ * Gets the singleton instance.
+ * 
+ * @return the singleton instance.
+ */
 public static NullOutputStream getInstance() {
 return INSTANCE;
 }



[2/2] logging-log4j2 git commit: Javadoc.

2016-09-07 Thread ggregory
Javadoc.

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

Branch: refs/heads/master
Commit: 8f62ff4677728210668ef780aec527d05bd0cbbc
Parents: 94a5de3
Author: Gary Gregory 
Authored: Wed Sep 7 16:47:22 2016 -0700
Committer: Gary Gregory 
Committed: Wed Sep 7 16:47:22 2016 -0700

--
 .../logging/log4j/core/appender/rolling/TriggeringPolicy.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/8f62ff46/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
index 057aaa3..0b032d6 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
@@ -38,7 +38,7 @@ public interface TriggeringPolicy extends LifeCycle {
  * true is returned, RolloverPolicy.rollover will be called but it
  * can determine that a rollover is not warranted.
  *
- * @param logEvent   A reference to the currently event.
+ * @param logEvent   A reference to the current log event.
  * @return true if a rollover should occur.
  */
 boolean isTriggeringEvent(final LogEvent logEvent);



logging-log4j2 git commit: Javadoc.

2016-09-07 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master a559d5caf -> f6bb2c3af


Javadoc.

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

Branch: refs/heads/master
Commit: f6bb2c3af967de70dbf8cde6498e996eaea67071
Parents: a559d5c
Author: ggregory 
Authored: Wed Sep 7 12:23:36 2016 -0400
Committer: ggregory 
Committed: Wed Sep 7 12:23:36 2016 -0400

--
 .../log4j/core/appender/AbstractManager.java| 424 +--
 1 file changed, 212 insertions(+), 212 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/f6bb2c3a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
index edd82a2..acd2759 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
@@ -1,212 +1,212 @@
-/*
- * 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.core.appender;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.locks.Lock;
-import java.util.concurrent.locks.ReentrantLock;
-
-import org.apache.logging.log4j.Level;
-import org.apache.logging.log4j.Logger;
-import org.apache.logging.log4j.core.AbstractLifeCycle;
-import org.apache.logging.log4j.core.LoggerContext;
-import org.apache.logging.log4j.message.Message;
-import org.apache.logging.log4j.status.StatusLogger;
-
-/**
- * Abstract base class used to register managers.
- * 
- * This class implements {@link AutoCloseable} mostly to allow unit tests to 
be written safely and succinctly. While
- * managers do need to allocate resources (usually on construction) and then 
free these resources, a manager is longer
- * lived than other auto-closeable objects like streams. None the less, making 
a manager AutoCloseable forces readers to
- * be aware of the the pattern: allocate resources on construction and call 
{@link #close()} at some point.
- * 
- */
-public abstract class AbstractManager implements AutoCloseable {
-
-/**
- * Allow subclasses access to the status logger without creating another 
instance.
- */
-protected static final Logger LOGGER = StatusLogger.getLogger();
-
-// Need to lock that map instead of using a ConcurrentMap due to stop 
removing the
-// manager from the map and closing the stream, requiring the whole stop 
method to be locked.
-private static final Map MAP = new HashMap<>();
-
-private static final Lock LOCK = new ReentrantLock();
-
-/**
- * Number of Appenders using this manager.
- */
-protected int count;
-
-private final String name;
-
-private final LoggerContext loggerContext;
-
-protected AbstractManager(final LoggerContext loggerContext, final String 
name) {
-this.loggerContext = loggerContext;
-this.name = name;
-LOGGER.debug("Starting {} {}", this.getClass().getSimpleName(), name);
-}
-
-/**
- * Called to signify that this Manager is no longer required by an 
Appender.
- */
-@Override
-public void close() {
-stop(AbstractLifeCycle.DEFAULT_STOP_TIMEOUT, 
AbstractLifeCycle.DEFAULT_STOP_TIMEUNIT);
-}
-
-public void stop(final long timeout, final TimeUnit timeUnit) {
-LOCK.lock();
-try {
---count;
-if (count <= 0) {
-MAP.remove(name);
-LOGGER.debug("Shutting down {} {}", 

logging-log4j2 git commit: Javadoc.

2016-09-06 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 0d201adc0 -> c513f1333


Javadoc.

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

Branch: refs/heads/master
Commit: c513f13335895d89b455358e3eba8237626efe35
Parents: 0d201ad
Author: Gary Gregory 
Authored: Tue Sep 6 22:29:52 2016 -0400
Committer: Gary Gregory 
Committed: Tue Sep 6 22:29:52 2016 -0400

--
 .../logging/log4j/core/filter/LevelRangeFilter.java | 12 ++--
 1 file changed, 6 insertions(+), 6 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/c513f133/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
index ff4ff26..fd78433 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
@@ -28,13 +28,13 @@ import 
org.apache.logging.log4j.core.config.plugins.PluginFactory;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * This filter returns the onMatch result if the level in the LogEvent is in 
the
- * range of the configured min and max levels, otherwise it returns onMismatch
- * value . For example, if the filter is configured with Level ERROR and Level
- * INFO and the LogEvent contains Level WARN then the onMatch value will be
- * returned since WARN events are in between ERROR and INFO.
+ * This filter returns the {@code onMatch} result if the level in the {@code 
LogEvent} is in the range of the configured
+ * min and max levels, otherwise it returns {@code onMismatch} value . For 
example, if the filter is configured with
+ * {@link Level#ERROR} and {@link Level#INFO} and the LogEvent contains {@link 
Level#WARN} then the onMatch value will
+ * be returned since {@link Level#WARN WARN} events are in between {@link 
Level#ERROR ERROR} and {@link Level#INFO
+ * INFO}.
  * 
- * The default Levels are both ERROR.
+ * The default Levels are both {@link Level#ERROR ERROR}.
  * 
  */
 @Plugin(name = "LevelRangeFilter", category = Node.CATEGORY, elementType = 
Filter.ELEMENT_TYPE, printObject = true)



logging-log4j2 git commit: Javadoc.

2016-09-06 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master c24b2b1c7 -> 0d201adc0


Javadoc.

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

Branch: refs/heads/master
Commit: 0d201adc02bc0768f1bc2f78e9665a434a902e8d
Parents: c24b2b1
Author: Gary Gregory 
Authored: Tue Sep 6 22:26:56 2016 -0400
Committer: Gary Gregory 
Committed: Tue Sep 6 22:26:56 2016 -0400

--
 .../org/apache/logging/log4j/core/filter/LevelRangeFilter.java| 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/0d201adc/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
index 2530c41..ff4ff26 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/LevelRangeFilter.java
@@ -33,8 +33,9 @@ import org.apache.logging.log4j.message.Message;
  * value . For example, if the filter is configured with Level ERROR and Level
  * INFO and the LogEvent contains Level WARN then the onMatch value will be
  * returned since WARN events are in between ERROR and INFO.
- *
+ * 
  * The default Levels are both ERROR.
+ * 
  */
 @Plugin(name = "LevelRangeFilter", category = Node.CATEGORY, elementType = 
Filter.ELEMENT_TYPE, printObject = true)
 public final class LevelRangeFilter extends AbstractFilter {



logging-log4j2 git commit: Javadoc.

2016-09-05 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master b1befb553 -> b569d1d7b


Javadoc.

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

Branch: refs/heads/master
Commit: b569d1d7b818d2fc80061d2bb4cb8c3043134f10
Parents: b1befb5
Author: Gary Gregory 
Authored: Mon Sep 5 16:22:35 2016 -0400
Committer: Gary Gregory 
Committed: Mon Sep 5 16:22:35 2016 -0400

--
 .../org/apache/logging/log4j/core/appender/AbstractManager.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/b569d1d7/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
index 4855a12..0a036a0 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/AbstractManager.java
@@ -158,7 +158,7 @@ public abstract class AbstractManager implements 
AutoCloseable {
 
 /**
  * Called to signify that this Manager is no longer required by an 
Appender.
- * @deprecated Use {@link #close()}.
+ * @deprecated In 2.7, use {@link #close()}.
  */
 @Deprecated
 public void release() {



logging-log4j2 git commit: Javadoc.

2016-09-05 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 2e3a17282 -> b1befb553


Javadoc.

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

Branch: refs/heads/master
Commit: b1befb55343c563a769f57091159ef8598caa985
Parents: 2e3a172
Author: Gary Gregory 
Authored: Mon Sep 5 16:07:23 2016 -0400
Committer: Gary Gregory 
Committed: Mon Sep 5 16:07:23 2016 -0400

--
 .../src/main/java/org/apache/logging/log4j/core/LifeCycle.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/b1befb55/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
index 9311487..e6e5a10 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/LifeCycle.java
@@ -68,7 +68,7 @@ public interface LifeCycle {
  * 
  * @param timeout the maximum time to wait
  * @param timeUnit the time unit of the timeout argument
- * @return 
+ * @return true if the receiver was stopped cleanly and normally, false 
otherwise.
  */
 boolean stop(long timeout, TimeUnit timeUnit);
 



[32/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-08-28 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1528
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[41/50] [abbrv] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-28 Thread rpopma
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1528
Commit: bc085f22a5c43d61355ee31154b57a9612173799
Parents: 82032fc
Author: Gary Gregory 
Authored: Fri Aug 26 21:52:29 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 21:52:29 2016 -0700

--
 .../apache/logging/log4j/core/filter/DynamicThresholdFilter.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bc085f22/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
index 8072e7c..f63e416 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
@@ -35,13 +35,13 @@ import org.apache.logging.log4j.core.util.KeyValuePair;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * Compare against a log level that is associated with an MDC value.
+ * Compares against a log level that is associated with an MDC value.
  */
 @Plugin(name = "DynamicThresholdFilter", category = Node.CATEGORY, elementType 
= Filter.ELEMENT_TYPE, printObject = true)
 public final class DynamicThresholdFilter extends AbstractFilter {
 
 /**
- * Create the DynamicThresholdFilter.
+ * Creates a DynamicThresholdFilter.
  * @param key The name of the key to compare.
  * @param pairs An array of value and Level pairs.
  * @param defaultThreshold The default Level.



[35/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-08-27 Thread mikes
Javadoc.

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

Branch: refs/heads/LOG4J-1181
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[44/50] [abbrv] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-27 Thread mikes
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J-1181
Commit: bc085f22a5c43d61355ee31154b57a9612173799
Parents: 82032fc
Author: Gary Gregory 
Authored: Fri Aug 26 21:52:29 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 21:52:29 2016 -0700

--
 .../apache/logging/log4j/core/filter/DynamicThresholdFilter.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bc085f22/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
index 8072e7c..f63e416 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
@@ -35,13 +35,13 @@ import org.apache.logging.log4j.core.util.KeyValuePair;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * Compare against a log level that is associated with an MDC value.
+ * Compares against a log level that is associated with an MDC value.
  */
 @Plugin(name = "DynamicThresholdFilter", category = Node.CATEGORY, elementType 
= Filter.ELEMENT_TYPE, printObject = true)
 public final class DynamicThresholdFilter extends AbstractFilter {
 
 /**
- * Create the DynamicThresholdFilter.
+ * Creates a DynamicThresholdFilter.
  * @param key The name of the key to compare.
  * @param pairs An array of value and Level pairs.
  * @param defaultThreshold The default Level.



[38/50] [abbrv] logging-log4j2 git commit: Javadoc.

2016-08-27 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1512
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[37/42] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-27 Thread rpopma
Javadoc: Use the active voice.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: bc085f22a5c43d61355ee31154b57a9612173799
Parents: 82032fc
Author: Gary Gregory 
Authored: Fri Aug 26 21:52:29 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 21:52:29 2016 -0700

--
 .../apache/logging/log4j/core/filter/DynamicThresholdFilter.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bc085f22/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
index 8072e7c..f63e416 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
@@ -35,13 +35,13 @@ import org.apache.logging.log4j.core.util.KeyValuePair;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * Compare against a log level that is associated with an MDC value.
+ * Compares against a log level that is associated with an MDC value.
  */
 @Plugin(name = "DynamicThresholdFilter", category = Node.CATEGORY, elementType 
= Filter.ELEMENT_TYPE, printObject = true)
 public final class DynamicThresholdFilter extends AbstractFilter {
 
 /**
- * Create the DynamicThresholdFilter.
+ * Creates a DynamicThresholdFilter.
  * @param key The name of the key to compare.
  * @param pairs An array of value and Level pairs.
  * @param defaultThreshold The default Level.



[28/42] logging-log4j2 git commit: Javadoc.

2016-08-27 Thread rpopma
Javadoc.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[28/40] logging-log4j2 git commit: Javadoc.

2016-08-27 Thread rpopma
Javadoc.

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

Branch: 
refs/heads/LOG4J2-1010
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[37/40] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-27 Thread rpopma
Javadoc: Use the active voice.

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

Branch: 
refs/heads/LOG4J2-1010
Commit: bc085f22a5c43d61355ee31154b57a9612173799
Parents: 82032fc
Author: Gary Gregory 
Authored: Fri Aug 26 21:52:29 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 21:52:29 2016 -0700

--
 .../apache/logging/log4j/core/filter/DynamicThresholdFilter.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bc085f22/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
index 8072e7c..f63e416 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
@@ -35,13 +35,13 @@ import org.apache.logging.log4j.core.util.KeyValuePair;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * Compare against a log level that is associated with an MDC value.
+ * Compares against a log level that is associated with an MDC value.
  */
 @Plugin(name = "DynamicThresholdFilter", category = Node.CATEGORY, elementType 
= Filter.ELEMENT_TYPE, printObject = true)
 public final class DynamicThresholdFilter extends AbstractFilter {
 
 /**
- * Create the DynamicThresholdFilter.
+ * Creates a DynamicThresholdFilter.
  * @param key The name of the key to compare.
  * @param pairs An array of value and Level pairs.
  * @param defaultThreshold The default Level.



logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-26 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 82032fc6a -> bc085f22a


Javadoc: Use the active voice.

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

Branch: refs/heads/master
Commit: bc085f22a5c43d61355ee31154b57a9612173799
Parents: 82032fc
Author: Gary Gregory 
Authored: Fri Aug 26 21:52:29 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 21:52:29 2016 -0700

--
 .../apache/logging/log4j/core/filter/DynamicThresholdFilter.java | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/bc085f22/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
index 8072e7c..f63e416 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/filter/DynamicThresholdFilter.java
@@ -35,13 +35,13 @@ import org.apache.logging.log4j.core.util.KeyValuePair;
 import org.apache.logging.log4j.message.Message;
 
 /**
- * Compare against a log level that is associated with an MDC value.
+ * Compares against a log level that is associated with an MDC value.
  */
 @Plugin(name = "DynamicThresholdFilter", category = Node.CATEGORY, elementType 
= Filter.ELEMENT_TYPE, printObject = true)
 public final class DynamicThresholdFilter extends AbstractFilter {
 
 /**
- * Create the DynamicThresholdFilter.
+ * Creates a DynamicThresholdFilter.
  * @param key The name of the key to compare.
  * @param pairs An array of value and Level pairs.
  * @param defaultThreshold The default Level.



[08/10] logging-log4j2 git commit: Javadoc.

2016-08-26 Thread ggregory
Javadoc.

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

Branch: refs/heads/LOG4J2-1539
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



logging-log4j2 git commit: Javadoc.

2016-08-26 Thread ggregory
Repository: logging-log4j2
Updated Branches:
  refs/heads/master 213a24768 -> 498eef556


Javadoc.

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

Branch: refs/heads/master
Commit: 498eef5569a93606cb4784f20e51c4b93cf40bd3
Parents: 213a247
Author: Gary Gregory 
Authored: Fri Aug 26 08:55:33 2016 -0700
Committer: Gary Gregory 
Committed: Fri Aug 26 08:55:33 2016 -0700

--
 .../logging/log4j/core/config/xml/XmlConfigurationFactory.java  | 1 +
 1 file changed, 1 insertion(+)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/498eef55/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
index 9de84aa..a37718f 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/XmlConfigurationFactory.java
@@ -37,6 +37,7 @@ public class XmlConfigurationFactory extends 
ConfigurationFactory {
 
 /**
  * Returns the Configuration.
+ * @param loggerContext The logger context.
  * @param source The InputSource.
  * @return The Configuration.
  */



[06/31] logging-log4j2 git commit: Javadoc says: "@deprecated Will be removed in 2.5." and 2.6.2 is the current release.

2016-08-23 Thread ggregory
Javadoc says: "@deprecated Will be removed in 2.5." and 2.6.2 is the
current release.

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

Branch: refs/heads/LOG4J2-1539
Commit: cee9414b1a639e384df5f3dacb33b2e8e6e1737b
Parents: b7da5e7
Author: Gary Gregory 
Authored: Mon Aug 22 22:35:50 2016 -0700
Committer: Gary Gregory 
Committed: Mon Aug 22 22:35:50 2016 -0700

--
 .../apache/logging/log4j/core/util/Assert.java  | 36 
 1 file changed, 36 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/cee9414b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
index ff5b1e3..d2ddf81 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
@@ -31,40 +31,4 @@ public final class Assert {
 }
 return value;
 }
-
-/**
- * Throws a {@code NullPointerException} if the specified parameter is
- * {@code null}, otherwise returns the specified parameter.
- * 
- * On Java 7, just use {@code Objects.requireNonNull(T, String)}
- * 
- * 
- * Usage:
- * 
- * 
- * // earlier you would write this:
- * public SomeConstructor(Object param) {
- * if (param == null) {
- * throw new NullPointerException(param);
- * }
- * this.field = param;
- * }
- *
- * // now you can do the same in one line:
- * public SomeConstructor(Object param) {
- * this.field = Assert.requireNonNull(param);
- * }
- * 
- *
- * @param  the type of the parameter to check and return
- * @param object the parameter to check
- * @param message message to populate the NPE with if necessary
- * @return the specified parameter
- * @throws NullPointerException if {@code object} is {@code null}
- * @deprecated Will be removed in 2.5.
- */
-@Deprecated
-public static  T requireNonNull(final T object, final String message) {
-return Objects.requireNonNull(object, message);
-}
 }



[09/31] logging-log4j2 git commit: Javadoc nit.

2016-08-23 Thread ggregory
Javadoc nit.

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

Branch: refs/heads/LOG4J2-1539
Commit: 99c96e70571854d7377fcdd9a4a498c2cf310cec
Parents: aeea0bc
Author: Gary Gregory 
Authored: Mon Aug 22 22:48:44 2016 -0700
Committer: Gary Gregory 
Committed: Mon Aug 22 22:48:44 2016 -0700

--
 .../java/org/apache/logging/log4j/core/config/LoggerConfig.java| 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/99c96e70/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
index 97db13f..02fe245 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/config/LoggerConfig.java
@@ -433,7 +433,7 @@ public class LoggerConfig extends AbstractFilterable {
 /**
  * Factory method to create a LoggerConfig.
  *
- * @param additivity True if additive, false otherwise.
+ * @param additivity true if additive, false otherwise.
  * @param level The Level to be associated with the Logger.
  * @param loggerName The name of the Logger.
  * @param includeLocation whether location should be passed downstream



[03/22] logging-log4j2 git commit: Javadoc: Use the active voice.

2016-08-23 Thread rpopma
Javadoc: Use the active voice.

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

Branch: 
refs/heads/LOG4J2-1010
Commit: b6ec60158b32d76cdd427615718866340f806f12
Parents: d145cdb
Author: Gary Gregory 
Authored: Mon Aug 22 16:34:36 2016 -0700
Committer: Gary Gregory 
Committed: Mon Aug 22 16:34:36 2016 -0700

--
 .../logging/log4j/core/appender/rolling/TriggeringPolicy.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/b6ec6015/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
index 9f3001c..21181e5 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
@@ -26,7 +26,7 @@ import org.apache.logging.log4j.core.LogEvent;
 public interface TriggeringPolicy {
 
 /**
- * Initialize the Policy.
+ * Initializes the Policy.
  * @param manager The RollingFileManager.
  */
 



[10/22] logging-log4j2 git commit: Javadoc says: "@deprecated Will be removed in 2.5." and 2.6.2 is the current release.

2016-08-23 Thread rpopma
Javadoc says: "@deprecated Will be removed in 2.5." and 2.6.2 is the
current release.

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

Branch: 
refs/heads/LOG4J2-1010
Commit: cee9414b1a639e384df5f3dacb33b2e8e6e1737b
Parents: b7da5e7
Author: Gary Gregory 
Authored: Mon Aug 22 22:35:50 2016 -0700
Committer: Gary Gregory 
Committed: Mon Aug 22 22:35:50 2016 -0700

--
 .../apache/logging/log4j/core/util/Assert.java  | 36 
 1 file changed, 36 deletions(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/cee9414b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
index ff5b1e3..d2ddf81 100644
--- a/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
+++ b/log4j-core/src/main/java/org/apache/logging/log4j/core/util/Assert.java
@@ -31,40 +31,4 @@ public final class Assert {
 }
 return value;
 }
-
-/**
- * Throws a {@code NullPointerException} if the specified parameter is
- * {@code null}, otherwise returns the specified parameter.
- * 
- * On Java 7, just use {@code Objects.requireNonNull(T, String)}
- * 
- * 
- * Usage:
- * 
- * 
- * // earlier you would write this:
- * public SomeConstructor(Object param) {
- * if (param == null) {
- * throw new NullPointerException(param);
- * }
- * this.field = param;
- * }
- *
- * // now you can do the same in one line:
- * public SomeConstructor(Object param) {
- * this.field = Assert.requireNonNull(param);
- * }
- * 
- *
- * @param  the type of the parameter to check and return
- * @param object the parameter to check
- * @param message message to populate the NPE with if necessary
- * @return the specified parameter
- * @throws NullPointerException if {@code object} is {@code null}
- * @deprecated Will be removed in 2.5.
- */
-@Deprecated
-public static  T requireNonNull(final T object, final String message) {
-return Objects.requireNonNull(object, message);
-}
 }



[04/23] logging-log4j2 git commit: Javadoc: Hopefully oh so slightly nicer comment.

2016-08-23 Thread rpopma
Javadoc: Hopefully oh so slightly nicer comment.

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

Branch: refs/heads/LOG4J2-1349-gcfree-threadcontext
Commit: 7eba2e962fd8f4a89ee25be66ddbf34115f85ace
Parents: b6ec601
Author: Gary Gregory 
Authored: Mon Aug 22 16:35:34 2016 -0700
Committer: Gary Gregory 
Committed: Mon Aug 22 16:35:34 2016 -0700

--
 .../logging/log4j/core/appender/rolling/TriggeringPolicy.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
--


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/7eba2e96/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
--
diff --git 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
index 21181e5..412099b 100644
--- 
a/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
+++ 
b/log4j-core/src/main/java/org/apache/logging/log4j/core/appender/rolling/TriggeringPolicy.java
@@ -26,7 +26,7 @@ import org.apache.logging.log4j.core.LogEvent;
 public interface TriggeringPolicy {
 
 /**
- * Initializes the Policy.
+ * Initializes this triggering policy.
  * @param manager The RollingFileManager.
  */
 



  1   2   3   >