diff options
author | 2020-01-19 11:52:41 +0100 | |
---|---|---|
committer | 2020-01-19 11:52:41 +0100 | |
commit | a78e47e2d90aa050944b16b1fc1a3e62f83cef5f (patch) | |
tree | 8a4d50ed7bbbf056598961d3ba2fc2b63d3fbd09 /keywords.html | |
parent | Upload first built version (diff) | |
download | policy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.tar.gz policy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.tar.bz2 policy-guide-a78e47e2d90aa050944b16b1fc1a3e62f83cef5f.zip |
Update wrt maintainers, keywording and new theme
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'keywords.html')
-rw-r--r-- | keywords.html | 311 |
1 files changed, 245 insertions, 66 deletions
diff --git a/keywords.html b/keywords.html index 5052f26..e83ce12 100644 --- a/keywords.html +++ b/keywords.html @@ -1,12 +1,19 @@ -<!DOCTYPE html> +<!doctype html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> - <meta charset="utf-8" /> + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Keywording and stabilization — Gentoo Policy Guide documentation</title> - <link rel="stylesheet" href="_static/alabaster.css" type="text/css" /> + <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> @@ -15,27 +22,147 @@ <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Language-specific policies" href="languages.html" /> - <link rel="prev" title="Installed files" href="installed-files.html" /> - - <link rel="stylesheet" href="_static/custom.css" type="text/css" /> - - - <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" /> - + <link rel="prev" title="Installed files" href="installed-files.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/keywords.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="document"> - <div class="documentwrapper"> - <div class="bodywrapper"> - + <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 class="body" role="main"> - + </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="keywording-and-stabilization"> <h1>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Permalink to this headline">¶</a></h1> +<div class="section" id="rekeywording-on-dropped-keywords"> +<span id="index-0"></span><h2>Rekeywording on dropped keywords<a class="headerlink" href="#rekeywording-on-dropped-keywords" 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>by pkgcheck and repoman</p> +</dd> +</dl> +<p>The developer removing keywords from a package (e.g. due to new +dependencies) must file a rekeywording bug asking for the package being +retested. This rule can be exempted if the package is known not to work +(anymore) on the arch in question.</p> +<p><em>Rationale</em>: rekeywording on minor architectures often takes a long +time. If a developer neglects to request it immediately, it negatively +affects other developers who in the future either want to stabilize +a new version or to remove an old version.</p> +</div> +<div class="section" id="stabilizing-new-versions"> +<span id="index-1"></span><h2>Stabilizing new versions<a class="headerlink" href="#stabilizing-new-versions" 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>by pkgcheck</p> +</dd> +</dl> +<p>Whenever requesting a stabilization of a new version of the package, +the developer must CC <em>all</em> arches that had at least one previous stable +version of the package in question, and that still have ~arch keywords +in the stabilized version. This applies to experimental architectures +as well.</p> +<p>The stabilization request can be closed and old stable version removed +once all non-experimental architectures have processed the stabilization +request. However, the remaining arch teams should be kept CC-ed in case +they wanted to process the bug.</p> +<p><em>Rationale</em>: there were some cases of developers requesting +stabilization only of a subset of architectures they were personally +interested in. This meant some other developer had to independently +request stabilization on remaining architectures which only meant +a duplication of effort and unnecessary confusion over which version +is stable and whether arch teams are slacking or stabilization was not +requested on remaining architectures in the first place.</p> +</div> <div class="section" id="removing-stable-keywords"> -<span id="index-0"></span><h2>Removing stable keywords<a class="headerlink" href="#removing-stable-keywords" title="Permalink to this headline">¶</a></h2> +<span id="index-2"></span><h2>Removing stable keywords<a class="headerlink" href="#removing-stable-keywords" 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> @@ -58,24 +185,47 @@ of last rite mails.</p> </div> - </div> - - </div> - </div> - <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> - <div class="sphinxsidebarwrapper"> -<h1 class="logo"><a href="index.html">Gentoo Policy Guide</a></h1> - - - + + + + <div class="row" style="margin-top:50px;"> + <div class="col-sm-6"> + + <a href="installed-files.html" style="color:#767676;"> + <i class="fa fa-angle-double-left" aria-hidden="true"></i> + + Installed files + + </a> + + </div> + <div class="col-sm-6"> + + <a href="languages.html" class="pull-right" style="color:#767676;"> + + Language-specific policies + + <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=""> -<h3>Navigation</h3> -<p class="caption"><span class="caption-text">Contents:</span></p> -<ul class="current"> + <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> @@ -84,61 +234,90 @@ of last rite mails.</p> <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 current"><a class="current reference internal" href="#">Keywording and stabilization</a><ul> +<li class="toctree-l1 current"><a class="current reference internal" href="#">Keywording and stabilization</a><ul class='nav'> +<li class="toctree-l2"><a class="reference internal" href="#rekeywording-on-dropped-keywords">Rekeywording on dropped keywords</a></li> +<li class="toctree-l2"><a class="reference internal" href="#stabilizing-new-versions">Stabilizing new versions</a></li> <li class="toctree-l2"><a class="reference internal" href="#removing-stable-keywords">Removing stable keywords</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="languages.html">Language-specific policies</a></li> +<li class="toctree-l1"><a class="reference internal" href="maintainer.html">Package Maintainers</a></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> -<div class="relations"> -<h3>Related Topics</h3> -<ul> - <li><a href="index.html">Documentation overview</a><ul> - <li>Previous: <a href="installed-files.html" title="previous chapter">Installed files</a></li> - <li>Next: <a href="languages.html" title="next chapter">Language-specific policies</a></li> - </ul></li> -</ul> -</div> -<div id="searchbox" style="display: none" role="search"> - <h3 id="searchlabel">Quick search</h3> - <div class="searchformwrapper"> - <form class="search" action="search.html" method="get"> - <input type="text" name="q" aria-labelledby="searchlabel" /> - <input type="submit" value="Go" /> - </form> + + </nav> </div> </div> -<script type="text/javascript">$('#searchbox').show(0);</script> + </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> - </div> - </div> - <div class="clearer"></div> - </div> - <div class="footer"> - ©2020, Gentoo Authors. - - | - Powered by <a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> - & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a> - - | - <a href="_sources/keywords.rst.txt" - rel="nofollow">Page source</a> - </div> - + + </body> -</html>
\ No newline at end of file +</html> + |