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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id B20BC139084 for ; Sat, 25 Nov 2017 20:49:41 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 0726EE0E40; Sat, 25 Nov 2017 20:49:39 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id DC03EE0E3C for ; Sat, 25 Nov 2017 20:49:38 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id F25543406D1 for ; Sat, 25 Nov 2017 20:49:37 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 65C60A781 for ; Sat, 25 Nov 2017 20:49:35 +0000 (UTC) From: "Michał Górny" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Michał Górny" Message-ID: <1511642956.2b932a339cb9a6073e4bc508eaa733dcca1f5fd4.mgorny@gentoo> Subject: [gentoo-commits] data/glep:master commit in: / X-VCS-Repository: data/glep X-VCS-Files: glep-0074.rst X-VCS-Directories: / X-VCS-Committer: mgorny X-VCS-Committer-Name: Michał Górny X-VCS-Revision: 2b932a339cb9a6073e4bc508eaa733dcca1f5fd4 X-VCS-Branch: master Date: Sat, 25 Nov 2017 20:49:35 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: 22174662-95d0-46de-b44a-5a8bf76fc58f X-Archives-Hash: dc81f96a7fa563d1e52e0513f70e7b10 commit: 2b932a339cb9a6073e4bc508eaa733dcca1f5fd4 Author: Michał Górny gentoo org> AuthorDate: Mon Nov 13 17:06:27 2017 +0000 Commit: Michał Górny gentoo org> CommitDate: Sat Nov 25 20:49:16 2017 +0000 URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=2b932a33 glep-0074: Explain combining multiple Manifest trees The idea has been originally suggested by Robin H. Johnson. glep-0074.rst | 34 +++++++++++++++++++++++++++++++--- 1 file changed, 31 insertions(+), 3 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index e8fc849..42c0c9e 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -8,8 +8,8 @@ Type: Standards Track Status: Draft Version: 1 Created: 2017-10-21 -Last-Modified: 2017-11-06 -Post-History: 2017-10-26 +Last-Modified: 2017-11-16 +Post-History: 2017-10-26, 2017-11-16 Content-Type: text/x-rst Requires: 59, 61 Replaces: 44, 58, 60 @@ -365,6 +365,34 @@ uncompressed content and the specification is free to choose either of the files using the same base name. +Combining multiple Manifest trees (informational) +------------------------------------------------- + +This specification permits nesting multiple hierarchical Manifest trees. +In this layout, the specific directories of the Manifest tree can +be verified both as a part of another top-level Manifest, +and as an independent Manifest tree (when obtained without the parent +directory). + +For this to work, the sub-Manifest file in the directory must also +satisfy the requirements for the top-level Manifest file. That is: + +- it must be named ``Manifest`` and not compressed, + +- it must cover all the files in this directory and its subdirectories + (i.e. no files from the directory tree can be covered by parent + Manifest), + +- if authenticity verification is desired, it must be OpenPGP-signed. + +It should be noted that if such a directory is a subdirectory of a valid +Manifest tree, the sub-Manifest needs to be valid according +to the top-level Manifest and the OpenPGP signature is disregarded +as detailed in `Manifest file locations and nesting`_. The top-level +behavior is exhibited only when the directory is obtained without parent +directories. + + An example Manifest file (informational) ---------------------------------------- @@ -792,7 +820,7 @@ for the ``Manifest`` file in every package directory: - all ``.ebuild`` files need to use the ``EBUILD`` tag, -` the ``metadata.xml`` and ``ChangeLog`` files need to use +- the ``metadata.xml`` and ``ChangeLog`` files need to use the ``MISC`` tag, - the Manifest can be signed to provide authenticity verification,