summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'other-metadata.html')
-rw-r--r--other-metadata.html68
1 files changed, 33 insertions, 35 deletions
diff --git a/other-metadata.html b/other-metadata.html
index ab3be00..0fce736 100644
--- a/other-metadata.html
+++ b/other-metadata.html
@@ -1,11 +1,11 @@
<!doctype html>
-<html xmlns="http://www.w3.org/1999/xhtml">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
- <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
+ <meta name="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
<title>Other metadata variables &#8212; Gentoo Policy Guide documentation</title>
<link rel="stylesheet" href="_static/tyrian-sphinx-theme.css" type="text/css" />
@@ -19,9 +19,8 @@
<link rel="stylesheet" type="text/css" href="_static/tyrian-sphinx-theme.css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
- <script src="_static/jquery.js"></script>
- <script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
+ <script src="_static/sphinx_highlight.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="USE flags" href="use-flags.html" />
@@ -134,20 +133,20 @@
<section id="other-metadata-variables">
-<h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this headline">¶</a></h1>
+<h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this heading">¶</a></h1>
<span class="target" id="index-0"></span><section id="pg0701">
-<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><h2>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Permalink to this headline">¶</a></h2>
+<span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><h2>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Permalink to this heading">¶</a></h2>
<dl class="field-list simple">
-<dt class="field-odd">PG</dt>
+<dt class="field-odd">PG<span class="colon">:</span></dt>
<dd class="field-odd"><p>0701</p>
</dd>
-<dt class="field-even">Source</dt>
+<dt class="field-even">Source<span class="colon">:</span></dt>
<dd class="field-even"><p>QA (inferred from PMS)</p>
</dd>
-<dt class="field-odd">Reference</dt>
+<dt class="field-odd">Reference<span class="colon">:</span></dt>
<dd class="field-odd"><p><a class="reference external" href="https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&amp;oldid=109991#multislot.2FUSE-dependent_SLOT">https://wiki.gentoo.org/index.php?title=Project:Quality_Assurance/Policies&amp;oldid=109991#multislot.2FUSE-dependent_SLOT</a>, <a class="reference external" href="https://bugs.gentoo.org/174407">https://bugs.gentoo.org/174407</a></p>
</dd>
-<dt class="field-even">Reported</dt>
+<dt class="field-even">Reported<span class="colon">:</span></dt>
<dd class="field-even"><p><code class="docutils literal notranslate"><span class="pre">use</span></code> in global scope triggers fatal error</p>
</dd>
</dl>
@@ -174,18 +173,18 @@ manager behavior which could include use of unpredictable slot, cache
invalidation or explicit errors.</p>
</section>
<section id="pg0702">
-<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h2>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Permalink to this headline">¶</a></h2>
+<span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h2>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Permalink to this heading">¶</a></h2>
<dl class="field-list simple">
-<dt class="field-odd">PG</dt>
+<dt class="field-odd">PG<span class="colon">:</span></dt>
<dd class="field-odd"><p>0702</p>
</dd>
-<dt class="field-even">Source</dt>
+<dt class="field-even">Source<span class="colon">:</span></dt>
<dd class="field-even"><p>QA</p>
</dd>
-<dt class="field-odd">Reference</dt>
+<dt class="field-odd">Reference<span class="colon">:</span></dt>
<dd class="field-odd"><p><a class="reference external" href="https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035">https://archives.gentoo.org/gentoo-dev/message/83cc5bbd7bbe8bdf04dd3c3bc7f8a035</a></p>
</dd>
-<dt class="field-even">Reported</dt>
+<dt class="field-even">Reported<span class="colon">:</span></dt>
<dd class="field-even"><p>known bad values are reported by pkgcheck</p>
</dd>
</dl>
@@ -205,15 +204,15 @@ those cases, using the explicit No_homepage marker at least makes it
easy to identify such packages.</p>
</section>
<section id="pg0703">
-<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h2>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Permalink to this headline">¶</a></h2>
+<span id="restrict-test-for-use-test"></span><span id="index-3"></span><h2>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Permalink to this heading">¶</a></h2>
<dl class="field-list simple">
-<dt class="field-odd">PG</dt>
+<dt class="field-odd">PG<span class="colon">:</span></dt>
<dd class="field-odd"><p>0703</p>
</dd>
-<dt class="field-even">Source</dt>
+<dt class="field-even">Source<span class="colon">:</span></dt>
<dd class="field-even"><p>QA</p>
</dd>
-<dt class="field-odd">Reported</dt>
+<dt class="field-odd">Reported<span class="colon">:</span></dt>
<dd class="field-odd"><p>by pkgcheck</p>
</dd>
</dl>
@@ -239,29 +238,31 @@ common, and there is little harm in overspecifying it.</p>
</div>
</section>
<section id="pg0704">
-<span id="license"></span><span id="index-4"></span><h2>LICENSE<a class="headerlink" href="#pg0704" title="Permalink to this headline">¶</a></h2>
+<span id="license"></span><span id="index-4"></span><h2>LICENSE<a class="headerlink" href="#pg0704" title="Permalink to this heading">¶</a></h2>
<dl class="field-list simple">
-<dt class="field-odd">PG</dt>
+<dt class="field-odd">PG<span class="colon">:</span></dt>
<dd class="field-odd"><p>0704</p>
</dd>
-<dt class="field-even">Source</dt>
+<dt class="field-even">Source<span class="colon">:</span></dt>
<dd class="field-even"><p>QA</p>
</dd>
-<dt class="field-odd">Reported</dt>
+<dt class="field-odd">Reported<span class="colon">:</span></dt>
<dd class="field-odd"><p>no</p>
</dd>
</dl>
-<p>The <code class="docutils literal notranslate"><span class="pre">LICENSE</span></code> variable must explicitly list licenses for all files
-installed by the package. If some of the applicable licenses are
-conditional to USE flags, appropriate USE conditionals need to
-be expressed in the variable.</p>
+<p>The <code class="docutils literal notranslate"><span class="pre">LICENSE</span></code> variable must explicitly list all licenses pertaining
+to the “corresponding source” of the files installed by the package.
+This includes all their source code, but also all scripts used to
+control compilation and installation. If some of the applicable
+licenses are conditional to USE flags, appropriate USE conditionals
+need to be expressed in the variable.</p>
<p>If a package bundles any dependencies that are either installed,
statically linked or in any other way combined with installed files,
the licenses of these dependencies need to be listed as well. This
is not presently required when statically linking to dependencies
installed by separate packages in the repository.</p>
-<p>The licenses for files that are not installed but that are used at build
-time are not listed explicitly.</p>
+<p>The licenses for files that are neither installed nor used at build
+time shall not be listed.</p>
<p><em>Rationale</em>: the primary purpose of the license support in the package
manager is to provide the users with ability to decide on acceptable
licenses for their installed systems (and binary packages). In order
@@ -277,10 +278,6 @@ static linking to other packages, as in the latter case it is
non-trivial to implement and the package manager already verifies
the license while building dependencies (but not when installing binary
packages).</p>
-<p>The ebuild format does not provide a separate variable to list licenses
-needed only at build time. So far it has not been considered important
-enough to have one, as the relevant files exist only temporarily
-on the user’s system and do not affect the runtime use of packages.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Please remember to include the licenses of support files provided
@@ -370,7 +367,7 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</p>
<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 4.5.0</a> &amp; <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span>
+ <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 6.1.3</a> &amp; <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span>
</div>
<div class="col-xs-12 col-md-4">
</div>
@@ -387,11 +384,12 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</p>
<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–2022 Gentoo Authors</strong><br>
+ <strong>© 2001–2023 Gentoo Authors, 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