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 v2 2/2] glep-0068: Indicate that unknown elements should be ignored
Date: Thu, 13 Oct 2022 04:57:34
Message-Id: 20221013045701.277934-2-mgorny@gentoo.org
In Reply to: [gentoo-dev] [PATCH v2 1/2] glep-0068: Clarify and restrict XML data 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 6790e91..0906d3c 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