1 |
commit: b53ced9b3e8900dd5584b768d622fcbff15e78be |
2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
3 |
AuthorDate: Mon Nov 13 17:06:27 2017 +0000 |
4 |
Commit: Michał Górny <mgorny <AT> gentoo <DOT> org> |
5 |
CommitDate: Mon Nov 13 17:06:27 2017 +0000 |
6 |
URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=b53ced9b |
7 |
|
8 |
glep-0074: Explain combining multiple Manifest trees |
9 |
|
10 |
The idea has been originally suggested by Robin H. Johnson. |
11 |
|
12 |
glep-0074.rst | 28 ++++++++++++++++++++++++++++ |
13 |
1 file changed, 28 insertions(+) |
14 |
|
15 |
diff --git a/glep-0074.rst b/glep-0074.rst |
16 |
index e8fc849..aa26147 100644 |
17 |
--- a/glep-0074.rst |
18 |
+++ b/glep-0074.rst |
19 |
@@ -365,6 +365,34 @@ uncompressed content and the specification is free to choose either |
20 |
of the files using the same base name. |
21 |
|
22 |
|
23 |
+Combining multiple Manifest trees (informational) |
24 |
+------------------------------------------------- |
25 |
+ |
26 |
+This specification permits nesting multiple hierarchical Manifest trees. |
27 |
+In this layout, the specific directories of the Manifest tree can |
28 |
+be verified both as a part of another top-level Manifest, |
29 |
+and as an independent Manifest tree (when obtained without the parent |
30 |
+directory). |
31 |
+ |
32 |
+For this to work, the sub-Manifest file in the directory must also |
33 |
+satisfy the requirements for the top-level Manifest file. That is: |
34 |
+ |
35 |
+- it must be named ``Manifest`` and not compressed, |
36 |
+ |
37 |
+- it must cover all the files in this directory and its subdirectories |
38 |
+ (i.e. no files from the directory tree can be covered by parent |
39 |
+ Manifest), |
40 |
+ |
41 |
+- if authenticity verification is desired, it must be OpenPGP-signed. |
42 |
+ |
43 |
+It should be noted that if such a directory is a subdirectory of a valid |
44 |
+Manifest tree, the sub-Manifest needs to be valid according |
45 |
+to the top-level Manifest and the OpenPGP signature is disregarded |
46 |
+as detailed in `Manifest file locations and nesting`_. The top-level |
47 |
+behavior is exhibited only when the directory is obtained without parent |
48 |
+directories. |
49 |
+ |
50 |
+ |
51 |
An example Manifest file (informational) |
52 |
---------------------------------------- |