docbook-xml-dtd4: clean up LICENSE situation

Don't use the common 'OASIS' license, as this isn't a SPDX license and
is in fact specifically the DocBook XML v4 license text.

Instead, use NO_GENERIC_LICENSE to ship a custom license file. We still
need to ship a copy of it in-tree because the license code needs a bare
copy of the license text.  Reference the in-tree license text in the
license checksum to show that we've verified they match.

Also, clean up some comments.

Thanks to hongxu.jia@eng.windriver.com for a previous iteration of this.

(From OE-Core rev: d04db152a512f564566a4205db6fe788fcbadde2)

Signed-off-by: Ross Burton <ross.burton@arm.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Ross Burton
2025-03-17 12:51:58 +00:00
committed by Richard Purdie
parent cc5e31ceab
commit a0bf911c68
2 changed files with 5 additions and 24 deletions

View File

@@ -10,7 +10,3 @@ If you modify the DocBook DTD in any way, except for declaring and
referencing additional sets of general entities and declaring
additional notations, label your DTD as a variant of DocBook. See
the maintenance documentation for more information.
Please direct all questions, bug reports, or suggestions for
changes to the docbook@lists.oasis-open.org mailing list. For more
information, see http://www.oasis-open.org/docbook/.

View File

@@ -3,28 +3,13 @@ DESCRIPTION = "Document type definitions for verification of XML data \
files against the DocBook rule set."
HOMEPAGE = "https://docbook.org"
# The upstream sources are not distributed with a license file.
# LICENSE-OASIS is included as a "patch" to workaround this. When
# upgrading this recipe, please verify whether this is still needed.
LICENSE = "DocBook"
NO_GENERIC_LICENSE[DocBook] = "LICENSE-OASIS"
LICENSE = "OASIS"
LIC_FILES_CHKSUM = "file://${S}/LICENSE-OASIS;md5=c608985dd5f7f215e669e7639a0b1d2e"
# To support apps with xml schema backward compatibility, we must
# install a set of schemas. Install the latest based on PV and then
# name any specific versions as required. TODO: Figure out a mechanism
# to filter exactly which versions are necessary, if that's even
# possible.
#
# DocBook.org lists available release packages at https://docbook.org/xml/.
#
# The release packages relate docbook source at
# https://github.com/docbook/docbook but building them requires the
# Gradle build system. In future, it might be safer to use the source
# tree which would also enable proper SBOM generation through the
# bitbake build system.
#
LIC_FILES_CHKSUM = "file://docbook-4.5/docbookx.dtd;beginline=15;endline=30;md5=ab12da76ad94a41d04e1587693ebd9b6 \
file://LICENSE-OASIS;md5=b9ee6208caa6e66c68dfad6f31d73f92"
# Install the latest 4.5 DTDs, and the previous releases for backward compatibility.
SRC_URI = "https://docbook.org/xml/4.1.2/docbkx412.zip;name=payload412;subdir=docbook-4.1.2 \
https://docbook.org/xml/4.2/docbook-xml-4.2.zip;name=payload42;subdir=docbook-4.2 \
https://docbook.org/xml/4.3/docbook-xml-4.3.zip;name=payload43;subdir=docbook-4.3 \