You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by kk...@apache.org on 2020/11/18 20:45:38 UTC
[tomcat] branch 9.0.x updated: Bug 64931 - Implement validation of
changelog.xml file at build time.
This is an automated email from the ASF dual-hosted git repository.
kkolinko pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push:
new 694575d Bug 64931 - Implement validation of changelog.xml file at build time.
694575d is described below
commit 694575d986e60d58b50310326281fe07683c9a0b
Author: Konstantin Kolinko <kk...@apache.org>
AuthorDate: Wed Nov 18 20:28:56 2020 +0300
Bug 64931 - Implement validation of changelog.xml file at build time.
Validation is performed against an inline DTD.
---
build.xml | 5 ++++
webapps/docs/changelog.xml | 65 +++++++++++++++++++++++++++++++++++++++++++++-
2 files changed, 69 insertions(+), 1 deletion(-)
diff --git a/build.xml b/build.xml
index 56a9701..e0a2975 100644
--- a/build.xml
+++ b/build.xml
@@ -1249,6 +1249,11 @@
<target name="build-docs" depends="compile-prepare" description="Builds all documentation from XML sources">
+ <!-- Validation of changelog.xml -->
+ <xmlvalidate
+ file="webapps/docs/changelog.xml"
+ />
+
<copy todir="${tomcat.build}/webapps">
<fileset dir="webapps">
<include name="docs/images/**"/>
diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 63d586a..2d62b47 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -17,6 +17,65 @@
-->
<!DOCTYPE document [
<!ENTITY project SYSTEM "project.xml">
+
+ <!-- DTD is used to validate changelog structure at build time. BZ 64931. -->
+
+ <!ELEMENT document (project?, properties, body)>
+ <!ATTLIST document url CDATA #REQUIRED>
+
+ <!-- body and title are used both in project.xml and in this document -->
+ <!ELEMENT body ANY>
+ <!ELEMENT title (#PCDATA)>
+
+ <!-- Elements of project.xml -->
+ <!ELEMENT project (title, logo, body)>
+ <!ATTLIST project name CDATA #REQUIRED>
+ <!ATTLIST project href CDATA #REQUIRED>
+
+ <!ELEMENT logo (#PCDATA)>
+ <!ATTLIST logo href CDATA #REQUIRED>
+
+ <!ELEMENT menu (item+)>
+ <!ATTLIST menu name CDATA #REQUIRED>
+
+ <!ELEMENT item EMPTY>
+ <!ATTLIST item name CDATA #REQUIRED>
+ <!ATTLIST item href CDATA #REQUIRED>
+
+ <!-- Elements of this document -->
+ <!ELEMENT properties (author*, title, no-comments) >
+ <!ELEMENT author (#PCDATA)>
+ <!ATTLIST author email CDATA #IMPLIED>
+ <!ELEMENT no-comments EMPTY>
+
+ <!ELEMENT section (subsection)*>
+ <!ATTLIST section name CDATA #REQUIRED>
+ <!ATTLIST section rtext CDATA #IMPLIED>
+
+ <!ELEMENT subsection (changelog+)>
+ <!ATTLIST subsection name CDATA #REQUIRED>
+
+ <!ELEMENT changelog (add|update|fix|scode|docs|design)*>
+ <!ELEMENT add ANY>
+ <!ELEMENT update ANY>
+ <!ELEMENT fix ANY>
+ <!ELEMENT scode ANY>
+ <!ELEMENT docs ANY>
+ <!ELEMENT design ANY>
+
+ <!ELEMENT bug (#PCDATA)>
+ <!ELEMENT rev (#PCDATA)>
+
+ <!-- Random HTML markup tags. Add more here as needed. -->
+ <!ELEMENT a (#PCDATA)>
+ <!ATTLIST a href CDATA #REQUIRED>
+ <!ATTLIST a rel CDATA #IMPLIED>
+
+ <!ELEMENT b (#PCDATA)>
+ <!ELEMENT code (#PCDATA)>
+ <!ELEMENT em (#PCDATA)>
+ <!ELEMENT strong (#PCDATA)>
+ <!ELEMENT tt (#PCDATA)>
]>
<?xml-stylesheet type="text/xsl" href="tomcat-docs.xsl"?>
<document url="changelog.html">
@@ -38,7 +97,7 @@
Fixes having an issue number are sorted by their number, ascending.
- There is no ordering by add/update/fix/scode.
+ There is no ordering by add/update/fix/scode/docs/design.
Other fixed issues are added to the end of the list, chronologically.
They eventually become mixed with the numbered issues (i.e., numbered
@@ -53,6 +112,10 @@
<update>
Update the CXF module to Apache CXF 3.4.1. (remm)
</update>
+ <add>
+ <bug>64931</bug>: Implement validation of <code>changelog.xml</code>
+ file at build time. (kkolinko)
+ </add>
</changelog>
</subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org