diff options
| author |   Michał Górny <mgorny@gentoo.org> | 2021-08-15 08:33:29 +0200 |
|---|---|---|
| committer | Michał Górny <mgorny@gentoo.org> | 2021-08-15 08:33:36 +0200 |
| commit | 27a05bcff5d4ba814b3c1279937e3b38c3c925a5 (patch) | |
| tree | fd5a476acbd3a566bc904fb91e3c1247f16af28f /installed-files.html | |
| parent | Rebuild the site (diff) | |
| download | policy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.tar.gz policy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.tar.bz2 policy-guide-27a05bcff5d4ba814b3c1279937e3b38c3c925a5.zip | |
Rebuild / update
Signed-off-by: Michał Górny <mgorny@gentoo.org>
Diffstat (limited to 'installed-files.html')
| -rw-r--r-- | installed-files.html | 48 |
1 files changed, 36 insertions, 12 deletions
diff --git a/installed-files.html b/installed-files.html index 799a837..78782b4 100644 --- a/installed-files.html +++ b/installed-files.html @@ -5,7 +5,8 @@ <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="viewport" content="width=device-width, initial-scale=1"><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" /> + <title>Installed files — 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" /> @@ -14,11 +15,13 @@ <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"> + <link rel="stylesheet" type="text/css" href="_static/pygments.css" /> + <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/language_data.js"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Keywording and stabilization" href="keywords.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="installed-files"> + <section id="installed-files"> <h1>Installed files<a class="headerlink" href="#installed-files" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg0301"> +<section id="pg0301"> <span id="installation-of-small-files"></span><span id="index-0"></span><h2>Installation of small files<a class="headerlink" href="#pg0301" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -166,8 +169,8 @@ applicable here since this package needs to be installed by the user if he wishes to use completions in the first place, and if it is not installed, completion files are not used at all.</p> </div> -</div> -<div class="section" id="pg0302"> +</section> +<section id="pg0302"> <span id="installation-of-static-libraries"></span><span id="index-1"></span><h2>Installation of static libraries<a class="headerlink" href="#pg0302" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -190,8 +193,8 @@ support for packages practically impossible. It may be used whenever really necessary (e.g. for recovery tools) but otherwise proliferating it is considered harmful. There is no point in installing static libraries if they are never going to be used.</p> -</div> -<div class="section" id="pg0303"> +</section> +<section id="pg0303"> <span id="installation-of-libtool-la-files"></span><span id="index-2"></span><h2>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -224,8 +227,28 @@ and caused many issues, in particular due to hardcoding full paths. Today they are practically replaced by more portable pkg-config files, and while libtool keeps generating them, they are considered unnecessary and potentially harmful.</p> -</div> -</div> +</section> +<section id="pg0304"> +<span id="virtuals"></span><span id="index-3"></span><h2>Virtuals<a class="headerlink" href="#pg0304" title="Permalink to this headline">¶</a></h2> +<dl class="field-list simple"> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0304</p> +</dd> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> +</dd> +<dt class="field-odd">Reported</dt> +<dd class="field-odd"><p>no</p> +</dd> +</dl> +<p>Packages in the <code class="docutils literal notranslate"><span class="pre">virtual</span></code> category must not install any files.</p> +<p><em>Rationale</em>: The <code class="docutils literal notranslate"><span class="pre">virtual</span></code> category is reserved for packages with +an empty installation image. Package managers rely on this for some +optimizations. Also QA tools make certain assumptions about virtuals, +e.g., that they must not assign the <code class="docutils literal notranslate"><span class="pre">LICENSE</span></code> variable (which would +be impossible if they installed any files).</p> +</section> +</section> @@ -267,7 +290,7 @@ unnecessary and potentially harmful.</p> <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> + <p class="hidden" role="heading"><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> @@ -281,6 +304,7 @@ unnecessary and potentially harmful.</p> <li class="toctree-l2"><a class="reference internal" href="#pg0301">Installation of small files</a></li> <li class="toctree-l2"><a class="reference internal" href="#pg0302">Installation of static libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="#pg0303">Installation of libtool (.la) files</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0304">Virtuals</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a></li> @@ -307,7 +331,7 @@ unnecessary and potentially harmful.</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 3.3.0</a> & <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 4.1.2</a> & <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> |