[gentoo-commits] data/glep:master commit in: /
commit: 85162e53fc1973dc428ba6148d96c4fa81908074 Author: Ulrich Müller gentoo org> AuthorDate: Thu Sep 26 11:42:31 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Sep 26 11:42:31 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=85162e53 glep-0084: Fix typo Signed-off-by: Ulrich Müller gentoo.org> glep-0084.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0084.rst b/glep-0084.rst index 37fe26a..28bbbcc 100644 --- a/glep-0084.rst +++ b/glep-0084.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Final Version: 1.0 Created: 2023-11-01 -Last-Modified: 2024-07-22 +Last-Modified: 2024-09-26 Post-History: 2023-10-04, 2023-10-13, 2023-11-01 Content-Type: text/x-rst --- @@ -93,7 +93,7 @@ Comments Block The lines in the comment block are prefixed with a "#" symbol. The comments should be separated with single space from the "#", unless this is trailing whitespace, in which case it should be removed (meaning blank lines in comments -block are just "#\n"). +block are just "#\\n"). The comments block consists of 2 mandatory parts (`author line`_ and `explanation`_) and one optional part (`last-rite epilogue`_). A blank line to
[gentoo-commits] data/glep:master commit in: /
commit: c2bf655fd1d5b29737e627a1aa4dafbea75d0ed2 Author: Ulrich Müller gentoo org> AuthorDate: Fri Aug 30 16:09:59 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Sep 8 19:24:16 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c2bf655f glep-0083: Allow deprecation when only one newer EAPI exists Approved by the council on 2024-09-08. Closes: https://bugs.gentoo.org/938755 Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 33 + 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index 38b4e57..3b538ee 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -4,10 +4,10 @@ Title: EAPI deprecation Author: Ulrich Müller Type: Informational Status: Active -Version: 1 +Version: 2 Created: 2022-06-30 -Last-Modified: 2022-08-14 -Post-History: 2022-07-11, 2022-07-31 +Last-Modified: 2024-09-08 +Post-History: 2022-07-11, 2022-07-31, 2024-08-30, 2024-09-01 Content-Type: text/x-rst --- @@ -38,11 +38,12 @@ warn about this [#COUNCIL-20130409]_. A *banned EAPI* must no longer be used, neither for new ebuilds, nor for updating of existing ebuilds [#COUNCIL-20140311]_. -The Gentoo Council will deprecate an EAPI when +The Gentoo Council will deprecate an EAPI when one or more newer +Council-approved EAPIs are supported by the stable version of Portage, +namely -* two newer Council-approved EAPIs are supported by the stable version - of Portage, and -* one of them has been supported for 24 months. +* two newer EAPIs, one of them supported for at least 24 months, or +* one newer EAPI, supported for at least 48 months. The Gentoo Council will ban a deprecated EAPI when @@ -70,7 +71,9 @@ allow projects to support a longer upgrade path. Requiring two newer EAPIs before deprecation will allow ebuilds that are otherwise seldom updated to be bumped to the next but one EAPI -immediately. +immediately. However, deprecation of an EAPI should not be deferred +forever, so it can be effected after a longer waiting period of 48 +months even if only one newer EAPI exists at that point. A delay of 24 months between deprecation and ban will give ebuild authors enough time to update. This is especially relevant for @@ -81,6 +84,20 @@ ebuild updates (and bug reports requesting them) manageable, as a banned EAPI is sufficient reason for updating an ebuild. +Example +=== + +Under this policy, EAPI 7 will be deprecated when either + +* Portage has supported EAPI 8 for 24 months, and supports another + later EAPI (e.g. EAPI 9), or +* Portage has supported EAPI 8 for 48 months. + +Portage has supported EAPI 8 since 2021-07-05. The first condition +would be fulfilled after 2023-07-05, as soon as an EAPI 9 is also +supported. The second condition would be fulfilled after 2025-07-05. + + Backwards Compatibility ===
[gentoo-commits] data/glep:master commit in: /
commit: 17315157743178a61a86bb51b38b52507432908c Author: Ulrich Müller gentoo org> AuthorDate: Mon Sep 2 08:28:14 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Sep 2 08:42:09 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=17315157 glep-0076: Fix date of copyright assignment document The assignment document was committed to the gentoo CVS repository on 2003-12-09: https://gitweb.gentoo.org/archive/proj/gentoo.git/commit/?id=9b5e6825a96238a4dfe83cc92d641858a0740222 We also have three forms signed by developers that are dated 2003-12-29 and 2003-12-31. Closes: https://bugs.gentoo.org/938922 Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 524413b..73d18ef 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,7 +10,7 @@ Type: Informational Status: Active Version: 2 Created: 2013-04-23 -Last-Modified: 2024-04-16 +Last-Modified: 2024-09-02 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02, 2024-04-04 Content-Type: text/x-rst @@ -48,7 +48,7 @@ going forward. In the beginning (2000 or earlier), the copyright header stated that *Gentoo Technologies, Inc.* was the copyright holder, without any formal paperwork. The formal assignment document was however only -introduced in early 2004. The assignment had many objectors (mostly +introduced in late 2003. The assignment had many objectors (mostly on the ``gentoo-core`` mailing list). The developer recruiting procedures attempted to require signing of the document as a condition for becoming a developer, but it was not applied to pre-existing
[gentoo-commits] data/glep:master commit in: /
commit: 9f935319c5724dbf38ceb4979026c7241d559dc8 Author: Ulrich Müller gentoo org> AuthorDate: Mon Jul 22 05:42:26 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Jul 22 05:42:26 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=9f935319 glep-0084: Mark as Final per 2024-07-21 Council decision Bug: https://bugs.gentoo.org/914982 Signed-off-by: Ulrich Müller gentoo.org> glep-0084.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0084.rst b/glep-0084.rst index 93acf65..37fe26a 100644 --- a/glep-0084.rst +++ b/glep-0084.rst @@ -3,10 +3,10 @@ GLEP: 84 Title: Standard format for package.mask files Author: Arthur Zamarin Type: Standards Track -Status: Accepted +Status: Final Version: 1.0 Created: 2023-11-01 -Last-Modified: 2024-02-27 +Last-Modified: 2024-07-22 Post-History: 2023-10-04, 2023-10-13, 2023-11-01 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: c8e9d35cf52b4d8f67150a4b45a3681df7998c97 Author: Ulrich Müller gentoo org> AuthorDate: Tue Jul 16 16:17:34 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Tue Jul 16 16:17:34 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c8e9d35c glep-0037: Fix a typo Signed-off-by: Ulrich Müller gentoo.org> glep-0037.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0037.rst b/glep-0037.rst index fd84e22..d66ca28 100644 --- a/glep-0037.rst +++ b/glep-0037.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Deferred Version: 1 Created: 2005-04-30 -Last-Modified: 2014-01-21 +Last-Modified: 2024-07-16 Post-History: 2005-04-30, 2006-09-05 Content-Type: text/x-rst --- @@ -66,7 +66,7 @@ IUSE and RDEPEND metadata. An example would be something like this:: DESCRIPTION="Java Development Kit 1.4" KEYWORDS="amd64 hppa ia64 ppc ppc64 sparc x86" RDEPEND="|| ( -=dev-java/blackdown-jdk-1.4\* +=dev-java/blackdown-jdk-1.4* =dev-java/ibm-jdk-bin-1.4* =dev-java/jrockit-jdk-bin-1.4* =dev-java/kaffe-1.1.4*
[gentoo-commits] data/glep:master commit in: /
commit: 11b80e266922982805d6368273fe3832f5c5e808 Author: Ulrich Müller gentoo org> AuthorDate: Sun Mar 31 09:07:11 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Mar 31 09:07:11 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=11b80e26 glep-0076: Drop reference to project licensing wiki page This hasn't worked out; few projects list their licenses there. In any case, the wiki page can continue to exist but it need not be part of the policy. Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 6 -- 1 file changed, 6 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 403bf78..7b0afc9 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -120,9 +120,6 @@ c) A license approved as GPL compatible by the Free Software Exceptions for other free software licenses will be granted by the Gentoo Council on a case by case basis. -For easy reference, the license for each project should be documented -on the wiki page at [#PROJECTS]_. - Certificate of Origin - @@ -373,9 +370,6 @@ References .. [#GPL-COMPAT] GPL-compatible free software licenses, https://www.gnu.org/licenses/license-list.en.html#GPLCompatibleLicenses -.. [#PROJECTS] Licensing of Gentoo projects, - https://wiki.gentoo.org/wiki/Project:Licenses/Licensing_of_Gentoo_projects - .. [#OSDL-DCO] Open Source Development Labs, Inc., Developer's Certificate of Origin 1.1, https://web.archive.org/web/20060524185355/http://www.osdlab.org/newsroom/press_releases/2004/2004_05_24_dco.html
[gentoo-commits] data/glep:master commit in: /
commit: 307e63cbcadeab62391aba4aeec3d2ee3d65778d Author: Ulrich Müller gentoo org> AuthorDate: Tue Apr 16 16:41:27 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Tue Apr 16 16:41:27 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=307e63cb glep-0076: Reapproved, update status Closes: https://bugs.gentoo.org/929012 Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 5 - 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/glep-0076.rst b/glep-0076.rst index 7f7e425..524413b 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,7 +10,7 @@ Type: Informational Status: Active Version: 2 Created: 2013-04-23 -Last-Modified: 2024-04-09 +Last-Modified: 2024-04-16 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02, 2024-04-04 Content-Type: text/x-rst @@ -25,6 +25,9 @@ Gentoo Board of Trustees on 2018-09-15. Reapproved with clarified real name requirement on 2018-10-19. Marked as Active on 2018-10-21. Reapproved with relaxed real name policy on 2023-04-01. +Version 2 transferred responsibilities from Trustees to Council, +approved on 2024-04-16. + Abstract
[gentoo-commits] data/glep:master commit in: /
commit: 4b0997c437fb3db9964af4a3740807c3147dadb1 Author: Ulrich Müller gentoo org> AuthorDate: Tue Apr 9 16:34:13 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Tue Apr 9 16:34:13 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=4b0997c4 glep-0076: Update Post-History Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 7b0afc9..7f7e425 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,8 +10,9 @@ Type: Informational Status: Active Version: 2 Created: 2013-04-23 -Last-Modified: 2024-03-31 -Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02 +Last-Modified: 2024-04-09 +Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02, + 2024-04-04 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 7f0ce454b2359ed742b84d1d60176fadad15c066 Author: Ulrich Müller gentoo org> AuthorDate: Sun Mar 31 09:05:01 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Mar 31 09:05:01 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=7f0ce454 glep-0076: Shift responsibilities from Trustees to Council After Gentoo Linux has become an associated project of SPI, the Council is the obvious entity to be responsible for the tasks previously assigned to the Trustees. Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 27 ++- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 338e094..403bf78 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -8,9 +8,9 @@ Author: Richard Freeman , Michał Górny Type: Informational Status: Active -Version: 1.3 +Version: 2 Created: 2013-04-23 -Last-Modified: 2023-04-01 +Last-Modified: 2024-03-31 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02 Content-Type: text/x-rst --- @@ -94,9 +94,9 @@ infrastructure or to any official Gentoo project (independently of hosting) must comply with this policy. Unofficial Gentoo projects are also recommended to use this policy. -Questions regarding this policy should be directed to the Trustees +Questions regarding this policy should be directed to the Council or the ``gentoo-project`` mailing list. Any concerns over possible -copyright violations should be directed to the Trustees if they cannot +copyright violations should be directed to the Council if they cannot be worked out with the appropriate maintainer. @@ -118,7 +118,7 @@ c) A license approved as GPL compatible by the Free Software Foundation [#GPL-COMPAT]_. Exceptions for other free software licenses will be granted by the -Gentoo Foundation on a case by case basis. +Gentoo Council on a case by case basis. For easy reference, the license for each project should be documented on the wiki page at [#PROJECTS]_. @@ -213,7 +213,7 @@ associated project/package providing as much information as possible. Files that are not brought into compliance within 60 days or upon a request for removal by a aggrieved copyright holder will be removed. Any concerns not addressed by a maintainer can be appealed to the -Trustees. +Council. Simplified Attribution @@ -253,6 +253,12 @@ the DCO model and an FLA model [#FLA]_ as it is used by different open source projects. Contributors would be able to freely choose whether they sign the FLA document or not. +After Gentoo Linux has become an associated project of Software in the +Public Interest (SPI) [#SPI]_, the Gentoo Council will be responsible +for granting of license exceptions and resolution of copyright issues, +instead of the Gentoo Foundation Trustees. The Council may confer +with SPI for issues that it cannot resolve itself. + Licensing of Projects - @@ -274,9 +280,9 @@ license.) By default, GPL-incompatible licenses (e.g., the CDDL) are not allowed, because their use would hinder interchange of code between -Gentoo projects. However, the Foundation can grant exceptions to -this, as long as the license in question is a free software or open -source license. +Gentoo projects. However, the Council can grant exceptions to this, +as long as the license in question is a free software or open source +license. Changes to the Certificate of Origin @@ -382,6 +388,9 @@ References https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/process/submitting-patches.rst?id=d4563201f33a022fc0353033d9dfeb1606a88330#n410 https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=d4563201f33a022fc0353033d9dfeb1606a88330 +.. [#SPI] Software in the Public Interest, + https://www.spi-inc.org/ + .. [#CC-SOFTWARE] Can I apply a Creative Commons license to software? https://creativecommons.org/faq/#can-i-apply-a-creative-commons-license-to-software
[gentoo-commits] data/glep:master commit in: /
commit: fcc19947f624062e6ae921af9b3436a968cd6041 Author: Ulrich Müller gentoo org> AuthorDate: Tue Feb 27 09:30:31 2024 + Commit: Ulrich Müller gentoo org> CommitDate: Tue Feb 27 09:30:31 2024 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=fcc19947 glep-0084: Mark as Accepted by 2023-12-10 Council decision Signed-off-by: Ulrich Müller gentoo.org> glep-0084.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0084.rst b/glep-0084.rst index e199355..93acf65 100644 --- a/glep-0084.rst +++ b/glep-0084.rst @@ -3,10 +3,10 @@ GLEP: 84 Title: Standard format for package.mask files Author: Arthur Zamarin Type: Standards Track -Status: Draft +Status: Accepted Version: 1.0 Created: 2023-11-01 -Last-Modified: 2023-12-02 +Last-Modified: 2024-02-27 Post-History: 2023-10-04, 2023-10-13, 2023-11-01 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 89d8ce8a95d9437c5e439c77e16373f02f5f856a Author: Ulrich Müller gentoo org> AuthorDate: Sat Dec 2 12:02:19 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Dec 2 12:02:19 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=89d8ce8a glep-0084: Add Post-History Signed-off-by: Ulrich Müller gentoo.org> glep-0084.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/glep-0084.rst b/glep-0084.rst index 2a279ee..e199355 100644 --- a/glep-0084.rst +++ b/glep-0084.rst @@ -6,6 +6,8 @@ Type: Standards Track Status: Draft Version: 1.0 Created: 2023-11-01 +Last-Modified: 2023-12-02 +Post-History: 2023-10-04, 2023-10-13, 2023-11-01 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 6503d22701f216d3a304d42799a555a29eff91af Author: Arthur Zamarin gentoo org> AuthorDate: Wed Nov 1 20:33:56 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Dec 2 12:01:47 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=6503d227 glep-0084: Initial draft of Standard format for package.mask files Signed-off-by: Arthur Zamarin gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0084.rst | 277 ++ 1 file changed, 277 insertions(+) diff --git a/glep-0084.rst b/glep-0084.rst new file mode 100644 index 000..2a279ee --- /dev/null +++ b/glep-0084.rst @@ -0,0 +1,277 @@ +--- +GLEP: 84 +Title: Standard format for package.mask files +Author: Arthur Zamarin +Type: Standards Track +Status: Draft +Version: 1.0 +Created: 2023-11-01 +Content-Type: text/x-rst +--- + +Abstract + + +This GLEP specifies the format of ``package.mask`` files under profiles +directory. + +Motivation +== + +At the moment of writing this GLEP, ``package.mask`` files didn't have a full +format specification. While PMS sections 4.4 [#PMS-4.4]_ and 5.2.8 +[#PMS-5.2.8]_ specifies the raw format which the package manager must support +for correct behavior, it does not specify how comments must be formatted, how +entries must be grouped, how last-rite masks should be written, etc. + +Various tools have been developed to handle that mask message. A non exhaustive +list includes ``lr-add-pmask`` [#lr-add-pmask]_, ``pkgdev mask`` [#pkgdev-mask]_, +and ``soko`` [#soko-mask]_. Those tools have different purposes, filing a new +mask message with all relevant information, and showing a nice rendered mask +message to users. Those tools are very complicated (since they need to handle +various edge cases of existing masks, and try to prepare for future mask +messages). + +For a long time, ``profiles/package.mask`` had a special header [#CURR-MASK]_ +whose purpose was to define the mask message formatting. While it has served +its purpose for a long time indeed, it still left a lot of wiggle room for the +message. + +Therefore, the motivation for this GLEP is to provide unified, clear and +complete specification for package.mask entries across the repository. + +Specification += + +Header +-- + +As an opt-in GLEP for files, files which want to use this GLEP format should +define a special header line which tools should use to know the format of the +file. This line should appear as the first non empty line after the copyright +header. The line should be: + +# Uses GLEP 84 format + +This header should come instead of the current very long header [#CURR-MASK]_, +as mentioning the GLEP is enough. + +Files can decide to add some extra file documentation, in which case, the +entries start after the first separation line comment which begins and ends +with at least 5 "-", matching to the regex: + +# -{5,}.*-{5,} + +All comments before the first occurrence of this separation line comment are +ignored, and should be considered as file documentation. Another separation +line may appear, after which all comments are also ignored. Those separation +lines are optional, and are not required for the file to conform to this GLEP. + +Entries Grouping + + +Each mask entry consists of 2 parts: `comments block`_ and `packages list`_, +which aren't separated by a blank line between the 2 parts. Between entries, a +mandatory blank line must appear. + +New entries added to the file must be inserted at the beginning, after the file +header. + +Packages List +- + +Must conform to PMS sections 4.4 [#PMS-4.4]_ and 5.2.8 [#PMS-5.2.8]_. This GLEP +further limits the syntax to one item per line, without any leading or trailing +whitespace, no comments inside the packages list. Blank lines between items are +allowed. + +Comments Block +-- + +The lines in the comment block are prefixed with a "#" symbol. The comments +should be separated with single space from the "#", unless this is trailing +whitespace, in which case it should be removed (meaning blank lines in comments +block are just "#\n"). + +The comments block consists of 2 mandatory parts (`author line`_ and +`explanation`_) and one optional part (`last-rite epilogue`_). A blank line to +separate the parts is optional. Trailing whitespace should be dropped. + +The lines of the comments block should use column wrapping of 80 characters +(including the "#" prefix). The author line is excluded from this maximum +width. + +For simplifying the explanation, we wouldn't mention the "#" prefix. +Implementations are advised to drop this prefix before further processing the +block. + +Author Line +''' + +A line of the format: ``${AUTHOR-NAME} <${EMAIL}> (${SINGLE-DATE})``. The author +name and email should correspond to the mask author, and should confirm to the +GLEP 76 rules. The date should be of RFC-3339 full-date format,
[gentoo-commits] data/glep:master commit in: /
commit: 7c9d58e9d49cb7042bd273e137657b6f1b320671 Author: Ulrich Müller gentoo org> AuthorDate: Fri Sep 15 16:37:40 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Sep 15 16:37:40 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=7c9d58e9 glep-0046: Fix Post-History Actually posted to gentoo-dev mailing list on 2008-01-21 and 2008-03-25: https://archives.gentoo.org/gentoo-dev/message/46d474d621455bc204654dc483e87cc5 https://archives.gentoo.org/gentoo-dev/message/57ecd69e0f1e2688a56f81aeea29bf61 Signed-off-by: Ulrich Müller gentoo.org> glep-0046.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0046.rst b/glep-0046.rst index e1305a9..cf1cde8 100644 --- a/glep-0046.rst +++ b/glep-0046.rst @@ -8,8 +8,8 @@ Type: Standards Track Status: Replaced Version: 1 Created: 2005-12-26 -Last-Modified: 2017-10-13 -Post-History: 2005-12-26, 2006-03-05, 2008-01-24, 2008-05-10 +Last-Modified: 2023-09-15 +Post-History: 2005-12-26, 2006-03-05, 2008-01-21, 2008-03-25 Content-Type: text/x-rst Replaced-By: 68 ---
[gentoo-commits] data/glep:master commit in: /
commit: ad0ba451bfb78609d86d1b69f2a2c2685e6cea16 Author: Ulrich Müller gentoo org> AuthorDate: Fri Sep 15 15:29:41 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Sep 15 15:29:41 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=ad0ba451 glep-0075: Update status of implementation Bug: https://bugs.gentoo.org/784713 Signed-off-by: Ulrich Müller gentoo.org> glep-0075.rst | 16 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/glep-0075.rst b/glep-0075.rst index bfeafc9..413db21 100644 --- a/glep-0075.rst +++ b/glep-0075.rst @@ -7,11 +7,19 @@ Type: Standards Track Status: Final Version: 1 Created: 2018-01-26 -Last-Modified: 2019-11-11 +Last-Modified: 2023-09-15 Post-History: 2018-01-27, 2019-10-24 Content-Type: text/x-rst --- +Status +== +As of 2019-10-18, the Gentoo Infrastructure team has successfully +deployed the ``filename-hash BLAKE2B 8`` layout on Gentoo mirrors. +The previous flat directory structure has been removed on 2023-09-14 +[#BUG784713]_. + + Abstract This GLEP describes the procedure for splitting the distfiles on mirrors @@ -382,12 +390,12 @@ and maintaining mirrors via ``emirrordist``. The implementation supports both listed layouts, with all hash functions supported by Portage and cutoffs being multiples of 4. -As of 2019-10-18, the Gentoo Infrastructure team has successfully -deployed the ``filename-hash BLAKE2B 8`` layout on Gentoo mirrors. - References == +.. [#BUG784713] Bug 784713 - Remove old distfile mirror layout + (https://bugs.gentoo.org/784713) + .. [#DESKTOP_FORMAT] Desktop Entry Specification: Basic format of the file (https://standards.freedesktop.org/desktop-entry-spec/latest/ar01s03.html)
[gentoo-commits] data/glep:master commit in: /
commit: 6307965530a2094c64fedfecc51c20b85431ec9a Author: Ulrich Müller gentoo org> AuthorDate: Tue May 2 19:09:37 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Mon May 8 20:08:58 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=63079655 glep-0078: Update reference implementation section Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 12 +--- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 1282838..12e8ef1 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -7,7 +7,7 @@ Type: Standards Track Status: Accepted Version: 1.1 Created: 2018-11-15 -Last-Modified: 2022-11-15 +Last-Modified: 2023-05-02 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28, 2022-09-21 Content-Type: text/x-rst @@ -625,9 +625,8 @@ the goal of using simple and transparent package format. Reference Implementation -The proof-of-concept implementation of binary package format converter -is available as xpak2gpkg [#XPAK2GPKG]_. It can be used to easily -create packages in the new format for early inspection. +The gpkg format is supported by Portage since version 3.0.36 +[#PORTAGE-3.0.36]_. References @@ -660,9 +659,8 @@ References .. [#TAR-PORTABILITY] Michał Górny, Portability of tar features (https://dev.gentoo.org/~mgorny/articles/portability-of-tar-features.html) -.. [#XPAK2GPKG] xpak2gpkg: Proof-of-concept converter from tbz2/xpak - to gpkg binpkg format - (https://github.com/mgorny/xpak2gpkg) +.. [#PORTAGE-3.0.36] Portage version 3.0.36 + (https://gitweb.gentoo.org/proj/portage.git/commit/?h=portage-3.0.36) .. [#TARDUP] tar: Multiple Members with the Same Name (https://www.gnu.org/software/tar/manual/html_node/multiple.html)
[gentoo-commits] data/glep:master commit in: /
commit: b7e6873ab3b8f51cdb1f31e991d2e3c2999fe179 Author: Ulrich Müller gentoo org> AuthorDate: Sun May 14 19:06:56 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sun May 14 19:06:56 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=b7e6873a glep-0078: Mark as Final per 2023-05-14 Council decision Closes: https://bugs.gentoo.org/672672 Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 12e8ef1..6b3ed74 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -4,10 +4,10 @@ Title: Gentoo binary package container format Author: Michał Górny , Sheng Yu Type: Standards Track -Status: Accepted +Status: Final Version: 1.1 Created: 2018-11-15 -Last-Modified: 2023-05-02 +Last-Modified: 2023-05-14 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28, 2022-09-21 Content-Type: text/x-rst
[gentoo-commits] data/glep:master commit in: /
commit: 83f291b94066a9163462acbdc86b1662c5e25f3b Author: Ulrich Müller gentoo org> AuthorDate: Mon May 8 19:15:45 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Mon May 8 19:15:45 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=83f291b9 glep-0039: Order references by their occurrence in the text Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 7f19f60..a9f87ef 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -246,8 +246,6 @@ References Message-ID 20050614035141.GC15256\@dst.grantgoodyear.org (https://archives.gentoo.org/gentoo-dev/message/f5ab9ccca62a5d5e0b7b7ab0156f19b3) -.. [#Project_pages] https://wiki.gentoo.org/wiki/Gentoo_Wiki:Developer_Central/Project_pages - .. [#Council2007] 2007-02-08 council meeting (https://projects.gentoo.org/council/meeting-logs/20070208-summary.txt) @@ -259,6 +257,8 @@ References .. [#Council2013] 2013-02-12 council meeting (https://projects.gentoo.org/council/meeting-logs/20130212-summary.txt) +.. [#Project_pages] https://wiki.gentoo.org/wiki/Gentoo_Wiki:Developer_Central/Project_pages + Copyright =
[gentoo-commits] data/glep:master commit in: /
commit: 7d51419e1b6935ddbd1f848ad192241b256d6bf3 Author: Ulrich Müller gentoo org> AuthorDate: Mon Apr 10 13:15:04 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:21 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=7d51419e glep-0039: Update license to CC BY-SA 4.0 Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index f0b6dcb..5edcb25 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -242,6 +242,6 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: 9b1caddb1071ff78e752df76df07610d27ffa108 Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 08:22:45 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Mon May 8 16:48:05 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=9b1caddb glep-0039: Add summary of changes Plus references to the relevant council decisions. Suggested-By: John Helmert III gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 21 - 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/glep-0039.rst b/glep-0039.rst index d52ec2a..911e0dc 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -7,7 +7,7 @@ Type: Informational Status: Final Version: 2 Created: 2005-09-01 -Last-Modified: 2023-04-10 +Last-Modified: 2023-05-08 Post-History: 2005-09-01, 2006-02-09, 2007-10-12, 2008-01-19 Content-Type: text/x-rst Replaces: 4 @@ -21,6 +21,14 @@ Gentoo developers on 2005-06-14 [#Metastructure_vote]_. GLEP amended on 2006-02-09 to add the final bullet point to list B in `Specification`_. +Updated by an all-developers vote on 2023-05-08: + +* Replace leaving council members by next in line [#Council2007]_. +* Updating this document requires an all-developers vote [#Council2009]_. +* Council members must be developers [#Council2013]_. +* An inquorate council meeting cannot take any substantive action. +* Drop hard requirement of yearly project lead elections. + Abstract @@ -239,6 +247,17 @@ References .. [#Project_pages] https://wiki.gentoo.org/wiki/Gentoo_Wiki:Developer_Central/Project_pages +.. [#Council2007] 2007-02-08 council meeting + (https://projects.gentoo.org/council/meeting-logs/20070208-summary.txt) + +.. [#Council2009] 2009-07-20 council meeting + (https://projects.gentoo.org/council/meeting-logs/20090720-summary.txt), + confirmed on 2011-07-15 + (https://projects.gentoo.org/council/meeting-logs/20110715-summary.txt) + +.. [#Council2013] 2013-02-12 council meeting + (https://projects.gentoo.org/council/meeting-logs/20130212-summary.txt) + Copyright =
[gentoo-commits] data/glep:master commit in: /
commit: c644cd012d75f49773f01d0e148ec4f9c3e6bc6a Author: Ulrich Müller gentoo org> AuthorDate: Sun Apr 16 08:08:05 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Mon May 8 16:48:06 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c644cd01 glep-0039: Update Version and Post-History Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 911e0dc..7f19f60 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -5,10 +5,11 @@ Author: Grant Goodyear , Ciaran McCreesh Type: Informational Status: Final -Version: 2 +Version: 3 Created: 2005-09-01 Last-Modified: 2023-05-08 -Post-History: 2005-09-01, 2006-02-09, 2007-10-12, 2008-01-19 +Post-History: 2005-09-01, 2006-02-09, 2007-10-12, 2008-01-19, 2022-11-25, + 2023-04-10, 2023-04-16 Content-Type: text/x-rst Replaces: 4 ---
[gentoo-commits] data/glep:master commit in: /
commit: 29bfaccbe91395059dacf47dfa9759283301aed2 Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 12:06:12 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:19 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=29bfaccb glep-0039: An inquorate council meeting cannot take substantive action Bug: https://bugs.gentoo.org/520074 Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/glep-0039.rst b/glep-0039.rst index 3193625..397691b 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -163,7 +163,8 @@ B. Global issues will be decided by an elected Gentoo council. * The 'slacker' marker is reset when a member is elected. * If any meeting has less than 50% attendance by council members, a new election for *all* places must be held within a month. The 'one year' - is then reset from that point. + is then reset from that point. No substantive action can be taken + in any such meeting. * Disciplinary actions may be appealed to the council. * A proxy must not be an existing council member, and any single person may not be a proxy for more than one council member at any given
[gentoo-commits] data/glep:master commit in: /
commit: 6399e61090a8d9839fb71715dc31cb95bedad5e5 Author: Ulrich Müller gentoo org> AuthorDate: Mon Apr 10 13:17:41 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:21 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=6399e610 glep-0039: Fix whitespace Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 5edcb25..d52ec2a 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -81,12 +81,12 @@ Problems with the existing system 1. The assumption that TLPs are complete is either incorrect (there still is no "server" TLP) or just plain weird (but the lack of a server TLP is technically okay because all devs who don't have an - obvious TLP belong to the "base" TLP by default). + obvious TLP belong to the "base" TLP by default). 2. There is nothing at all to ensure that project leads actually do represent the devs they supposedly lead or satisfy their responsibilities. Indeed, should a TLP manager go AWOL it is not at all obvious how the situation should be resolved. -3. Nothing is being decided at global scope right now. Some TLP strategic +3. Nothing is being decided at global scope right now. Some TLP strategic managers rarely attend the managers' meetings, and the managers as a whole certainly are not providing any sort of global vision for Gentoo right now. @@ -174,7 +174,7 @@ B. Global issues will be decided by an elected Gentoo council. Rationale = -So, does this proposal solve any of the previously-mentioned problems? +So, does this proposal solve any of the previously-mentioned problems? 1. There is no longer any requirement that the project structure be complete. Some devs work on very specific parts of the tree, while
[gentoo-commits] data/glep:master commit in: /
commit: e9027e1d081ea5737230985110dc044fce40039d Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 07:42:06 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:20 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=e9027e1d glep-0039: Drop hard requirement of yearly lead elections Taking feedback from gentoo-project mailing list into account. Suggested-By: John Helmert III gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 6 -- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 4078584..f0b6dcb 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -117,8 +117,10 @@ A. A project is a group of developers working towards a goal (or a set out-of-date.) If the Wiki page isn't maintained, it is presumed dead. * It should have at least one lead, and the leads are selected by - the members of the project. This selection must occur at least - once every 12 months, and may occur at any time. + the members of the project. This selection should occur at least + once every 12 months, and may occur at any time. Any member can + demand a lead election if the last election was more than + 12 months ago. * It may have zero or more sub-projects. Sub-projects are just projects that provide some additional structure, and their Wiki pages are defined as sub-projects of the parent project.
[gentoo-commits] data/glep:master commit in: /
commit: 1dbe638f022c64bd29dfbe4d0a8bd55ca49d1549 Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 11:17:26 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:20 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=1dbe638f glep-0039: Projects need not have a lead Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 7 +++ 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 397691b..4078584 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -116,10 +116,9 @@ A. A project is a group of developers working towards a goal (or a set that the information on the page is factually correct and not out-of-date.) If the Wiki page isn't maintained, it is presumed dead. - * It may have one or many leads, and the leads are - selected by the members of the project. This selection must - occur at least once every 12 months, and may occur at any - time. + * It should have at least one lead, and the leads are selected by + the members of the project. This selection must occur at least + once every 12 months, and may occur at any time. * It may have zero or more sub-projects. Sub-projects are just projects that provide some additional structure, and their Wiki pages are defined as sub-projects of the parent project.
[gentoo-commits] data/glep:master commit in: /
commit: c4df5974adab69d97f5118d0f7f693167a50581c Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 11:04:06 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:18 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c4df5974 glep-0039: Replace leaving council members by next in line Accepted in the 2007-02-08 council meeting. Wording slightly updated, in order to clarify that even after an election the new council member will get a reduced term. This is already current practice and was followed by the council several times in the past: 2007-03-08 (uberlord), 2007-06-14 (jaervosz), 2008-09-11 (cardoe), 2009-02-26 (leio), 2009-05-28 (ulm), 2011-01-11 (patrick). Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 13 ++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index b942b48..a85ac18 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -145,9 +145,16 @@ B. Global issues will be decided by an elected Gentoo council. two consecutive meetings, they are marked as a slacker. * If a council member who has been marked a slacker misses any further meeting (or their appointed proxy doesn't show up), they lose their - position and a new election is held to replace that person. The newly - elected council member gets a 'reduced' term so that the yearly - elections still elect a full group. + position. + * Whenever a member of the council loses their position (the reason + is irrelevant; e.g. they resign or they are booted for slacking), + then the next person in line from the previous council election + is offered the position. If they accept and the current council + unanimously accepts the new person, they get the position. + Otherwise, it is offered to the next person in line, and so forth. + If the council does not accept that person, then a new election is + held to choose a new member. The new member gets a 'reduced' term + so that the yearly elections still elect a full group. * Council members who have previously been booted for excessive slacking may stand for future elections, including the election for their replacement. They should, however, justify their slackerness, and
[gentoo-commits] data/glep:master commit in: /
commit: 890b3b73a05bdbe3fdc171ab01b7428510737fe3 Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 11:13:11 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:19 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=890b3b73 glep-0039: Council members must be developers Discussed in 2013-02-12 council meeting. Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/glep-0039.rst b/glep-0039.rst index a85ac18..3193625 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -138,6 +138,7 @@ B. Global issues will be decided by an elected Gentoo council. first election that number was set to 7 by acclamation.) * Council members will be chosen by a general election of all devs once per year. + * Council members (and their proxies) must be Gentoo developers. * The council must hold an open meeting at least once per month. * Council decisions are by majority vote of those who show up (or their proxies).
[gentoo-commits] data/glep:master commit in: /
commit: e9470f1d9d31bf6037a326865afe869516190a2c Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 09:46:55 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:17 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=e9470f1d glep-0039: Update title Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0039.rst b/glep-0039.rst index 82bf1d9..697a6f2 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -1,13 +1,13 @@ --- GLEP: 39 -Title: An "old-school" metastructure proposal with "boot for being a slacker" +Title: Gentoo metastructure Author: Grant Goodyear , Ciaran McCreesh Type: Informational Status: Final Version: 2 Created: 2005-09-01 -Last-Modified: 2019-11-07 +Last-Modified: 2023-04-10 Post-History: 2005-09-01, 2006-02-09, 2007-10-12, 2008-01-19 Content-Type: text/x-rst Replaces: 4
[gentoo-commits] data/glep:master commit in: /
commit: f94967967abc1f7f506d3ebbe9e23b8b7c05d1b9 Author: Ulrich Müller gentoo org> AuthorDate: Thu Nov 10 10:40:57 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 15 11:58:18 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f9496796 glep-0039: Updating GLEP 39 requires an all-developers vote See council decision of 2009-07-20, confirmed again on 2011-07-15. Added quorum, as discussed in 2023-04-09 council meeting. Signed-off-by: Ulrich Müller gentoo.org> glep-0039.rst | 13 + 1 file changed, 13 insertions(+) diff --git a/glep-0039.rst b/glep-0039.rst index 697a6f2..b942b48 100644 --- a/glep-0039.rst +++ b/glep-0039.rst @@ -206,6 +206,19 @@ So, does this proposal solve any of the previously-mentioned problems? 8. This proposal has nothing to say about GLEPs. +Updates to this document + + +Any major updates to this document (that is, those that change its +content rather than just fixing typos or adding small clarifications) +require a vote of all developers. Eligible voters are all developers +at the time when the proposed update is published. The vote passes if +both of the following conditions are fulfilled: + +* The ratio of positive to negative votes is at least two to one, and +* the number of positive votes is no less than one quarter of the number + of eligible voters. + References ==
[gentoo-commits] data/glep:master commit in: /
commit: 9a01af44a438cc3ceda548cab6c7834cf51aa222 Author: Ulrich Müller gentoo org> AuthorDate: Sat Apr 1 09:03:24 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Apr 1 09:03:24 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=9a01af44 glep-0076: Reapproved Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/glep-0076.rst b/glep-0076.rst index 5e0b364..338e094 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,7 +10,7 @@ Type: Informational Status: Active Version: 1.3 Created: 2013-04-23 -Last-Modified: 2022-07-02 +Last-Modified: 2023-04-01 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26, 2023-03-02 Content-Type: text/x-rst --- @@ -22,6 +22,7 @@ Status Accepted by the Gentoo Council on 2018-09-09 and approved by the Gentoo Board of Trustees on 2018-09-15. Reapproved with clarified real name requirement on 2018-10-19. Marked as Active on 2018-10-21. +Reapproved with relaxed real name policy on 2023-04-01. Abstract
[gentoo-commits] data/glep:master commit in: /
commit: 70243c0374f54847e10abb91b847b29026e62a69 Author: Ulrich Müller gentoo org> AuthorDate: Tue Feb 21 15:54:50 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Mar 12 20:13:41 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=70243c03 Replace outdated URLs pointing to CVS repositories Closes: https://bugs.gentoo.org/895734 Signed-off-by: Ulrich Müller gentoo.org> glep-0001.rst | 2 +- glep-0056.rst | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/glep-0001.rst b/glep-0001.rst index a522014..85e47d3 100644 --- a/glep-0001.rst +++ b/glep-0001.rst @@ -363,7 +363,7 @@ References and Footnotes .. [#VCS] https://gitweb.gentoo.org/data/glep.git -.. [#CVS] https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo/xml/htdocs/proj/en/glep/ +.. [#CVS] https://gitweb.gentoo.org/archive/proj/gentoo.git/log/xml/htdocs/proj/en/glep .. [#WIKI] https://wiki.gentoo.org/index.php?title=Special%3AAllPages&from=&to=&namespace=550 diff --git a/glep-0056.rst b/glep-0056.rst index eb03f17..f9a5e0e 100644 --- a/glep-0056.rst +++ b/glep-0056.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Replaced Version: 1 Created: 2008-06-03 -Last-Modified: 2020-04-12 +Last-Modified: 2023-02-21 Post-History: 2008-06-05, 2008-06-13 Content-Type: text/x-rst Replaced-By: 68 @@ -107,9 +107,9 @@ References .. [#use-flag-metadata-bug] https://bugs.gentoo.org/199788 -.. [#use-flag-metadata-example1] https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/sys-apps/hal/metadata.xml?view=markup +.. [#use-flag-metadata-example1] https://gitweb.gentoo.org/archive/repo/gentoo-2.git/tree/sys-apps/hal/metadata.xml?id=37af07d2465e22f74394aa2ff2fd80698ac2d12b -.. [#use-flag-metadata-example2] https://sources.gentoo.org/cgi-bin/viewvc.cgi/gentoo-x86/media-tv/mythtv/metadata.xml?view=markup +.. [#use-flag-metadata-example2] https://gitweb.gentoo.org/archive/repo/gentoo-2.git/tree/media-tv/mythtv/metadata.xml?id=37af07d2465e22f74394aa2ff2fd80698ac2d12b .. [#devhandbook] https://devmanual.gentoo.org/ebuild-writing/misc-files/metadata/index.html
[gentoo-commits] data/glep:master commit in: /
commit: c9b977dce26aa2242d68f14876f745d9384fe7ca Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 16:41:02 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Mar 12 20:08:27 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c9b977dc glep-0042: Specify that "Posted" date must be in UTC Bug: https://bugs.gentoo.org/895728 Signed-off-by: Ulrich Müller gentoo.org> glep-0042.rst | 11 ++- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/glep-0042.rst b/glep-0042.rst index 0c40261..69d7f6e 100644 --- a/glep-0042.rst +++ b/glep-0042.rst @@ -9,7 +9,7 @@ Type: Standards Track Status: Final Version: 4 Created: 2005-10-31 -Last-Modified: 2019-11-07 +Last-Modified: 2023-02-22 Post-History: 2005-11-01, 2005-11-05, 2005-11-07, 2005-12-11, 2005-12-13, 2005-12-18, 2006-01-05, 2006-03-02, 2006-03-06, 2006-06-12, 2006-09-05, 2016-03-10, 2017-11-27 @@ -237,7 +237,8 @@ The following headers describe the purpose and format of the news item: ``Posted:`` Date of posting, in ``-mm-dd`` format (e.g. 2005-12-18) for -compatibility with GLEP 45 [#glep-45]_. Translations should use the date +compatibility with GLEP 45 [#glep-45]_. The date must be represented +in UTC (Coordinated Universal Time). Translations should use the date of the original news item. Mandatory. ``Revision:`` @@ -519,8 +520,8 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/. .. vim: set tw=80 fileencoding=utf-8 spell spelllang=en et :
[gentoo-commits] data/glep:master commit in: /
commit: 41c04a323b363c7755fb90bc72c66d3f173716b7 Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 16:39:31 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Mar 12 20:08:22 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=41c04a32 glep-{0001,0002}: Specify that all dates must be in UTC Bug: https://bugs.gentoo.org/895728 Signed-off-by: Ulrich Müller gentoo.org> glep-0001.rst | 5 +++-- glep-0002.rst | 9 + 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/glep-0001.rst b/glep-0001.rst index 5b33558..a522014 100644 --- a/glep-0001.rst +++ b/glep-0001.rst @@ -8,7 +8,7 @@ Type: Informational Status: Active Version: 4 Created: 2003-05-31 -Last-Modified: 2022-07-08 +Last-Modified: 2023-02-22 Post-History: 2003-06-01, 2003-07-02, 2008-01-19, 2008-06-05, 2011-03-09, 2013-12-14, 2017-09-17, 2018-07-10, 2019-11-24 Content-Type: text/x-rst @@ -294,7 +294,8 @@ The Created header records the date that the GLEP was assigned a number, Last-Modified specifies the date that the GLEP was last updated in the master branch, while Post-History is used to record the dates of when new versions of the GLEP are posted to the appropriate mailing list. All three headers -should be in ISO 8601 ``-mm-dd`` format, e.g. 2001-08-14. +should be in ISO 8601 ``-mm-dd`` format, e.g. 2001-08-14, with the dates +represented in UTC (Coordinated Universal Time). The format of a GLEP is specified with a Content-Type header, which must be "text/x-rst" for ReStructuredText GLEPs (see GLEP 2 [#GLEP2]_). diff --git a/glep-0002.rst b/glep-0002.rst index ab68ee9..95cbe7c 100644 --- a/glep-0002.rst +++ b/glep-0002.rst @@ -8,7 +8,7 @@ Type: Informational Status: Active Version: 4.1 Created: 2003-05-31 -Last-Modified: 2022-07-09 +Last-Modified: 2023-02-22 Post-History: 2003-06-02, 2013-12-17, 2017-09-17, 2019-11-24 Content-Type: text/x-rst --- @@ -98,7 +98,8 @@ directions below. - Reset the Version to "1". - Change the Created and Last-Modified headers to today's date. Be sure to - follow the format carefully: it must be in ISO 8601 ``-mm-dd`` format. + follow the format carefully: it must be in ISO 8601 ``-mm-dd`` format, + with the date represented in UTC (Coordinated Universal Time). - Reset the Post-History to empty for now; you'll add dates to this header each time you post your GLEP to gentoo-...@lists.gentoo.org. If you @@ -107,8 +108,8 @@ directions below. Post-History: 2003-08-14, 2003-09-03 - You must manually add new dates and check them in. If you don't have - check-in privileges, send your changes to the GLEP editors. + You must manually add new dates (again, in UTC) and check them in. If you + don't have check-in privileges, send your changes to the GLEP editors. - For Standards Track GLEPs, if your feature depends on the acceptance of some other currently in-development GLEP, add a Requires header right
[gentoo-commits] data/glep:master commit in: /
commit: d9ee35e0bd53b28e7cc1ffd6f2c4e4f1ad028b0a Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 07:23:19 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Wed Feb 22 15:59:52 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=d9ee35e0 glep-0068: Allow EAPI 5 dependency specifications This applies to the "restrict" attribute which is used with the "maintainer", "longdescription", "flag", and "stabilize-allarches" elements. Closes: https://bugs.gentoo.org/895790 Reviewed-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0068.rst | 16 +++- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/glep-0068.rst b/glep-0068.rst index 9d10aaa..ca75991 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -4,9 +4,9 @@ Title: Package and category metadata Author: Michał Górny Type: Standards Track Status: Final -Version: 1.3 +Version: 1.4 Created: 2016-03-14 -Last-Modified: 2022-10-14 +Last-Modified: 2023-01-22 Post-History: 2016-03-16, 2018-02-20, 2022-05-22, 2022-10-07 Content-Type: text/x-rst Requires: 67 @@ -118,7 +118,7 @@ of ``en`` is assumed. Restriction specifiers are used whenever an element supports restricting to specific package versions. In this case, each occurence of the element may -contain an optional ``restrict=""`` attribute that contains an EAPI 0 +contain an optional ``restrict=""`` attribute that contains an EAPI 5 dependency specification that has to match one or more versions of the package. In this case, the metadata provided by the element applies only to the package versions matching the restriction. @@ -341,8 +341,9 @@ added three clarifications to it: - only package dependency specifications are allowed (i.e. no USE-conditionals or multiple dependency specifications), -- only EAPI=0 dependency specifications are allowed, since ``metadata.xml`` - provides no EAPI identification mechanism and it predates EAPI, +- EAPI 5 dependency specifications are allowed. Although ``metadata.xml`` + provides no EAPI identification mechanism, the top-level profile directory + specifies EAPI 5, and Portage supports EAPI 5 since 2012. - only dependencies referencing the same package are allowed. @@ -452,6 +453,11 @@ Example metadata.xml file develo...@example.com Example Developer + +another...@example.com +Another Developer +CC only on bugs for libfoo.so.11 + proj...@example.com Example Project
[gentoo-commits] data/glep:master commit in: /
commit: c25b5d2d047dc0b17c285aeaf758adb359e5ab20 Author: Ulrich Müller gentoo org> AuthorDate: Wed Feb 22 16:36:28 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Wed Feb 22 16:36:28 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c25b5d2d glep-0068: Update Post-History Signed-off-by: Ulrich Müller gentoo.org> glep-0068.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0068.rst b/glep-0068.rst index ca75991..f822c6e 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -6,8 +6,8 @@ Type: Standards Track Status: Final Version: 1.4 Created: 2016-03-14 -Last-Modified: 2023-01-22 -Post-History: 2016-03-16, 2018-02-20, 2022-05-22, 2022-10-07 +Last-Modified: 2023-02-22 +Post-History: 2016-03-16, 2018-02-20, 2022-05-22, 2022-10-07, 2023-02-22 Content-Type: text/x-rst Requires: 67 Replaces: 34, 46, 56
[gentoo-commits] data/glep:master commit in: /
commit: ee00c93b5ef6c8d687fef55875d4f46caef04a2b Author: Ulrich Müller gentoo org> AuthorDate: Wed Apr 6 06:27:03 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Wed Feb 22 08:15:07 2023 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=ee00c93b glep-0059: Fix spelling of "deprecate" Closes: https://bugs.gentoo.org/836876 Acked-By: Robin H. Johnson gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0059.rst | 18 +- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/glep-0059.rst b/glep-0059.rst index 035ee45..ae50b66 100644 --- a/glep-0059.rst +++ b/glep-0059.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Final Version: 1 Created: 2008-10-22 -Last-Modified: 2017-11-16 +Last-Modified: 2022-04-06 Post-History: 2009-12-01, 2010-01-31 Content-Type: text/x-rst Requires: 44 @@ -107,7 +107,7 @@ by a preference list. Over time, the weaker checksums should be removed from Manifest2 files, once all old Portage installations have had sufficient time to upgrade. Stronger checksums shall be added as soon as an implementation is available in Portage. Weak checksums may be removed -as long as the depreciation process is followed (see below). +as long as the deprecation process is followed (see below). As soon as feasible, we should add the SHA512 and WHIRLPOOL algorithms. In future, as stream-based checksums are developed (in response to the @@ -124,21 +124,21 @@ Python implementations available, ranging from pure Python to C-based The existence unsupported hash is not considered to be a failure unless no supported hashes are available for a given Manifest entry. -Checksum depreciation timing - +Checksum deprecation timing +--- General principles: ~~~ -A minimum set of depreciated checksums shall be maintained only to +A minimum set of deprecated checksums shall be maintained only to support old package manager versions where needed by historically used trees: -- New package manager versions should NOT use depreciated checksums in +- New package manager versions should NOT use deprecated checksums in -- New trees with that have never used the depreciated checksums may omit +- New trees with that have never used the deprecated checksums may omit them for reasons of size, but are still strongly suggested to include them. -- Removal of depreciated checksums shall happen after no less than 18 +- Removal of deprecated checksums shall happen after no less than 18 months or one major Portage version cycle, whichever is greater. Immediate plans: @@ -162,7 +162,7 @@ After the majority of Portage installations include SHA512 support: Backwards Compatibility === Old versions of Portage may support and expect only specific checksums. -This is accounted for in the checksum depreciation discussion. +This is accounted for in the checksum deprecation discussion. For maximum compatibility, we should only have to include each of the old algorithms that we are officially still supporting, as well as the
[gentoo-commits] data/glep:master commit in: /
commit: 35d78b0e98258a8f0ea45e7b6cce4fe70d63a6d6 Author: Michał Górny gentoo org> AuthorDate: Tue Nov 15 20:10:29 2022 + Commit: Michał Górny gentoo org> CommitDate: Tue Nov 15 20:10:29 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=35d78b0e glep-0078: Fix a typo in footnote reference Signed-off-by: Michał Górny gentoo.org> glep-0078.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 3c7e899..1282838 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -7,7 +7,7 @@ Type: Standards Track Status: Accepted Version: 1.1 Created: 2018-11-15 -Last-Modified: 2022-09-21 +Last-Modified: 2022-11-15 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28, 2022-09-21 Content-Type: text/x-rst @@ -359,7 +359,7 @@ compressed members in those circumstances. The signatures are created as binary detached OpenPGP signature files as defined by RFC 4880 § 11.4 or a subsequent standard, with filename corresponding to the member filename with ``.sig`` suffix appended -[#RFC-4880]_. +[#RFC4880]_. The exact details regarding creating and verifying signatures, as well as maintaining and distributing keys are outside the scope of this
[gentoo-commits] data/glep:master commit in: /
commit: 6f462732060cdec7b5aa3a952155b55a68490c86 Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 18:09:13 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:41 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=6f462732 glep-0078: Clarify that Manifest is signed too Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/glep-0078.rst b/glep-0078.rst index 8b6fabb..d77576a 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -328,7 +328,9 @@ the inner archive contents. This file also provides protection against signature reuse/replacement attacks if the OpenPGP signatures are used. The implementation follows the Manifest specifications in GLEP 74 -[#GLEP74]_ and uses the DATA tag for files within the container. +and uses the ``DATA`` tag for files within the container. +If the package is using OpenPGP signatures, the Manifest file must also +include a cleartext OpenPGP signature as defined in GLEP 74 [#GLEP74]_. The implementation should be able to detect checksum mismatches, as well as missing, duplicate, or extraneous files within
[gentoo-commits] data/glep:master commit in: /
commit: e10ae4cbdd5233b5a249728b26cd4aeed20a85f5 Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 18:14:09 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:41 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=e10ae4cb glep-0078: Clarify that Manifest must be present for signed binpkg Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 5 + 1 file changed, 5 insertions(+) diff --git a/glep-0078.rst b/glep-0078.rst index d77576a..3c7e899 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -228,6 +228,11 @@ If the Manifest is present, all files contained in the archive must be listed in it and verify successfully. The package manager should ignore unknown files but preserve them across package updates. +For a binary package to be considered signed and suitable for +authenticity verification, the Manifest file must be present and contain +a valid signature. It is recommended to include detached signatures +for archive members as well. + Permitted .tar format features --
[gentoo-commits] data/glep:master commit in: /
commit: f32c94f10397fd7f351c36430ccf31332e0b9653 Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 18:01:40 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:40 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f32c94f1 glep-0078: Link compressed file formats to GLEP 74 Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 18 ++ 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 994c023..40c451c 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -5,7 +5,7 @@ Author: Michał Górny , Sheng Yu Type: Standards Track Status: Accepted -Version: 1 +Version: 1.1 Created: 2018-11-15 Last-Modified: 2022-09-21 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28, @@ -304,15 +304,17 @@ Archive member compression The archive members outlined above support optional compression using one of the compressed file formats supported by the package manager. -The exact list of compression types is outside the scope of this -specification. +The list of compression types is maintained in GLEP 74 [#GLEP74]_. +The package manager may implement an arbitrary subset of compressed file +formats. However, it is recommended that it can uncompress all formats +that are not listed as deprecated. The implementations must support archive members being uncompressed, and must support using different compression types for different files. When compressing an archive member, the member filename should be -suffixed using the standard suffix for the particular compressed file -type (e.g. ``.bz2`` for bzip2 format). +suffixed using the suffix for the particular compressed file type +specified in GLEP 74. The package Manifest file @@ -638,15 +640,15 @@ References .. [#GNU-TAR] GNU tar: an archiver tool, Appendix E Tar Internals (https://www.gnu.org/software/tar/manual/html_node/Tar-Internals.html) +.. [#GLEP74] GLEP 74: Full-tree verification using Manifest files + (https://www.gentoo.org/glep/glep-0074.html) + .. [#DEB-FORMAT] deb(5) — Debian binary package format (https://manpages.debian.org/unstable/dpkg-dev/deb.5.en.html) .. [#TAR-PORTABILITY] Michał Górny, Portability of tar features (https://dev.gentoo.org/~mgorny/articles/portability-of-tar-features.html) -.. [#GLEP74] GLEP 74: Full-tree verification using Manifest files - (https://www.gentoo.org/glep/glep-0074.html) - .. [#XPAK2GPKG] xpak2gpkg: Proof-of-concept converter from tbz2/xpak to gpkg binpkg format (https://github.com/mgorny/xpak2gpkg)
[gentoo-commits] data/glep:master commit in: /
commit: 6238f7df2e934a67dbb10d0b06a6205b21bc4a87 Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 17:36:00 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:39 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=6238f7df glep-0078: Replace "basename" with non-ambiguous explanation It has been pointed out that the "basename" term may be ambiguous in the context. Explain explicitly that it is the filename with .gpkg.tar suffix stripped. Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 14 -- 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 05ceba9..e841f00 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -7,8 +7,9 @@ Type: Standards Track Status: Accepted Version: 1 Created: 2018-11-15 -Last-Modified: 2022-08-14 -Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28 +Last-Modified: 2022-09-21 +Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28, + 2022-09-21 Content-Type: text/x-rst --- @@ -193,10 +194,11 @@ The gpkg package container is an uncompressed .tar achive whose filename should use ``.gpkg.tar`` suffix. The archive contains a number of files. All package-related files -should be stored in a single directory whose name matches the basename -of the package file. However, the implementation must be able to -process an archive where the directory name is mismatched. There should -be no explicit archive member entry for the directory. +should be stored in a single directory whose name matches the package +filename after stripping the ``.gpkg.tar`` suffix. However, +the implementation must be able to process an archive where +the directory name is mismatched. There should be no explicit archive +member entry for the directory. The package directory contains the following members, in order:
[gentoo-commits] data/glep:master commit in: /
commit: d1bcfd642092dcf317da669dd20aeb7fa8af91ee Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 18:06:35 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:40 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=d1bcfd64 glep-0078: Link OpenPGP to RFC 4880 Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 10 +++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 40c451c..8b6fabb 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -349,9 +349,10 @@ not verify, the package manager must reject processing the corresponding archive member. In particular, it must not attempt decompressing compressed members in those circumstances. -The signatures are created as binary detached OpenPGP signature files, -with filename corresponding to the member filename with ``.sig`` suffix -appended. +The signatures are created as binary detached OpenPGP signature files +as defined by RFC 4880 § 11.4 or a subsequent standard, with filename +corresponding to the member filename with ``.sig`` suffix appended +[#RFC-4880]_. The exact details regarding creating and verifying signatures, as well as maintaining and distributing keys are outside the scope of this @@ -643,6 +644,9 @@ References .. [#GLEP74] GLEP 74: Full-tree verification using Manifest files (https://www.gentoo.org/glep/glep-0074.html) +.. [#RFC4880] RFC 4880: OpenPGP Message Format + (https://www.rfc-editor.org/rfc/rfc4880) + .. [#DEB-FORMAT] deb(5) — Debian binary package format (https://manpages.debian.org/unstable/dpkg-dev/deb.5.en.html)
[gentoo-commits] data/glep:master commit in: /
commit: fe6a88cc8debf6f310da7b75b389997add9c48d9 Author: Michał Górny gentoo org> AuthorDate: Wed Sep 21 17:50:30 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Nov 13 20:19:39 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=fe6a88cc glep-0078: Link tar format to the respective standards Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 13 +++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index e841f00..994c023 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -232,8 +232,10 @@ ignore unknown files but preserve them across package updates. Permitted .tar format features -- -The tar archives should use either the POSIX ustar format or a subset -of the GNU format with the following (optional) extensions: +The tar archives should use either the POSIX ustar format as defined +by POSIX.1-2017 [#POSIX-USTAR]_ or a subset of the ustar-compatible +GNU tar format as described in the GNU tar manual [#GNU-TAR]_ with +the following (optional) extensions: - long pathnames and long linknames, @@ -629,6 +631,13 @@ References written in C (https://packages.gentoo.org/packages/app-portage/portage-utils) +.. [#POSIX-USTAR] The Open Group Base Specifications Issue 7, 2018 + edition, pax - portable archive interchange, ustar Interchange Format + (https://pubs.opengroup.org/onlinepubs/9699919799/utilities/pax.html#tag_20_92_13_06) + +.. [#GNU-TAR] GNU tar: an archiver tool, Appendix E Tar Internals + (https://www.gnu.org/software/tar/manual/html_node/Tar-Internals.html) + .. [#DEB-FORMAT] deb(5) — Debian binary package format (https://manpages.debian.org/unstable/dpkg-dev/deb.5.en.html)
[gentoo-commits] data/glep:master commit in: /
commit: 64b0e12172204bc2d4da087106fe2b63c41f1f78 Author: Ulrich Müller gentoo org> AuthorDate: Wed Nov 2 12:03:22 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Nov 3 12:39:48 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=64b0e121 glep-0011: Restore missing author Fixes: 87c7e6ac57539a57d18f714c69eace8a63114654 Signed-off-by: Ulrich Müller gentoo.org> glep-0011.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/glep-0011.rst b/glep-0011.rst index 91dbe4a..2eaaa39 100644 --- a/glep-0011.rst +++ b/glep-0011.rst @@ -1,7 +1,8 @@ --- GLEP: 11 Title: Web Application Installation -Author: Stuart Herbert +Author: Troy Dack , +Stuart Herbert Type: Standards Track Status: Final Version: 1
[gentoo-commits] data/glep:master commit in: /
commit: f272c4405c21296760f286f9f2665f6e8dc22085 Author: Petr Vaněk atlas cz> AuthorDate: Wed Nov 2 10:53:16 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Nov 3 12:39:39 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f272c440 glep-0011: Add double spaces after . Signed-off-by: Petr Vaněk atlas.cz> Signed-off-by: Ulrich Müller gentoo.org> glep-0011.rst | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/glep-0011.rst b/glep-0011.rst index 50009e3..91dbe4a 100644 --- a/glep-0011.rst +++ b/glep-0011.rst @@ -34,8 +34,8 @@ Definitions *Web Application Instance* An apparent install of the Web Application that is served up via the - webserver. There may be any number of instances per Web Application. - This is a major use for web applications. Our Gentoo Zope setup + webserver. There may be any number of instances per Web Application. + This is a major use for web applications. Our Gentoo Zope setup already provides instances and can be used for some concepts on this matter. @@ -209,7 +209,7 @@ must. To enable support for multiple virtual host installations a new USE flag is -to be added to Portage. The use flag will be:: +to be added to Portage. The use flag will be:: vhost @@ -220,7 +220,7 @@ application will be affected, see below for more details. To assist administration of multiple virtual hosts a "VHost Configuration Tool" -needs to be developed and implemented. Initial discussion regarding the VHost +needs to be developed and implemented. Initial discussion regarding the VHost Config tool and proposed usage can be found at [#VHost-Config-Tool]_. It's the job of the VHost Config toolset to make a local instance of the web
[gentoo-commits] data/glep:master commit in: /
commit: 0595fad704bdd1df3a5b5993887ac0a7673ab51d Author: Petr Vaněk atlas cz> AuthorDate: Wed Nov 2 10:53:15 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Nov 3 12:39:38 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=0595fad7 glep-0011: Conform directory convention The trailing slash should be present when describing the location of directory according to *Conventions* section. This change unifies all appearances of /home/httpd/ in this document. Signed-off-by: Petr Vaněk atlas.cz> Signed-off-by: Ulrich Müller gentoo.org> glep-0011.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/glep-0011.rst b/glep-0011.rst index e2ea5bd..50009e3 100644 --- a/glep-0011.rst +++ b/glep-0011.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Final Version: 1 Created: 2003-08-02 -Last-Modified: 2019-11-07 +Last-Modified: 2022-11-02 Post-History: 2003-08-07, 2003-08-12, 2003-08-13, 2006-09-03 Content-Type: text/x-rst --- @@ -165,7 +165,7 @@ add support for Apache 2 as well as supporting Apache 1 installations. 2. Application Installation --- -The current accepted standard Document Root in Gentoo is /home/httpd. The +The current accepted standard Document Root in Gentoo is /home/httpd/. The discussion suggest that this is not the best location to install web based applications. @@ -297,7 +297,7 @@ Backwards Compatibility There may be some issues regarding compatibility with existing installs of web applications. This is particularly true if the default Document Root is -moved from what is accepted as the current standard (/home/httpd). +moved from what is accepted as the current standard (/home/httpd/). The main issues are: * transition of existing configuration files to the
[gentoo-commits] data/glep:master commit in: /
commit: 1da78d3a58cedb1309a729cfeeb250e50963db9a Author: Petr Vaněk atlas cz> AuthorDate: Wed Nov 2 10:53:17 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Nov 3 12:39:39 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=1da78d3a glep-0023: Add double space after . Signed-off-by: Petr Vaněk atlas.cz> Signed-off-by: Ulrich Müller gentoo.org> glep-0023.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0023.rst b/glep-0023.rst index 398fad1..e13f64b 100644 --- a/glep-0023.rst +++ b/glep-0023.rst @@ -100,8 +100,8 @@ The format of this file is ... Also any line starting with # is ignored and may be used for comments. -Group names use the same syntax as normal license names. Also license groups -may contain other groups. +Group names use the same syntax as normal license names. Also license +groups may contain other groups. License groups may not contain negated elements, so a group ::
[gentoo-commits] data/glep:master commit in: /
commit: 6a39fe543944bfa68288f41331d922b4edea6ad9 Author: Michał Górny gentoo org> AuthorDate: Sat Oct 22 14:58:32 2022 + Commit: Michał Górny gentoo org> CommitDate: Sun Oct 30 13:58:57 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=6a39fe54 glep-0074: Reference RFC 3339 instead of ISO 8601 Reference the open RFC 3339 standard instead of ISO 8601. Firstly, because closed standards are not something people can easily look into. Secondly, because we only need a very small subset of what ISO 8601 defines and RFC 3339 provides exactly that. Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 12 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index d5e5057..93d75b0 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -8,8 +8,9 @@ Type: Standards Track Status: Final Version: 1.3 Created: 2017-10-21 -Last-Modified: 2022-10-04 -Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11 +Last-Modified: 2022-10-30 +Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11, + 2022-10-22 Content-Type: text/x-rst Requires: 59, 61 Replaces: 44, 58, 60 @@ -267,8 +268,8 @@ The Manifest files can specify the following tags: ``TIMESTAMP `` Specifies a timestamp of when the Manifest file was last updated. - The timestamp must be a valid second-precision ISO 8601 extended - format combined date and time in UTC timezone, i.e. using + The timestamp must be a valid second-precision RFC 3339 format + combined date and time in UTC timezone [#RFC3339]_, i.e. using the following ``strftime()`` format string: ``%Y-%m-%dT%H:%M:%SZ``. Optional. The package manager can use it to detect an outdated repository checkout as described in `Timestamp verification`_. @@ -1211,6 +1212,9 @@ References .. [#UNICODE] The Unicode standard (https://unicode.org/versions/latest/) +.. [#RFC3339] RFC 3339: Date and Time on the Internet: Timestamps + (https://www.rfc-editor.org/rfc/rfc3339) + .. [#PMS-FETCH] Package Manager Specification: Dependency Specification Format - SRC_URI (https://projects.gentoo.org/pms/6/pms.html#x1-940008.2.10)
[gentoo-commits] data/glep:master commit in: /
commit: 75261f97e6ea138d53f4b38834082ba4a10e0183 Author: Michał Górny gentoo org> AuthorDate: Fri Oct 7 20:22:22 2022 + Commit: Michał Górny gentoo org> CommitDate: Fri Oct 14 15:34:59 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=75261f97 glep-0068: Clarify and restrict XML data format Explicitly specify XML 1.0 and link to the specification. Forbid "external markup declarations" and processing DTDs to secure against common XML attacks. Signed-off-by: Michał Górny gentoo.org> glep-0068.rst | 21 ++--- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/glep-0068.rst b/glep-0068.rst index 78ac7ea..a2bee64 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -4,10 +4,10 @@ Title: Package and category metadata Author: Michał Górny Type: Standards Track Status: Final -Version: 1.2 +Version: 1.3 Created: 2016-03-14 -Last-Modified: 2022-05-22 -Post-History: 2016-03-16, 2018-02-20, 2022-05-22 +Last-Modified: 2022-10-14 +Post-History: 2016-03-16, 2018-02-20, 2022-05-22, 2022-10-07 Content-Type: text/x-rst Requires: 67 Replaces: 34, 46, 56 @@ -59,10 +59,14 @@ Metadata files -- This specification provides two kinds of metadata files: category metadata -files and package metadata files. Both kinds of files use XML file format -with structure defined in this GLEP. The XML structure does not use -a namespace and must not contain any elements outside the scope of this -specification. +files and package metadata files. Both kinds of files use the XML 1.0 file +format [#XML10]_. They must not use external markup declarations, as defined +in the XML specification. While they may reference or include a DTD, the parser +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. Category metadata files are named ``metadata.xml`` and located inside category directories in an ebuild repository. Their structure is described @@ -516,6 +520,9 @@ References .. [#METADATA-DTD] The original metadata.dtd file https://gitweb.gentoo.org/data/dtd.git/tree/metadata.dtd?id=a908a93b5afe295359e0a01814c9bef8b5268bcd +.. [#XML10] Extensible Markup Language (XML) 1.0 (Fifth Edition) + https://www.w3.org/TR/xml/ + .. [#BCP-47] BCP 47: "Tags for identifying languages", https://tools.ietf.org/rfc/bcp/bcp47.txt
[gentoo-commits] data/glep:master commit in: /
commit: 5330e6efbdf16a1aef8b257201359f224484f235 Author: Michał Górny gentoo org> AuthorDate: Fri Oct 7 20:24:52 2022 + Commit: Michał Górny gentoo org> CommitDate: Fri Oct 14 15:35:01 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=5330e6ef glep-0068: Indicate that unknown elements should be ignored 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 gentoo.org> glep-0068.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/glep-0068.rst b/glep-0068.rst index a2bee64..9d10aaa 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
[gentoo-commits] data/glep:master commit in: /
commit: 2044fddc9109876cb8b908c0749cc2eaaccffab3 Author: Michał Górny gentoo org> AuthorDate: Fri Sep 23 13:19:18 2022 + Commit: Michał Górny gentoo org> CommitDate: Tue Oct 4 06:56:08 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=2044fddc glep-0074: Specify the format of size and checksum fields Closes: https://bugs.gentoo.org/872332 Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 13 + 1 file changed, 13 insertions(+) diff --git a/glep-0074.rst b/glep-0074.rst index 0a55ad4..5cf0708 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -191,6 +191,19 @@ The encoding can be used for other characters as well. In particular, escaping non-printable characters might be desirable. +Size and checksum fields + + +The Manifest entries used to describe files list the file size in bytes +and one or more checksums. The size is expressed as an unsigned decimal +integer. The checksums are expressed using pairs of fields, with +the first field in every pair specifying the hash name and the second +field its value. The names of hashes and the encoding of their values +are specified in the `checksum algorithms`_ section. + +It is invalid to specify a hash name without a value. + + File verification -
[gentoo-commits] data/glep:master commit in: /
commit: 9b53e76d502b457efb38e69645ef7f8da5e28190 Author: Michał Górny gentoo org> AuthorDate: Fri Sep 23 13:09:19 2022 + Commit: Michał Górny gentoo org> CommitDate: Tue Oct 4 06:56:01 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=9b53e76d glep-0074: Clarify that DIST entries are specific to PMs Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 5 - 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/glep-0074.rst b/glep-0074.rst index 7f53302..0a55ad4 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -8,7 +8,7 @@ Type: Standards Track Status: Final Version: 1.3 Created: 2017-10-21 -Last-Modified: 2022-09-21 +Last-Modified: 2022-10-04 Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11 Content-Type: text/x-rst Requires: 59, 61 @@ -286,6 +286,9 @@ The Manifest files can specify the following tags: ``DIST`` entries apply to all packages below the Manifest file specifying them. + This entry is specific to package manager use and it is not used + when verifying local directories. + Deprecated Manifest tags
[gentoo-commits] data/glep:master commit in: /
commit: 0dcde7c19a93fbc13180e1a0708c83557f3de4e7 Author: Michał Górny gentoo org> AuthorDate: Fri Sep 23 13:34:40 2022 + Commit: Michał Górny gentoo org> CommitDate: Tue Oct 4 06:56:08 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=0dcde7c1 glep-0074: Clarify the hex encoding of hash values Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 8 1 file changed, 8 insertions(+) diff --git a/glep-0074.rst b/glep-0074.rst index 5cf0708..d5e5057 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -418,6 +418,14 @@ Checksum algorithms | ``WHIRLPOOL`` | Whirlpool [#BARRETO]_ | 512 | Hex | | +-+---+--+--+-+ +The following hash value encodings are used: + +Hex + The hash value expressed as an unsigned hexadecimal integer, + using digits ``0`` to ``9`` and lowercase letters ``a`` to ``f``, + with no prefix or suffix. + + Any new hashes must be added to this specification prior to being used in Manifest files. Adding a new hash is considered a backwards-compatible change to the GLEP. It is recommended that new
[gentoo-commits] data/glep:master commit in: /
commit: 06c577a0e72864859fbb2fb1cb7b7e8d60a78d79 Author: Michał Górny gentoo org> AuthorDate: Sun Sep 11 11:54:56 2022 + Commit: Michał Górny gentoo org> CommitDate: Wed Sep 21 17:31:41 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=06c577a0 glep-0074: Specify compressed file formats Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 81 +++ 1 file changed, 71 insertions(+), 10 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index 3d7bbbd..7f53302 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -27,7 +27,8 @@ Changes === v1.3 - Formally specified the current set of hash algorithms supported. + Formally specified the current set of hash algorithms and compressed + Manifest formats supported. v1.2 Specified the newline convention used for Manifests. @@ -432,9 +433,8 @@ compression and this specification. The compressed Manifest files are required to be suffixed for their compression algorithm. This suffix should be used to recognize -the compression and decompress Manifests transparently. The exact list -of algorithms and their corresponding suffixes are outside the scope -of this specification. +the compression and decompress Manifests transparently. The supported +formats are specified in `compressed file formats`_ section. The top-level Manifest file must not be compressed. Since the OpenPGP signature covers the uncompressed text and is compressed itself, @@ -455,6 +455,46 @@ uncompressed content and the specification is free to choose either of the files using the same base name. +Compressed file formats +--- + +.. table:: Table 2. Defined compressed file formats + :widths: auto + + === == === + Tool nameSuffix Specification Notes + === == === + bzip2.bz2(none known) + gzip .gz RFC 1952 [#RFC1952]_ Recommended + lz4 .lz4(none known) + lzip .lz RFC draft [#LZIP]_ + lzma .lzma (none known) Deprecated + lzop .lzo(none known) + xz .xz xz [#XZ]_ + zstd .zstRFC 8878 [#RFC8878]_ + === == === + +Any new formats must be added to this specification prior to being used +for Manifest files. Adding a new compressed file format is considered +a backwards-compatible change to the GLEP. It is recommended that new +formats use their reference (most common) file suffixes. + +An implementation can implement an arbitrary subset of the listed +formats. For best interoperability, it should implement at least +the recommended formats. Using deprecated formats should be avoided. + +If multiple Manifest variants coexist using different compressed file +formats, the implementation may choose to use an arbitrary subset +of them. However, all of them must be verified against the hashes stored +in the containing Manifest. Should they be decompressed, the resulting +contents must be identical. + +If the compressed file format is unsupported and a variant using +a supported format coexists, the other variant should be used. However, +at least one supported variant must exist for the verification +to succeed. + + Combining multiple Manifest trees (informational) - @@ -1033,12 +1073,19 @@ into a compressed sub-Manifest in the top directory (e.g. ``Manifest.sub.gz``), and including a ``MANIFEST`` entry for this file in a signed, uncompressed top-level Manifest. -The existence of additional entries for uncompressed Manifest checksums -was debated. However, plain entries for the uncompressed file would -be confusing if only the compressed file existed, and conflicting -if both uncompressed and compressed variants existed. Furthermore, -it has been pointed out that ``DIST`` entries do not have -an uncompressed variant either. +The existence of additional entries for checksums of Manifest contents +after uncompressing was debated. However, plain entries for +the uncompressed file would be confusing if only the compressed file +existed. Furthermore, it has been pointed out that ``DIST`` entries +do not have an uncompressed variant either. + +The specification permits coexistence of multiple variants of the same +Manifest file using different compression for historical compatibility. +However, there does not seem to be any real benefit from including +a compressed Manifest file if the uncompressed variant needs to exist +anyway. Providing different compressed variants could technically +improve interoperability, though the same result could probably +be achieved by using a more commonly supported format (e.g. gzip). Performance considerations @@ -1171,6 +1218,20 @@ References (archived at 2017-11-29) (https://web.archive.org/web/
[gentoo-commits] data/glep:master commit in: /
commit: 26220236cdb5a8a743513fb57990961b9df2fcbe Author: Michał Górny gentoo org> AuthorDate: Sun Sep 11 11:01:38 2022 + Commit: Michał Górny gentoo org> CommitDate: Wed Sep 21 17:31:41 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=26220236 glep-0074: Specify supported hash algorithms Replace the informational hash name section with a formal specification of allowed hash algorithms. The original reasoning for leaving them implementation-defined was poor. After all, not a single new hash was added since the initial version of the GLEP. At the same time, ensuring consistent support for at least a minimal set of hash algorithms is crucial to interoperability. Given that the effort needed to update the GLEP is relatively small, it is better to require all algorithms to be formally listed than to have to track all implementations for new hashes and hope for consistency. Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 177 +- 1 file changed, 127 insertions(+), 50 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index c55242f..3d7bbbd 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -6,7 +6,7 @@ Author: Michał Górny , Ulrich Müller Type: Standards Track Status: Final -Version: 1.2 +Version: 1.3 Created: 2017-10-21 Last-Modified: 2022-09-21 Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11 @@ -26,6 +26,9 @@ efficient and provide means of backwards compatibility. Changes === +v1.3 + Formally specified the current set of hash algorithms supported. + v1.2 Specified the newline convention used for Manifests. @@ -364,27 +367,60 @@ up to and including the *original* directory. Note that those sub-Manifests can use different filenames than ``Manifest``. -Checksum algorithms (informational) - -This section is informational only. Specifying the exact set -of supported algorithms is outside the scope of this specification. - -The algorithm names reserved at the time of writing are: - -- ``MD5`` [#MD5]_, -- ``RMD160`` -- RIPEMD-160 [#RIPEMD160]_, -- ``SHA1`` [#SHS]_, -- ``SHA256`` and ``SHA512`` -- SHA-2 family of hashes [#SHS]_, -- ``WHIRLPOOL`` [#WHIRLPOOL]_, -- ``BLAKE2B`` and ``BLAKE2S`` -- BLAKE2 family of hashes [#BLAKE2]_, -- ``SHA3_256`` and ``SHA3_512`` -- SHA-3 family of hashes [#SHA3]_, -- ``STREEBOG256`` and ``STREEBOG512`` -- Streebog family of hashes - [#STREEBOG]_. - -The method of introducing new hashes is defined by GLEP 59 [#GLEP59]_. -It is recommended that any new hashes are named after the Python -``hashlib`` module algorithm names, transformed into uppercase. +Checksum algorithms +--- + +.. table:: Table 1. Defined hash algorithms + :widths: auto + + +-+---+--+--+-+ + | Name| Specification | Bits | Enc. | Notes | + +=+===+==+==+=+ + | ``BLAKE2B`` | | 512 | Hex | Recommended | + +-+ RFC 7693 [#RFC7693]_ +--+--+-+ + | ``BLAKE2S`` | | 256 | Hex | | + +-+---+--+--+-+ + | ``MD5`` | RFC 1321 [#RFC1321]_ | 128 | Hex | Deprecated | + +-+---+--+--+-+ + | ``RMD160`` | RIPEMD-160 [#RMD160]_ | 160 | Hex | | + +-+---+--+--+-+ + | ``SHA1``| | 160 | Hex | Deprecated | + +-+ +--+--+-+ + | ``SHA256`` | FIPS 180-4 [#SHS]_| 256 | Hex | | + +-+ +--+--+-+ + | ``SHA512`` | | 512 | Hex | Recommended | + +-+---+--+--+-+ + | ``SHA3_256``| | 256 | Hex | | + +-+ FIPS 202 [#SHA3]_ +--+--+-+ + | ``SHA3_512``| | 512 | Hex | | + +-+---+--+--+-+ + | ``STREEBOG256`` | | 256 | Hex | | + +-+ RFC 6986 [#RFC6986]_ +--+--+-+ + | ``STREEBOG512`` | | 512 | Hex | | + +-+---+--+--+-+ + | ``WHIRLPOOL`` | Whirlpool [#BARRETO]_ | 512 | Hex | | + +-+---+--+--+-+ + +Any new hashes must be added to this specification prior to being used +in Manifest files. Adding a
[gentoo-commits] data/glep:master commit in: /
commit: cbaba08317020f34b1cfd552feb759c2f51c354a Author: Michał Górny gentoo org> AuthorDate: Sun Sep 11 07:17:16 2022 + Commit: Michał Górny gentoo org> CommitDate: Wed Sep 21 17:31:37 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=cbaba083 glep-0074: Add a changelog Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 15 +-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index 182a871..c55242f 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -8,8 +8,8 @@ Type: Standards Track Status: Final Version: 1.2 Created: 2017-10-21 -Last-Modified: 2022-09-08 -Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08 +Last-Modified: 2022-09-21 +Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08, 2022-09-11 Content-Type: text/x-rst Requires: 59, 61 Replaces: 44, 58, 60 @@ -23,6 +23,17 @@ integrity and authenticity checks. The format aims to be future-proof, efficient and provide means of backwards compatibility. +Changes +=== + +v1.2 + Specified the newline convention used for Manifests. + +v1.1 + Removed the restriction that all files covered by a Manifest tree + must reside on the same filesystem. + + Motivation ==
[gentoo-commits] data/glep:master commit in: /
commit: 75a16a8fdc2600dd22e456a29202a3e8fad4ad6f Author: Michał Górny gentoo org> AuthorDate: Thu Sep 8 08:29:30 2022 + Commit: Michał Górny gentoo org> CommitDate: Thu Sep 8 11:14:35 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=75a16a8f glep-0074: Specify newline convention Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 18 -- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index 677bf35..182a871 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -6,7 +6,7 @@ Author: Michał Górny , Ulrich Müller Type: Standards Track Status: Final -Version: 1.1 +Version: 1.2 Created: 2017-10-21 Last-Modified: 2022-09-08 Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08 @@ -79,7 +79,10 @@ are relative to the directory containing the Manifest file. The paths must not reference the parent directory (``..``). Forward slash (``/``) is used as path component separator. -The Manifest files use UTF-8 encoding. +The Manifest files use UTF-8 encoding. Line feed (``U+000A``) is used +to separate lines. For best compatibility, empty lines and any +additional whitespace, including the carriage return character +(``U+000D``) should be ignored by the implementation. Manifest file locations and nesting @@ -516,6 +519,17 @@ information to perform the verification following all the rules specific to the Gentoo repository. +Newline convention +-- + +Prior to version 1.2, the specification did not indicate the encoding +to be used for newlines. Since the format is primarily used on Gentoo +Linux systems, this has been changed to follow the Unix convention +of using the line feed character. However, for best interoperability +the implementation should be prepared to treat superfluous carriage +return characters as whitespace and ignore them. + + Tree design ---
[gentoo-commits] data/glep:master commit in: /
commit: 561c5f4e480585b47d33fc109f8a4933c17e1f7c Author: Michał Górny gentoo org> AuthorDate: Thu Sep 8 07:57:40 2022 + Commit: Michał Górny gentoo org> CommitDate: Thu Sep 8 11:14:33 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=561c5f4e glep-0074: Link OpenPGP to RFC 4880 Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 6 +- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/glep-0074.rst b/glep-0074.rst index b61801d..1005f85 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -82,7 +82,8 @@ Manifest file locations and nesting The ``Manifest`` file located in the root directory of the repository is called top-level Manifest, and it is used to perform the full-tree verification. In order to verify the authenticity, it must be signed -using OpenPGP, using the armored cleartext format. +using OpenPGP, using the armored cleartext format as defined by RFC 4880 +§ 7 or a subsequent standard [#RFC4880]_. The top-level Manifest may reference sub-Manifests contained in subdirectories of the repository. The sub-Manifests are traditionally @@ -1026,6 +1027,9 @@ References .. [#GLEP61] GLEP 61: Manifest2 compression (https://www.gentoo.org/glep/glep-0061.html) +.. [#RFC4880] RFC 4880: OpenPGP Message Format + (https://www.rfc-editor.org/rfc/rfc4880) + .. [#UNICODE] The Unicode standard (https://unicode.org/versions/latest/)
[gentoo-commits] data/glep:master commit in: /
commit: efdb4d5651d07ff760abbf5067d1662ea4885cf2 Author: Michał Górny gentoo org> AuthorDate: Thu Sep 8 08:05:26 2022 + Commit: Michał Górny gentoo org> CommitDate: Thu Sep 8 11:14:34 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=efdb4d56 glep-0074: Clearly indicate that top-level Manifest is not listed Make it clear that the top-level Manifest is not verified through itself or other Manifests, and should not be explicitly listed in IGNORE. Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index 1005f85..0ce7baf 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -109,8 +109,9 @@ of specific files and directories (recursively): 3. using names starting with a dot (``.``) which are always skipped. -All files that are not ignored must be covered by at least one -of the Manifests. +The top-level Manifest is skipped implicitly and it is an error to list +it in Manifest files. All remaining files that are not ignored must +be covered by at least one of the Manifests. A single file may be matched by multiple identical or equivalent Manifest entries, if and only if the entries have the same semantics,
[gentoo-commits] data/glep:master commit in: /
commit: 2d609f4f49bafeea9a9d8dc822f128a742f06524 Author: Michał Górny gentoo org> AuthorDate: Thu Sep 8 08:21:05 2022 + Commit: Michał Górny gentoo org> CommitDate: Thu Sep 8 11:14:35 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=2d609f4f glep-0074: Inline Manifest format description Rather than limiting the GLEP to list changes from GLEP 44, include a short inline explanation of the base Manifest format. This makes the standard more standalone, and GLEP 44 did not do a very good job of describing the format either. Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 6 ++ 1 file changed, 6 insertions(+) diff --git a/glep-0074.rst b/glep-0074.rst index 0ce7baf..677bf35 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -68,6 +68,12 @@ repurposed as a generic *tag* that could also indicate additional (non-checksum) metadata. Appropriately, those tags can be followed by other space-separated values. +The Manifest file is a line-oriented text file. Every line comprises +a single Manifest entry and consists of one or more fields separated +by a single space character (``U+0020``). The tags and their +corresponding fields are defined in the `modern Manifest tags`_ +and `deprecated Manifest tags`_ sections. + Unless specified otherwise, the paths used in the Manifest files are relative to the directory containing the Manifest file. The paths must not reference the parent directory (``..``). Forward slash (``/``)
[gentoo-commits] data/glep:master commit in: /
commit: 46b85501444d64d58f3cea85c52bf01f18462eee Author: Michał Górny gentoo org> AuthorDate: Thu Sep 8 10:21:29 2022 + Commit: Michał Górny gentoo org> CommitDate: Thu Sep 8 11:14:33 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=46b85501 glep-0074: Update license to CC BY-SA 4.0 Signed-off-by: Michał Górny gentoo.org> glep-0074.rst | 11 ++- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/glep-0074.rst b/glep-0074.rst index 4adf068..b61801d 100644 --- a/glep-0074.rst +++ b/glep-0074.rst @@ -8,8 +8,8 @@ Type: Standards Track Status: Final Version: 1.1 Created: 2017-10-21 -Last-Modified: 2018-03-11 -Post-History: 2017-10-26, 2017-11-16, 2018-02-08 +Last-Modified: 2022-09-08 +Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08 Content-Type: text/x-rst Requires: 59, 61 Replaces: 44, 58, 60 @@ -1071,6 +1071,7 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. + +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: ee1708ca1eac24ee5edd50556d4a3d5de93bbc20 Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 14 19:34:02 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Aug 14 19:34:02 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=ee1708ca glep-0078: Mark as Accepted per 2022-08-14 Council decision Bug: https://bugs.gentoo.org/672672 Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 194b3f4..05ceba9 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -4,10 +4,10 @@ Title: Gentoo binary package container format Author: Michał Górny , Sheng Yu Type: Standards Track -Status: Draft +Status: Accepted Version: 1 Created: 2018-11-15 -Last-Modified: 2022-06-06 +Last-Modified: 2022-08-14 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 92ce080994750b093047f690b458c1e3a2c55d1e Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 14 19:30:49 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Aug 14 19:30:49 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=92ce0809 glep-0083: Mark as Active per 2022-08-14 Council decision Closes: https://bugs.gentoo.org/855362 Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index fed445d..38b4e57 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -3,10 +3,10 @@ GLEP: 83 Title: EAPI deprecation Author: Ulrich Müller Type: Informational -Status: Draft +Status: Active Version: 1 Created: 2022-06-30 -Last-Modified: 2022-07-31 +Last-Modified: 2022-08-14 Post-History: 2022-07-11, 2022-07-31 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 93ca68d1c57b2df5a1f7db33831e8d8a04183c74 Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 14 19:28:21 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Aug 14 19:28:21 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=93ca68d1 glep-0013: Delete trailing whitespace Signed-off-by: Ulrich Müller gentoo.org> glep-0013.rst | 38 +++--- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/glep-0013.rst b/glep-0013.rst index 5846480..1b9be64 100644 --- a/glep-0013.rst +++ b/glep-0013.rst @@ -23,7 +23,7 @@ Abstract This GLEP provides a vision on the evolution of the Gentoo Documentation, namely a handbook-like document that provides its readers documentation about -every aspect of the Gentoo distribution: installation, administration, +every aspect of the Gentoo distribution: installation, administration, application usage, development etc. Motivation @@ -32,7 +32,7 @@ Motivation Gentoo's current Installation Guide [#InstGuide]_ is rapidly growing, being extended with more and more features that the Gentoo users can help with their quest for the perfect installation. This increase is needed and a Good Thing, -but it makes the guide less easy to read or use as reference. +but it makes the guide less easy to read or use as reference. There is no reason whatsoever that this evolution will stagnate, on the contrary: people start asking why the Alternative Installation Guide @@ -55,7 +55,7 @@ To address the beforementioned problem, there are two ideas: - Merge all information into one Big Handbook. This is of course an idea that we borrow from our FreeBSD friends [#FBSDHandBook]_ who already have an - extensive handbook related to their BSD-distribution. + extensive handbook related to their BSD-distribution. It is this second idea that this GLEP describes. @@ -70,9 +70,9 @@ Implementation == To implement such a handbook, the Gentoo Documentation Project [#GDP]_ needs a -rewritten stylesheet for its GuideXML [#GuideXML]_ format. Since there are no -problems with GuideXML itself, and since it is very flexible in its use, the -recommendation to stick with GuideXML is clear. We do need some extra features +rewritten stylesheet for its GuideXML [#GuideXML]_ format. Since there are no +problems with GuideXML itself, and since it is very flexible in its use, the +recommendation to stick with GuideXML is clear. We do need some extra features in GuideXML, without breaking the current GuideXML implementation. This last thing is important, since implementing this handbook-like document @@ -89,14 +89,14 @@ Guides, etc.) Other chapters that need to be put in place are: - A chapter on Gentoo Development, which embraces all current - development-specific guides, such as the Gentoo Developer HOWTO, the Gentoo - Policy, the Ebuild HOWTO, the Eclass HOWTO, etc. This has already been - frequently asked by the Gentoo ebuild maintainers and several other Gentoo - Developers. + development-specific guides, such as the Gentoo Developer HOWTO, the Gentoo + Policy, the Ebuild HOWTO, the Eclass HOWTO, etc. This has already been + frequently asked by the Gentoo ebuild maintainers and several other Gentoo + Developers. - A chapter specific to System Administration, such as Mailserver Administration, User Administration, Printing Administration etc. We already - have several guides that describe parts of these items. + have several guides that describe parts of these items. - A chapter specific to Gentoo Usage, including our popular Desktop Configuration Guide [#Desktop]_ and several Application-specific guides. @@ -124,8 +124,8 @@ information-division:: The tag is currently a one-time tag: it defines the start of the guide, and of course the guide ends with . The tag divides the document into separate chapters. However, -most of our documents have small chapters, whereas normal books and documents -have chapters that encompasses several pages. +most of our documents have small chapters, whereas normal books and documents +have chapters that encompasses several pages. The tag further divides the chapter in which it resides. This means that our current installation guides have a division-depth of 2: @@ -150,7 +150,7 @@ The final implementation is in-document references. Currently, the Gentoo Documentation Developers have so guess in what chapter a certain section resides, and what section we are actually discussing: ``#doc_chap4_sect3`` provides us with a link to chapter 4, section 3. This is a workable -implementation for small documents, but impossible for handbooks. +implementation for small documents, but impossible for handbooks. Implementing a more HTML-alike reference inside the division-tags would be preferable: , ``http://www.gentoo.org/doc/en/handbook``) we maintain @@ -259,7 +259,7 @@ This is a possible
[gentoo-commits] data/glep:master commit in: /
commit: 349e1ed63fb29157f3a318f696e9fec8b4da0cc4 Author: Ulrich Müller gentoo org> AuthorDate: Sun Aug 14 19:27:36 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Aug 14 19:27:36 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=349e1ed6 glep-0013: Change Status to Moribund Closes: https://bugs.gentoo.org/853166 Signed-off-by: Ulrich Müller gentoo.org> glep-0013.rst | 11 +-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/glep-0013.rst b/glep-0013.rst index 2b95a50..5846480 100644 --- a/glep-0013.rst +++ b/glep-0013.rst @@ -3,14 +3,21 @@ GLEP: 13 Title: Providing the users with a Gentoo Handbook Author: Sven Vermeulen Type: Standards Track -Status: Final +Status: Moribund Version: 1 Created: 2003-08-15 -Last-Modified: 2015-01-12 +Last-Modified: 2022-08-14 Post-History: 2003-08-19, 2004-10-25 Content-Type: text/x-rst --- +Status +== + +The Handbook no longer uses GuideXML but moved to the wiki in 2014, +and the Gentoo Documentation Project was decommissioned shortly after. +Marked as Moribund by decision of the Gentoo Council on 2022-08-14. + Abstract
[gentoo-commits] data/glep:master commit in: /
commit: 5a62f0b5a6168f97f909a18397c35360c35349d5 Author: Ulrich Müller gentoo org> AuthorDate: Sun Jul 31 21:45:19 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Jul 31 21:45:19 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=5a62f0b5 glep-0083: Typo Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glep-0083.rst b/glep-0083.rst index 0980124..fed445d 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -77,7 +77,7 @@ authors enough time to update. This is especially relevant for overlays and downstream distributions. An additional requirement for banning an EAPI is that fewer than 5 % of ebuilds are using the EAPI in question. This requirement is defined to help keep the number of -ebuild updates (and bug reports requesting them) managable, as a +ebuild updates (and bug reports requesting them) manageable, as a banned EAPI is sufficient reason for updating an ebuild.
[gentoo-commits] data/glep:master commit in: /
commit: cb08149b6689fd23aa92f3e0f0b0d835a10523b6 Author: Ulrich Müller gentoo org> AuthorDate: Sun Jul 31 21:18:14 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Jul 31 21:18:14 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=cb08149b glep-0083: Grammatical corrections Suggested-by: Thomas Bracht Laumann Jespersen laumann.xyz> Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 13 +++-- 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index 7050b25..0980124 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -22,7 +22,7 @@ Motivation == So far, old EAPIs were deprecated by the Gentoo Council in an ad-hoc -manner. No fixed criteria were used, resulting in very different +manner. No fixed criteria were used, resulting in unpredictable deprecation times after approval of newer EAPIs. Standardized criteria for deprecation and banning will make the life cycle of EAPIs more predictable. @@ -47,7 +47,7 @@ The Gentoo Council will deprecate an EAPI when The Gentoo Council will ban a deprecated EAPI when * 24 months have passed since its deprecation, and -* it is used by less than 5 % of ebuilds in the Gentoo repository. +* it is used by fewer than 5 % of ebuilds in the Gentoo repository. EAPIs used in profiles are outside the scope of this GLEP. @@ -74,10 +74,11 @@ immediately. A delay of 24 months between deprecation and ban will give ebuild authors enough time to update. This is especially relevant for -overlays and downstream distributions. Since a banned EAPI is -sufficient reason for updating an ebuild, an additional threshold of -5 % is required, in order to keep the number of such updates (and bug -reports requesting them) manageable. +overlays and downstream distributions. An additional requirement for +banning an EAPI is that fewer than 5 % of ebuilds are using the EAPI +in question. This requirement is defined to help keep the number of +ebuild updates (and bug reports requesting them) managable, as a +banned EAPI is sufficient reason for updating an ebuild. Backwards Compatibility
[gentoo-commits] data/glep:master commit in: /
commit: 5b29e45b7f48bfa90af1050b8c59443b6e3f5229 Author: Ulrich Müller gentoo org> AuthorDate: Sun Jul 31 17:27:44 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Jul 31 17:27:44 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=5b29e45b glep-0083: Update posting date Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glep-0083.rst b/glep-0083.rst index 653e537..7050b25 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -7,7 +7,7 @@ Status: Draft Version: 1 Created: 2022-06-30 Last-Modified: 2022-07-31 -Post-History: 2022-07-11 +Post-History: 2022-07-11, 2022-07-31 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: dd2ad50a87453ed2380913e4fb9572cfa03ed822 Author: Ulrich Müller gentoo org> AuthorDate: Sun Jul 31 17:20:45 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Jul 31 17:20:45 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=dd2ad50a glep-0083: Update extrapolated EAPI 6 data Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index a696c4e..653e537 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -6,7 +6,7 @@ Type: Informational Status: Draft Version: 1 Created: 2022-06-30 -Last-Modified: 2022-07-20 +Last-Modified: 2022-07-31 Post-History: 2022-07-11 Content-Type: text/x-rst --- @@ -98,14 +98,14 @@ EAPI Portage Gentoo repo deprecated diff. banned 3 2010-03-08 2015-01-16 2014-02-25 2013-03-17 -11 2016-01-10 2015-03-17 -10 4 2011-03-17 2018-01-11 2015-10-11 2016-01-17 +3 2018-04-08 2018-01-17 -3 5 2012-12-11 2021-06-15 2018-05-13 2018-06-27 +1 2021-08-08 2021-06-15 -2 -6 2016-01-17 2022-11-22 2021-07-11 2021-07-050 2023-07-05 +6 2016-01-17 2022-11-06 2021-07-11 2021-07-050 2023-07-05 [*]_ 7 2018-06-27 8 2021-07-05 == === === == == === == == .. [*] Extrapolated date, obtained by fitting data between 2021-01-01 - and 2022-07-11 with an exponential function. + and 2022-07-31 with an exponential function. References
[gentoo-commits] data/glep:master commit in: /
commit: 39320f554660010c6cb502dbf5195b641500b423 Author: Ulrich Müller gentoo org> AuthorDate: Wed Jul 20 18:58:09 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Wed Jul 20 18:58:09 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=39320f55 glep-0083: Convert the CSV table into a simple table Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 33 - 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index dc73a72..a696c4e 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -87,23 +87,22 @@ The following table compares the actual dates of deprecations and bans [#PMS-PROJECT]_ with the dates that would have resulted from the criteria proposed in this GLEP ("new date"). -.. csv-table:: - :header-rows: 2 - :stub-columns: 1 - :widths: auto - :align: right - - EAPI,Portage,Gentoo repo,deprecated,deprecated,diff.,banned,banned,diff. - ,stable,usage < 5 %,actual date,new date,months,actual date,new date,months - 0,2005-12-26,2017-02-28,2014-02-25,2009-12-11,-50,2016-01-10,2017-02-28,+14 - 1,2007-12-11,2009-10-25,2013-04-09,2011-01-08,-27,2014-03-11,2013-01-08,-14 - 2,2009-01-08,2015-03-27,2013-04-09,2012-03-08,-13,2014-03-11,2015-03-27,+12 - 3,2010-03-08,2015-01-16,2014-02-25,2013-03-17,-11,2016-01-10,2015-03-17,-10 - 4,2011-03-17,2018-01-11,2015-10-11,2016-01-17,+3,2018-04-08,2018-01-17,-3 - 5,2012-12-11,2021-06-15,2018-05-13,2018-06-27,+1,2021-08-08,2021-06-15,-2 - 6,2016-01-17,2022-11-22 [*]_,2021-07-11,2021-07-05,0,,2023-07-05, - 7,2018-06-27,,, - 8,2021-07-05,,, + == === === == == === == == +EAPI Portage Gentoo repo deprecated diff. banned diff. + -- --- --- -- --- -- +\ stable usage < 5 % actual date new datemonths actual date new datemonths + == === === == == === == == +0 2005-12-26 2017-02-28 2014-02-25 2009-12-11 -50 2016-01-10 2017-02-28 +14 +1 2007-12-11 2009-10-25 2013-04-09 2011-01-08 -27 2014-03-11 2013-01-08 -14 +2 2009-01-08 2015-03-27 2013-04-09 2012-03-08 -13 2014-03-11 2015-03-27 +12 +3 2010-03-08 2015-01-16 2014-02-25 2013-03-17 -11 2016-01-10 2015-03-17 -10 +4 2011-03-17 2018-01-11 2015-10-11 2016-01-17 +3 2018-04-08 2018-01-17 -3 +5 2012-12-11 2021-06-15 2018-05-13 2018-06-27 +1 2021-08-08 2021-06-15 -2 +6 2016-01-17 2022-11-22 2021-07-11 2021-07-050 2023-07-05 + [*]_ +7 2018-06-27 +8 2021-07-05 + == === === == == === == == .. [*] Extrapolated date, obtained by fitting data between 2021-01-01 and 2022-07-11 with an exponential function.
[gentoo-commits] data/glep:master commit in: /
commit: d06db6ad7b6fb75c35b3db4f70bbbec103265655 Author: Ulrich Müller gentoo org> AuthorDate: Wed Jul 20 18:36:33 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Wed Jul 20 18:36:33 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=d06db6ad glep-0083: Use a list for the deprecation criteria Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 17 ++--- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index f2a55a3..dc73a72 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -6,7 +6,7 @@ Type: Informational Status: Draft Version: 1 Created: 2022-06-30 -Last-Modified: 2022-07-11 +Last-Modified: 2022-07-20 Post-History: 2022-07-11 Content-Type: text/x-rst --- @@ -38,13 +38,16 @@ warn about this [#COUNCIL-20130409]_. A *banned EAPI* must no longer be used, neither for new ebuilds, nor for updating of existing ebuilds [#COUNCIL-20140311]_. -The Gentoo Council will deprecate an EAPI when two newer EAPIs are -supported by the stable version of Portage, and one of them has been -supported for 24 months. +The Gentoo Council will deprecate an EAPI when -The Gentoo Council will ban a deprecated EAPI when it is used by less -than 5 % of ebuilds in the Gentoo repository, but no sooner than 24 -months after its deprecation. +* two newer Council-approved EAPIs are supported by the stable version + of Portage, and +* one of them has been supported for 24 months. + +The Gentoo Council will ban a deprecated EAPI when + +* 24 months have passed since its deprecation, and +* it is used by less than 5 % of ebuilds in the Gentoo repository. EAPIs used in profiles are outside the scope of this GLEP.
[gentoo-commits] data/glep:master commit in: /
commit: fee3ef8459482d515a4cfaf2308558ac8d279ccf Author: Ulrich Müller gentoo org> AuthorDate: Sat Jul 16 07:02:45 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Jul 16 07:02:45 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=fee3ef84 glep-0083: Whitespace Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 18 +- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/glep-0083.rst b/glep-0083.rst index 3f9b259..f2a55a3 100644 --- a/glep-0083.rst +++ b/glep-0083.rst @@ -22,17 +22,17 @@ Motivation == So far, old EAPIs were deprecated by the Gentoo Council in an ad-hoc -manner. No fixed criteria were used, resulting in very different -deprecation times after approval of newer EAPIs. Standardized criteria -for deprecation and banning will make the life cycle of EAPIs more -predictable. +manner. No fixed criteria were used, resulting in very different +deprecation times after approval of newer EAPIs. Standardized +criteria for deprecation and banning will make the life cycle of EAPIs +more predictable. Specification = A *deprecated EAPI* is no longer required for the upgrade path of -users' systems. Its use is discouraged, and tools like pkgcheck will +users' systems. Its use is discouraged, and tools like pkgcheck will warn about this [#COUNCIL-20130409]_. A *banned EAPI* must no longer be used, neither for new ebuilds, nor @@ -60,8 +60,8 @@ complexity, e.g. in eclasses. On the other hand, an upgrade path to a stable system is guaranteed for one year, plus limited support for systems that are outdated more -than a year [#COUNCIL-20091109]_. Therefore, previous EAPIs are still -required during that time. A period of 24 months before deprecation +than a year [#COUNCIL-20091109]_. Therefore, previous EAPIs are still +required during that time. A period of 24 months before deprecation has been chosen, which is more than the required minimum and will allow projects to support a longer upgrade path. @@ -70,8 +70,8 @@ are otherwise seldom updated to be bumped to the next but one EAPI immediately. A delay of 24 months between deprecation and ban will give ebuild -authors enough time to update. This is especially relevant for -overlays and downstream distributions. Since a banned EAPI is +authors enough time to update. This is especially relevant for +overlays and downstream distributions. Since a banned EAPI is sufficient reason for updating an ebuild, an additional threshold of 5 % is required, in order to keep the number of such updates (and bug reports requesting them) manageable.
[gentoo-commits] data/glep:master commit in: /
commit: 793cc7e7c2f8eac333f3cfe126947e524e9655d7 Author: Ulrich Müller gentoo org> AuthorDate: Mon Jun 6 13:58:54 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Jul 14 10:28:50 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=793cc7e7 glep-0078: Update footer to CC-BY-SA-4.0 Acked-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 9 + 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 82c74c8..92d4547 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -7,7 +7,7 @@ Type: Standards Track Status: Draft Version: 1 Created: 2018-11-15 -Last-Modified: 2021-10-10 +Last-Modified: 2022-06-06 Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28 Content-Type: text/x-rst --- @@ -649,6 +649,7 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. + +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: 7a3ab2f042a222b8346ee00cccf00d2b582fb4a1 Author: Michał Górny gentoo org> AuthorDate: Thu Jul 14 10:12:57 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Jul 14 10:29:40 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=7a3ab2f0 glep-0078: Typographic fixes Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 46 +++--- 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index fb0f6dc..194b3f4 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -215,7 +215,7 @@ The package directory contains the following members, in order: ``image.tar${comp}.sig`` (optional). 6. The package Manifest data file ``Manifest``, optionally clear-text - signed (required) + signed (required). It is recommended that relative order of the archive members is preserved. However, implementations must support archives with members @@ -317,16 +317,16 @@ The package Manifest file The Manifest file must include digests of all files in the binary package container, except for itself. The purpose of this file is to provide the package manager with an ability to detect corruption -or alteration of the binary package before attempting to read the -inner archive contents. This file also provides protection against +or alteration of the binary package before attempting to read +the inner archive contents. This file also provides protection against signature reuse/replacement attacks if the OpenPGP signatures are used. The implementation follows the Manifest specifications in GLEP 74 [#GLEP74]_ and uses the DATA tag for files within the container. The implementation should be able to detect checksum mismatches, -as well as missing, duplicate, or extraneous files within the -container. In the case of verification failure, no subsequent +as well as missing, duplicate, or extraneous files within +the container. In the case of verification failure, no subsequent operations on the archive should be performed. @@ -337,9 +337,9 @@ The archive members and Manifest support optional OpenPGP signatures. The implementations must allow the user to specify whether OpenPGP signatures are to be expected in remotely fetched packages. -If the signatures are expected and the archive member is unsigned, the -package manager must reject processing it. If the signature does not -verify, the package manager must reject processing the corresponding +If the signatures are expected and the archive member is unsigned, +the package manager must reject processing it. If the signature does +not verify, the package manager must reject processing the corresponding archive member. In particular, it must not attempt decompressing compressed members in those circumstances. @@ -525,30 +525,30 @@ format [#DEB-FORMAT]_. Some of the original features of .tar are obsolete with the modern usage. -Firstly, .tar permits duplicate files to exist [#TARDUP]_. The -later duplicate files overwrite the previously extracted files when +Firstly, .tar permits duplicate files to exist [#TARDUP]_. +The later duplicate files overwrite the previously extracted files when extracting all files in order. This is useful for incremental backups. However, a general-purpose archiving tools may choose -arbitrary files matching a path name, leading to checksum or -signature bypass. To prevent this, duplicate files are forbidden +arbitrary files matching a path name, leading to checksum +or signature bypass. To prevent this, duplicate files are forbidden from existing. Secondly, .tar lacks integrity checks, except for the header self-check. Data corruption can usually be detected through integrity checks in the additional compression layer. However, -this does not provide a way of verifying the integrity of the -compressed data in advance. For this reason, an additional +this does not provide a way of verifying the integrity +of the compressed data in advance. For this reason, an additional Manifest file is included that provides checksums for other files in the archive. A corrupted Manifest invalidates the whole package. Thirdly, many .tar implementations have various security problems, including the Python tarfile module [#ISSUE21109]_. They provide -multiple attack vectors, e.g. permitting overwriting files outside the -destination directory using special filenames, symlinks, hard links or -device files. For this purpose, only regular files are permitted inside -the container. It is recommended to process the container data in place -rather than extracting it. +multiple attack vectors, e.g. permitting overwriting files outside +the destination directory using special filenames, symlinks, hard links +or device files. For this purpose, only regular files are permitted +inside the container. It is recommended to process the container data
[gentoo-commits] data/glep:master commit in: /
commit: 22ecc72d5b66a765e2d6ed58df26519a90633167 Author: Sheng Yu protonmail com> AuthorDate: Sat May 28 19:06:46 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Jul 14 10:28:50 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=22ecc72d glep-0078: draft update Bug: https://bugs.gentoo.org/820578 Signed-off-by: Sheng Yu protonmail.com> Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 114 -- 1 file changed, 96 insertions(+), 18 deletions(-) diff --git a/glep-0078.rst b/glep-0078.rst index 1f7cd9b..82c74c8 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -2,12 +2,13 @@ GLEP: 78 Title: Gentoo binary package container format Author: Michał Górny +Sheng Yu Type: Standards Track Status: Draft Version: 1 Created: 2018-11-15 -Last-Modified: 2019-07-29 -Post-History: 2018-11-17, 2019-07-08 +Last-Modified: 2021-10-10 +Post-History: 2018-11-17, 2019-07-08, 2021-09-13, 2021-09-22, 2022-05-28 Content-Type: text/x-rst --- @@ -154,10 +155,15 @@ The following obligatory goals have been set for a replacement format: enough to let user inspect and manipulate it without special tooling or detailed knowledge. -3. **The file format must provide support for OpenPGP signatures.** +3. **The file format must be able to detect its own data corruption.** + In particular, it needs to contain the checksum of its own data for + package manager to be able to verify its integrity without relying + on additional files. + +4. **The file format must provide support for OpenPGP signatures.** Preferably, it should use standard OpenPGP message formats. -4. **The file format must allow for efficient metadata updates.** +5. **The file format must allow for efficient metadata updates.** In particular, it should be possible to update the metadata without having to recompress package files. @@ -186,35 +192,39 @@ The container format The gpkg package container is an uncompressed .tar achive whose filename should use ``.gpkg.tar`` suffix. -The archive contains a number of files, stored in a single directory -whose name should match the basename of the package file. However, -the implementation must be able to process an archive where -the directory name is mismatched. There should be no explicit archive -member entry for the directory. +The archive contains a number of files. All package-related files +should be stored in a single directory whose name matches the basename +of the package file. However, the implementation must be able to +process an archive where the directory name is mismatched. There should +be no explicit archive member entry for the directory. The package directory contains the following members, in order: 1. The package format identifier file ``gpkg-1`` (required). -2. A signature for the metadata archive: ``metadata.tar${comp}.sig`` +2. The metadata archive ``metadata.tar${comp}``, optionally compressed + (required). + +3. A signature for the metadata archive: ``metadata.tar${comp}.sig`` (optional). -3. The metadata archive ``metadata.tar${comp}``, optionally compressed - (required). +4. The filesystem image archive ``image.tar${comp}``, optionally + compressed (required). -4. A signature for the filesystem image archive: +5. A signature for the filesystem image archive: ``image.tar${comp}.sig`` (optional). -5. The filesystem image archive ``image.tar${comp}``, optionally - compressed (required). +6. The package Manifest data file ``Manifest``, optionally clear-text + signed (required) It is recommended that relative order of the archive members is preserved. However, implementations must support archives with members out of order. The container may be extended with additional members in the future. -The implementations should ignore unrecognized members and preserve -them across package updates. +If the Manifest is present, all files contained in the archive must +be listed in it and verify successfully. The package manager should +ignore unknown files but preserve them across package updates. Permitted .tar format features @@ -301,10 +311,29 @@ suffixed using the standard suffix for the particular compressed file type (e.g. ``.bz2`` for bzip2 format). +The package Manifest file +- + +The Manifest file must include digests of all files in the binary +package container, except for itself. The purpose of this file is +to provide the package manager with an ability to detect corruption +or alteration of the binary package before attempting to read the +inner archive contents. This file also provides protection against +signature reuse/replacement attacks if the OpenPGP signatures are used. + +The implementation follows the Manifest specifications in GLEP 74 +[#GLEP74]_ and uses the DATA tag for files within the container. + +The implementation should be able to detect
[gentoo-commits] data/glep:master commit in: /
commit: c22b30f84851bb357e4e01a1208cf220dbdbf7f5 Author: Ulrich Müller gentoo org> AuthorDate: Mon Jun 6 13:59:14 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Jul 14 10:28:51 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=c22b30f8 glep-0078: Fix Author header Signed-off-by: Ulrich Müller gentoo.org> glep-0078.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/glep-0078.rst b/glep-0078.rst index 92d4547..fb0f6dc 100644 --- a/glep-0078.rst +++ b/glep-0078.rst @@ -1,7 +1,7 @@ --- GLEP: 78 Title: Gentoo binary package container format -Author: Michał Górny +Author: Michał Górny , Sheng Yu Type: Standards Track Status: Draft
[gentoo-commits] data/glep:master commit in: /
commit: 119d8ef975320ab37c642d5ff804fade8b2ad232 Author: Ulrich Müller gentoo org> AuthorDate: Thu Jun 30 15:03:23 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Jul 11 18:58:10 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=119d8ef9 glep-0083: Initial draft of EAPI deprecation GLEP Bug: https://bugs.gentoo.org/855362 Signed-off-by: Ulrich Müller gentoo.org> glep-0083.rst | 134 ++ 1 file changed, 134 insertions(+) diff --git a/glep-0083.rst b/glep-0083.rst new file mode 100644 index 000..3f9b259 --- /dev/null +++ b/glep-0083.rst @@ -0,0 +1,134 @@ +--- +GLEP: 83 +Title: EAPI deprecation +Author: Ulrich Müller +Type: Informational +Status: Draft +Version: 1 +Created: 2022-06-30 +Last-Modified: 2022-07-11 +Post-History: 2022-07-11 +Content-Type: text/x-rst +--- + + +Abstract + + +Introduce standardized criteria for deprecation and banning of EAPIs. + + +Motivation +== + +So far, old EAPIs were deprecated by the Gentoo Council in an ad-hoc +manner. No fixed criteria were used, resulting in very different +deprecation times after approval of newer EAPIs. Standardized criteria +for deprecation and banning will make the life cycle of EAPIs more +predictable. + + +Specification += + +A *deprecated EAPI* is no longer required for the upgrade path of +users' systems. Its use is discouraged, and tools like pkgcheck will +warn about this [#COUNCIL-20130409]_. + +A *banned EAPI* must no longer be used, neither for new ebuilds, nor +for updating of existing ebuilds [#COUNCIL-20140311]_. + +The Gentoo Council will deprecate an EAPI when two newer EAPIs are +supported by the stable version of Portage, and one of them has been +supported for 24 months. + +The Gentoo Council will ban a deprecated EAPI when it is used by less +than 5 % of ebuilds in the Gentoo repository, but no sooner than 24 +months after its deprecation. + +EAPIs used in profiles are outside the scope of this GLEP. + + +Rationale += + +Timing of EAPI deprecation is a trade-off between different factors. +On the one hand, the total number of EAPIs in active use should be +limited; this will prevent the learning curve for new developers and +contributors from becoming too steep and will help to reduce code +complexity, e.g. in eclasses. + +On the other hand, an upgrade path to a stable system is guaranteed +for one year, plus limited support for systems that are outdated more +than a year [#COUNCIL-20091109]_. Therefore, previous EAPIs are still +required during that time. A period of 24 months before deprecation +has been chosen, which is more than the required minimum and will +allow projects to support a longer upgrade path. + +Requiring two newer EAPIs before deprecation will allow ebuilds that +are otherwise seldom updated to be bumped to the next but one EAPI +immediately. + +A delay of 24 months between deprecation and ban will give ebuild +authors enough time to update. This is especially relevant for +overlays and downstream distributions. Since a banned EAPI is +sufficient reason for updating an ebuild, an additional threshold of +5 % is required, in order to keep the number of such updates (and bug +reports requesting them) manageable. + + +Backwards Compatibility +=== + +The following table compares the actual dates of deprecations and bans +[#PMS-PROJECT]_ with the dates that would have resulted from the +criteria proposed in this GLEP ("new date"). + +.. csv-table:: + :header-rows: 2 + :stub-columns: 1 + :widths: auto + :align: right + + EAPI,Portage,Gentoo repo,deprecated,deprecated,diff.,banned,banned,diff. + ,stable,usage < 5 %,actual date,new date,months,actual date,new date,months + 0,2005-12-26,2017-02-28,2014-02-25,2009-12-11,-50,2016-01-10,2017-02-28,+14 + 1,2007-12-11,2009-10-25,2013-04-09,2011-01-08,-27,2014-03-11,2013-01-08,-14 + 2,2009-01-08,2015-03-27,2013-04-09,2012-03-08,-13,2014-03-11,2015-03-27,+12 + 3,2010-03-08,2015-01-16,2014-02-25,2013-03-17,-11,2016-01-10,2015-03-17,-10 + 4,2011-03-17,2018-01-11,2015-10-11,2016-01-17,+3,2018-04-08,2018-01-17,-3 + 5,2012-12-11,2021-06-15,2018-05-13,2018-06-27,+1,2021-08-08,2021-06-15,-2 + 6,2016-01-17,2022-11-22 [*]_,2021-07-11,2021-07-05,0,,2023-07-05, + 7,2018-06-27,,, + 8,2021-07-05,,, + +.. [*] Extrapolated date, obtained by fitting data between 2021-01-01 + and 2022-07-11 with an exponential function. + + +References +== + +.. [#COUNCIL-20130409] "EAPI deprecation", + Gentoo Council meeting summary 2013-04-09 + (https://projects.gentoo.org/council/meeting-logs/20130409-summary.txt). + Note: The original quote says "Repoman" instead of "pkgcheck". + +.. [#COUNCIL-20140311] "Ban on EAPI 1 and 2 should extend to updating + EAPI in existing ebuilds", Gentoo Council meeting summary 2014-03-11 + (https://projects.gentoo.org/council/meeting-logs/20140311-su
[gentoo-commits] data/glep:master commit in: /
commit: fddc189901100b041343e935a1dabb09860f8932 Author: Ulrich Müller gentoo org> AuthorDate: Fri Jul 8 20:23:54 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Jul 9 08:38:45 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=fddc1899 glep-0002: "GLEP x" and "RFC x" aren't automatically linked Closes: https://bugs.gentoo.org/857066 Signed-off-by: Ulrich Müller gentoo.org> glep-0002.rst | 7 ++- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/glep-0002.rst b/glep-0002.rst index 6ef72ca..ab68ee9 100644 --- a/glep-0002.rst +++ b/glep-0002.rst @@ -6,9 +6,9 @@ Author: Grant Goodyear , Ulrich Müller Type: Informational Status: Active -Version: 4 +Version: 4.1 Created: 2003-05-31 -Last-Modified: 2019-11-24 +Last-Modified: 2022-07-09 Post-History: 2003-06-02, 2013-12-17, 2017-09-17, 2019-11-24 Content-Type: text/x-rst --- @@ -426,9 +426,6 @@ Footnotes containing the URLs from external targets will be generated automatically at the end of the References section of the GLEP, along with footnote references linking the reference text to the footnotes. -Text of the form "GLEP x" or "RFC x" (where "x" is a number) will be -linked automatically to the appropriate URLs. - Footnotes -
[gentoo-commits] data/glep:master commit in: /
commit: a8c95268e2f0de7c683703c84d6a2d2dda97f113 Author: Ulrich Müller gentoo org> AuthorDate: Fri Jul 8 17:36:07 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Jul 8 17:36:07 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=a8c95268 glep-0044: Delete duplicate reference Signed-off-by: Ulrich Müller gentoo.org> glep-0044.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/glep-0044.rst b/glep-0044.rst index c9f8cb1..bc945da 100644 --- a/glep-0044.rst +++ b/glep-0044.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Replaced Version: 1 Created: 2005-12-04 -Last-Modified: 2019-11-07 +Last-Modified: 2022-07-08 Post-History: 2005-12-06, 2006-01-23, 2006-09-03 Content-Type: text/x-rst Replaced-By: 74 @@ -327,8 +327,6 @@ References .. [#manifest2-patch] https://archives.gentoo.org/gentoo-portage-dev/message/f2b5be6629510343bd50418429912b1d -.. [#manifest2-example] glep-0044-extras/manifest2-example.txt - Copyright =
[gentoo-commits] data/glep:master commit in: /
commit: 4e6022e1056b730373d1b3787d057edd7247b1d0 Author: Ulrich Müller gentoo org> AuthorDate: Fri Jul 8 17:35:31 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Jul 8 17:35:31 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=4e6022e1 glep-0001: Use uppercase for footnote and its reference Signed-off-by: Ulrich Müller gentoo.org> glep-0001.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0001.rst b/glep-0001.rst index 020fac3..5b33558 100644 --- a/glep-0001.rst +++ b/glep-0001.rst @@ -8,7 +8,7 @@ Type: Informational Status: Active Version: 4 Created: 2003-05-31 -Last-Modified: 2022-06-06 +Last-Modified: 2022-07-08 Post-History: 2003-06-01, 2003-07-02, 2008-01-19, 2008-06-05, 2011-03-09, 2013-12-14, 2017-09-17, 2018-07-10, 2019-11-24 Content-Type: text/x-rst @@ -18,7 +18,7 @@ Credits === The GLEP concept, and, in fact, much of the text of this document, -is liberally stolen from Python's [#Python]_ PEPs [#PEPS]_, especially +is liberally stolen from Python's [#PYTHON]_ PEPs [#PEPS]_, especially PEP-0001 [#PEP1]_ by Barry A. Warsaw, Jeremy Hylton, and David Goodger. What is a GLEP?
[gentoo-commits] data/glep:master commit in: /
commit: 0f3c9dfdf8712570404c3d90b788536d3cff514e Author: Joonas Niilola gentoo org> AuthorDate: Sat Jul 2 08:06:59 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Jul 2 08:37:22 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=0f3c9dfd glep-0076: replace one dead link from references Signed-off-by: Joonas Niilola gentoo.org> [Also update the page title] Closes: https://bugs.gentoo.org/855692 Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 634ac83..2216483 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,7 +10,7 @@ Type: Informational Status: Active Version: 1.1 Created: 2013-04-23 -Last-Modified: 2021-12-26 +Last-Modified: 2022-07-02 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26 Content-Type: text/x-rst --- @@ -393,8 +393,8 @@ References .. [#CC-PDM-1.0] Creative Commons: Public Domain Mark 1.0, https://creativecommons.org/publicdomain/mark/1.0/ -.. [#CHROMIUM] Chromium: Contributing Code, - https://www.chromium.org/developers/contributing-code#TOC-Legal-stuff +.. [#CHROMIUM] Contributing to Chromium, + https://chromium.googlesource.com/chromium/src/+/main/docs/contributing.md#Legal-stuff Copyright
[gentoo-commits] data/glep:master commit in: /
commit: 10a2746a9a44523e5a5f1ffe01aee0447e127635 Author: Ulrich Müller gentoo org> AuthorDate: Mon Jun 6 16:38:40 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Jun 12 19:11:06 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=10a2746a glep-0001: Clarify that multiple authors are comma-separated This follows from headers being RFC 2822 style, but clarify it by explicitly saying so. Closes: https://bugs.gentoo.org/850121 Signed-off-by: Ulrich Müller gentoo.org> glep-0001.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/glep-0001.rst b/glep-0001.rst index 61a08a4..020fac3 100644 --- a/glep-0001.rst +++ b/glep-0001.rst @@ -8,7 +8,7 @@ Type: Informational Status: Active Version: 4 Created: 2003-05-31 -Last-Modified: 2019-11-24 +Last-Modified: 2022-06-06 Post-History: 2003-06-01, 2003-07-02, 2008-01-19, 2008-06-05, 2011-03-09, 2013-12-14, 2017-09-17, 2018-07-10, 2019-11-24 Content-Type: text/x-rst @@ -273,7 +273,8 @@ if the email address is included, and just if the address is not given. If there are multiple authors, each should be on a separate line -following RFC 2822 continuation line conventions. +following RFC 2822 continuation line conventions. The list of authors is +comma-separated, i.e. all lines but the last must end with a comma. The Type header specifies the type of GLEP: Informational or Standards Track.
[gentoo-commits] data/glep:master commit in: /
commit: f6ba29bfdb9572e186bb2cdf5c8380ac9a62ae63 Author: Ulrich Müller gentoo org> AuthorDate: Sun May 22 05:53:45 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Sun May 22 05:53:45 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f6ba29bf glep-0068: Update language identifiers from ISO 639-1 to BCP 47 This will allow codes like pt-BR or zh-Hant which is already used in at least one longdescription in the Gentoo repository. Note that the L10N USE_EXPAND and GLEP 42 news items also use BCP 47 for language names. Bug: https://bugs.gentoo.org/578294 Signed-off-by: Ulrich Müller gentoo.org> glep-0068.rst | 22 ++ 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/glep-0068.rst b/glep-0068.rst index 83e54d9..78ac7ea 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -4,10 +4,10 @@ Title: Package and category metadata Author: Michał Górny Type: Standards Track Status: Final -Version: 1.1 +Version: 1.2 Created: 2016-03-14 -Last-Modified: 2021-09-11 -Post-History: 2016-03-16, 2018-02-20 +Last-Modified: 2022-05-22 +Post-History: 2016-03-16, 2018-02-20, 2022-05-22 Content-Type: text/x-rst Requires: 67 Replaces: 34, 46, 56 @@ -106,8 +106,8 @@ The following common attributes are allowed on multiple elements: Language specifiers are used whenever an element supports variants in different languages. In this case, each occurrence of the element may -contain an optional ``lang=""`` attribute that contains a ISO 639-1 language -code. In case no ``lang=""`` attribute is provided, an implicit default +contain an optional ``lang=""`` attribute that contains an IETF language tag +[#BCP-47]_. In case no ``lang=""`` attribute is provided, an implicit default of ``en`` is assumed. Restriction specifiers are used whenever an element supports restricting to @@ -321,6 +321,9 @@ language identifier in any of the considered standards. Furthermore, since and no tools relied on the implicit default defined in the DTD, it was decided to change the implicit default to ``en``. +Language identifiers were later updated to allow full IETF language tags, +so that codes like ``pt-BR`` or ``zh-Hant`` can be represented. + Package restrictions @@ -513,6 +516,9 @@ References .. [#METADATA-DTD] The original metadata.dtd file https://gitweb.gentoo.org/data/dtd.git/tree/metadata.dtd?id=a908a93b5afe295359e0a01814c9bef8b5268bcd +.. [#BCP-47] BCP 47: "Tags for identifying languages", + https://tools.ietf.org/rfc/bcp/bcp47.txt + .. [#ORIGINAL-METADATA-XML] The original metadata.xml proposal: Paul de Vrieze. "IMPORTANT: The proposal for the metadata.xml file". gentoo-dev mailing list, 2003-06-27, @@ -529,6 +535,6 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: 36f83c4f7cc6b51ce8e99d3b4b4cbabb9ba889d7 Author: Ulrich Müller gentoo org> AuthorDate: Tue May 3 10:49:06 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Tue May 3 10:49:06 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=36f83c4f glep-0023: Update bug URLs Signed-off-by: Ulrich Müller gentoo.org> glep-0023.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0023.rst b/glep-0023.rst index e8df911..398fad1 100644 --- a/glep-0023.rst +++ b/glep-0023.rst @@ -179,9 +179,9 @@ References == .. [1] Gentoo Linux Bug 17367 - (http://bugs.gentoo.org/show_bug.cgi?id=17367) + (https://bugs.gentoo.org/17367) .. [2] Gentoo Linux Bug 34146 - (http://bugs.gentoo.org/show_bug.cgi?id=34146) + (https://bugs.gentoo.org/34146) Copyright
[gentoo-commits] data/glep:master commit in: /
commit: b393fd4f412720d6d01664abdacc791211b643a3 Author: Ulrich Müller gentoo org> AuthorDate: Tue May 3 10:47:31 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Tue May 3 10:47:31 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=b393fd4f glep-0023: Delete trailing whitespace Signed-off-by: Ulrich Müller gentoo.org> glep-0023.rst | 80 +-- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/glep-0023.rst b/glep-0023.rst index 9113464..e8df911 100644 --- a/glep-0023.rst +++ b/glep-0023.rst @@ -24,20 +24,20 @@ Abstract Currently, every ebuild in the main Gentoo repository is required to have a -valid LICENSE entry. However, the syntax of this entry is not officially -defined and the entry itself is only used when outputting package +valid LICENSE entry. However, the syntax of this entry is not officially +defined and the entry itself is only used when outputting package details. Motivation == -Many users wish to regulate the software they install with regards to -licenses for various reasons [1]_. Some want a system free of any -software that is not OSI-approved; others are simply curious as to what +Many users wish to regulate the software they install with regards to +licenses for various reasons [1]_. Some want a system free of any +software that is not OSI-approved; others are simply curious as to what licenses they are implicitly accepting. -Furthermore, some software requires that a user interactively accept its -license for its author's to consider it legally binding. This is +Furthermore, some software requires that a user interactively accept its +license for its author's to consider it legally binding. This is currently implemented using ``eutils.eclass``. @@ -47,21 +47,21 @@ Specification Ebuild LICENSE Variable --- -Most ebuilds are for software which is released under a single license. -In these cases, the current LICENSE variable can remain as is. For +Most ebuilds are for software which is released under a single license. +In these cases, the current LICENSE variable can remain as is. For example: :: LICENSE="single-license" -However, there are several ebuilds for software which is released under -several licenses, of which the user must accept one, some or all [2]_. -To complicate this, some ebuilds include optional components which fall +However, there are several ebuilds for software which is released under +several licenses, of which the user must accept one, some or all [2]_. +To complicate this, some ebuilds include optional components which fall under a different license. To accommodate these cases, LICENSE syntax should accommodate all -functionality offered by a DEPEND string. To keep things simple, this +functionality offered by a DEPEND string. To keep things simple, this GLEP proposes that the syntax be identical. For example: :: @@ -78,34 +78,34 @@ begin with a hyphen, a dot or a plus sign. License Groups -- -Almost all users are willing to install any software that is -FSF-approved. Other users are willing to install any software and -implicitly accept its license. To this end, implementations will also +Almost all users are willing to install any software that is +FSF-approved. Other users are willing to install any software and +implicitly accept its license. To this end, implementations will also need to handle grouping of licenses. -At a minimum, there needs to be the groups ``GPL-COMPATIBLE``, -``FSF-APPROVED``, ``OSI-APPROVED`` and ``NON-MUST-HAVE-READ``. -``NON-MUST-HAVE-READ`` licenses are those that don't require manual -acceptance for to be considered legally binding. This is the current +At a minimum, there needs to be the groups ``GPL-COMPATIBLE``, +``FSF-APPROVED``, ``OSI-APPROVED`` and ``NON-MUST-HAVE-READ``. +``NON-MUST-HAVE-READ`` licenses are those that don't require manual +acceptance for to be considered legally binding. This is the current behaviour of portage. -These groups are defined in a new file ``license_groups`` in +These groups are defined in a new file ``license_groups`` in the ``profiles`` subdirectory of the tree (or overlays). Details of handling groups defined in overlays is implementation dependent. The format of this file is :: - + ... Also any line starting with # is ignored and may be used for comments. -Group names use the same syntax as normal license names. Also license groups +Group names use the same syntax as normal license names. Also license groups may contain other groups. License groups may not contain negated elements, so a group :: - + mygroup foo -bar -bla is illegal. @@ -114,17 +114,17 @@ is illegal. ACCEPT_LICENSE -- -This GLEP proposes that a user be able to explicitly accept or decline -lic
[gentoo-commits] data/glep:master commit in: /
commit: edf40aeab84bfed880306527de3dccf401e792fa Author: Ulrich Müller gentoo org> AuthorDate: Tue May 3 10:44:37 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Tue May 3 10:44:37 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=edf40aea glep-0023: Fix a typo Signed-off-by: Ulrich Müller gentoo.org> glep-0023.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0023.rst b/glep-0023.rst index b2b5bf2..9113464 100644 --- a/glep-0023.rst +++ b/glep-0023.rst @@ -7,7 +7,7 @@ Type: Standards Track Status: Final Version: 1 Created: 2004-03-09 -Last-Modified: 2016-06-23 +Last-Modified: 2022-05-03 Post-History: 2004-03-08, 2004-03-10, 2004-10-25, 2006-11-18, 2006-11-21 Content-Type: text/x-rst --- @@ -170,7 +170,7 @@ Backwards Compatibility There should be no change to the user experience without the user explicitly choosing to do so. This mandates that the configuration variable be named ``ACCEPT_LICENSE`` as some users may -already have it set due to ebuilds using ``eutil.eclass``'s +already have it set due to ebuilds using ``eutils.eclass``'s implementation. It also mandates that the default ``ACCEPT_LICENSE`` be set to ``@NON-MUST-HAVE-READ`` in the main Gentoo repository as implementations are not required to provide an internal default.
[gentoo-commits] data/glep:master commit in: /
commit: 5a8a26ff0a3f938fd8dec88e8f8725f72a933a79 Author: Ulrich Müller gentoo org> AuthorDate: Fri Apr 15 05:50:07 2022 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Apr 15 05:50:07 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=5a8a26ff glep-0057: Add blank lines before literal blocks Plus other whitespace fixes. No change of text. Bug: https://bugs.gentoo.org/699934 Signed-off-by: Ulrich Müller gentoo.org> glep-0057.rst | 33 +++-- 1 file changed, 23 insertions(+), 10 deletions(-) diff --git a/glep-0057.rst b/glep-0057.rst index 793d2d0..173952b 100644 --- a/glep-0057.rst +++ b/glep-0057.rst @@ -6,7 +6,7 @@ Type: Informational Status: Final Version: 1 Created: 2008-10-22 -Last-Modified: 2019-11-07 +Last-Modified: 2022-04-15 Post-History: 2009-12-01 Content-Type: text/x-rst --- @@ -18,7 +18,7 @@ and problems in the Gentoo software distribution process, with a strong emphasis on security. The concepts thus developed, will then be used in the following GLEPs to describe a comprehensive security solution for this distribution process that prevents trivial attacks and increases -the difficulty on more complex attacks. +the difficulty on more complex attacks. Motivation == @@ -139,7 +139,7 @@ with the choice of either syncing from the sometimes slow or even unresponsive Gentoo-controlled rsync mirrors or risk being compromised by syncing from one of the community-provided mirrors. We will show that protection against this class of attacks is very easy to implement with -little added cost. +little added cost. At the level of mirrors, addition of malicious content is not the only attack. As discussed by Cappos et al [C08a]_, [C08b]_, an attacker may use @@ -211,13 +211,15 @@ https://archives.gentoo.org/gentoo-dev/message/7062d6765b35406b4b8ed6b7c6e8fc28 [ http://www.gentoo.org/news/en/gwn/20030421-newsletter.xml#doc_chap1_sect2 ] 2003-04, gentoo-security mailing list, "The state of ebuild signing -in portage" - Joshua Brindle (method), the first suggestion of signed Manifests, -but also an unusual key-trust model: +in portage" - Joshua Brindle (method), the first suggestion of signed +Manifests, but also an unusual key-trust model: Message-ID unknown https://marc.info/?l=gentoo-security&m=105073449619892&w=2 -2003-04, gentoo-core mailing list, "New Digests and Signing -- Attempted Explanation" +2003-04, gentoo-core mailing list, "New Digests and Signing -- Attempted +Explanation" :: + Date: Wed, 2 Apr 2003 23:39:05 -0600 From: Nick Jones Message-ID: <20030402233905.a18...@twobit.net> @@ -226,6 +228,7 @@ https://marc.info/?l=gentoo-security&m=105073449619892&w=2 signing." - This overview was one of the first to help developers see how to use their devs, and was mainly intended for keysigning meetups. :: + Date: Mon, 30 Jun 2003 14:32:09 +1000 (EST) From: Troy Dack Message-ID: <33220.203.10.231.229.1056947529.squir...@tkdack.bpa.nu> @@ -234,18 +237,22 @@ how to use their devs, and was mainly intended for keysigning meetups. with an not very positive response, delayed by Nick Jones (carpaski) getting rooted and a safe cleanup taking a long time to affect. :: + Date: 06 Aug 2003 15:36:34 -0500 From: Chris PeBenito Message-Id: <1060202193.1532.42.ca...@chris.pebenito.net> -2003-12-02, gentoo-core mailing list, "Report: rsync1.it.gentoo.org compromised" +2003-12-02, gentoo-core mailing list, "Report: rsync1.it.gentoo.org +compromised" :: + Date: Tue, 2 Dec 2003 20:25:57 +0100 From: Andrea Barisani Message-ID: <20031202192557.ga11...@sole.infis.univ.trieste.it> 2003-12-03, gentoo-core mailing list, "Signing of ebuilds" :: + Date: Wed, 3 Dec 2003 11:15:09 +0100 From: Hanno Böck Message-Id: <20031203111509.6b2e414b.ha...@gentoo.org> @@ -255,6 +262,7 @@ includes the first GnuPG signing prototype code, by Robin H. Johnson (robbat2). Andrew Cowie (rac) also produces a proof-of-concept around this time. :: + Date: Sun, 7 Dec 2003 21:01:03 + From: Douglas Russell Message-Id: <200312072101.08245.pu...@gentoo.org> @@ -286,6 +294,7 @@ tree-signing work. Problems at the time later in the thread show that the upstream gpg-agent is not ready, amongst other minor implementation issues. :: + Date: Mon, 17 Jan 2005 11:04:50 +0100 From: Thierry Carrez Message-ID: <41eb8dc2.6050...@gentoo.org> @@ -302,6 +311,7 @@ Informal statistics show that 26% of packages in the tree include a signed Manifest. Questions are raised regarding key types, and key policies. :: + Date: Tue, 8 Mar 2005 12:21:55 +0100 From: Torsten Veller Message-ID: <20050308113947.ga4dd7c...@veller.net> @@ -312,6 +322,7 @@ outstanding issues, also mentioning partial Manifests, as well as a comparision between the signing procedures used in Slackware, Debian and RPM-based distros. ::
[gentoo-commits] data/glep:master commit in: /
commit: 8e672d599f941ccb56afbd06f011b2142d0a01c7 Author: Robin H. Johnson gentoo org> AuthorDate: Fri Apr 15 04:27:18 2022 + Commit: Robin H. Johnson gentoo org> CommitDate: Fri Apr 15 04:27:18 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=8e672d59 glep-0057: update bibiographic data Signed-off-by: Robin H. Johnson gentoo.org> Closes: https://bugs.gentoo.org/699934 glep-0057.rst | 41 + 1 file changed, 41 insertions(+) diff --git a/glep-0057.rst b/glep-0057.rst index c4114e2..793d2d0 100644 --- a/glep-0057.rst +++ b/glep-0057.rst @@ -213,26 +213,51 @@ https://archives.gentoo.org/gentoo-dev/message/7062d6765b35406b4b8ed6b7c6e8fc28 2003-04, gentoo-security mailing list, "The state of ebuild signing in portage" - Joshua Brindle (method), the first suggestion of signed Manifests, but also an unusual key-trust model: +Message-ID unknown https://marc.info/?l=gentoo-security&m=105073449619892&w=2 2003-04, gentoo-core mailing list, "New Digests and Signing -- Attempted Explanation" +:: +Date: Wed, 2 Apr 2003 23:39:05 -0600 +From: Nick Jones +Message-ID: <20030402233905.a18...@twobit.net> 2003-06, gentoo-core mailing list, "A quick guide to GPG and key signing." - This overview was one of the first to help developers see how to use their devs, and was mainly intended for keysigning meetups. +:: +Date: Mon, 30 Jun 2003 14:32:09 +1000 (EST) +From: Troy Dack +Message-ID: <33220.203.10.231.229.1056947529.squir...@tkdack.bpa.nu> 2003-08-09, gentoo-core mailing list, "Ebuild signing" - status query, with an not very positive response, delayed by Nick Jones (carpaski) getting rooted and a safe cleanup taking a long time to affect. +:: +Date: 06 Aug 2003 15:36:34 -0500 +From: Chris PeBenito +Message-Id: <1060202193.1532.42.ca...@chris.pebenito.net> 2003-12-02, gentoo-core mailing list, "Report: rsync1.it.gentoo.org compromised" +:: +Date: Tue, 2 Dec 2003 20:25:57 +0100 +From: Andrea Barisani +Message-ID: <20031202192557.ga11...@sole.infis.univ.trieste.it> 2003-12-03, gentoo-core mailing list, "Signing of ebuilds" +:: +Date: Wed, 3 Dec 2003 11:15:09 +0100 +From: Hanno Böck +Message-Id: <20031203111509.6b2e414b.ha...@gentoo.org> 2003-12-07, gentoo-core mailing list, "gpg signing of Manifests", thread includes the first GnuPG signing prototype code, by Robin H. Johnson (robbat2). Andrew Cowie (rac) also produces a proof-of-concept around this time. +:: +Date: Sun, 7 Dec 2003 21:01:03 + +From: Douglas Russell +Message-Id: <200312072101.08245.pu...@gentoo.org> 2004-03-23, gentoo-dev mailing list, "2004.1 will not include a secure portage" - Kurt Lieber (klieber). Signing is nowhere near ready for @@ -260,6 +285,10 @@ portage signing". Thierry Carrez (koon) suggests that more go into tree-signing work. Problems at the time later in the thread show that the upstream gpg-agent is not ready, amongst other minor implementation issues. +:: +Date: Mon, 17 Jan 2005 11:04:50 +0100 +From: Thierry Carrez +Message-ID: <41eb8dc2.6050...@gentoo.org> 2005-02-20, gentoo-dev mailing list, "post-LWE 2005" - Brian Harring (ferringb). A discussion on the ongoing lack of signing, and that @@ -272,12 +301,20 @@ https://marc.info/?l=gentoo-dev&m=110893886214157&w=2 Informal statistics show that 26% of packages in the tree include a signed Manifest. Questions are raised regarding key types, and key policies. +:: +Date: Tue, 8 Mar 2005 12:21:55 +0100 +From: Torsten Veller +Message-ID: <20050308113947.ga4dd7c...@veller.net> 2005-11-16, gentoo-core mailing list, "Gentoo key signing practices and official Gentoo keyring". A discussion of key handling and other outstanding issues, also mentioning partial Manifests, as well as a comparision between the signing procedures used in Slackware, Debian and RPM-based distros. +:: +Date: Wed, 16 Nov 2005 12:29:46 -0800 +From: "Robin H. Johnson" +Message-ID: <20051116202946.ga9...@curie-int.vc.shawcable.net> 2005-11-19, gentoo-portage-dev mailing list, "Manifest signing" - Robin H. Johnson (robbat2) follows up the previous -core posting, discussion @@ -313,6 +350,10 @@ https://archives.gentoo.org/gentoo-dev/message/b25efdb57f973e1f53b38eadc55de1ee 2007-11-30, portage-dev alias, "Manifest2 and Tree-signing" - Robin H. Johnson (robbat2). First review thread for these GLEPs, many suggestions from Marius Mauch (genone). +:: +Date: Fri, 30 Nov 2007 22:13:43 -0800 +From: "Robin H. Johnson" +Message-ID: <20071201061343.gg14...@curie-int.orbis-terrarum.net> 2008-04-03, gentoo-dev mailing list, "Re: Monthly Gentoo Council Reminder for April" - Ciaran McCreesh (ciaranm). A thread in which
[gentoo-commits] data/glep:master commit in: /
commit: 92a8b1c7f6e1c615755538b147e175d44d5354c0 Author: Ulrich Müller gentoo org> AuthorDate: Sun Dec 26 10:31:47 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Jan 10 06:12:54 2022 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=92a8b1c7 glep-0076: Update URL of FSFE FLA Reorder references by their occurrence in the text. Update license to CC-BY-SA-4.0. Closes: https://bugs.gentoo.org/829997 Signed-off-by: Ulrich Müller gentoo.org> glep-0076.rst | 16 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/glep-0076.rst b/glep-0076.rst index 4aa5ee5..634ac83 100644 --- a/glep-0076.rst +++ b/glep-0076.rst @@ -10,7 +10,7 @@ Type: Informational Status: Active Version: 1.1 Created: 2013-04-23 -Last-Modified: 2018-12-09 +Last-Modified: 2021-12-26 Post-History: 2018-06-10, 2018-06-19, 2018-08-31, 2018-09-26 Content-Type: text/x-rst --- @@ -170,7 +170,7 @@ The following is the current Gentoo Certificate of Origin, revision 1: this project or the free software license(s) involved. The Gentoo Certificate of Origin is licensed under a Creative Commons -Attribution-ShareAlike 3.0 Unported License [#CC-BY-SA-3.0]_. +Attribution-ShareAlike 4.0 International License [#CC-BY-SA-4.0]_. It is based on the Linux Kernel DCO [#OSDL-DCO]_, released by Open Source Development Labs, Inc. in 2005 under a CC-BY-SA-2.5 License. @@ -348,6 +348,9 @@ Matija Šuklje, Matthew Thode, and Alec Warner for their input. References == +.. [#FLA] FSFE Legal: Fiduciary Licence Agreement (FLA), + https://fsfe.org/activities/fla/fla.en.html + .. [#SOCIAL-CONTRACT] Gentoo Social Contract, https://www.gentoo.org/get-started/philosophy/social-contract.html @@ -378,9 +381,6 @@ References https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/process/submitting-patches.rst?h=v4.18#n460 https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=af45f32d25cc1e374184675eadc9f740221d8392 -.. [#FLA] FSFE Legal: Fiduciary Licence Agreement (FLA), - https://fsfe.org/activities/ftf/fla.en.html - .. [#CC-SOFTWARE] Can I apply a Creative Commons license to software? https://creativecommons.org/faq/#can-i-apply-a-creative-commons-license-to-software @@ -400,6 +400,6 @@ References Copyright = -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: f1bfb92b330de121950a826c8b2f5df7ea399fe8 Author: Ulrich Müller gentoo org> AuthorDate: Sun Sep 12 19:23:02 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Sep 12 19:23:02 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f1bfb92b glep-0082: Mark as Final per 2021-09-12 Council decision Closes: https://bugs.gentoo.org/793164 Signed-off-by: Ulrich Müller gentoo.org> glep-0082.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0082.rst b/glep-0082.rst index c04123f..c115637 100644 --- a/glep-0082.rst +++ b/glep-0082.rst @@ -3,10 +3,10 @@ GLEP: 82 Title: Repository configuration file (layout.conf) Author: Michał Górny Type: Standards Track -Status: Accepted +Status: Final Version: 1.2 Created: 2021-05-19 -Last-Modified: 2021-08-01 +Last-Modified: 2021-09-12 Post-History: 2021-05-19, 2021-06-18, 2021-08-01 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: bc8174792e6849efbe5309ead6bbd8e119508700 Author: Ulrich Müller gentoo org> AuthorDate: Sat Sep 11 11:27:24 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Sat Sep 11 11:27:24 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=bc817479 glep-0068: Fix typos Signed-off-by: Ulrich Müller gentoo.org> glep-0068.rst | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/glep-0068.rst b/glep-0068.rst index d8fc379..83e54d9 100644 --- a/glep-0068.rst +++ b/glep-0068.rst @@ -6,7 +6,7 @@ Type: Standards Track Status: Final Version: 1.1 Created: 2016-03-14 -Last-Modified: 2020-05-06 +Last-Modified: 2021-09-11 Post-History: 2016-03-16, 2018-02-20 Content-Type: text/x-rst Requires: 67 @@ -480,9 +480,9 @@ Example metadata.xml file Enables bar feature -Konfiguriert das Paket mit Unterstütztung für foo -Konfiguriert das Paket mit Unterstütztung für bar (benötigt dev-libs/bar) -Konfiguriert das Paket mit Unterstütztung für bar +Konfiguriert das Paket mit Unterstützung für foo +Konfiguriert das Paket mit Unterstützung für bar (benötigt dev-libs/bar) +Konfiguriert das Paket mit Unterstützung für bar
[gentoo-commits] data/glep:master commit in: /
commit: 28484760e0095e8f80f24385cf89f180954bb4d7 Author: Michał Górny gentoo org> AuthorDate: Sun Aug 1 16:14:06 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Sun Aug 8 20:04:13 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=28484760 glep-0082: Add profile-eapis-* keys Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0082.rst | 20 +--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/glep-0082.rst b/glep-0082.rst index d395fe1..c04123f 100644 --- a/glep-0082.rst +++ b/glep-0082.rst @@ -4,10 +4,10 @@ Title: Repository configuration file (layout.conf) Author: Michał Górny Type: Standards Track Status: Accepted -Version: 1.1 +Version: 1.2 Created: 2021-05-19 -Last-Modified: 2021-07-12 -Post-History: 2021-05-19, 2021-06-18 +Last-Modified: 2021-08-01 +Post-History: 2021-05-19, 2021-06-18, 2021-08-01 Content-Type: text/x-rst --- @@ -164,6 +164,20 @@ eapis-testing = with stable keywords, i.e. development tools should block their use in such ebuilds. +profile-eapis-deprecated = + Specifies one or more EAPIs that are to be considered deprecated + by the development tools for use in profiles, i.e. their use + in any of the profiles listed in ``profiles/profiles.desc`` or their + parent profiles should trigger a warning. If not specified, no EAPIs + are deprecated. + +profile-eapis-banned = + Specifies one or more EAPIs that are to be considered banned + by the development tools for use in profiles, i.e. their use + in any of the profiles listed in ``profiles/profiles.desc`` or their + parent profiles should be blocked. If not specified, no EAPIs + are banned. + repo-name = Specifies the repository name. If specified, it must be equal to the contents of ``profiles/repo_name``. If not specified,
[gentoo-commits] data/glep:master commit in: /
commit: 1142f6be877bf59db87080dd2f9afa70c941fee3 Author: Ulrich Müller gentoo org> AuthorDate: Mon Jul 12 07:02:58 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Jul 12 07:02:58 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=1142f6be glep-0082: Mark as Accepted per 2021-07-11 Council decision Bug: https://bugs.gentoo.org/793164 Signed-off-by: Ulrich Müller gentoo.org> glep-0082.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0082.rst b/glep-0082.rst index 5fd8009..d395fe1 100644 --- a/glep-0082.rst +++ b/glep-0082.rst @@ -3,10 +3,10 @@ GLEP: 82 Title: Repository configuration file (layout.conf) Author: Michał Górny Type: Standards Track -Status: Draft +Status: Accepted Version: 1.1 Created: 2021-05-19 -Last-Modified: 2021-06-18 +Last-Modified: 2021-07-12 Post-History: 2021-05-19, 2021-06-18 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 25b8a4140c882aaad4d381de01ba7a0e5957bc08 Author: Ulrich Müller gentoo org> AuthorDate: Fri Jun 18 16:02:07 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Fri Jun 18 16:41:07 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=25b8a414 glep-0082: New key "eapis-testing" As discussed in #gentoo-portage yesterday: After a new EAPI has been approved, there is a period during which there is no stable Portage version supporting the new EAPI, and ebuilds for the new EAPI should not be stabilised during that period. Add a new "eapis-testing" key to layout.conf, so that development tools can warn about it. Suggested-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0082.rst | 11 --- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/glep-0082.rst b/glep-0082.rst index 6703313..5fd8009 100644 --- a/glep-0082.rst +++ b/glep-0082.rst @@ -4,10 +4,10 @@ Title: Repository configuration file (layout.conf) Author: Michał Górny Type: Standards Track Status: Draft -Version: 1.0 +Version: 1.1 Created: 2021-05-19 -Last-Modified: 2021-05-31 -Post-History: 2021-05-19 +Last-Modified: 2021-06-18 +Post-History: 2021-05-19, 2021-06-18 Content-Type: text/x-rst --- @@ -159,6 +159,11 @@ eapis-banned = be blocked. If not specified, no EAPIs are banned. This key does not apply to EAPI use in profiles. +eapis-testing = + Specifies one or more EAPIs that must not (yet) be used in ebuilds + with stable keywords, i.e. development tools should block their use + in such ebuilds. + repo-name = Specifies the repository name. If specified, it must be equal to the contents of ``profiles/repo_name``. If not specified,
[gentoo-commits] data/glep:master commit in: /
commit: b850151285073b29dd4c3d3138fe4361024265ba Author: Ulrich Müller gentoo org> AuthorDate: Thu Jun 17 20:06:53 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Jun 17 20:06:53 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=b8501512 glep-0072: Mark as Final per 2021-06-13 Council decision Signed-off-by: Ulrich Müller gentoo.org> glep-0072.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0072.rst b/glep-0072.rst index 244b534..602fb8d 100644 --- a/glep-0072.rst +++ b/glep-0072.rst @@ -4,10 +4,10 @@ Title: Architecture stability status file Author: Andreas K. Hüttel , Michał Górny Type: Standards Track -Status: Accepted +Status: Final Version: 1 Created: 2017-05-06 -Last-Modified: 2020-05-10 +Last-Modified: 2021-06-17 Post-History: 2017-05-06, 2020-04-10 Content-Type: text/x-rst ---
[gentoo-commits] data/glep:master commit in: /
commit: 8f50b61d7a09de216bbaaf86d75a61a195bf42bb Author: Michał Górny gentoo org> AuthorDate: Wed Jun 9 07:30:06 2021 + Commit: Michał Górny gentoo org> CommitDate: Wed Jun 9 07:32:39 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=8f50b61d glep-0082: Indicate that eapis-* do not apply to eclasses Signed-off-by: Michał Górny gentoo.org> glep-0082.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/glep-0082.rst b/glep-0082.rst index 8a1094b..6703313 100644 --- a/glep-0082.rst +++ b/glep-0082.rst @@ -147,6 +147,7 @@ eapis-deprecated = Specifies one or more EAPIs that are to be considered deprecated by the development tools for use in ebuilds, i.e. their use should trigger a warning. If not specified, no EAPIs are deprecated. + This key does not apply to EAPI use in profiles. Example:: @@ -155,7 +156,8 @@ eapis-deprecated = eapis-banned = Specifies one or more EAPIs that are to be considered banned by the development tools for use in ebuilds, i.e. their use should - be blocked. If not specified, no EAPIs are banned. + be blocked. If not specified, no EAPIs are banned. This key + does not apply to EAPI use in profiles. repo-name = Specifies the repository name. If specified, it must be equal
[gentoo-commits] data/glep:master commit in: /
commit: b116366090df280cfe686e30e21082959cf36c7c Author: Ulrich Müller gentoo org> AuthorDate: Mon May 31 08:44:08 2021 + Commit: Ulrich Müller gentoo org> CommitDate: Mon May 31 08:44:08 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=b1163660 glep-0080: Deferred due to inactivity Closes: https://bugs.gentoo.org/682294 Signed-off-by: Ulrich Müller gentoo.org> glep-0080.rst | 10 -- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/glep-0080.rst b/glep-0080.rst index d21d6f2..ac69087 100644 --- a/glep-0080.rst +++ b/glep-0080.rst @@ -3,14 +3,20 @@ GLEP: 80 Title: Identity verification via OpenPGP WoT Author: Michał Górny Type: Standards Track -Status: Draft +Status: Deferred Version: 1 Created: 2019-03-04 -Last-Modified: 2019-11-07 +Last-Modified: 2021-05-31 Post-History: 2019-03-04 Content-Type: text/x-rst --- +Status +== +Marked as deferred by GLEP editor Ulrich Müller on 2021-05-31, due to +inactivity. + + Abstract This GLEP proposes establishing a non-obligatory, distributed identity
[gentoo-commits] data/glep:master commit in: /
commit: 90abb55d4eed07b5caaaf62e9cbe3d077d279ef5 Author: Michał Górny gentoo org> AuthorDate: Mon May 31 08:12:12 2021 + Commit: Michał Górny gentoo org> CommitDate: Mon May 31 08:12:12 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=90abb55d glep-0082: initial draft for layout.conf GLEP Signed-off-by: Michał Górny gentoo.org> glep-0082.rst | 294 ++ 1 file changed, 294 insertions(+) diff --git a/glep-0082.rst b/glep-0082.rst new file mode 100644 index 000..8a1094b --- /dev/null +++ b/glep-0082.rst @@ -0,0 +1,294 @@ +--- +GLEP: 82 +Title: Repository configuration file (layout.conf) +Author: Michał Górny +Type: Standards Track +Status: Draft +Version: 1.0 +Created: 2021-05-19 +Last-Modified: 2021-05-31 +Post-History: 2021-05-19 +Content-Type: text/x-rst +--- + +Abstract + + +The ``metadata/layout.conf`` file format is specified as used by Portage +and pkgcore. A standard set of configuration keys is described +including the keys currently used in the Gentoo repository. + + +Motivation +== + +The ``metadata/layout.conf`` file was first added to the Gentoo +repository in Oct 2011, to facilitate setting of hashes used +in Manifest2 files. In Mar 2012, it was used to indicate the transition +to the new ``md5-dict`` cache format. In Jul 2013, it started being +used to indicate the repository's masters and effectively became +obligatory for all repositories. + +Today, ``layout.conf`` is used for various repository configuration +knobs that can be expressed as simple values and therefore +do not justify adding new files to the repository. This primarily +involves the configuration of development tools but also includes a few +keys relevant to the behavior of the package manager. + +However, ``layout.conf`` is currently not covered by any formal +specification. The PMS neglects its existence entirely, and the keys +used are roughly defined by their first use of Portage or pkgcore. +This GLEP aims to overcome this by providing a formal specification +for the file, as well as an up-to-date list of permitted configuration +keys. + + +Specification += + +layout.conf file format +--- + +Every ebuild repository must contain a ``metadata/layout.conf`` file. +The file uses a line-oriented key-value format:: + +# comments are allowed +key = value +key2 = value2 + +Lines starting with a hash sign (``#``) represent comments and are +ignored, as are lines consisting entirely of whitespace. + +Key can be any string and must not contain spaces. The exact form +of value depends on the key. For some keys, the value is permitted +to contain spaces, and it must not be quoted. In some cases an empty +value is permitted. The whitespace between the elements is optional +and is ultimately stripped. Every key must occur no more than once +in the file. + + +Configuration keys +-- + +This GLEP specifies a number of standard configuration keys. New keys +may be added to it in the future. It is strongly recommended that any +new keys are added to the specification before being used. + +The package manager can implement a subset of the listed keys. Unknown +keys should be ignored. + + +The following keys must be present in a ``layout.conf`` file: + +masters = + Specifies the master repositories of this repository. For stand-alone + repositories, this must be set to an empty value. Otherwise, it can + list one or more repositories, separated by spaces. This key must + be specified. + + Examples:: + + # most common case + masters = gentoo + # stand-alone repository + masters = + # multiple masters + masters = gentoo python + + +The following keys are optional: + +manifest-hashes = + Specifies the list of hashes that should be used for new distfiles + in the Manifest files. The development tools may create a subset + of the specified hashes if it is not updating the checksums for + the specified distfile, or does not support the hash in question. + The hash names are specified in GLEP 74. [#GLEP74]_ The default + set of hashes is implementation-defined. + + Example:: + + manifest-hashes = BLAKE2B SHA512 + +manifest-required-hashes = + Specifies the list of hashes that must be used in Manifest files. + The development tools must support all the hashes listed there, + and update distfile checksums to use these hashes (refetching + if necessary). This must be a subset of manifest-hashes. If not + specified, all hashes from manifest-hashes (or the default set) + are considered required. + +use-manifests = ``strict``, ``true`` or ``false`` + Indicates the policy for creating and using Manifest files. If set + to ``strict``, Manifest files are created and files are required to + match digests found in Manifests. If set to ``true``, Manifests + are created but digest mismatches are ign
[gentoo-commits] data/glep:master commit in: /
commit: 824f0fcd9a466ca69e9705bd2f380ccac768151a Author: Michał Górny gentoo org> AuthorDate: Sun Feb 28 11:33:38 2021 + Commit: Michał Górny gentoo org> CommitDate: Sun Feb 28 19:02:54 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=824f0fcd glep-0067: Add proxied="" attribute to distinguish proxied maints Introduce an additional proxied="" attribute to make it possible to explicitly distinguish proxied maintainers from regular maintainers. This is supposed to resolve false positives in the QA check responsible for detecting leftover proxy-maint project usage. Currently it wrongly assumes that all Gentoo devs (as in people with @gentoo.org) have direct push access and therefore don't need a proxy. Signed-off-by: Michał Górny gentoo.org> glep-0067.rst | 53 +++-- 1 file changed, 47 insertions(+), 6 deletions(-) diff --git a/glep-0067.rst b/glep-0067.rst index e22f216..8140b15 100644 --- a/glep-0067.rst +++ b/glep-0067.rst @@ -4,10 +4,10 @@ Title: Package maintenance structure Author: Michał Górny Type: Standards Track Status: Final -Version: 1 +Version: 1.1 Created: 2015-12-13 -Last-Modified: 2016-01-13 -Post-History: 2015-11-03, 2016-05-29 +Last-Modified: 2021-02-28 +Post-History: 2015-11-03, 2016-05-29, 2021-02-28 Content-Type: text/x-rst --- @@ -23,6 +23,13 @@ Maintainer listings in ``metadata.xml`` become uniform, and can be used directly to assign bugs. +Change log +== + +v1.1 + Added the ``proxied`` attribute to the package . + + Motivation == @@ -144,19 +151,35 @@ of the element. The e-mail address, human-readable name and maintenance description are placed in , and sub-elements appropriately. +Optionally, a ``proxied`` attribute can be specified having one +of the three possible values: + +- ``yes`` indicating that the maintainer is a proxied maintainer + (i.e. is unable to push changes directly) + +- ``no`` indicating that the maintainer is a real maintainer (i.e. can + push changes directly) + +- ``proxy`` indicating that the listed developer is serving only + as a proxy for other maintainers + +If the attribute is not specified, the default value of ``no`` +is assumed. If at least one maintainer is listed as a proxied +maintainer (``proxied="yes"``), then at least one other maintainer +should be listed as a proxy (``proxied="proxy"``), and vice versa. + .. code:: xml - + f...@example.com Foo Barsky -Proxied maintainer exam...@gentoo.org Example Developer - + proxy-ma...@gentoo.org @@ -428,6 +451,24 @@ maintainers can add themselves to ``metadata.xml`` in a single commit to the repository. If external database was used, the database would have to be updated in addition to the repository commit. +Proxied maintainers +--- + +As of version 1.1, an additional ``proxied`` attribute has been added +to the element for package maintainers. This is used +to explicitly distinguish regular developers, proxied maintainers +and proxies. + +The primary purpose is to resolve false positives in the QA report used +to report leftover proxy-maint project instances, as well as improve +detection of maintainers without a proxy. Currently, these checks +unconditionally assume that all Gentoo developers have commit access, +and everyone else is a proxied maintainer. This does not account for +developers without commit access that maintain packages via a proxy. + +The property is added as a separate attribute in order to ensure +backwards compatibility. + Backwards Compatibility ===
[gentoo-commits] data/glep:master commit in: /
commit: 3232aa12738915cfecf3663672ea59b90a79772b Author: Mike Gilbert gentoo org> AuthorDate: Thu Dec 17 17:43:40 2020 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Jan 4 07:11:18 2021 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=3232aa12 glep-0063: Add section about the Gentoo keyserver Closes: https://bugs.gentoo.org/760923 Signed-off-by: Mike Gilbert gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> glep-0063.rst | 32 1 file changed, 24 insertions(+), 8 deletions(-) diff --git a/glep-0063.rst b/glep-0063.rst index 82541bd..80ca81d 100644 --- a/glep-0063.rst +++ b/glep-0063.rst @@ -7,10 +7,10 @@ Author: Robin H. Johnson , Michał Górny Type: Standards Track Status: Final -Version: 2.1 +Version: 2.2 Created: 2013-02-18 -Last-Modified: 2019-11-07 -Post-History: 2013-11-10, 2018-07-03, 2018-07-21, 2019-02-24 +Last-Modified: 2020-12-17 +Post-History: 2013-11-10, 2018-07-03, 2018-07-21, 2019-02-24, 2020-12-17 Content-Type: text/x-rst --- @@ -28,6 +28,9 @@ OpenPGP key management policies for the Gentoo Linux distribution. Changes === +v2.2 + Added information about the Gentoo keyserver. + v2.1 A requirement for an encryption key has been added, in order to extend the GLEP beyond commit signing and into use of OpenPGP for dev-to-dev @@ -114,7 +117,7 @@ Keys that do not conform to them can not be used to commit. 6. UID using your ``@gentoo.org`` e-mail included in the key. -7. Upload your key to the SKS keyserver rotation before usage! +7. Keys must be uploaded to the Gentoo keyserver. Recommendations --- @@ -135,8 +138,13 @@ their primary key). 5. Encrypted backup of your secret keys. +6. Upload to SKS or another public keyserver pool. + +Gentoo Infrastructure += + Gentoo LDAP -=== +--- All Gentoo developers must list the complete fingerprint for their primary keys in the "``gpgfingerprint``" LDAP field. It must be exactly 40 hex digits, @@ -147,6 +155,14 @@ of the fingerprint field. In any place that presently displays the "``gpgkey``" field, the last 16 hex digits of the fingerprint should be displayed instead. +Gentoo Keyserver + + +Gentoo infrastructure uses a keyserver that is isolated from the SKS pool. +This keyserver is restricted to accepting uploads from authorized Gentoo hosts. +Instructions for uploading keys to this server may be found at +https://keys.gentoo.org/. + Backwards Compatibility === @@ -212,6 +228,6 @@ Copyright Copyright (c) 2013-2019 by Robin Hugh Johnson, Andreas K. Hüttel, Marissa Fischer, Michał Górny. -This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 -Unported License. To view a copy of this license, visit -https://creativecommons.org/licenses/by-sa/3.0/. +This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 +International License. To view a copy of this license, visit +https://creativecommons.org/licenses/by-sa/4.0/.
[gentoo-commits] data/glep:master commit in: /
commit: f89ff538122d32e8df6d194624262ab3da49a3fc Author: Ulrich Müller gentoo org> AuthorDate: Sun May 10 19:31:50 2020 + Commit: Ulrich Müller gentoo org> CommitDate: Sun May 10 19:31:50 2020 + URL:https://gitweb.gentoo.org/data/glep.git/commit/?id=f89ff538 glep-0072: Mark as Accepted per 2020-05-10 Council meeting. Signed-off-by: Ulrich Müller gentoo.org> glep-0072.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/glep-0072.rst b/glep-0072.rst index 4f7a1f9..244b534 100644 --- a/glep-0072.rst +++ b/glep-0072.rst @@ -4,10 +4,10 @@ Title: Architecture stability status file Author: Andreas K. Hüttel , Michał Górny Type: Standards Track -Status: Draft +Status: Accepted Version: 1 Created: 2017-05-06 -Last-Modified: 2020-04-26 +Last-Modified: 2020-05-10 Post-History: 2017-05-06, 2020-04-10 Content-Type: text/x-rst ---