[logging-log4j2] branch master updated: LOG4J2-2810 - Add information about using a URL in log4j.configurationFile

[rg...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rgoers pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git


The following commit(s) were added to refs/heads/master by this push:
     new 808bfeb  LOG4J2-2810 - Add information about using a URL in log4j.configurationFile
808bfeb is described below

commit 808bfeb4da024ba04edf3ddef0f2aaaf148c9d41
Author: Ralph Goers <rg...@apache.org>
AuthorDate: Fri Apr 17 16:08:10 2020 -0700

    LOG4J2-2810 - Add information about using a URL in log4j.configurationFile
---
 src/changes/changes.xml                     | 3 +++
 src/site/asciidoc/manual/configuration.adoc | 8 ++++++--
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index d0a864a..2f60ba9 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -169,6 +169,9 @@
       </action>
     </release>
     <release version="2.13.2" date="2020-MM-DD" description="GA Release 2.13.2">
+      <action issue="LOG4J2-2810" dev="rgoers" type="fix">
+        Add information about using a url in log4j.configurationFile.
+      </action>
       <action issue="LOG4J2-2813" dev="rgoers" type="fix" due-to="Keith D Gregory">
         serializeToBytes was checking wrong variable for null.
       </action>
diff --git a/src/site/asciidoc/manual/configuration.adoc b/src/site/asciidoc/manual/configuration.adoc
index dd0fdff..33d713b 100644
--- a/src/site/asciidoc/manual/configuration.adoc
+++ b/src/site/asciidoc/manual/configuration.adoc
@@ -55,7 +55,9 @@ for properties, and one for XML.
 
 1.  Log4j will inspect the `"log4j.configurationFile"` system property
 and, if set, will attempt to load the configuration using the
-`ConfigurationFactory` that matches the file extension.
+`ConfigurationFactory` that matches the file extension. Note that this
+is not restricted to a location on the local file system and may contain
+a URL.
 2.  If no system property is set the properties ConfigurationFactory
 will look for `log4j2-test.properties` in the classpath.
 3.  If no such file is found the YAML ConfigurationFactory will look for
@@ -1677,7 +1679,9 @@ variable; and _Legacy Property Name_ for the pre-2.10 name.
 |LOG4J_CONFIGURATION_FILE
 | 
 |Path to an Log4j 2 configuration file. May
-also contain a comma separated list of configuration file names.
+also contain a comma separated list of configuration file names. May contain a URL.
+When specified as a URL the "override" query parameter may be used to specify additional
+configuration file locations.
 
 |[[debug]]log4j2.debug +
 ([[log4j2.debug]]log4j2.debug)