Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev@l.g.o
Cc: "Michał Górny" <mgorny@g.o>
Subject: [gentoo-dev] [PATCH 2/2] glep-0068: Indicate that unknown elements should be ignored
Date: Sat, 08 Oct 2022 06:41:09
Message-Id: 20221008064021.60348-3-mgorny@gentoo.org
In Reply to: [gentoo-dev] [PATCH 0/2] glep-0068: Stricten the XML format by "Michał Górny"
1 As originally stated, the GLEP did not permit extending the format.
2 Let's relax the requirement to conforming files but indicate that
3 the parsers should ignore unknown (i.e. future) elements.
4
5 Signed-off-by: Michał Górny <mgorny@g.o>
6 ---
7 glep-0068.rst | 2 ++
8 1 file changed, 2 insertions(+)
9
10 diff --git a/glep-0068.rst b/glep-0068.rst
11 index d3e3611..45ca30f 100644
12 --- a/glep-0068.rst
13 +++ b/glep-0068.rst
14 @@ -67,6 +67,8 @@ must not fetch or process it.
15 The data structure of metadata files is defined in this GLEP. The elements
16 and attributes do not use namespaces. Conforming files must not contain
17 any elements or attributes that are not defined in this specification.
18 +However, parsers should ignore any unknown elements or attributes in order
19 +to permit future extension.
20
21 Category metadata files are named ``metadata.xml`` and located inside category
22 directories in an ebuild repository. Their structure is described
23 --
24 2.38.0