summaryrefslogtreecommitdiff
blob: b46d86f129bc09f77279b6486391e904c9634185 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
---
GLEP: 3
Title: Ebuild maintainter extension GLEP
Author: Caleb Tennis <caleb@gentoo.org>
Type: Standards Track
Status: Deferred
Version: 1
Created: 2003-06-09
Last-Modified: 2014-01-15
Post-History: 2003-06-10
Content-Type: text/x-rst
---


Abstract
========

Gentoo's portage tree attempts to provide a self contained, easy to use, and
automatic installation procedure for as many packages as can be maintained by
developers.

This GLEP proposes allowing non-core Gentoo developers to be considered as
ebuild maintainers sponsored via a core Gentoo developer.  This system will
allow more ebuilds to be available in portage with active maintainers for
those ebuilds.

This GLEP only applies to EBUILD based bugs that contain a request for a
package to be committed or version bumped within portage.

Motivation
==========

As of the first draft of this GLEP, there are 1387 EBUILD bug requests in
Gentoo's bugzilla database.  Many of these requests contain ebuilds that
have been submitted by the bug reporter and are simply awaiting a Gentoo
developer to sponsor the submission of the ebuild.



Rationale
=========

Gentoo's portage tree already contains the most popular ebuilds for packages
available today.  Many teams exist that are responsible for maintaining these
core ebuilds in the portage tree.  But, for ebuilds that are not as commonly
used, there is no good focal point upon which to rest these ebuilds.

For example, any submitted ebuild that is a KDE application gets routed to the
KDE team.  However, the KDE team may be unfamiliar with the submitted ebuild.
A new graphical MySQL editor may be submitted to the MYSQL team, but none of
the members of that team may be familiar or have the desire to learn a new
program to submit it to portage.

We want to be able to provide for as many ebuilds in portage as feasible and
make sure that all ebuilds have some person who is responsible for
maintenance.


Backwards Compatibility
=======================

No current policies exist that interfere with this document.


Implementation
==============

Incoming ebuild bug reports should continue to be processed as normal.

Bug reports that *do not* contain an attached ebuild should be marked as
NEEDINFO.  A message asking the user to create and submit an ebuild should be
attached to the bug.

Bug reports that *do* have an attached ebuild should be responded to with
a message asking if the reporter agrees to provide maintenance and support for
the ebuild and package.

If a reporter *does not* agree to provide package maintenance, the bug report
should be marked WONTFIX.

If a reporter *does* agree to provide package support, the ebuild should
be added to portage with a note in the ChangeLog that the reporter is
considered the maintainer of that particular ebuild.

Any incoming bug reports that are related to this ebuild should continue to
get processed as normal.  The team that the ebuild goes to should then CC the
author of the ebuild.  Optionally, if a docs-team member has prior knowledge
that the ebuild is externally maintained, he/she can add that person to the CC
list.

Security
========

**At the very least**, all ebuilds must be looked over by the developer
handling the commit.

In no case should a submitted digest file be used.  The developer is
responsible for creating the digest file based on an actual download of the
source code.

Potential breaches in security can still exist, however.  The developer
handling the installation should take every step to ensure that no ebuild,
package, or other files have been compromised.


Future
======

Current proposals to rethink Gentoo portage and bug handling (a.k.a Herds) are
still in negotiation.  It is the intention of the author of this GLEP to evolve
the concept of this GLEP as the Herds concept matures and stabilizes.


References
==========

.. [#GLEP2] GLEP 2, Sample ReStructuredText GLEP Template, Goodyear,
   (https://www.gentoo.org/glep/glep-0002.html)


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/