diff options
Diffstat (limited to 'maintainer.html')
| -rw-r--r-- | maintainer.html | 329 |
1 files changed, 329 insertions, 0 deletions
diff --git a/maintainer.html b/maintainer.html new file mode 100644 index 0000000..f930f0d --- /dev/null +++ b/maintainer.html @@ -0,0 +1,329 @@ + +<!doctype html> + +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <title>Package Maintainers — Gentoo Policy Guide documentation</title> + <link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" /> + <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> + <link rel="stylesheet" href="_static/custom.css" type="text/css" /> + + <link rel="icon" href="https://www.gentoo.org/favicon.ico" type="image/x-icon"> + <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen"> + <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen"> + <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> + <script type="text/javascript" src="_static/jquery.js"></script> + <script type="text/javascript" src="_static/underscore.js"></script> + <script type="text/javascript" src="_static/doctools.js"></script> + <script type="text/javascript" src="_static/language_data.js"></script> + <link rel="index" title="Index" href="genindex.html" /> + <link rel="search" title="Search" href="search.html" /> + <link rel="next" title="Other metadata variables" href="other-metadata.html" /> + <link rel="prev" title="Language-specific policies" href="languages.html" /> + </head><body> + <header> + <div class="site-title"> + <div class="container"> + <div class="row"> + <div class="site-title-buttons"> + <div class="btn-group btn-group-sm"> + <a href="https://get.gentoo.org/" role="button" class="btn get-gentoo"><span class="fa fa-fw fa-download"></span> <strong>Get Gentoo!</strong></a> + <div class="btn-group btn-group-sm"> + <a class="btn gentoo-org-sites dropdown-toggle" data-toggle="dropdown" data-target="#" href="#"> + <span class="fa fa-fw fa-map-o"></span> <span class="hidden-xs">gentoo.org sites</span> <span class="caret"></span> + </a> + <ul class="dropdown-menu dropdown-menu-right"> + <li><a href="https://www.gentoo.org/" title="Main Gentoo website"><span class="fa fa-home fa-fw"></span> gentoo.org</a></li> + <li><a href="https://wiki.gentoo.org/" title="Find and contribute documentation"><span class="fa fa-file-text-o fa-fw"></span> Wiki</a></li> + <li><a href="https://bugs.gentoo.org/" title="Report issues and find common issues"><span class="fa fa-bug fa-fw"></span> Bugs</a></li> + <li><a href="https://forums.gentoo.org/" title="Discuss with the community"><span class="fa fa-comments-o fa-fw"></span> Forums</a></li> + <li><a href="https://packages.gentoo.org/" title="Find software for your Gentoo"><span class="fa fa-hdd-o fa-fw"></span> Packages</a></li> + <li class="divider"></li> + <li><a href="https://planet.gentoo.org/" title="Find out what's going on in the developer community"><span class="fa fa-rss fa-fw"></span> Planet</a></li> + <li><a href="https://archives.gentoo.org/" title="Read up on past discussions"><span class="fa fa-archive fa-fw"></span> Archives</a></li> + <li><a href="https://sources.gentoo.org/" title="Browse our source code"><span class="fa fa-code fa-fw"></span> Sources</a></li> + <li class="divider"></li> + <li><a href="https://infra-status.gentoo.org/" title="Get updates on the services provided by Gentoo"><span class="fa fa-server fa-fw"></span> Infra Status</a></li> + </ul> + </div> + </div> + </div> + <div class="logo"> + <a href="index.html" title="Back to the homepage" class="site-logo"></a> + <span class="site-label"> Policy Guide </span> + </div> + </div> + </div> + </div> + <nav class="tyrian-navbar" role="navigation"> + <div class="container"> + <div class="row"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-main-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + <div class="collapse navbar-collapse navbar-main-collapse"> + <ul class="nav navbar-nav"> + <li> + <a href="index.html">Home</a></li> + <li class=""><a href="_sources/maintainer.rst.txt">Source</a></li> + <li> + <a href="search.html">Search</a></li> + <li> + <a href="genindex.html">Index</a></li> + + + + </ul> + + <form action="search.html" class="navbar-form navbar-right" method="get" onsubmit="if (this.quicksearch.value == '') + { alert('Please enter one or more search terms first.'); + return false; } return true;"> + + <div class="input-group" style="margin-top:2px;"> + <span class="input-group-addon" style="background:#61597b;color:#FFF;border:0px;" id="basic-addon1"><i class="fa fa-search" aria-hidden="true"></i></span> + <input class="form-control" style="height:30px;border:0px;background:#61597b;color:#FFF;padding-left:0px;box-shadow: none;" type="text" id="quicksearch_top" name="q" title="Quick Search" placeholder="Quick Search" value=""> + </div> + <button class="btn btn-default hidden" type="submit" value="Search" id="find_top">Search</button> + </form> + + </div> + </div> + </div> + </nav> + </header> + + + <div class="container"> + <div class="row"> + + + + <div class="col-md-9 col-sm-12 col-xs-12" role="main"> + + + + + + + <div class="section" id="package-maintainers"> +<h1>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this headline">¶</a></h1> +<div class="section" id="adding-new-maintainers"> +<span id="index-0"></span><h2>Adding new maintainers<a class="headerlink" href="#adding-new-maintainers" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">Source</dt> +<dd class="field-odd"><p>QA</p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>no</p> +</dd> +</dl> +<p>Developers must not add other developers as package maintainers, unless +the developers in question consent to that. Developers must not add +projects that they are not members of as package maintainers, unless +one of the project members explicitly agrees to that or the project +policy explicitly permits it.</p> +<p><em>Rationale</em>: this policy aims to prevent package maintainers being added +as backup maintainers without their consent or knowledge. What’s worse, +once the original maintainer resigns the packages frequently drop +to backup maintainers who are neither interested in maintaining them, +nor often aware why they are listed as maintainers.</p> +<p>For example, developers used to frequently add Python team as a backup +maintainer to various packages not fitting the project’s profile. This +includes various end-user programs written in Python. Many of those +packages ended up being maintained solely by Python, and distinguishing +them from packages actually within project’s profile was hard.</p> +</div> +<div class="section" id="new-packages-without-a-maintainer"> +<span id="index-1"></span><h2>New packages without a maintainer<a class="headerlink" href="#new-packages-without-a-maintainer" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">Source</dt> +<dd class="field-odd"><p>QA</p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>no</p> +</dd> +</dl> +<p>It is explicitly forbidden to add new packages without a dedicated +maintainer. This does not apply if the package in question is not +technically a new one but merely split out of unmaintained package.</p> +<p><em>Rationale</em>: Gentoo is currently suffering from a very large number +of packages without a maintainer. There is a small group of developers +trying to fix them as necessary. It is unfair and inappropriate +to increase their maintenance burden by adding new packages and refusing +to take care of them.</p> +<span class="target" id="index-2"></span></div> +<div class="section" id="removing-package-maintainers"> +<span id="index-3"></span><h2>Removing package maintainers<a class="headerlink" href="#removing-package-maintainers" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">Source</dt> +<dd class="field-odd"><p>QA</p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>no</p> +</dd> +</dl> +<p>When removing maintainers from a package, the developer must reassign +all bugs filed for it. Furthermore, when removing the last maintainer +for a package, the developer must add the following comment +to <code class="docutils literal notranslate"><span class="pre">metadata.xml</span></code>:</p> +<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><!-- maintainer-needed --> +</pre></div> +</div> +<p>Furthermore, the developer must send an ‘up for grabs’ mail +to gentoo-dev mailing list, containing the list of packages with +no maintainer. If possible, please include any information that could +be helpful to future maintainers.</p> +<p><em>Rationale</em>: reassigning bugs is necessary to make sure that old bugs +are not lost assigned to developers who are no longer interested +in them. The maintainer-needed comment is meant to make it possible +to easily grep for unmaintained packages. The ‘up for grabs’ mails aim +to increase the chances of packages finding a new maintainers (compared +to them silently becoming maintainer-needed).</p> +</div> +</div> + + + + + + + <div class="row" style="margin-top:50px;"> + <div class="col-sm-6"> + + <a href="languages.html" style="color:#767676;"> + <i class="fa fa-angle-double-left" aria-hidden="true"></i> + + Language-specific policies + + </a> + + </div> + + <div class="col-sm-6"> + + <a href="other-metadata.html" class="pull-right" style="color:#767676;"> + + Other metadata variables + + <i class="fa fa-angle-double-right" aria-hidden="true"></i> + </a> + + </div> + </div> + + + + + </div> + + + <div class="col-md-3 hidden-sm hidden-xs" role="main"> +<div class="" role="navigation" aria-label="main navigation"> + <div class=""> + + <nav class="bs-docs-sidebar" data-spy="affix" data-offset-top="140" data-offset-bottom="400"> + <p class="hidden"><span class="hidden-text">Contents:</span></p> +<ul class='current nav'> +<li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a></li> +<li class="toctree-l1"><a class="reference internal" href="motivation.html">Motivation and history</a></li> +<li class="toctree-l1"><a class="reference internal" href="basics.html">Basic information</a></li> +<li class="toctree-l1"><a class="reference internal" href="other-docs.html">Other policy documents</a></li> +<li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li> +<li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li> +<li class="toctree-l1"><a class="reference internal" href="filesystem.html">File system layout</a></li> +<li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li> +<li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li> +<li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li> +<li class="toctree-l1 current"><a class="current reference internal" href="#">Package Maintainers</a><ul class='nav'> +<li class="toctree-l2"><a class="reference internal" href="#adding-new-maintainers">Adding new maintainers</a></li> +<li class="toctree-l2"><a class="reference internal" href="#new-packages-without-a-maintainer">New packages without a maintainer</a></li> +<li class="toctree-l2"><a class="reference internal" href="#removing-package-maintainers">Removing package maintainers</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="other-metadata.html">Other metadata variables</a></li> +<li class="toctree-l1"><a class="reference internal" href="use-flags.html">USE flags</a></li> +<li class="toctree-l1"><a class="reference internal" href="user-group.html">Users and groups</a></li> +</ul> + + + </nav> + </div> +</div> + </div> + + </div> + <div class="clearer"></div> + </div> + <footer> + <div class="container"> + <div class="row"> + <div class="col-xs-12 col-md-offset-2 col-md-7"> + <h3 class="footerhead">Gentoo Policy Guide </h3> + <div class="row"> + <div class="col-xs-12 col-md-4"> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> & <a href="#">Tyrian Theme 0.0.1</a></span> + </div> + <div class="col-xs-12 col-md-4"> + </div> + <div class="col-xs-12 col-md-4"> + </div> + </div> + </div> + <div class="col-xs-12 col-md-3"> + <h3 class="footerhead">Questions or comments?</h3> + Please feel free to <a href="https://www.gentoo.org/inside-gentoo/contact/">contact us</a>. + </div> + </div> + <div class="row"> + <div class="col-xs-2 col-sm-3 col-md-2"> + <ul class="footerlinks three-icons"> + <li><a href="https://twitter.com/gentoo" title="@Gentoo on Twitter"><span class="fa fa-twitter fa-fw"></span></a></li> + <li><a href="https://plus.google.com/+Gentoo" title="+Gentoo on Google+"><span class="fa fa-google-plus fa-fw"></span></a></li> + <li><a href="https://www.facebook.com/gentoo.org" title="Gentoo on Facebook"><span class="fa fa-facebook fa-fw"></span></a></li> + </ul> + </div> + <div class="col-xs-10 col-sm-9 col-md-10"> + <strong>© 2001–2020 Gentoo Foundation, Inc.</strong><br> + <small> + Gentoo is a trademark of the Gentoo Foundation, Inc. + The contents of this document, unless otherwise expressly stated, are licensed under the + <a href="https://creativecommons.org/licenses/by-sa/3.0/" rel="license">CC-BY-SA-3.0</a> license. + The <a href="https://www.gentoo.org/inside-gentoo/foundation/name-logo-guidelines.html">Gentoo Name and Logo Usage Guidelines</a> apply. + </small> + </div> + </div> + </div> + </footer> + + <script src="https://assets.gentoo.org/tyrian/bootstrap.min.js"></script> + + + <script type="text/javascript"> + $('body').scrollspy({ + target: '.bs-docs-sidebar', + offset: 40 + }); + </script> + + + <script type="text/javascript"> + $('#indices-and-tables').hide() + </script> + + + + + + + + </body> +</html> + |