summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2017-11-02 19:19:35 +0100
committerMichał Górny <mgorny@gentoo.org>2017-11-25 21:49:15 +0100
commitd1934de3c1207a64da09742c3b25cfb60e9c34bc (patch)
tree5c268201dc25eded87982f2877e35216c5b73336
parentglep-0074: Clarify OPTIONAL desc (diff)
downloadglep-d1934de3c1207a64da09742c3b25cfb60e9c34bc.tar.gz
glep-d1934de3c1207a64da09742c3b25cfb60e9c34bc.tar.bz2
glep-d1934de3c1207a64da09742c3b25cfb60e9c34bc.zip
glep-0074: Remove OPTIONAL
-rw-r--r--glep-0074.rst29
1 files changed, 4 insertions, 25 deletions
diff --git a/glep-0074.rst b/glep-0074.rst
index b7b5a8c..f256451 100644
--- a/glep-0074.rst
+++ b/glep-0074.rst
@@ -148,13 +148,7 @@ used:
c. otherwise, the verification succeeds.
-3. If the file is covered by an entry of the ``OPTIONAL`` type:
-
- a. if the file is present, then the verification fails,
-
- b. otherwise, the verification succeeds.
-
-4. If the file is present but not listed in Manifest, the verification
+3. If the file is present but not listed in Manifest, the verification
fails.
Unless specified otherwise, the package manager must not allow using
@@ -221,13 +215,6 @@ The Manifest files can specify the following tags:
in non-strict mode. Used for files that do not affect the installed
packages (``metadata.xml``, ``use.desc``).
-``OPTIONAL <path>``
- Specifies a file that does not exist in the distribution but if it
- did, it would be marked as ``MISC``. In the strict mode, the file
- must not exist for the verification to pass. The package manager
- may ignore a stray file matching this entry if operating in non-strict
- mode.
-
``DIST <filename> <size> <checksums>…``
Specifies a distfile entry used to verify files fetched as part
of ``SRC_URI``. The filename must match the filename used to store
@@ -272,8 +259,8 @@ can be used:
4. Process all ``IGNORE`` entries. Remove any paths matching them
from the *present* set.
-5. Collect all files covered by ``DATA``, ``MISC``, ``OPTIONAL``,
- ``EBUILD`` and ``AUX`` entries into the *covered* set.
+5. Collect all files covered by ``DATA``, ``MISC``, ``EBUILD``
+ and ``AUX`` entries into the *covered* set.
6. Verify the entries in *covered* set for incompatible duplicates
and collisions with ignored files as explained in `Manifest file
@@ -550,12 +537,6 @@ It aims to account for two use cases:
2. Accounting for automatically generated files that might be updated
by standard tooling.
-The traditional ``MISC`` type is amended with a complementary
-``OPTIONAL`` tag to account for files that are not provided
-in the specific repository. It aims to ensure that the same path would
-be non-fatal when provided by the repository but fatal when created
-by the user tooling.
-
Timestamp field
---------------
@@ -643,9 +624,7 @@ on providing them via an additional rsync module.
If such files were injected into the repository, they would cause strict
verification failures of Manifests. To account for this, Infra could
-provide either ``OPTIONAL`` entries for the Manifest files to allow them
-in non-strict verification mode, or ``IGNORE`` entries to allow them
-in the strict mode.
+provide ``IGNORE`` entries to allow them to exist.
Splitting distfile checksums from file checksums