From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 89103158094 for ; Sat, 8 Oct 2022 06:41:09 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 48FB0E09C9; Sat, 8 Oct 2022 06:40:28 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 16950E09C1 for ; Sat, 8 Oct 2022 06:40:28 +0000 (UTC) From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Cc: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Subject: [gentoo-dev] [PATCH 2/2] glep-0068: Indicate that unknown elements should be ignored Date: Sat, 8 Oct 2022 08:40:21 +0200 Message-Id: <20221008064021.60348-3-mgorny@gentoo.org> X-Mailer: git-send-email 2.38.0 In-Reply-To: <20221008064021.60348-1-mgorny@gentoo.org> References: <20221008064021.60348-1-mgorny@gentoo.org> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: 0a294008-a8dd-408d-b1ef-34fce5588745 X-Archives-Hash: e92bb9bc46b908e31429d8a33f888fda As originally stated, the GLEP did not permit extending the format. Let's relax the requirement to conforming files but indicate that the parsers should ignore unknown (i.e. future) elements. Signed-off-by: Michał Górny --- glep-0068.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/glep-0068.rst b/glep-0068.rst index d3e3611..45ca30f 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -67,6 +67,8 @@ must not fetch or process it. The data structure of metadata files is defined in this GLEP. The elements and attributes do not use namespaces. Conforming files must not contain any elements or attributes that are not defined in this specification. +However, parsers should ignore any unknown elements or attributes in order +to permit future extension. Category metadata files are named ``metadata.xml`` and located inside category directories in an ebuild repository. Their structure is described -- 2.38.0