Bug 577760 – GLEP 2: does not allow replacing multiple GLEPs with a single one

• Product: Documentation
• Status: RESOLVED FIXED

[Description Michał Górny 2016-03-19 08:24:30 UTC]

GLEP 68 redefines metadata.xml and provides a single spec for all data in it. Therefore, it would be reasonable to replace all the earlier GLEPs that provide parts of this data (GLEP 34, 46, 56). However, it seems that the wiki template specified by GLEP 2 allows only one replacement.

[Comment 1 Chris Reffett (RETIRED) 2016-03-19 12:01:10 UTC]

Sounds reasonable, GLEP team approves. Wiki team: my wiki-fu is weak, would this be feasible?

[Comment 2 Alex Legler (RETIRED) 2016-03-26 11:33:57 UTC]

(In reply to Chris Reffett from comment #1)
> Sounds reasonable, GLEP team approves. Wiki team: my wiki-fu is weak, would
> this be feasible?

Feasible and implemented. I'll leave you to update GLEP 2.

[Comment 3 Michał Górny 2017-10-17 15:50:38 UTC]

This is actually permitted by the current wording of GLEP 1 [1]. However, the text of both GLEPs still partially suggest a single value, and I've submitted a patches clarifying that ([2], [3]). Given that it's merely a clarification, I'm going to push them in a few days time if nobody opposes.

[1]:https://www.gentoo.org/glep/glep-0001.html
[2]:https://archives.gentoo.org/gentoo-project/message/0c1533ca2fa9f90d66375cfd9dd1d93c
[3]:https://archives.gentoo.org/gentoo-project/message/8187bb9528c0941bdb04af50ed4f3445

[Comment 4 Larry the Git Cow 2017-10-27 17:44:36 UTC]

The bug has been closed via the following commit(s):

https://gitweb.gentoo.org/data/glep.git/commit/?id=c20fe701388d8394c0e957177355eb139559c84e

commit c20fe701388d8394c0e957177355eb139559c84e
Author:     Michał Górny <[e-mail]>
AuthorDate: 2017-10-13 15:09:38 +0000
Commit:     Michał Górny <[e-mail]>
CommitDate: 2017-10-27 17:44:21 +0000

    glep-0002: Indicate that the 'Replaces' header is multi-value
    
    Update the description of the 'Replaces' header to account for
    replacement of multiple GLEPs. This possibility is already permitted
    by GLEP 1; however, GLEP 2 seems to be out of date.
    
    Closes: https://bugs.gentoo.org/577760

 glep-0002.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

Additionally, it has been referenced in the following commit(s):

https://gitweb.gentoo.org/data/glep.git/commit/?id=3d0bdf3bc2fb72de1f80cf42a57dd4002cff59f7

commit 3d0bdf3bc2fb72de1f80cf42a57dd4002cff59f7
Author:     Michał Górny <[e-mail]>
AuthorDate: 2017-10-13 15:07:01 +0000
Commit:     Michał Górny <[e-mail]>
CommitDate: 2017-10-27 17:44:21 +0000

    glep-0001: Clearly indicate that 'Replaces' is multi-value
    
    Use the plural 'glep numbers' form for the Replaces header to indicate
    it may have multiple values. This is already allowed by the text
    of the GLEP.
    
    Bug: https://bugs.gentoo.org/577760

 glep-0001.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)}