You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by vy...@apache.org on 2024/03/19 10:45:04 UTC
(logging-site) 03/03: Explain XSD versioning
This is an automated email from the ASF dual-hosted git repository.
vy pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/logging-site.git
commit 69968e5303be57fc4350c0f1788664623466ab72
Author: Volkan Yazıcı <vo...@yazi.ci>
AuthorDate: Tue Mar 19 11:44:42 2024 +0100
Explain XSD versioning
---
xml/ns/index.adoc | 17 +++++++++++++++--
1 file changed, 15 insertions(+), 2 deletions(-)
diff --git a/xml/ns/index.adoc b/xml/ns/index.adoc
index d781f00f..c8c5084b 100644
--- a/xml/ns/index.adoc
+++ b/xml/ns/index.adoc
@@ -20,6 +20,15 @@
All XML Schemas for Apache Logging Services projects are published at this directory.
The canonical name for this directory is `https://logging.apache.org/xml/ns`.
+[IMPORTANT]
+====
+There are two important things to understand about XSD versioning scheme used here to employ these schemas in your applications:
+
+. *Schema versions and project versions evolve independently.*
+That is, Log4j `2.24.0` release does not necessarily mean a new `log4j-config-2.24.0.xsd`: the Log4j 2 runtime configuration API might have been kept intact.
+. *Users are recommended to use schemas with only major versions*; `log4j-config-2.xsd`, `log4j-changelog-0.xsd`, etc.
+====
+
[#log4j2]
== Log4j 2 schemas
@@ -48,7 +57,9 @@ Following schemas model the Log4j runtime configuration, i.e., `log4j2.xml`.
<?xml version="1.0" encoding="UTF-8"?>
<Configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://logging.apache.org/xml/ns"
- xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+ xsi:schemaLocation="
+ https://logging.apache.org/xml/ns
+ https://logging.apache.org/xml/ns/log4j-config-2.xsd">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d [%t] %p %c - %m%n"/>
@@ -106,7 +117,9 @@ It is designed for Apache Log4j, but can be used for any Java project.
<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="https://logging.apache.org/xml/ns"
- xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
+ xsi:schemaLocation="
+ https://logging.apache.org/xml/ns
+ https://logging.apache.org/xml/ns/log4j-changelog-0.xsd"
type="updated">
<issue id="2370" link="https://github.com/apache/logging-log4j2/pull/2370"/>
<description format="asciidoc">Update `actions/checkout` to version `4.1.2`</description>