diff options
| -rw-r--r-- | .buildinfo | 2 | ||||
| -rw-r--r-- | _sources/dependencies.rst.txt | 4 | ||||
| -rw-r--r-- | _sources/deprecation.rst.txt | 1 | ||||
| -rw-r--r-- | _sources/installed-files.rst.txt | 18 | ||||
| -rw-r--r-- | _static/basic.css | 110 | ||||
| -rw-r--r-- | _static/doctools.js | 11 | ||||
| -rw-r--r-- | _static/language_data.js | 6 | ||||
| -rw-r--r-- | _static/pygments.css | 8 | ||||
| -rw-r--r-- | _static/searchtools.js | 30 | ||||
| -rw-r--r-- | _static/underscore.js | 37 | ||||
| -rw-r--r-- | basics.html | 31 | ||||
| -rw-r--r-- | combined.html | 354 | ||||
| -rw-r--r-- | dependencies.html | 63 | ||||
| -rw-r--r-- | deprecation.html | 30 | ||||
| -rw-r--r-- | ebuild-format.html | 35 | ||||
| -rw-r--r-- | filesystem.html | 39 | ||||
| -rw-r--r-- | genindex.html | 22 | ||||
| -rw-r--r-- | index.html | 22 | ||||
| -rw-r--r-- | installed-files.html | 48 | ||||
| -rw-r--r-- | keywords.html | 27 | ||||
| -rw-r--r-- | languages.html | 27 | ||||
| -rw-r--r-- | maintainer.html | 27 | ||||
| -rw-r--r-- | motivation.html | 23 | ||||
| -rw-r--r-- | other-docs.html | 43 | ||||
| -rw-r--r-- | other-metadata.html | 31 | ||||
| -rw-r--r-- | preface.html | 27 | ||||
| -rw-r--r-- | search.html | 17 | ||||
| -rw-r--r-- | searchindex.js | 2 | ||||
| -rw-r--r-- | std-policy-index.html | 11 | ||||
| -rw-r--r-- | use-flags.html | 27 | ||||
| -rw-r--r-- | user-group.html | 19 |
31 files changed, 666 insertions, 486 deletions
@@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: daa7b134e8e74971d12c9aaa9337c9d6 +config: 6960e05debd63d7927ef9e6452cd4258 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/_sources/dependencies.rst.txt b/_sources/dependencies.rst.txt index a1f5177..c0afb81 100644 --- a/_sources/dependencies.rst.txt +++ b/_sources/dependencies.rst.txt @@ -18,8 +18,8 @@ dependencies is installed. There is no specific preference as to how user should be informed of optional runtime dependencies. Three possible ways are -``optfeature`` from ``eutils`` eclass, ``readme.gentoo-r1`` eclass -and plain ``elog`` messages. +``optfeature`` eclass, ``readme.gentoo-r1`` eclass and plain ``elog`` +messages. *Rationale*: toggling USE flags in order to enable or disable optional runtime dependencies causes needless rebuilds of packages in question. diff --git a/_sources/deprecation.rst.txt b/_sources/deprecation.rst.txt index 83284f5..1fb03a6 100644 --- a/_sources/deprecation.rst.txt +++ b/_sources/deprecation.rst.txt @@ -25,7 +25,6 @@ Deprecated eclasses ------------------- :PG: 1003 :Source: individual eclass maintainers -:Reference: https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf :Reported: by pkgcheck and repoman Deprecated eclasses should not be used in new ebuilds. Existing diff --git a/_sources/installed-files.rst.txt b/_sources/installed-files.rst.txt index db949b0..da6263e 100644 --- a/_sources/installed-files.rst.txt +++ b/_sources/installed-files.rst.txt @@ -88,3 +88,21 @@ 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. + + +.. index:: + pair: installed files; virtuals + +Virtuals +-------- +:PG: 0304 +:Source: QA +:Reported: no + +Packages in the ``virtual`` category must not install any files. + +*Rationale*: The ``virtual`` 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 ``LICENSE`` variable (which would +be impossible if they installed any files). diff --git a/_static/basic.css b/_static/basic.css index 24a49f0..912859b 100644 --- a/_static/basic.css +++ b/_static/basic.css @@ -4,7 +4,7 @@ * * Sphinx stylesheet -- basic theme. * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -130,7 +130,7 @@ ul.search li a { font-weight: bold; } -ul.search li div.context { +ul.search li p.context { color: #888; margin: 2px 0 0 30px; text-align: left; @@ -277,25 +277,25 @@ p.rubric { font-weight: bold; } -img.align-left, .figure.align-left, object.align-left { +img.align-left, figure.align-left, .figure.align-left, object.align-left { clear: left; float: left; margin-right: 1em; } -img.align-right, .figure.align-right, object.align-right { +img.align-right, figure.align-right, .figure.align-right, object.align-right { clear: right; float: right; margin-left: 1em; } -img.align-center, .figure.align-center, object.align-center { +img.align-center, figure.align-center, .figure.align-center, object.align-center { display: block; margin-left: auto; margin-right: auto; } -img.align-default, .figure.align-default { +img.align-default, figure.align-default, .figure.align-default { display: block; margin-left: auto; margin-right: auto; @@ -319,7 +319,8 @@ img.align-default, .figure.align-default { /* -- sidebars -------------------------------------------------------------- */ -div.sidebar { +div.sidebar, +aside.sidebar { margin: 0 0 0.5em 1em; border: 1px solid #ddb; padding: 7px; @@ -377,12 +378,14 @@ div.body p.centered { /* -- content of sidebars/topics/admonitions -------------------------------- */ div.sidebar > :last-child, +aside.sidebar > :last-child, div.topic > :last-child, div.admonition > :last-child { margin-bottom: 0; } div.sidebar::after, +aside.sidebar::after, div.topic::after, div.admonition::after, blockquote::after { @@ -455,20 +458,22 @@ td > :last-child { /* -- figures --------------------------------------------------------------- */ -div.figure { +div.figure, figure { margin: 0.5em; padding: 0.5em; } -div.figure p.caption { +div.figure p.caption, figcaption { padding: 0.3em; } -div.figure p.caption span.caption-number { +div.figure p.caption span.caption-number, +figcaption span.caption-number { font-style: italic; } -div.figure p.caption span.caption-text { +div.figure p.caption span.caption-text, +figcaption span.caption-text { } /* -- field list styles ----------------------------------------------------- */ @@ -503,6 +508,63 @@ table.hlist td { vertical-align: top; } +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + /* -- other body styles ----------------------------------------------------- */ @@ -629,14 +691,6 @@ dl.glossary dt { font-size: 1.1em; } -.optional { - font-size: 1.3em; -} - -.sig-paren { - font-size: larger; -} - .versionmodified { font-style: italic; } @@ -765,8 +819,12 @@ div.code-block-caption code { table.highlighttable td.linenos, span.linenos, -div.doctest > div.highlight span.gp { /* gp: Generic.Prompt */ - user-select: none; +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ } div.code-block-caption span.caption-number { @@ -781,16 +839,6 @@ div.literal-block-wrapper { margin: 1em 0; } -code.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -code.descclassname { - background-color: transparent; -} - code.xref, a code { background-color: transparent; font-weight: bold; diff --git a/_static/doctools.js b/_static/doctools.js index 7d88f80..8cbf1b1 100644 --- a/_static/doctools.js +++ b/_static/doctools.js @@ -4,7 +4,7 @@ * * Sphinx JavaScript utilities for all documentation. * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -29,9 +29,14 @@ if (!window.console || !console.firebug) { /** * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL */ jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); }; /** @@ -296,12 +301,14 @@ var Documentation = { window.location.href = prevHref; return false; } + break; case 39: // right var nextHref = $('link[rel="next"]').prop('href'); if (nextHref) { window.location.href = nextHref; return false; } + break; } } }); diff --git a/_static/language_data.js b/_static/language_data.js index d2b4ee9..863704b 100644 --- a/_static/language_data.js +++ b/_static/language_data.js @@ -5,7 +5,7 @@ * This script contains the language-specific data used by searchtools.js, * namely the list of stopwords, stemmer, scorer and splitter. * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -13,7 +13,8 @@ var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"]; -/* Non-minified version JS is _stemmer.js if file is provided */ +/* Non-minified version is copied as a separate JS file, is available */ + /** * Porter Stemmer */ @@ -199,7 +200,6 @@ var Stemmer = function() { - var splitChars = (function() { var result = {}; var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648, diff --git a/_static/pygments.css b/_static/pygments.css index f346859..691aeb8 100644 --- a/_static/pygments.css +++ b/_static/pygments.css @@ -1,7 +1,7 @@ -pre { line-height: 125%; margin: 0; } -td.linenos pre { color: #000000; background-color: #f0f0f0; padding-left: 5px; padding-right: 5px; } -span.linenos { color: #000000; background-color: #f0f0f0; padding-left: 5px; padding-right: 5px; } -td.linenos pre.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +pre { line-height: 125%; } +td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } .highlight .hll { background-color: #ffffcc } .highlight { background: #eeffcc; } diff --git a/_static/searchtools.js b/_static/searchtools.js index 261ecaa..e09f926 100644 --- a/_static/searchtools.js +++ b/_static/searchtools.js @@ -4,7 +4,7 @@ * * Sphinx JavaScript utilities for the full-text search. * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @@ -248,7 +248,7 @@ var Search = { // results left, load the summary and display it if (results.length) { var item = results.pop(); - var listItem = $('<li style="display:none"></li>'); + var listItem = $('<li></li>'); var requestUrl = ""; var linkUrl = ""; if (DOCUMENTATION_OPTIONS.BUILDER === 'dirhtml') { @@ -273,9 +273,9 @@ var Search = { if (item[3]) { listItem.append($('<span> (' + item[3] + ')</span>')); Search.output.append(listItem); - listItem.slideDown(5, function() { + setTimeout(function() { displayNextItem(); - }); + }, 5); } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { $.ajax({url: requestUrl, dataType: "text", @@ -285,16 +285,16 @@ var Search = { listItem.append(Search.makeSearchSummary(data, searchterms, hlterms)); } Search.output.append(listItem); - listItem.slideDown(5, function() { + setTimeout(function() { displayNextItem(); - }); + }, 5); }}); } else { // no source available, just display title Search.output.append(listItem); - listItem.slideDown(5, function() { + setTimeout(function() { displayNextItem(); - }); + }, 5); } } // search finished, update title and status message @@ -380,6 +380,13 @@ var Search = { }, /** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions + */ + escapeRegExp : function(string) { + return string.replace(/[.*+\-?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string + }, + + /** * search for full-text terms in the index */ performTermsSearch : function(searchterms, excluded, terms, titleterms) { @@ -402,13 +409,14 @@ var Search = { ]; // add support for partial matches if (word.length > 2) { + var word_regex = this.escapeRegExp(word); for (var w in terms) { - if (w.match(word) && !terms[word]) { + if (w.match(word_regex) && !terms[word]) { _o.push({files: terms[w], score: Scorer.partialTerm}) } } for (var w in titleterms) { - if (w.match(word) && !titleterms[word]) { + if (w.match(word_regex) && !titleterms[word]) { _o.push({files: titleterms[w], score: Scorer.partialTitle}) } } @@ -501,7 +509,7 @@ var Search = { var excerpt = ((start > 0) ? '...' : '') + $.trim(text.substr(start, 240)) + ((start + 240 - text.length) ? '...' : ''); - var rv = $('<div class="context"></div>').text(excerpt); + var rv = $('<p class="context"></p>').text(excerpt); $.each(hlwords, function() { rv = rv.highlightText(this, 'highlighted'); }); diff --git a/_static/underscore.js b/_static/underscore.js index 5b55f32..cf177d4 100644 --- a/_static/underscore.js +++ b/_static/underscore.js @@ -1,31 +1,6 @@ -// Underscore.js 1.3.1 -// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc. -// Underscore is freely distributable under the MIT license. -// Portions of Underscore are inspired or borrowed from Prototype, -// Oliver Steele's Functional, and John Resig's Micro-Templating. -// For all details and documentation: -// http://documentcloud.github.com/underscore -(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source== -c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c, -h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var j=b.each= -b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===n)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(x&&a.map===x)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a== -null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect= -function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e= -e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck= -function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a,computed:b})}); -return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return b};b.sortBy=function(a,c,d){return b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a, -c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=b.head=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest= -b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];return d},[]); -return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=function(a,c, -d){if(a==null)return-1;var e;if(d)return d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||0,a=0);for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d;return g}; -var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new F,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.memoize=function(a, -c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(a,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return function(){d=this;e=arguments;var b;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c));g?h=true: -a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return function(){var e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}}; -b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments, -1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)}; -b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"}; -b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a), -function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return"',_.escape("+ -u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]= -function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain= -true;return this};m.prototype.value=function(){return this._wrapped}}).call(this); +!function(n,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define("underscore",r):(n="undefined"!=typeof globalThis?globalThis:n||self,function(){var t=n._,e=n._=r();e.noConflict=function(){return n._=t,e}}())}(this,(function(){ +// Underscore.js 1.13.1 +// https://underscorejs.org +// (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors +// Underscore may be freely distributed under the MIT license. +var n="1.13.1",r="object"==typeof self&&self.self===self&&self||"object"==typeof global&&global.global===global&&global||Function("return this")()||{},t=Array.prototype,e=Object.prototype,u="undefined"!=typeof Symbol?Symbol.prototype:null,o=t.push,i=t.slice,a=e.toString,f=e.hasOwnProperty,c="undefined"!=typeof ArrayBuffer,l="undefined"!=typeof DataView,s=Array.isArray,p=Object.keys,v=Object.create,h=c&&ArrayBuffer.isView,y=isNaN,d=isFinite,g=!{toString:null}.propertyIsEnumerable("toString"),b=["valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString"],m=Math.pow(2,53)-1;function j(n,r){return r=null==r?n.length-1:+r,function(){for(var t=Math.max(arguments.length-r,0),e=Array(t),u=0;u<t;u++)e[u]=arguments[u+r];switch(r){case 0:return n.call(this,e);case 1:return n.call(this,arguments[0],e);case 2:return n.call(this,arguments[0],arguments[1],e)}var o=Array(r+1);for(u=0;u<r;u++)o[u]=arguments[u];return o[r]=e,n.apply(this,o)}}function _(n){var r=typeof n;return"function"===r||"object"===r&&!!n}function w(n){return void 0===n}function A(n){return!0===n||!1===n||"[object Boolean]"===a.call(n)}function x(n){var r="[object "+n+"]";return function(n){return a.call(n)===r}}var S=x("String"),O=x("Number"),M=x("Date"),E=x("RegExp"),B=x("Error"),N=x("Symbol"),I=x("ArrayBuffer"),T=x("Function"),k=r.document&&r.document.childNodes;"function"!=typeof/./&&"object"!=typeof Int8Array&&"function"!=typeof k&&(T=function(n){return"function"==typeof n||!1});var D=T,R=x("Object"),F=l&&R(new DataView(new ArrayBuffer(8))),V="undefined"!=typeof Map&&R(new Map),P=x("DataView");var q=F?function(n){return null!=n&&D(n.getInt8)&&I(n.buffer)}:P,U=s||x("Array");function W(n,r){return null!=n&&f.call(n,r)}var z=x("Arguments");!function(){z(arguments)||(z=function(n){return W(n,"callee")})}();var L=z;function $(n){return O(n)&&y(n)}function C(n){return function(){return n}}function K(n){return function(r){var t=n(r);return"number"==typeof t&&t>=0&&t<=m}}function J(n){return function(r){return null==r?void 0:r[n]}}var G=J("byteLength"),H=K(G),Q=/\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/;var X=c?function(n){return h?h(n)&&!q(n):H(n)&&Q.test(a.call(n))}:C(!1),Y=J("length");function Z(n,r){r=function(n){for(var r={},t=n.length,e=0;e<t;++e)r[n[e]]=!0;return{contains:function(n){return r[n]},push:function(t){return r[t]=!0,n.push(t)}}}(r);var t=b.length,u=n.constructor,o=D(u)&&u.prototype||e,i="constructor";for(W(n,i)&&!r.contains(i)&&r.push(i);t--;)(i=b[t])in n&&n[i]!==o[i]&&!r.contains(i)&&r.push(i)}function nn(n){if(!_(n))return[];if(p)return p(n);var r=[];for(var t in n)W(n,t)&&r.push(t);return g&&Z(n,r),r}function rn(n,r){var t=nn(r),e=t.length;if(null==n)return!e;for(var u=Object(n),o=0;o<e;o++){var i=t[o];if(r[i]!==u[i]||!(i in u))return!1}return!0}function tn(n){return n instanceof tn?n:this instanceof tn?void(this._wrapped=n):new tn(n)}function en(n){return new Uint8Array(n.buffer||n,n.byteOffset||0,G(n))}tn.VERSION=n,tn.prototype.value=function(){return this._wrapped},tn.prototype.valueOf=tn.prototype.toJSON=tn.prototype.value,tn.prototype.toString=function(){return String(this._wrapped)};var un="[object DataView]";function on(n,r,t,e){if(n===r)return 0!==n||1/n==1/r;if(null==n||null==r)return!1;if(n!=n)return r!=r;var o=typeof n;return("function"===o||"object"===o||"object"==typeof r)&&function n(r,t,e,o){r instanceof tn&&(r=r._wrapped);t instanceof tn&&(t=t._wrapped);var i=a.call(r);if(i!==a.call(t))return!1;if(F&&"[object Object]"==i&&q(r)){if(!q(t))return!1;i=un}switch(i){case"[object RegExp]":case"[object String]":return""+r==""+t;case"[object Number]":return+r!=+r?+t!=+t:0==+r?1/+r==1/t:+r==+t;case"[object Date]":case"[object Boolean]":return+r==+t;case"[object Symbol]":return u.valueOf.call(r)===u.valueOf.call(t);case"[object ArrayBuffer]":case un:return n(en(r),en(t),e,o)}var f="[object Array]"===i;if(!f&&X(r)){if(G(r)!==G(t))return!1;if(r.buffer===t.buffer&&r.byteOffset===t.byteOffset)return!0;f=!0}if(!f){if("object"!=typeof r||"object"!=typeof t)return!1;var c=r.constructor,l=t.constructor;if(c!==l&&!(D(c)&&c instanceof c&&D(l)&&l instanceof l)&&"constructor"in r&&"constructor"in t)return!1}o=o||[];var s=(e=e||[]).length;for(;s--;)if(e[s]===r)return o[s]===t;if(e.push(r),o.push(t),f){if((s=r.length)!==t.length)return!1;for(;s--;)if(!on(r[s],t[s],e,o))return!1}else{var p,v=nn(r);if(s=v.length,nn(t).length!==s)return!1;for(;s--;)if(p=v[s],!W(t,p)||!on(r[p],t[p],e,o))return!1}return e.pop(),o.pop(),!0}(n,r,t,e)}function an(n){if(!_(n))return[];var r=[];for(var t in n)r.push(t);return g&&Z(n,r),r}function fn(n){var r=Y(n);return function(t){if(null==t)return!1;var e=an(t);if(Y(e))return!1;for(var u=0;u<r;u++)if(!D(t[n[u]]))return!1;return n!==hn||!D(t[cn])}}var cn="forEach",ln="has",sn=["clear","delete"],pn=["get",ln,"set"],vn=sn.concat(cn,pn),hn=sn.concat(pn),yn=["add"].concat(sn,cn,ln),dn=V?fn(vn):x("Map"),gn=V?fn(hn):x("WeakMap"),bn=V?fn(yn):x("Set"),mn=x("WeakSet");function jn(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)e[u]=n[r[u]];return e}function _n(n){for(var r={},t=nn(n),e=0,u=t.length;e<u;e++)r[n[t[e]]]=t[e];return r}function wn(n){var r=[];for(var t in n)D(n[t])&&r.push(t);return r.sort()}function An(n,r){return function(t){var e=arguments.length;if(r&&(t=Object(t)),e<2||null==t)return t;for(var u=1;u<e;u++)for(var o=arguments[u],i=n(o),a=i.length,f=0;f<a;f++){var c=i[f];r&&void 0!==t[c]||(t[c]=o[c])}return t}}var xn=An(an),Sn=An(nn),On=An(an,!0);function Mn(n){if(!_(n))return{};if(v)return v(n);var r=function(){};r.prototype=n;var t=new r;return r.prototype=null,t}function En(n){return _(n)?U(n)?n.slice():xn({},n):n}function Bn(n){return U(n)?n:[n]}function Nn(n){return tn.toPath(n)}function In(n,r){for(var t=r.length,e=0;e<t;e++){if(null==n)return;n=n[r[e]]}return t?n:void 0}function Tn(n,r,t){var e=In(n,Nn(r));return w(e)?t:e}function kn(n){return n}function Dn(n){return n=Sn({},n),function(r){return rn(r,n)}}function Rn(n){return n=Nn(n),function(r){return In(r,n)}}function Fn(n,r,t){if(void 0===r)return n;switch(null==t?3:t){case 1:return function(t){return n.call(r,t)};case 3:return function(t,e,u){return n.call(r,t,e,u)};case 4:return function(t,e,u,o){return n.call(r,t,e,u,o)}}return function(){return n.apply(r,arguments)}}function Vn(n,r,t){return null==n?kn:D(n)?Fn(n,r,t):_(n)&&!U(n)?Dn(n):Rn(n)}function Pn(n,r){return Vn(n,r,1/0)}function qn(n,r,t){return tn.iteratee!==Pn?tn.iteratee(n,r):Vn(n,r,t)}function Un(){}function Wn(n,r){return null==r&&(r=n,n=0),n+Math.floor(Math.random()*(r-n+1))}tn.toPath=Bn,tn.iteratee=Pn;var zn=Date.now||function(){return(new Date).getTime()};function Ln(n){var r=function(r){return n[r]},t="(?:"+nn(n).join("|")+")",e=RegExp(t),u=RegExp(t,"g");return function(n){return n=null==n?"":""+n,e.test(n)?n.replace(u,r):n}}var $n={"&":"&","<":"<",">":">",'"':""","'":"'","`":"`"},Cn=Ln($n),Kn=Ln(_n($n)),Jn=tn.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g},Gn=/(.)^/,Hn={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},Qn=/\\|'|\r|\n|\u2028|\u2029/g;function Xn(n){return"\\"+Hn[n]}var Yn=/^\s*(\w|\$)+\s*$/;var Zn=0;function nr(n,r,t,e,u){if(!(e instanceof r))return n.apply(t,u);var o=Mn(n.prototype),i=n.apply(o,u);return _(i)?i:o}var rr=j((function(n,r){var t=rr.placeholder,e=function(){for(var u=0,o=r.length,i=Array(o),a=0;a<o;a++)i[a]=r[a]===t?arguments[u++]:r[a];for(;u<arguments.length;)i.push(arguments[u++]);return nr(n,e,this,this,i)};return e}));rr.placeholder=tn;var tr=j((function(n,r,t){if(!D(n))throw new TypeError("Bind must be called on a function");var e=j((function(u){return nr(n,e,r,this,t.concat(u))}));return e})),er=K(Y);function ur(n,r,t,e){if(e=e||[],r||0===r){if(r<=0)return e.concat(n)}else r=1/0;for(var u=e.length,o=0,i=Y(n);o<i;o++){var a=n[o];if(er(a)&&(U(a)||L(a)))if(r>1)ur(a,r-1,t,e),u=e.length;else for(var f=0,c=a.length;f<c;)e[u++]=a[f++];else t||(e[u++]=a)}return e}var or=j((function(n,r){var t=(r=ur(r,!1,!1)).length;if(t<1)throw new Error("bindAll must be passed function names");for(;t--;){var e=r[t];n[e]=tr(n[e],n)}return n}));var ir=j((function(n,r,t){return setTimeout((function(){return n.apply(null,t)}),r)})),ar=rr(ir,tn,1);function fr(n){return function(){return!n.apply(this,arguments)}}function cr(n,r){var t;return function(){return--n>0&&(t=r.apply(this,arguments)),n<=1&&(r=null),t}}var lr=rr(cr,2);function sr(n,r,t){r=qn(r,t);for(var e,u=nn(n),o=0,i=u.length;o<i;o++)if(r(n[e=u[o]],e,n))return e}function pr(n){return function(r,t,e){t=qn(t,e);for(var u=Y(r),o=n>0?0:u-1;o>=0&&o<u;o+=n)if(t(r[o],o,r))return o;return-1}}var vr=pr(1),hr=pr(-1);function yr(n,r,t,e){for(var u=(t=qn(t,e,1))(r),o=0,i=Y(n);o<i;){var a=Math.floor((o+i)/2);t(n[a])<u?o=a+1:i=a}return o}function dr(n,r,t){return function(e,u,o){var a=0,f=Y(e);if("number"==typeof o)n>0?a=o>=0?o:Math.max(o+f,a):f=o>=0?Math.min(o+1,f):o+f+1;else if(t&&o&&f)return e[o=t(e,u)]===u?o:-1;if(u!=u)return(o=r(i.call(e,a,f),$))>=0?o+a:-1;for(o=n>0?a:f-1;o>=0&&o<f;o+=n)if(e[o]===u)return o;return-1}}var gr=dr(1,vr,yr),br=dr(-1,hr);function mr(n,r,t){var e=(er(n)?vr:sr)(n,r,t);if(void 0!==e&&-1!==e)return n[e]}function jr(n,r,t){var e,u;if(r=Fn(r,t),er(n))for(e=0,u=n.length;e<u;e++)r(n[e],e,n);else{var o=nn(n);for(e=0,u=o.length;e<u;e++)r(n[o[e]],o[e],n)}return n}function _r(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=Array(u),i=0;i<u;i++){var a=e?e[i]:i;o[i]=r(n[a],a,n)}return o}function wr(n){var r=function(r,t,e,u){var o=!er(r)&&nn(r),i=(o||r).length,a=n>0?0:i-1;for(u||(e=r[o?o[a]:a],a+=n);a>=0&&a<i;a+=n){var f=o?o[a]:a;e=t(e,r[f],f,r)}return e};return function(n,t,e,u){var o=arguments.length>=3;return r(n,Fn(t,u,4),e,o)}}var Ar=wr(1),xr=wr(-1);function Sr(n,r,t){var e=[];return r=qn(r,t),jr(n,(function(n,t,u){r(n,t,u)&&e.push(n)})),e}function Or(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?e[o]:o;if(!r(n[i],i,n))return!1}return!0}function Mr(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o<u;o++){var i=e?e[o]:o;if(r(n[i],i,n))return!0}return!1}function Er(n,r,t,e){return er(n)||(n=jn(n)),("number"!=typeof t||e)&&(t=0),gr(n,r,t)>=0}var Br=j((function(n,r,t){var e,u;return D(r)?u=r:(r=Nn(r),e=r.slice(0,-1),r=r[r.length-1]),_r(n,(function(n){var o=u;if(!o){if(e&&e.length&&(n=In(n,e)),null==n)return;o=n[r]}return null==o?o:o.apply(n,t)}))}));function Nr(n,r){return _r(n,Rn(r))}function Ir(n,r,t){var e,u,o=-1/0,i=-1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=n[a])&&e>o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))>i||u===-1/0&&o===-1/0)&&(o=n,i=u)}));return o}function Tr(n,r,t){if(null==r||t)return er(n)||(n=jn(n)),n[Wn(n.length-1)];var e=er(n)?En(n):jn(n),u=Y(e);r=Math.max(Math.min(r,u),0);for(var o=u-1,i=0;i<r;i++){var a=Wn(i,o),f=e[i];e[i]=e[a],e[a]=f}return e.slice(0,r)}function kr(n,r){return function(t,e,u){var o=r?[[],[]]:{};return e=qn(e,u),jr(t,(function(r,u){var i=e(r,u,t);n(o,r,i)})),o}}var Dr=kr((function(n,r,t){W(n,t)?n[t].push(r):n[t]=[r]})),Rr=kr((function(n,r,t){n[t]=r})),Fr=kr((function(n,r,t){W(n,t)?n[t]++:n[t]=1})),Vr=kr((function(n,r,t){n[t?0:1].push(r)}),!0),Pr=/[^\ud800-\udfff]|[\ud800-\udbff][\udc00-\udfff]|[\ud800-\udfff]/g;function qr(n,r,t){return r in t}var Ur=j((function(n,r){var t={},e=r[0];if(null==n)return t;D(e)?(r.length>1&&(e=Fn(e,r[1])),r=an(n)):(e=qr,r=ur(r,!1,!1),n=Object(n));for(var u=0,o=r.length;u<o;u++){var i=r[u],a=n[i];e(a,i,n)&&(t[i]=a)}return t})),Wr=j((function(n,r){var t,e=r[0];return D(e)?(e=fr(e),r.length>1&&(t=r[1])):(r=_r(ur(r,!1,!1),String),e=function(n,t){return!Er(r,t)}),Ur(n,e,t)}));function zr(n,r,t){return i.call(n,0,Math.max(0,n.length-(null==r||t?1:r)))}function Lr(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[0]:zr(n,n.length-r)}function $r(n,r,t){return i.call(n,null==r||t?1:r)}var Cr=j((function(n,r){return r=ur(r,!0,!0),Sr(n,(function(n){return!Er(r,n)}))})),Kr=j((function(n,r){return Cr(n,r)}));function Jr(n,r,t,e){A(r)||(e=t,t=r,r=!1),null!=t&&(t=qn(t,e));for(var u=[],o=[],i=0,a=Y(n);i<a;i++){var f=n[i],c=t?t(f,i,n):f;r&&!t?(i&&o===c||u.push(f),o=c):t?Er(o,c)||(o.push(c),u.push(f)):Er(u,f)||u.push(f)}return u}var Gr=j((function(n){return Jr(ur(n,!0,!0))}));function Hr(n){for(var r=n&&Ir(n,Y).length||0,t=Array(r),e=0;e<r;e++)t[e]=Nr(n,e);return t}var Qr=j(Hr);function Xr(n,r){return n._chain?tn(r).chain():r}function Yr(n){return jr(wn(n),(function(r){var t=tn[r]=n[r];tn.prototype[r]=function(){var n=[this._wrapped];return o.apply(n,arguments),Xr(this,t.apply(tn,n))}})),tn}jr(["pop","push","reverse","shift","sort","splice","unshift"],(function(n){var r=t[n];tn.prototype[n]=function(){var t=this._wrapped;return null!=t&&(r.apply(t,arguments),"shift"!==n&&"splice"!==n||0!==t.length||delete t[0]),Xr(this,t)}})),jr(["concat","join","slice"],(function(n){var r=t[n];tn.prototype[n]=function(){var n=this._wrapped;return null!=n&&(n=r.apply(n,arguments)),Xr(this,n)}}));var Zr=Yr({__proto__:null,VERSION:n,restArguments:j,isObject:_,isNull:function(n){return null===n},isUndefined:w,isBoolean:A,isElement:function(n){return!(!n||1!==n.nodeType)},isString:S,isNumber:O,isDate:M,isRegExp:E,isError:B,isSymbol:N,isArrayBuffer:I,isDataView:q,isArray:U,isFunction:D,isArguments:L,isFinite:function(n){return!N(n)&&d(n)&&!isNaN(parseFloat(n))},isNaN:$,isTypedArray:X,isEmpty:function(n){if(null==n)return!0;var r=Y(n);return"number"==typeof r&&(U(n)||S(n)||L(n))?0===r:0===Y(nn(n))},isMatch:rn,isEqual:function(n,r){return on(n,r)},isMap:dn,isWeakMap:gn,isSet:bn,isWeakSet:mn,keys:nn,allKeys:an,values:jn,pairs:function(n){for(var r=nn(n),t=r.length,e=Array(t),u=0;u<t;u++)e[u]=[r[u],n[r[u]]];return e},invert:_n,functions:wn,methods:wn,extend:xn,extendOwn:Sn,assign:Sn,defaults:On,create:function(n,r){var t=Mn(n);return r&&Sn(t,r),t},clone:En,tap:function(n,r){return r(n),n},get:Tn,has:function(n,r){for(var t=(r=Nn(r)).length,e=0;e<t;e++){var u=r[e];if(!W(n,u))return!1;n=n[u]}return!!t},mapObject:function(n,r,t){r=qn(r,t);for(var e=nn(n),u=e.length,o={},i=0;i<u;i++){var a=e[i];o[a]=r(n[a],a,n)}return o},identity:kn,constant:C,noop:Un,toPath:Bn,property:Rn,propertyOf:function(n){return null==n?Un:function(r){return Tn(n,r)}},matcher:Dn,matches:Dn,times:function(n,r,t){var e=Array(Math.max(0,n));r=Fn(r,t,1);for(var u=0;u<n;u++)e[u]=r(u);return e},random:Wn,now:zn,escape:Cn,unescape:Kn,templateSettings:Jn,template:function(n,r,t){!r&&t&&(r=t),r=On({},r,tn.templateSettings);var e=RegExp([(r.escape||Gn).source,(r.interpolate||Gn).source,(r.evaluate||Gn).source].join("|")+"|$","g"),u=0,o="__p+='";n.replace(e,(function(r,t,e,i,a){return o+=n.slice(u,a).replace(Qn,Xn),u=a+r.length,t?o+="'+\n((__t=("+t+"))==null?'':_.escape(__t))+\n'":e?o+="'+\n((__t=("+e+"))==null?'':__t)+\n'":i&&(o+="';\n"+i+"\n__p+='"),r})),o+="';\n";var i,a=r.variable;if(a){if(!Yn.test(a))throw new Error("variable is not a bare identifier: "+a)}else o="with(obj||{}){\n"+o+"}\n",a="obj";o="var __t,__p='',__j=Array.prototype.join,"+"print=function(){__p+=__j.call(arguments,'');};\n"+o+"return __p;\n";try{i=new Function(a,"_",o)}catch(n){throw n.source=o,n}var f=function(n){return i.call(this,n,tn)};return f.source="function("+a+"){\n"+o+"}",f},result:function(n,r,t){var e=(r=Nn(r)).length;if(!e)return D(t)?t.call(n):t;for(var u=0;u<e;u++){var o=null==n?void 0:n[r[u]];void 0===o&&(o=t,u=e),n=D(o)?o.call(n):o}return n},uniqueId:function(n){var r=++Zn+"";return n?n+r:r},chain:function(n){var r=tn(n);return r._chain=!0,r},iteratee:Pn,partial:rr,bind:tr,bindAll:or,memoize:function(n,r){var t=function(e){var u=t.cache,o=""+(r?r.apply(this,arguments):e);return W(u,o)||(u[o]=n.apply(this,arguments)),u[o]};return t.cache={},t},delay:ir,defer:ar,throttle:function(n,r,t){var e,u,o,i,a=0;t||(t={});var f=function(){a=!1===t.leading?0:zn(),e=null,i=n.apply(u,o),e||(u=o=null)},c=function(){var c=zn();a||!1!==t.leading||(a=c);var l=r-(c-a);return u=this,o=arguments,l<=0||l>r?(e&&(clearTimeout(e),e=null),a=c,i=n.apply(u,o),e||(u=o=null)):e||!1===t.trailing||(e=setTimeout(f,l)),i};return c.cancel=function(){clearTimeout(e),a=0,e=u=o=null},c},debounce:function(n,r,t){var e,u,o,i,a,f=function(){var c=zn()-u;r>c?e=setTimeout(f,r-c):(e=null,t||(i=n.apply(a,o)),e||(o=a=null))},c=j((function(c){return a=this,o=c,u=zn(),e||(e=setTimeout(f,r),t&&(i=n.apply(a,o))),i}));return c.cancel=function(){clearTimeout(e),e=o=a=null},c},wrap:function(n,r){return rr(r,n)},negate:fr,compose:function(){var n=arguments,r=n.length-1;return function(){for(var t=r,e=n[r].apply(this,arguments);t--;)e=n[t].call(this,e);return e}},after:function(n,r){return function(){if(--n<1)return r.apply(this,arguments)}},before:cr,once:lr,findKey:sr,findIndex:vr,findLastIndex:hr,sortedIndex:yr,indexOf:gr,lastIndexOf:br,find:mr,detect:mr,findWhere:function(n,r){return mr(n,Dn(r))},each:jr,forEach:jr,map:_r,collect:_r,reduce:Ar,foldl:Ar,inject:Ar,reduceRight:xr,foldr:xr,filter:Sr,select:Sr,reject:function(n,r,t){return Sr(n,fr(qn(r)),t)},every:Or,all:Or,some:Mr,any:Mr,contains:Er,includes:Er,include:Er,invoke:Br,pluck:Nr,where:function(n,r){return Sr(n,Dn(r))},max:Ir,min:function(n,r,t){var e,u,o=1/0,i=1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;a<f;a++)null!=(e=n[a])&&e<o&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))<i||u===1/0&&o===1/0)&&(o=n,i=u)}));return o},shuffle:function(n){return Tr(n,1/0)},sample:Tr,sortBy:function(n,r,t){var e=0;return r=qn(r,t),Nr(_r(n,(function(n,t,u){return{value:n,index:e++,criteria:r(n,t,u)}})).sort((function(n,r){var t=n.criteria,e=r.criteria;if(t!==e){if(t>e||void 0===t)return 1;if(t<e||void 0===e)return-1}return n.index-r.index})),"value")},groupBy:Dr,indexBy:Rr,countBy:Fr,partition:Vr,toArray:function(n){return n?U(n)?i.call(n):S(n)?n.match(Pr):er(n)?_r(n,kn):jn(n):[]},size:function(n){return null==n?0:er(n)?n.length:nn(n).length},pick:Ur,omit:Wr,first:Lr,head:Lr,take:Lr,initial:zr,last:function(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[n.length-1]:$r(n,Math.max(0,n.length-r))},rest:$r,tail:$r,drop:$r,compact:function(n){return Sr(n,Boolean)},flatten:function(n,r){return ur(n,r,!1)},without:Kr,uniq:Jr,unique:Jr,union:Gr,intersection:function(n){for(var r=[],t=arguments.length,e=0,u=Y(n);e<u;e++){var o=n[e];if(!Er(r,o)){var i;for(i=1;i<t&&Er(arguments[i],o);i++);i===t&&r.push(o)}}return r},difference:Cr,unzip:Hr,transpose:Hr,zip:Qr,object:function(n,r){for(var t={},e=0,u=Y(n);e<u;e++)r?t[n[e]]=r[e]:t[n[e][0]]=n[e][1];return t},range:function(n,r,t){null==r&&(r=n||0,n=0),t||(t=r<n?-1:1);for(var e=Math.max(Math.ceil((r-n)/t),0),u=Array(e),o=0;o<e;o++,n+=t)u[o]=n;return u},chunk:function(n,r){if(null==r||r<1)return[];for(var t=[],e=0,u=n.length;e<u;)t.push(i.call(n,e,e+=r));return t},mixin:Yr,default:tn});return Zr._=Zr,Zr}));
\ No newline at end of file diff --git a/basics.html b/basics.html index a5165ff..aa8f686 100644 --- a/basics.html +++ b/basics.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>Basic information — 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="Other policy documents" href="other-docs.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="basic-information"> + <section id="basic-information"> <h1>Basic information<a class="headerlink" href="#basic-information" title="Permalink to this headline">¶</a></h1> -<div class="section" id="goals-of-policy-making"> +<section id="goals-of-policy-making"> <h2>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Permalink to this headline">¶</a></h2> <p>The Gentoo policies focus on three aims:</p> <ol class="arabic simple"> @@ -150,8 +153,8 @@ in providing a consistent end-user experience. The same concepts applied across different packages make it easier for user to achieve his goals and reduce the likeliness of surprising behavior.</p></li> </ol> -</div> -<div class="section" id="policy-compliance-checking"> +</section> +<section id="policy-compliance-checking"> <h2>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Permalink to this headline">¶</a></h2> <p>Currently, there are two kinds of tools involved in detecting policy violations:</p> @@ -173,8 +176,8 @@ All non-trivial violations are reported to the <a class="reference external" hre mailing list and to the developers making the relevant commits. This supplements the direct use of linting tools by developers with reliable tree-wide scans.</p> -</div> -<div class="section" id="policy-enforcement"> +</section> +<section id="policy-enforcement"> <h2>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Permalink to this headline">¶</a></h2> <p>The Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> is tasked with enforcement of the tree policies. Its role is governed by <a class="reference external" href="https://www.gentoo.org/glep/glep-0048.html">GLEP 48</a>. It focuses on documenting @@ -186,8 +189,8 @@ than if the developer was requested to fix it), or when developer refuses to resolve policy violations.</p> <p>Finally, in case of repeated unwillingness to follow policies, the QA team can issue disciplinary measures against the developer in question.</p> -</div> -<div class="section" id="policy-making-changes-and-appeals"> +</section> +<section id="policy-making-changes-and-appeals"> <h2>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Permalink to this headline">¶</a></h2> <p>The majority of policies are written down and maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a>. Other Gentoo projects also create policies that affect their @@ -198,8 +201,8 @@ In order to change or abolish the policy, that team should be contacted. If the project in question disagrees with the change, <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> can be asked to override the policy. All QA decisions and policies can further be appealed to the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Council">Council</a>.</p> -</div> -</div> +</section> +</section> @@ -241,7 +244,7 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w <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> @@ -282,7 +285,7 @@ be appealed to the <a class="reference external" href="https://wiki.gentoo.org/w <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> diff --git a/combined.html b/combined.html index 478b358..ce8ced8 100644 --- a/combined.html +++ b/combined.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>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" /> </head><body> @@ -107,7 +110,7 @@ - <div class="section" id="gentoo-policy-guide"> + <section id="gentoo-policy-guide"> <h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Permalink to this headline">¶</a></h1> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. @@ -117,9 +120,9 @@ The policies are meant to be supplied with rationale and clear indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> <div class="toctree-wrapper compound"> -<span id="document-preface"></span><div class="section" id="preface"> +<span id="document-preface"></span><section id="preface"> <h2>Preface<a class="headerlink" href="#preface" title="Permalink to this headline">¶</a></h2> -<div class="section" id="introduction"> +<section id="introduction"> <h3>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h3> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. @@ -128,24 +131,24 @@ team or the Council), as well as specific to other Gentoo projects. The policies are meant to be supplied with rationale and clear indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> -</div> -<div class="section" id="authors"> +</section> +<section id="authors"> <h3>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">¶</a></h3> <p>This document is maintained by the Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA project</a>.</p> <p>The current text authors are:</p> <ul class="simple"> <li><p>Michał Górny (mgorny)</p></li> </ul> -</div> -<div class="section" id="license"> +</section> +<section id="license"> <h3>License<a class="headerlink" href="#license" title="Permalink to this headline">¶</a></h3> <p>This work is licensed under the <a class="reference external" href="https://creativecommons.org/licenses/by-sa/4.0/.">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</p> -</div> -</div> -<span id="document-motivation"></span><div class="section" id="motivation-and-history"> +</section> +</section> +<span id="document-motivation"></span><section id="motivation-and-history"> <h2>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Permalink to this headline">¶</a></h2> -<div class="section" id="historical-state-of-policy-documentation"> +<section id="historical-state-of-policy-documentation"> <h3>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Permalink to this headline">¶</a></h3> <p>At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.</p> @@ -171,8 +174,8 @@ and which are obsolete or non-binding tips.</p> project documentation, and a lot of de facto policies that were established less or more formally in the past but were never really written down.</p> -</div> -<div class="section" id="purpose-of-the-policy-guide"> +</section> +<section id="purpose-of-the-policy-guide"> <h3>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Permalink to this headline">¶</a></h3> <p>The Policy Guide was created in order to address aforementioned documentation deficiencies. Its primary purpose is to collect all @@ -187,11 +190,11 @@ information, and how the policy can be updated if need arises.</p> <p>This Guide is going to replace the QA team policies page. All new QA policies will be documented directly in it. Other documentation (e.g. devmanual) should conform to policies stated here.</p> -</div> -</div> -<span id="document-basics"></span><div class="section" id="basic-information"> +</section> +</section> +<span id="document-basics"></span><section id="basic-information"> <h2>Basic information<a class="headerlink" href="#basic-information" title="Permalink to this headline">¶</a></h2> -<div class="section" id="goals-of-policy-making"> +<section id="goals-of-policy-making"> <h3>Goals of policy making<a class="headerlink" href="#goals-of-policy-making" title="Permalink to this headline">¶</a></h3> <p>The Gentoo policies focus on three aims:</p> <ol class="arabic simple"> @@ -209,8 +212,8 @@ in providing a consistent end-user experience. The same concepts applied across different packages make it easier for user to achieve his goals and reduce the likeliness of surprising behavior.</p></li> </ol> -</div> -<div class="section" id="policy-compliance-checking"> +</section> +<section id="policy-compliance-checking"> <h3>Policy compliance checking<a class="headerlink" href="#policy-compliance-checking" title="Permalink to this headline">¶</a></h3> <p>Currently, there are two kinds of tools involved in detecting policy violations:</p> @@ -232,8 +235,8 @@ All non-trivial violations are reported to the <a class="reference external" hre mailing list and to the developers making the relevant commits. This supplements the direct use of linting tools by developers with reliable tree-wide scans.</p> -</div> -<div class="section" id="policy-enforcement"> +</section> +<section id="policy-enforcement"> <h3>Policy enforcement<a class="headerlink" href="#policy-enforcement" title="Permalink to this headline">¶</a></h3> <p>The Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> is tasked with enforcement of the tree policies. Its role is governed by <a class="reference external" href="https://www.gentoo.org/glep/glep-0048.html">GLEP 48</a>. It focuses on documenting @@ -245,8 +248,8 @@ than if the developer was requested to fix it), or when developer refuses to resolve policy violations.</p> <p>Finally, in case of repeated unwillingness to follow policies, the QA team can issue disciplinary measures against the developer in question.</p> -</div> -<div class="section" id="policy-making-changes-and-appeals"> +</section> +<section id="policy-making-changes-and-appeals"> <h3>Policy making, changes and appeals<a class="headerlink" href="#policy-making-changes-and-appeals" title="Permalink to this headline">¶</a></h3> <p>The majority of policies are written down and maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a>. Other Gentoo projects also create policies that affect their @@ -257,13 +260,13 @@ In order to change or abolish the policy, that team should be contacted. If the project in question disagrees with the change, <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA team</a> can be asked to override the policy. All QA decisions and policies can further be appealed to the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Council">Council</a>.</p> -</div> -</div> -<span id="document-other-docs"></span><div class="section" id="other-policy-documents"> +</section> +</section> +<span id="document-other-docs"></span><section id="other-policy-documents"> <h2>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Permalink to this headline">¶</a></h2> -<div class="section" id="gentoo-specific-documentation"> +<section id="gentoo-specific-documentation"> <h3>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Permalink to this headline">¶</a></h3> -<div class="section" id="package-manager-specification"> +<section id="package-manager-specification"> <h4>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Permalink to this headline">¶</a></h4> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provides the specification of ebuild format, as well as general guidelines for implementing package managers. All ebuilds in the Gentoo @@ -272,8 +275,8 @@ enforce additional restrictions upon the format discussed in PMS.</p> <p>PMS is maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:PMS">PMS project</a>. All major changes are done in subsequent EAPIs that are approved by the Council. The project’s wiki page discusses how PMS can be changed via <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Package_Manager_Specification/Future_EAPI_process">future EAPI process</a>.</p> -</div> -<div class="section" id="gleps"> +</section> +<section id="gleps"> <h4>GLEPs<a class="headerlink" href="#gleps" title="Permalink to this headline">¶</a></h4> <p><a class="reference external" href="https://www.gentoo.org/glep/">GLEPs</a> provide the highest level policies applicable to Gentoo. Final or active GLEPs apply to all developers. Tree policies may impose @@ -281,8 +284,8 @@ additional restrictions on GLEPs but may not override them.</p> <p>The process for creating and updating GLEPs is documented in <a class="reference external" href="https://www.gentoo.org/glep/glep-0001.html">GLEP 1</a>. In general, all GLEP updates go through mailing list review and need to be approved by the Council.</p> -</div> -<div class="section" id="developer-manual"> +</section> +<section id="developer-manual"> <h4>Developer Manual<a class="headerlink" href="#developer-manual" title="Permalink to this headline">¶</a></h4> <p><a class="reference external" href="https://devmanual.gentoo.org/">Devmanual</a> is the basic guide for ebuild developers. Besides policies, it contains many general recommendations and detailed instructions. @@ -290,28 +293,28 @@ Developer Manual does not specify policies itself, and needs to comply with policies defined in this document.</p> <p>Technically, devmanual can be changed by any developer. However, it is recommended that all changes are reviewed by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Devmanual">devmanual project</a>.</p> -</div> -</div> -<div class="section" id="external-standards"> +</section> +</section> +<section id="external-standards"> <h3>External standards<a class="headerlink" href="#external-standards" title="Permalink to this headline">¶</a></h3> -<div class="section" id="posix"> +<section id="posix"> <h4>POSIX<a class="headerlink" href="#posix" title="Permalink to this headline">¶</a></h4> <p><a class="reference external" href="http://get.posixcertified.ieee.org/">POSIX</a> is the basic standard for operating systems. However, its rules apply to the software packaged in Gentoo rather than the distribution itself. Nevertheless, when no more specific policy applies, following POSIX is recommended.</p> -</div> -<div class="section" id="fhs"> +</section> +<section id="fhs"> <h4>FHS<a class="headerlink" href="#fhs" title="Permalink to this headline">¶</a></h4> <p><a class="reference external" href="https://refspecs.linuxfoundation.org/fhs.shtml">FHS</a> specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.</p> -</div> -</div> -</div> -<span id="document-dependencies"></span><div class="section" id="dependencies"> +</section> +</section> +</section> +<span id="document-dependencies"></span><section id="dependencies"> <h2>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline">¶</a></h2> -<span class="target" id="index-0"></span><div class="section" id="pg0001"> +<span class="target" id="index-0"></span><section id="pg0001"> <span id="optional-runtime-dependencies"></span><span id="index-1"></span><h3>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -333,8 +336,8 @@ being nonfunctional unless at least one of a set of optional runtime dependencies is installed.</p> <p>There is no specific preference as to how user should be informed of optional runtime dependencies. Three possible ways are -<code class="docutils literal notranslate"><span class="pre">optfeature</span></code> from <code class="docutils literal notranslate"><span class="pre">eutils</span></code> eclass, <code class="docutils literal notranslate"><span class="pre">readme.gentoo-r1</span></code> eclass -and plain <code class="docutils literal notranslate"><span class="pre">elog</span></code> messages.</p> +<code class="docutils literal notranslate"><span class="pre">optfeature</span></code> eclass, <code class="docutils literal notranslate"><span class="pre">readme.gentoo-r1</span></code> eclass and plain <code class="docutils literal notranslate"><span class="pre">elog</span></code> +messages.</p> <p><em>Rationale</em>: toggling USE flags in order to enable or disable optional runtime dependencies causes needless rebuilds of packages in question. This is especially important for packages that take long time to build.</p> @@ -344,8 +347,8 @@ This is especially important for packages that take long time to build.</p> rebuilding package in question. It has been tentatively approved by the Council but no reference implementation has been written.</p> </div> -</div> -<div class="section" id="pg0002"> +</section> +<section id="pg0002"> <span id="dependencies-with-no-revision"></span><span id="index-2"></span><h3>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -364,11 +367,11 @@ revision is requested, <code class="docutils literal notranslate"><span class="p is necessary, the <code class="docutils literal notranslate"><span class="pre">~</span></code> (tilde) operator must be used instead.</p> <p><em>Example</em>:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># BAD:</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span> <span class="c1"># GOOD:</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span><span class="o">-</span><span class="n">r0</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span><span class="o">-</span><span class="n">r3</span> -<span class="o">~</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span><span class="o">-</span><span class="n">r0</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span><span class="o">-</span><span class="n">r3</span> +<span class="o">~</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span> </pre></div> </div> <p><em>Rationale</em>: using <code class="docutils literal notranslate"><span class="pre">=</span></code> operator in place of <code class="docutils literal notranslate"><span class="pre">~</span></code> to mean a specific @@ -376,10 +379,10 @@ version has been a common mistake. This policy uses the fact that no revision and explicit <code class="docutils literal notranslate"><span class="pre">-r0</span></code> are equivalent. By explicitly requesting the latter, it warns developers to reconsider whether they used the correct operator.</p> -</div> -<div class="section" id="slot-and-subslot-dependencies"> +</section> +<section id="slot-and-subslot-dependencies"> <span id="index-3"></span><h3>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Permalink to this headline">¶</a></h3> -<div class="section" id="pg0011"> +<section id="pg0011"> <span id="on-sub-slotted-packages"></span><h4>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Permalink to this headline">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -415,8 +418,8 @@ means ‘verified that any slot is acceptable’.</p> is specified on the dependency. It pulls in the slot corresponding to the newest package version available.</p> </div> -</div> -<div class="section" id="pg0012"> +</section> +<section id="pg0012"> <span id="special-case-qt-packages"></span><span id="index-4"></span><h4>special case: Qt packages<a class="headerlink" href="#pg0012" title="Permalink to this headline">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -437,8 +440,8 @@ libraries is stable within each slot, and the subslot is used to refer to private ABI. Therefore, the <code class="docutils literal notranslate"><span class="pre">:=</span></code> operator must only be used if your package uses one of the private API parts, and plain <code class="docutils literal notranslate"><span class="pre">:5</span></code> or likewise dependency must be used otherwise.</p> -</div> -<div class="section" id="proactive-use-of-slot-operators"> +</section> +<section id="proactive-use-of-slot-operators"> <h4>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Permalink to this headline">¶</a></h4> <p>There is an open debate on whether developers should be proactively adding <code class="docutils literal notranslate"><span class="pre">:=</span></code> slot operators on packages that do not define subslots @@ -450,9 +453,9 @@ argue that in many cases the future use of subslots is reasonably predictable.</p> <p>Opponents claim that the future use of subslots is not 100% predictable. They point out the case of Qt packages as an example.</p> -</div> -</div> -<div class="section" id="pg0003"> +</section> +</section> +<section id="pg0003"> <span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h3>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -494,10 +497,10 @@ and decide to remove the dependency and code responsible for linking to it in place, Portage may apply the former immediately even if the package installed by the user still links to libfoo.</p> </div> -</div> -<div class="section" id="use-dependencies"> +</section> +<section id="use-dependencies"> <span id="index-6"></span><h3>USE dependencies<a class="headerlink" href="#use-dependencies" title="Permalink to this headline">¶</a></h3> -<div class="section" id="pg0021"> +<section id="pg0021"> <span id="on-packages-without-the-flag"></span><h4>on packages without the flag<a class="headerlink" href="#pg0021" title="Permalink to this headline">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -535,12 +538,12 @@ dependencies</a>, it is an error to apply 2-style USE dependency to a package missing the flag. Furthermore, checking for this makes it possible to report whenever USE flags on a package are changed without updating its reverse dependencies.</p> -</div> -</div> -</div> -<span id="document-deprecation"></span><div class="section" id="deprecations"> +</section> +</section> +</section> +<span id="document-deprecation"></span><section id="deprecations"> <h2>Deprecations<a class="headerlink" href="#deprecations" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg1001"> +<section id="pg1001"> <span id="deprecated-eapis"></span><span id="index-0"></span><h3>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -561,8 +564,8 @@ should be migrated to newer EAPIs on version bumps, or proactively when no version bumps are expected.</p> <p>The current list of deprecated EAPIs is stored as <code class="docutils literal notranslate"><span class="pre">eapis-deprecated</span></code> in <code class="docutils literal notranslate"><span class="pre">metadata/layout.conf</span></code>.</p> -</div> -<div class="section" id="pg1003"> +</section> +<section id="pg1003"> <span id="deprecated-eclasses"></span><span id="index-1"></span><h3>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -571,11 +574,8 @@ in <code class="docutils literal notranslate"><span class="pre">metadata/layout. <dt class="field-even">Source</dt> <dd class="field-even"><p>individual eclass maintainers</p> </dd> -<dt class="field-odd">Reference</dt> -<dd class="field-odd"><p><a class="reference external" href="https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf">https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf</a></p> -</dd> -<dt class="field-even">Reported</dt> -<dd class="field-even"><p>by pkgcheck and repoman</p> +<dt class="field-odd">Reported</dt> +<dd class="field-odd"><p>by pkgcheck and repoman</p> </dd> </dl> <p>Deprecated eclasses should not be used in new ebuilds. Existing @@ -583,11 +583,11 @@ packages should be updated not to use these eclasses on version bumps, or proactively when no version bumps are expected.</p> <p>Deprecations are indicated using the <code class="docutils literal notranslate"><span class="pre">@DEPRECATED</span></code> eclassdoc tag inside the eclass files.</p> -</div> -</div> -<span id="document-ebuild-format"></span><div class="section" id="ebuild-file-format"> +</section> +</section> +<span id="document-ebuild-format"></span><section id="ebuild-file-format"> <h2>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0101"> +<section id="pg0101"> <span id="coding-style"></span><span id="index-0"></span><h3>Coding style<a class="headerlink" href="#pg0101" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -613,8 +613,8 @@ or <code class="docutils literal notranslate"><span class="pre">test</span></cod <p><em>Rationale</em>: the recommended constructs are less error-prone. Consistency avoids unnecessary changes when other developers edit the ebuild.</p> -</div> -<div class="section" id="pg0102"> +</section> +<section id="pg0102"> <span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h3>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -640,8 +640,8 @@ converted into eclasses.</p> the principle of least surprise. It makes the maintenance harder, confuses other developers and tools that do not explicitly account for that possibility, including linting tools.</p> -</div> -<div class="section" id="pg0103"> +</section> +<section id="pg0103"> <span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h3>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -662,8 +662,8 @@ as package versions), there is little advantage to using variables there. On the other hand, variables render the URIs unusable without preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.</p> -</div> -<div class="section" id="pg0104"> +</section> +<section id="pg0104"> <span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h3>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -685,8 +685,8 @@ incidentally depend on multi-valued variable having a single value goes against the principle of least surprise. Furthermore, it makes it hard to copy-paste part of the URI e.g. to investigate the directory index.</p> -</div> -<div class="section" id="pg0105"> +</section> +<section id="pg0105"> <span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h3>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -706,11 +706,11 @@ wrapping, appending, etc.).</p> when working with large number of ebuilds. The tool has only limited ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.</p> -</div> -</div> -<span id="document-filesystem"></span><div class="section" id="file-system-layout"> +</section> +</section> +<span id="document-filesystem"></span><section id="file-system-layout"> <h2>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0201"> +<section id="pg0201"> <span id="installation-paths"></span><span id="index-0"></span><h3>Installation paths<a class="headerlink" href="#pg0201" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -778,8 +778,8 @@ exceptions are:</p> <li><p>/gnu for the guix package manager</p></li> <li><p>/nix for the nix package manager</p></li> </ul> -</div> -<div class="section" id="pg0202"> +</section> +<section id="pg0202"> <span id="support-for-separate-usr"></span><span id="index-1"></span><h3>Support for separate /usr<a class="headerlink" href="#pg0202" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -803,8 +803,8 @@ for early boot without /usr mounted difficult, and whenever it is still works, it is either subtly broken or relying on hacks (udev). In setups using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.</p> -</div> -<div class="section" id="pg0203"> +</section> +<section id="pg0203"> <span id="strict-multilib-layout"></span><span id="index-2"></span><h3>Strict multilib layout<a class="headerlink" href="#pg0203" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -830,8 +830,8 @@ in order to maintain compatibility with old packages hardcoding /lib path. With modern Gentoo profiles, this is no longer the case and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.</p> -</div> -<div class="section" id="pg0204"> +</section> +<section id="pg0204"> <span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h3>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -856,8 +856,8 @@ files strictly needed at boot. For this reason, many old Gentoo installations may still use small / partition. Static libraries are used only during package builds, and installing them to rootfs would be a waste of space.</p> -</div> -<div class="section" id="pg0205"> +</section> +<section id="pg0205"> <span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h3>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -895,8 +895,8 @@ inconsistent with the use in other distributions where it was used to share data files. Since the latter implied users must not be added to the games group, a new group (gamestat) needed to be created to fulfill that purpose.</p> -</div> -<div class="section" id="pg0206"> +</section> +<section id="pg0206"> <span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h3>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -925,11 +925,11 @@ when symlinks are supposed to always reference the running host system.</p> <p><em>Rationale</em>: absolute symlinks work correctly only when the root filesystem is mounted at /. They point at the wrong location whenever it is mounted in another location, e.g. for the purposes of recovery.</p> -</div> -</div> -<span id="document-installed-files"></span><div class="section" id="installed-files"> +</section> +</section> +<span id="document-installed-files"></span><section id="installed-files"> <h2>Installed files<a class="headerlink" href="#installed-files" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0301"> +<section id="pg0301"> <span id="installation-of-small-files"></span><span id="index-0"></span><h3>Installation of small files<a class="headerlink" href="#pg0301" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -963,8 +963,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><h3>Installation of static libraries<a class="headerlink" href="#pg0302" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -987,8 +987,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><h3>Installation of libtool (.la) files<a class="headerlink" href="#pg0303" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1021,11 +1021,31 @@ 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> -<span id="document-keywords"></span><div class="section" id="keywording-and-stabilization"> +</section> +<section id="pg0304"> +<span id="virtuals"></span><span id="index-3"></span><h3>Virtuals<a class="headerlink" href="#pg0304" title="Permalink to this headline">¶</a></h3> +<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> +<span id="document-keywords"></span><section id="keywording-and-stabilization"> <h2>Keywording and stabilization<a class="headerlink" href="#keywording-and-stabilization" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0401"> +<section id="pg0401"> <span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h3>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1046,8 +1066,8 @@ retested. This rule can be exempted if the package is known not to work 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="pg0402"> +</section> +<section id="pg0402"> <span id="stabilizing-new-versions"></span><span id="index-1"></span><h3>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1076,8 +1096,8 @@ 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="pg0403"> +</section> +<section id="pg0403"> <span id="removing-stable-keywords"></span><span id="index-2"></span><h3>Removing stable keywords<a class="headerlink" href="#pg0403" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1100,13 +1120,13 @@ must work with maintainers of the depending packages before proceeding with it.</p> <p>The policy for removing a package must be followed here, with exception of last rite mails.</p> -</div> -</div> -<span id="document-languages"></span><div class="section" id="language-specific-policies"> +</section> +</section> +<span id="document-languages"></span><section id="language-specific-policies"> <h2>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Permalink to this headline">¶</a></h2> -<div class="section" id="python"> +<section id="python"> <span id="index-0"></span><h3>Python<a class="headerlink" href="#python" title="Permalink to this headline">¶</a></h3> -<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><div class="section" id="pg0501"> +<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><section id="pg0501"> <span id="eclass-usage"></span><span id="index-4"></span><h4>Eclass usage<a class="headerlink" href="#pg0501" title="Permalink to this headline">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1138,8 +1158,8 @@ matching implementation and that programs will not accidentally break if user changes his Python preferences. The helper functions and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.</p> -</div> -<div class="section" id="pg0502"> +</section> +<section id="pg0502"> <span id="python-2-deprecation"></span><span id="index-5"></span><h4>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Permalink to this headline">¶</a></h4> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1172,12 +1192,12 @@ exponentially.</p> the long-term maintenance costs, and give users better chance to prepare than delaying it until the number of packages losing Python 2 support will cause major upgrade issues.</p> -</div> -</div> -</div> -<span id="document-maintainer"></span><div class="section" id="package-maintainers"> +</section> +</section> +</section> +<span id="document-maintainer"></span><section id="package-maintainers"> <h2>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0601"> +<section id="pg0601"> <span id="adding-new-maintainers"></span><span id="index-0"></span><h3>Adding new maintainers<a class="headerlink" href="#pg0601" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1205,8 +1225,8 @@ 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="pg0602"> +</section> +<section id="pg0602"> <span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h3>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1227,8 +1247,8 @@ 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="pg0603"> +<span class="target" id="index-2"></span></section> +<section id="pg0603"> <span id="removing-package-maintainers"></span><span id="index-3"></span><h3>Removing package maintainers<a class="headerlink" href="#pg0603" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1258,11 +1278,11 @@ 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> -<span id="document-other-metadata"></span><div class="section" id="other-metadata-variables"> +</section> +</section> +<span id="document-other-metadata"></span><section id="other-metadata-variables"> <h2>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this headline">¶</a></h2> -<span class="target" id="index-0"></span><div class="section" id="pg0701"> +<span class="target" id="index-0"></span><section id="pg0701"> <span id="dynamic-slots-multislot-flag"></span><span id="index-1"></span><h3>Dynamic slots (multislot flag)<a class="headerlink" href="#pg0701" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1299,8 +1319,8 @@ on the state of querying the USE flag (which in turn could technically depend on slot, via <code class="docutils literal notranslate"><span class="pre">package.use</span></code>). This caused undefined package manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.</p> -</div> -<div class="section" id="pg0702"> +</section> +<section id="pg0702"> <span id="homepage-value-must-be-meaningful"></span><span id="index-2"></span><h3>HOMEPAGE value must be meaningful<a class="headerlink" href="#pg0702" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1330,8 +1350,8 @@ major Gentoo projects. Furthermore, many of the projects did not even have a single dedicated subpage anywhere in Gentoo web space. In all those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.</p> -</div> -<div class="section" id="pg0703"> +</section> +<section id="pg0703"> <span id="restrict-test-for-use-test"></span><span id="index-3"></span><h3>RESTRICT=test for USE=-test<a class="headerlink" href="#pg0703" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1364,8 +1384,8 @@ restriction since they handle missing test prerequisites gracefully packages since omitting the restriction by mistake is much more common, and there is little harm in overspecifying it.</p> </div> -</div> -<div class="section" id="pg0704"> +</section> +<section id="pg0704"> <span id="license"></span><span id="index-4"></span><h3>LICENSE<a class="headerlink" href="#pg0704" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1413,11 +1433,11 @@ on the user’s system and do not affect the runtime use of packages.</p> <p>Please remember to include the licenses of support files provided by the ebuild, e.g. init.d scripts (usually GPL-2).</p> </div> -</div> -</div> -<span id="document-use-flags"></span><div class="section" id="use-flags"> +</section> +</section> +<span id="document-use-flags"></span><section id="use-flags"> <h2>USE flags<a class="headerlink" href="#use-flags" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0801"> +<section id="pg0801"> <span id="versioned-use-flags"></span><span id="index-0"></span><h3>Versioned USE flags<a class="headerlink" href="#pg0801" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1447,8 +1467,8 @@ with the QA team before introduction.</p> of the QA policy on gtk/gtk2/gtk3 flags. The latter policy has been removed since.</p> </div> -</div> -<div class="section" id="pg0802"> +</section> +<section id="pg0802"> <span id="use-gui-flag"></span><span id="index-1"></span><h3>USE=gui flag<a class="headerlink" href="#pg0802" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1476,8 +1496,8 @@ adjust flags per package (manually discovering which flags are necessary to obtain the GUI) or enabling multiple toolkits globally which afterwards caused issues with packages supporting a choice between multiple GUIs.</p> -</div> -<div class="section" id="pg0803"> +</section> +<section id="pg0803"> <span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h3>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1509,11 +1529,11 @@ unnecessary mismatches between global flags and local flags.</p> distinguishing USE_EXPAND and regular flags easier. It also improves consistency between flag names that historically used hyphens or underscores depending on developer’s personal preference.</p> -</div> -</div> -<span id="document-user-group"></span><div class="section" id="users-and-groups"> +</section> +</section> +<span id="document-user-group"></span><section id="users-and-groups"> <h2>Users and groups<a class="headerlink" href="#users-and-groups" title="Permalink to this headline">¶</a></h2> -<span class="target" id="index-0"></span><div class="section" id="pg0901"> +<span class="target" id="index-0"></span><section id="pg0901"> <span id="user-and-group-account-policy"></span><span id="index-1"></span><h3>User and group account policy<a class="headerlink" href="#pg0901" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -1562,17 +1582,17 @@ and using it.</p> explicitly reserved UIDs / GIDs and the ones allocated dynamically by user.eclass (starting from 999 downwards). The lowest GID range has been reserved for true system users and groups.</p> +</section> +</section> </div> -</div> -</div> -</div> -<div class="section" id="indices-and-tables"> +</section> +<section id="indices-and-tables"> <h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1> <ul class="simple"> <li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li> <li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li> </ul> -</div> +</section> @@ -1590,7 +1610,7 @@ been reserved for true system users and groups.</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='nav'> <li class="toctree-l1"><a class="reference internal" href="#document-preface">Preface</a><ul class='nav'> <li class="toctree-l2"><a class="reference internal" href="#introduction">Introduction</a></li> @@ -1666,6 +1686,7 @@ been reserved for true system users and groups.</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="#document-keywords">Keywording and stabilization</a><ul class='nav'> @@ -1723,7 +1744,7 @@ been reserved for true system users and groups.</p> <h3 class="footerhead">None</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> @@ -1763,7 +1784,7 @@ been reserved for true system users and groups.</p> <span style="border-bottom: 1px solid #e1e1e1;font-weight: bold;">Contents</span> [<a class="" id="show_contents" role="button" data-toggle="collapse" href="#collapseExample" aria-expanded="false" aria-controls="collapseExample">show</a>] <div class="collapse" id="collapseExample" style="margin-top:10px;"> - <p class="caption"><span class="caption-text">Contents:</span></p> + <p class="caption" role="heading"><span class="caption-text">Contents:</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="index.html#document-preface">Preface</a><ul> <li class="toctree-l2"><a class="reference internal" href="index.html#introduction">Introduction</a></li> @@ -1839,6 +1860,7 @@ been reserved for true system users and groups.</p> <li class="toctree-l2"><a class="reference internal" href="index.html#pg0301">Installation of small files</a></li> <li class="toctree-l2"><a class="reference internal" href="index.html#pg0302">Installation of static libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="index.html#pg0303">Installation of libtool (.la) files</a></li> +<li class="toctree-l2"><a class="reference internal" href="index.html#pg0304">Virtuals</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="index.html#document-keywords">Keywording and stabilization</a><ul> diff --git a/dependencies.html b/dependencies.html index f002c80..3c003ec 100644 --- a/dependencies.html +++ b/dependencies.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>Dependencies — 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="Deprecations" href="deprecation.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="dependencies"> + <section id="dependencies"> <h1>Dependencies<a class="headerlink" href="#dependencies" title="Permalink to this headline">¶</a></h1> -<span class="target" id="index-0"></span><div class="section" id="pg0001"> +<span class="target" id="index-0"></span><section id="pg0001"> <span id="optional-runtime-dependencies"></span><span id="index-1"></span><h2>Optional runtime dependencies<a class="headerlink" href="#pg0001" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -154,8 +157,8 @@ being nonfunctional unless at least one of a set of optional runtime dependencies is installed.</p> <p>There is no specific preference as to how user should be informed of optional runtime dependencies. Three possible ways are -<code class="docutils literal notranslate"><span class="pre">optfeature</span></code> from <code class="docutils literal notranslate"><span class="pre">eutils</span></code> eclass, <code class="docutils literal notranslate"><span class="pre">readme.gentoo-r1</span></code> eclass -and plain <code class="docutils literal notranslate"><span class="pre">elog</span></code> messages.</p> +<code class="docutils literal notranslate"><span class="pre">optfeature</span></code> eclass, <code class="docutils literal notranslate"><span class="pre">readme.gentoo-r1</span></code> eclass and plain <code class="docutils literal notranslate"><span class="pre">elog</span></code> +messages.</p> <p><em>Rationale</em>: toggling USE flags in order to enable or disable optional runtime dependencies causes needless rebuilds of packages in question. This is especially important for packages that take long time to build.</p> @@ -165,8 +168,8 @@ This is especially important for packages that take long time to build.</p> rebuilding package in question. It has been tentatively approved by the Council but no reference implementation has been written.</p> </div> -</div> -<div class="section" id="pg0002"> +</section> +<section id="pg0002"> <span id="dependencies-with-no-revision"></span><span id="index-2"></span><h2>=-dependencies with no revision<a class="headerlink" href="#pg0002" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -185,11 +188,11 @@ revision is requested, <code class="docutils literal notranslate"><span class="p is necessary, the <code class="docutils literal notranslate"><span class="pre">~</span></code> (tilde) operator must be used instead.</p> <p><em>Example</em>:</p> <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># BAD:</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span> <span class="c1"># GOOD:</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span><span class="o">-</span><span class="n">r0</span> -<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span><span class="o">-</span><span class="n">r3</span> -<span class="o">~</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2</span><span class="o">.</span><span class="mi">3</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span><span class="o">-</span><span class="n">r0</span> +<span class="o">=</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span><span class="o">-</span><span class="n">r3</span> +<span class="o">~</span><span class="n">dev</span><span class="o">-</span><span class="n">libs</span><span class="o">/</span><span class="n">libfrobnicate</span><span class="o">-</span><span class="mf">1.2.3</span> </pre></div> </div> <p><em>Rationale</em>: using <code class="docutils literal notranslate"><span class="pre">=</span></code> operator in place of <code class="docutils literal notranslate"><span class="pre">~</span></code> to mean a specific @@ -197,10 +200,10 @@ version has been a common mistake. This policy uses the fact that no revision and explicit <code class="docutils literal notranslate"><span class="pre">-r0</span></code> are equivalent. By explicitly requesting the latter, it warns developers to reconsider whether they used the correct operator.</p> -</div> -<div class="section" id="slot-and-subslot-dependencies"> +</section> +<section id="slot-and-subslot-dependencies"> <span id="index-3"></span><h2>Slot and subslot dependencies<a class="headerlink" href="#slot-and-subslot-dependencies" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0011"> +<section id="pg0011"> <span id="on-sub-slotted-packages"></span><h3>on (sub-)slotted packages<a class="headerlink" href="#pg0011" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -236,8 +239,8 @@ means ‘verified that any slot is acceptable’.</p> is specified on the dependency. It pulls in the slot corresponding to the newest package version available.</p> </div> -</div> -<div class="section" id="pg0012"> +</section> +<section id="pg0012"> <span id="special-case-qt-packages"></span><span id="index-4"></span><h3>special case: Qt packages<a class="headerlink" href="#pg0012" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -258,8 +261,8 @@ libraries is stable within each slot, and the subslot is used to refer to private ABI. Therefore, the <code class="docutils literal notranslate"><span class="pre">:=</span></code> operator must only be used if your package uses one of the private API parts, and plain <code class="docutils literal notranslate"><span class="pre">:5</span></code> or likewise dependency must be used otherwise.</p> -</div> -<div class="section" id="proactive-use-of-slot-operators"> +</section> +<section id="proactive-use-of-slot-operators"> <h3>proactive use of slot operators<a class="headerlink" href="#proactive-use-of-slot-operators" title="Permalink to this headline">¶</a></h3> <p>There is an open debate on whether developers should be proactively adding <code class="docutils literal notranslate"><span class="pre">:=</span></code> slot operators on packages that do not define subslots @@ -271,9 +274,9 @@ argue that in many cases the future use of subslots is reasonably predictable.</p> <p>Opponents claim that the future use of subslots is not 100% predictable. They point out the case of Qt packages as an example.</p> -</div> -</div> -<div class="section" id="pg0003"> +</section> +</section> +<section id="pg0003"> <span id="revision-bumps-on-runtime-dependency-changes"></span><span id="index-5"></span><h2>Revision bumps on runtime dependency changes<a class="headerlink" href="#pg0003" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -315,10 +318,10 @@ and decide to remove the dependency and code responsible for linking to it in place, Portage may apply the former immediately even if the package installed by the user still links to libfoo.</p> </div> -</div> -<div class="section" id="use-dependencies"> +</section> +<section id="use-dependencies"> <span id="index-6"></span><h2>USE dependencies<a class="headerlink" href="#use-dependencies" title="Permalink to this headline">¶</a></h2> -<div class="section" id="pg0021"> +<section id="pg0021"> <span id="on-packages-without-the-flag"></span><h3>on packages without the flag<a class="headerlink" href="#pg0021" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -356,9 +359,9 @@ dependencies</a>, it is an error to apply 2-style USE dependency to a package missing the flag. Furthermore, checking for this makes it possible to report whenever USE flags on a package are changed without updating its reverse dependencies.</p> -</div> -</div> -</div> +</section> +</section> +</section> @@ -400,7 +403,7 @@ updating its reverse dependencies.</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> @@ -450,7 +453,7 @@ updating its reverse dependencies.</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> diff --git a/deprecation.html b/deprecation.html index 58c0799..8bcd3a9 100644 --- a/deprecation.html +++ b/deprecation.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>Deprecations — 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="Ebuild file format" href="ebuild-format.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="deprecations"> + <section id="deprecations"> <h1>Deprecations<a class="headerlink" href="#deprecations" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg1001"> +<section id="pg1001"> <span id="deprecated-eapis"></span><span id="index-0"></span><h2>Deprecated EAPIs<a class="headerlink" href="#pg1001" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -153,8 +156,8 @@ should be migrated to newer EAPIs on version bumps, or proactively when no version bumps are expected.</p> <p>The current list of deprecated EAPIs is stored as <code class="docutils literal notranslate"><span class="pre">eapis-deprecated</span></code> in <code class="docutils literal notranslate"><span class="pre">metadata/layout.conf</span></code>.</p> -</div> -<div class="section" id="pg1003"> +</section> +<section id="pg1003"> <span id="deprecated-eclasses"></span><span id="index-1"></span><h2>Deprecated eclasses<a class="headerlink" href="#pg1003" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -163,11 +166,8 @@ in <code class="docutils literal notranslate"><span class="pre">metadata/layout. <dt class="field-even">Source</dt> <dd class="field-even"><p>individual eclass maintainers</p> </dd> -<dt class="field-odd">Reference</dt> -<dd class="field-odd"><p><a class="reference external" href="https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf">https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/qa-policy.conf</a></p> -</dd> -<dt class="field-even">Reported</dt> -<dd class="field-even"><p>by pkgcheck and repoman</p> +<dt class="field-odd">Reported</dt> +<dd class="field-odd"><p>by pkgcheck and repoman</p> </dd> </dl> <p>Deprecated eclasses should not be used in new ebuilds. Existing @@ -175,8 +175,8 @@ packages should be updated not to use these eclasses on version bumps, or proactively when no version bumps are expected.</p> <p>Deprecations are indicated using the <code class="docutils literal notranslate"><span class="pre">@DEPRECATED</span></code> eclassdoc tag inside the eclass files.</p> -</div> -</div> +</section> +</section> @@ -218,7 +218,7 @@ inside the eclass files.</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> @@ -257,7 +257,7 @@ inside the eclass files.</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> diff --git a/ebuild-format.html b/ebuild-format.html index bb1b763..8e0c924 100644 --- a/ebuild-format.html +++ b/ebuild-format.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>Ebuild file format — 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="File system layout" href="filesystem.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="ebuild-file-format"> + <section id="ebuild-file-format"> <h1>Ebuild file format<a class="headerlink" href="#ebuild-file-format" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg0101"> +<section id="pg0101"> <span id="coding-style"></span><span id="index-0"></span><h2>Coding style<a class="headerlink" href="#pg0101" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -158,8 +161,8 @@ or <code class="docutils literal notranslate"><span class="pre">test</span></cod <p><em>Rationale</em>: the recommended constructs are less error-prone. Consistency avoids unnecessary changes when other developers edit the ebuild.</p> -</div> -<div class="section" id="pg0102"> +</section> +<section id="pg0102"> <span id="code-must-be-contained-within-ebuild-and-eclasses"></span><span id="index-1"></span><h2>Code must be contained within ebuild and eclasses<a class="headerlink" href="#pg0102" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -185,8 +188,8 @@ converted into eclasses.</p> the principle of least surprise. It makes the maintenance harder, confuses other developers and tools that do not explicitly account for that possibility, including linting tools.</p> -</div> -<div class="section" id="pg0103"> +</section> +<section id="pg0103"> <span id="homepage-must-not-contain-variables"></span><span id="index-2"></span><h2>HOMEPAGE must not contain variables<a class="headerlink" href="#pg0103" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -207,8 +210,8 @@ as package versions), there is little advantage to using variables there. On the other hand, variables render the URIs unusable without preprocessing, breaking URI support in terminals and editors, as well as reducing the usefulness of plain tools such as grep.</p> -</div> -<div class="section" id="pg0104"> +</section> +<section id="pg0104"> <span id="src-uri-must-not-refer-to-homepage"></span><span id="index-3"></span><h2>SRC_URI must not refer to HOMEPAGE<a class="headerlink" href="#pg0104" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -230,8 +233,8 @@ incidentally depend on multi-valued variable having a single value goes against the principle of least surprise. Furthermore, it makes it hard to copy-paste part of the URI e.g. to investigate the directory index.</p> -</div> -<div class="section" id="pg0105"> +</section> +<section id="pg0105"> <span id="keywords-must-be-defined-on-a-single-line"></span><span id="index-4"></span><h2>KEYWORDS must be defined on a single line<a class="headerlink" href="#pg0105" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -251,8 +254,8 @@ wrapping, appending, etc.).</p> when working with large number of ebuilds. The tool has only limited ability to process and modify ebuilds, and therefore developers must make sure that it works correctly on their ebuilds.</p> -</div> -</div> +</section> +</section> @@ -294,7 +297,7 @@ make sure that it works correctly on their ebuilds.</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> @@ -336,7 +339,7 @@ make sure that it works correctly on their ebuilds.</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> diff --git a/filesystem.html b/filesystem.html index 67e97dc..7a1cc9f 100644 --- a/filesystem.html +++ b/filesystem.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>File system layout — 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="Installed files" href="installed-files.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="file-system-layout"> + <section id="file-system-layout"> <h1>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg0201"> +<section id="pg0201"> <span id="installation-paths"></span><span id="index-0"></span><h2>Installation paths<a class="headerlink" href="#pg0201" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -200,8 +203,8 @@ exceptions are:</p> <li><p>/gnu for the guix package manager</p></li> <li><p>/nix for the nix package manager</p></li> </ul> -</div> -<div class="section" id="pg0202"> +</section> +<section id="pg0202"> <span id="support-for-separate-usr"></span><span id="index-1"></span><h2>Support for separate /usr<a class="headerlink" href="#pg0202" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -225,8 +228,8 @@ for early boot without /usr mounted difficult, and whenever it is still works, it is either subtly broken or relying on hacks (udev). In setups using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.</p> -</div> -<div class="section" id="pg0203"> +</section> +<section id="pg0203"> <span id="strict-multilib-layout"></span><span id="index-2"></span><h2>Strict multilib layout<a class="headerlink" href="#pg0203" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -252,8 +255,8 @@ in order to maintain compatibility with old packages hardcoding /lib path. With modern Gentoo profiles, this is no longer the case and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.</p> -</div> -<div class="section" id="pg0204"> +</section> +<section id="pg0204"> <span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h2>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -278,8 +281,8 @@ files strictly needed at boot. For this reason, many old Gentoo installations may still use small / partition. Static libraries are used only during package builds, and installing them to rootfs would be a waste of space.</p> -</div> -<div class="section" id="pg0205"> +</section> +<section id="pg0205"> <span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h2>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -317,8 +320,8 @@ inconsistent with the use in other distributions where it was used to share data files. Since the latter implied users must not be added to the games group, a new group (gamestat) needed to be created to fulfill that purpose.</p> -</div> -<div class="section" id="pg0206"> +</section> +<section id="pg0206"> <span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h2>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -347,8 +350,8 @@ when symlinks are supposed to always reference the running host system.</p> <p><em>Rationale</em>: absolute symlinks work correctly only when the root filesystem is mounted at /. They point at the wrong location whenever it is mounted in another location, e.g. for the purposes of recovery.</p> -</div> -</div> +</section> +</section> @@ -390,7 +393,7 @@ it is mounted in another location, e.g. for the purposes of recovery.</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> @@ -433,7 +436,7 @@ it is mounted in another location, e.g. for the purposes of recovery.</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> diff --git a/genindex.html b/genindex.html index 934080f..2890c48 100644 --- a/genindex.html +++ b/genindex.html @@ -14,11 +14,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="#" /> <link rel="search" title="Search" href="search.html" /> </head><body> @@ -143,6 +145,7 @@ | <a href="#R"><strong>R</strong></a> | <a href="#S"><strong>S</strong></a> | <a href="#U"><strong>U</strong></a> + | <a href="#V"><strong>V</strong></a> </div> <h2 id="B">B</h2> @@ -299,6 +302,8 @@ </li> <li><a href="installed-files.html#index-1">static library</a> </li> + <li><a href="installed-files.html#index-3">virtuals</a> +</li> </ul></li> </ul></td> </tr></table> @@ -490,6 +495,19 @@ </ul></td> </tr></table> +<h2 id="V">V</h2> +<table style="width: 100%" class="indextable genindextable"><tr> + <td style="width: 33%; vertical-align: top;"><ul> + <li> + virtuals + + <ul> + <li><a href="installed-files.html#index-3">installed files</a> +</li> + </ul></li> + </ul></td> +</tr></table> + @@ -519,7 +537,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 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> @@ -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>Gentoo Policy Guide — 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="Preface" href="preface.html" /> @@ -127,7 +130,7 @@ - <div class="section" id="gentoo-policy-guide"> + <section id="gentoo-policy-guide"> <h1>Gentoo Policy Guide<a class="headerlink" href="#gentoo-policy-guide" title="Permalink to this headline">¶</a></h1> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. @@ -137,7 +140,7 @@ The policies are meant to be supplied with rationale and clear indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> <div class="toctree-wrapper compound"> -<p class="caption"><span class="caption-text">Contents:</span></p> +<p class="caption" role="heading"><span class="caption-text">Contents:</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="preface.html">Preface</a><ul> <li class="toctree-l2"><a class="reference internal" href="preface.html#introduction">Introduction</a></li> @@ -213,6 +216,7 @@ in which the policy can be updated.</p> <li class="toctree-l2"><a class="reference internal" href="installed-files.html#pg0301">Installation of small files</a></li> <li class="toctree-l2"><a class="reference internal" href="installed-files.html#pg0302">Installation of static libraries</a></li> <li class="toctree-l2"><a class="reference internal" href="installed-files.html#pg0303">Installation of libtool (.la) files</a></li> +<li class="toctree-l2"><a class="reference internal" href="installed-files.html#pg0304">Virtuals</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="keywords.html">Keywording and stabilization</a><ul> @@ -254,14 +258,14 @@ in which the policy can be updated.</p> </li> </ul> </div> -</div> -<div class="section" id="indices-and-tables"> +</section> +<section id="indices-and-tables"> <h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1> <ul class="simple"> <li><p><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></p></li> <li><p><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></p></li> </ul> -</div> +</section> @@ -296,7 +300,7 @@ in which the policy can be updated.</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='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> @@ -331,7 +335,7 @@ in which the policy can be updated.</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> 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> diff --git a/keywords.html b/keywords.html index c3863a4..cc512e4 100644 --- a/keywords.html +++ b/keywords.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>Keywording and stabilization — 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="Language-specific policies" href="languages.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="keywording-and-stabilization"> + <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="pg0401"> +<section id="pg0401"> <span id="rekeywording-on-dropped-keywords"></span><span id="index-0"></span><h2>Rekeywording on dropped keywords<a class="headerlink" href="#pg0401" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -153,8 +156,8 @@ retested. This rule can be exempted if the package is known not to work 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="pg0402"> +</section> +<section id="pg0402"> <span id="stabilizing-new-versions"></span><span id="index-1"></span><h2>Stabilizing new versions<a class="headerlink" href="#pg0402" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -183,8 +186,8 @@ 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="pg0403"> +</section> +<section id="pg0403"> <span id="removing-stable-keywords"></span><span id="index-2"></span><h2>Removing stable keywords<a class="headerlink" href="#pg0403" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -207,8 +210,8 @@ must work with maintainers of the depending packages before proceeding with it.</p> <p>The policy for removing a package must be followed here, with exception of last rite mails.</p> -</div> -</div> +</section> +</section> @@ -250,7 +253,7 @@ of last rite mails.</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> @@ -290,7 +293,7 @@ of last rite mails.</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> diff --git a/languages.html b/languages.html index 277701a..6671fa1 100644 --- a/languages.html +++ b/languages.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>Language-specific policies — 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="Package Maintainers" href="maintainer.html" /> @@ -130,11 +133,11 @@ - <div class="section" id="language-specific-policies"> + <section id="language-specific-policies"> <h1>Language-specific policies<a class="headerlink" href="#language-specific-policies" title="Permalink to this headline">¶</a></h1> -<div class="section" id="python"> +<section id="python"> <span id="index-0"></span><h2>Python<a class="headerlink" href="#python" title="Permalink to this headline">¶</a></h2> -<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><div class="section" id="pg0501"> +<span class="target" id="index-1"></span><span class="target" id="index-2"></span><span class="target" id="index-3"></span><section id="pg0501"> <span id="eclass-usage"></span><span id="index-4"></span><h3>Eclass usage<a class="headerlink" href="#pg0501" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -166,8 +169,8 @@ matching implementation and that programs will not accidentally break if user changes his Python preferences. The helper functions and variables also make it possible to gracefully retire old implementations with minimal changes to existing ebuilds.</p> -</div> -<div class="section" id="pg0502"> +</section> +<section id="pg0502"> <span id="python-2-deprecation"></span><span id="index-5"></span><h3>Python 2 deprecation<a class="headerlink" href="#pg0502" title="Permalink to this headline">¶</a></h3> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -200,9 +203,9 @@ exponentially.</p> the long-term maintenance costs, and give users better chance to prepare than delaying it until the number of packages losing Python 2 support will cause major upgrade issues.</p> -</div> -</div> -</div> +</section> +</section> +</section> @@ -244,7 +247,7 @@ will cause major upgrade issues.</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> @@ -286,7 +289,7 @@ will cause major upgrade issues.</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> diff --git a/maintainer.html b/maintainer.html index 24b5043..ef9a973 100644 --- a/maintainer.html +++ b/maintainer.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>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" /> @@ -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="Other metadata variables" href="other-metadata.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="package-maintainers"> + <section id="package-maintainers"> <h1>Package Maintainers<a class="headerlink" href="#package-maintainers" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg0601"> +<section id="pg0601"> <span id="adding-new-maintainers"></span><span id="index-0"></span><h2>Adding new maintainers<a class="headerlink" href="#pg0601" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -160,8 +163,8 @@ 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="pg0602"> +</section> +<section id="pg0602"> <span id="new-packages-without-a-maintainer"></span><span id="index-1"></span><h2>New packages without a maintainer<a class="headerlink" href="#pg0602" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -182,8 +185,8 @@ 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="pg0603"> +<span class="target" id="index-2"></span></section> +<section id="pg0603"> <span id="removing-package-maintainers"></span><span id="index-3"></span><h2>Removing package maintainers<a class="headerlink" href="#pg0603" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -213,8 +216,8 @@ 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> +</section> +</section> @@ -256,7 +259,7 @@ to them silently becoming maintainer-needed).</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> @@ -296,7 +299,7 @@ to them silently becoming maintainer-needed).</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> diff --git a/motivation.html b/motivation.html index 010e239..5e66b2b 100644 --- a/motivation.html +++ b/motivation.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>Motivation and history — 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="Basic information" href="basics.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="motivation-and-history"> + <section id="motivation-and-history"> <h1>Motivation and history<a class="headerlink" href="#motivation-and-history" title="Permalink to this headline">¶</a></h1> -<div class="section" id="historical-state-of-policy-documentation"> +<section id="historical-state-of-policy-documentation"> <h2>Historical state of policy documentation<a class="headerlink" href="#historical-state-of-policy-documentation" title="Permalink to this headline">¶</a></h2> <p>At the time, Gentoo was lacking a clear and focused document listing all development-related policies in a concise and clear way.</p> @@ -158,8 +161,8 @@ and which are obsolete or non-binding tips.</p> project documentation, and a lot of de facto policies that were established less or more formally in the past but were never really written down.</p> -</div> -<div class="section" id="purpose-of-the-policy-guide"> +</section> +<section id="purpose-of-the-policy-guide"> <h2>Purpose of the Policy Guide<a class="headerlink" href="#purpose-of-the-policy-guide" title="Permalink to this headline">¶</a></h2> <p>The Policy Guide was created in order to address aforementioned documentation deficiencies. Its primary purpose is to collect all @@ -174,8 +177,8 @@ information, and how the policy can be updated if need arises.</p> <p>This Guide is going to replace the QA team policies page. All new QA policies will be documented directly in it. Other documentation (e.g. devmanual) should conform to policies stated here.</p> -</div> -</div> +</section> +</section> @@ -217,7 +220,7 @@ devmanual) should conform to policies stated here.</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 current"><a class="current reference internal" href="#">Motivation and history</a><ul class='nav'> @@ -256,7 +259,7 @@ devmanual) should conform to policies stated here.</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> diff --git a/other-docs.html b/other-docs.html index 29231f3..7a2e64c 100644 --- a/other-docs.html +++ b/other-docs.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>Other policy documents — 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="Dependencies" href="dependencies.html" /> @@ -130,11 +133,11 @@ - <div class="section" id="other-policy-documents"> + <section id="other-policy-documents"> <h1>Other policy documents<a class="headerlink" href="#other-policy-documents" title="Permalink to this headline">¶</a></h1> -<div class="section" id="gentoo-specific-documentation"> +<section id="gentoo-specific-documentation"> <h2>Gentoo-specific documentation<a class="headerlink" href="#gentoo-specific-documentation" title="Permalink to this headline">¶</a></h2> -<div class="section" id="package-manager-specification"> +<section id="package-manager-specification"> <h3>Package Manager Specification<a class="headerlink" href="#package-manager-specification" title="Permalink to this headline">¶</a></h3> <p><a class="reference external" href="https://projects.gentoo.org/pms/latest/pms.html">PMS</a> provides the specification of ebuild format, as well as general guidelines for implementing package managers. All ebuilds in the Gentoo @@ -143,8 +146,8 @@ enforce additional restrictions upon the format discussed in PMS.</p> <p>PMS is maintained by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:PMS">PMS project</a>. All major changes are done in subsequent EAPIs that are approved by the Council. The project’s wiki page discusses how PMS can be changed via <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Package_Manager_Specification/Future_EAPI_process">future EAPI process</a>.</p> -</div> -<div class="section" id="gleps"> +</section> +<section id="gleps"> <h3>GLEPs<a class="headerlink" href="#gleps" title="Permalink to this headline">¶</a></h3> <p><a class="reference external" href="https://www.gentoo.org/glep/">GLEPs</a> provide the highest level policies applicable to Gentoo. Final or active GLEPs apply to all developers. Tree policies may impose @@ -152,8 +155,8 @@ additional restrictions on GLEPs but may not override them.</p> <p>The process for creating and updating GLEPs is documented in <a class="reference external" href="https://www.gentoo.org/glep/glep-0001.html">GLEP 1</a>. In general, all GLEP updates go through mailing list review and need to be approved by the Council.</p> -</div> -<div class="section" id="developer-manual"> +</section> +<section id="developer-manual"> <h3>Developer Manual<a class="headerlink" href="#developer-manual" title="Permalink to this headline">¶</a></h3> <p><a class="reference external" href="https://devmanual.gentoo.org/">Devmanual</a> is the basic guide for ebuild developers. Besides policies, it contains many general recommendations and detailed instructions. @@ -161,25 +164,25 @@ Developer Manual does not specify policies itself, and needs to comply with policies defined in this document.</p> <p>Technically, devmanual can be changed by any developer. However, it is recommended that all changes are reviewed by the <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Devmanual">devmanual project</a>.</p> -</div> -</div> -<div class="section" id="external-standards"> +</section> +</section> +<section id="external-standards"> <h2>External standards<a class="headerlink" href="#external-standards" title="Permalink to this headline">¶</a></h2> -<div class="section" id="posix"> +<section id="posix"> <h3>POSIX<a class="headerlink" href="#posix" title="Permalink to this headline">¶</a></h3> <p><a class="reference external" href="http://get.posixcertified.ieee.org/">POSIX</a> is the basic standard for operating systems. However, its rules apply to the software packaged in Gentoo rather than the distribution itself. Nevertheless, when no more specific policy applies, following POSIX is recommended.</p> -</div> -<div class="section" id="fhs"> +</section> +<section id="fhs"> <h3>FHS<a class="headerlink" href="#fhs" title="Permalink to this headline">¶</a></h3> <p><a class="reference external" href="https://refspecs.linuxfoundation.org/fhs.shtml">FHS</a> specifies the suggested filesystem layout for Linux systems. Gentoo follows FHS only partially. Whenever Gentoo policies and FHS disagree, Gentoo policies should be followed.</p> -</div> -</div> -</div> +</section> +</section> +</section> @@ -221,7 +224,7 @@ disagree, Gentoo policies should be followed.</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> @@ -269,7 +272,7 @@ disagree, Gentoo policies should be followed.</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> diff --git a/other-metadata.html b/other-metadata.html index c3957e9..0a20af1 100644 --- a/other-metadata.html +++ b/other-metadata.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>Other metadata variables — 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="USE flags" href="use-flags.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="other-metadata-variables"> + <section id="other-metadata-variables"> <h1>Other metadata variables<a class="headerlink" href="#other-metadata-variables" title="Permalink to this headline">¶</a></h1> -<span class="target" id="index-0"></span><div class="section" id="pg0701"> +<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> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -169,8 +172,8 @@ on the state of querying the USE flag (which in turn could technically depend on slot, via <code class="docutils literal notranslate"><span class="pre">package.use</span></code>). This caused undefined package manager behavior which could include use of unpredictable slot, cache invalidation or explicit errors.</p> -</div> -<div class="section" id="pg0702"> +</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> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -200,8 +203,8 @@ major Gentoo projects. Furthermore, many of the projects did not even have a single dedicated subpage anywhere in Gentoo web space. In all those cases, using the explicit No_homepage marker at least makes it easy to identify such packages.</p> -</div> -<div class="section" id="pg0703"> +</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> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -234,8 +237,8 @@ restriction since they handle missing test prerequisites gracefully packages since omitting the restriction by mistake is much more common, and there is little harm in overspecifying it.</p> </div> -</div> -<div class="section" id="pg0704"> +</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> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -283,8 +286,8 @@ on the user’s system and do not affect the runtime use of packages.</p> <p>Please remember to include the licenses of support files provided by the ebuild, e.g. init.d scripts (usually GPL-2).</p> </div> -</div> -</div> +</section> +</section> @@ -326,7 +329,7 @@ by the ebuild, e.g. init.d scripts (usually GPL-2).</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> @@ -367,7 +370,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 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> diff --git a/preface.html b/preface.html index e331d27..d1747df 100644 --- a/preface.html +++ b/preface.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>Preface — 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="Motivation and history" href="motivation.html" /> @@ -134,9 +137,9 @@ - <div class="section" id="preface"> + <section id="preface"> <h1>Preface<a class="headerlink" href="#preface" title="Permalink to this headline">¶</a></h1> -<div class="section" id="introduction"> +<section id="introduction"> <h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2> <p>Gentoo Policy Guide aims to become a definitive clear source of all Tree Policies that are currently binding to Gentoo developers. @@ -145,21 +148,21 @@ team or the Council), as well as specific to other Gentoo projects. The policies are meant to be supplied with rationale and clear indication of the body setting the policy, and therefore the process in which the policy can be updated.</p> -</div> -<div class="section" id="authors"> +</section> +<section id="authors"> <h2>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">¶</a></h2> <p>This document is maintained by the Gentoo <a class="reference external" href="https://wiki.gentoo.org/wiki/Project:Quality_Assurance">QA project</a>.</p> <p>The current text authors are:</p> <ul class="simple"> <li><p>Michał Górny (mgorny)</p></li> </ul> -</div> -<div class="section" id="license"> +</section> +<section id="license"> <h2>License<a class="headerlink" href="#license" title="Permalink to this headline">¶</a></h2> <p>This work is licensed under the <a class="reference external" href="https://creativecommons.org/licenses/by-sa/4.0/.">Creative Commons Attribution-ShareAlike 4.0 International License</a>.</p> -</div> -</div> +</section> +</section> @@ -201,7 +204,7 @@ in which the policy can be updated.</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 current"><a class="current reference internal" href="#">Preface</a><ul class='nav'> <li class="toctree-l2"><a class="reference internal" href="#introduction">Introduction</a></li> @@ -241,7 +244,7 @@ in which the policy can be updated.</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> diff --git a/search.html b/search.html index 4f37785..5dc375b 100644 --- a/search.html +++ b/search.html @@ -14,13 +14,16 @@ <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> <script src="_static/searchtools.js"></script> + <script src="_static/language_data.js"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="#" /> <script src="searchindex.js" defer></script> @@ -130,6 +133,7 @@ <h1 id="search-documentation">Search</h1> + <div id="fallback" class="admonition warning"> <script>$('#fallback').hide();</script> <p> @@ -137,19 +141,26 @@ functionality. </p> </div> + + <p> Searching for multiple words only shows matches that contain all words. </p> + + <form action="" method="get"> - <input type="text" name="q" aria-labelledby="search-documentation" value="" /> + <input type="text" name="q" aria-labelledby="search-documentation" value="" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/> <input type="submit" value="search" /> <span id="search-progress" style="padding-left: 10px"></span> </form> + + <div id="search-results"> </div> + @@ -178,7 +189,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 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> diff --git a/searchindex.js b/searchindex.js index c562cdd..fc725d0 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["basics","dependencies","deprecation","ebuild-format","filesystem","index","installed-files","keywords","languages","maintainer","motivation","other-docs","other-metadata","preface","use-flags","user-group"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,sphinx:56},filenames:["basics.rst","dependencies.rst","deprecation.rst","ebuild-format.rst","filesystem.rst","index.rst","installed-files.rst","keywords.rst","languages.rst","maintainer.rst","motivation.rst","other-docs.rst","other-metadata.rst","preface.rst","use-flags.rst","user-group.rst"],objects:{},objnames:{},objtypes:{},terms:{"0001":1,"0002":1,"0003":1,"0011":1,"0012":1,"0021":1,"0101":3,"0102":3,"0103":3,"0104":3,"0105":3,"0201":4,"0202":4,"0203":4,"0204":4,"0205":4,"0206":4,"0301":6,"0302":6,"0303":6,"0401":7,"0402":7,"0403":7,"0501":8,"0502":8,"0601":9,"0602":9,"0603":9,"0701":12,"0702":12,"0703":12,"0704":12,"0801":14,"0802":14,"0803":14,"08gentoo":4,"0901":15,"100":[1,15],"1001":2,"1003":2,"101":15,"104017":1,"109991":[12,14],"126033":7,"2013":4,"20130813":4,"20130924":4,"20151011":[1,4],"20151213":4,"2016":12,"2019":8,"20191013":14,"2fuse":12,"499":15,"612630":3,"702460":15,"80librari":4,"80multilib":4,"83cc5bbd7bbe8bdf04dd3c3bc7f8a035":12,"999":15,"9cae3a92412a007febe7ac0612d50f5f":1,"break":[3,8],"case":[0,4,5,7,12],"class":0,"default":[1,6],"final":[0,10,11],"function":[0,3,4,8],"g\u00f3rny":13,"import":[1,8,12,15],"long":[1,7,8,12],"micha\u0142":13,"new":[2,4,5,8,10,14,15],"public":1,"static":[5,12],"switch":14,"true":15,"try":[0,3,9],"var":4,"while":[0,1,3,6,12],Adding:5,FHS:5,For:[1,4,9],Its:[0,10],PMS:[1,10,11,12],Such:[6,12],The:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,15],There:[1,6,9,10],USE:[5,6],Use:3,Using:1,With:4,abi:[1,4],abil:[3,10,12],abolish:0,about:12,absolut:5,accept:[1,4,12,15],access:4,accident:8,accord:1,account:[1,3,5],acct:15,achiev:0,across:[0,10],action:0,activ:11,actual:9,add:[3,9],added:[4,6,9],adding:[1,9,15],addit:[3,4,6,10,11],addition:0,address:10,adjust:14,adopt:15,advantag:[3,14],affect:[0,3,7,12],aforement:[4,10],after:[0,1,4],afterward:14,against:[0,3,10,12],agre:9,aid:15,aim:[0,1,5,9,13,14],align:3,all:[0,1,3,5,6,7,8,9,10,11,12,13,14,15],alloc:15,allow:[3,12],along:[4,10],alreadi:[1,4,8,12],also:[0,8,10,14],alter:12,alwai:[3,4],amd64:4,amount:10,analyz:0,ani:[1,3,6,9,10,11,12,14],anoth:[1,4,12],anymor:[4,7],anywher:12,api:1,app:6,appeal:5,append:3,appli:[0,1,7,9,10,11],applic:[1,4,6,10,11,12],appropri:[4,12],approv:[1,11,15],arbitrari:15,arch:[3,7],architectur:[0,4,7],archiv:[1,6,12,14],area:0,argu:1,aris:[10,14,15],ask:[0,7],assign:[9,15],assum:[1,14],assumpt:12,attempt:[3,6,10,14],attribut:13,author:5,autom:0,autotool:6,avail:[1,10,12,14],avoid:[3,6],awar:9,backup:9,bad:[1,4,12],base:6,baselayout:15,bash:[3,6],basic:[5,11],becom:[1,5,9,13],been:[1,4,6,12,14,15],befor:[0,7,14,15],behavior:[0,1,6,12],being:[1,6,7,8,9,12],besid:11,better:[8,10],between:[4,8,12,14,15],bin:4,binari:12,bind:[5,10,13],bit:4,blurri:4,bodi:[0,5,10,13],boot:4,both:[0,3,5,6,8,13,14],boundari:4,bracket:3,breakag:[1,7],broken:4,brought:6,browser:4,bug:[3,7,9,12,15],build:[0,1,4,6,8,12,14],builtin:3,bump:[2,5,15],bundl:12,burden:9,cach:12,call:[1,8],can:[0,1,4,5,7,10,11,12,13,14,15],care:9,categori:6,caus:[1,6,7,8,12,14],cf3f5a59ac918335766632bd02438722:14,chanc:[8,9],chang:[3,5,8,11],check:[1,4,5],choic:[3,14],choos:[12,14],chosen:15,chost:4,circumst:[1,12],claim:1,clarifi:4,clean:1,clear:[5,10,13,14],close:7,code:[0,1,5,8,12],collect:10,collis:15,combin:[0,5,10,12,13],comment:9,commit:0,common:[1,3,12,13],compar:9,compat:[4,8],compil:0,complet:[6,10,12],compli:11,complianc:5,compon:0,concept:0,concis:10,condit:[3,12],conf:2,config:6,conform:[10,11],confus:[3,7,14],consent:9,consequ:6,consid:[6,12,14],consist:[0,3,8,14],construct:3,contact:0,contain:[5,9,11,14],content:[3,5],context:6,contrari:12,contribut:0,control:[1,4,6,12,14],controlled_optional_rdepend:1,convert:[3,14],copi:3,correct:[1,4,12],correctli:[0,3,4],correspond:[1,4],cost:[6,8],could:[6,9,12],council:[0,1,2,4,5,10,11,13,14],cover:12,creat:[0,4,10,11,14,15],creativ:13,cross:15,ctarget:4,cumbersom:1,current:[0,2,4,5,9,13],dai:7,data:4,debat:1,decid:[1,12],decis:[0,10],declar:12,dedic:[9,12],defer:8,defici:10,defin:[1,5,8,11,14],definit:[5,13],delai:[8,15],delet:6,depclean:12,depend:[3,5,6,7,8,12,14],dependent_slot:12,deprec:[5,15],deriv:12,design:[3,5,13],desir:15,detail:11,detect:[0,1],dev:[1,4,9,12,14],develop:[0,1,3,4,5,7,9,10,13,14,15],devmanu:[10,11],did:[6,10,12],die:6,differ:[0,1,3,12],difficult:4,direct:[0,12],directli:[0,8,10],directori:[3,4],disabl:[1,12],disagre:[0,11],disciplinari:0,discourag:[6,14],discov:14,discuss:[11,14],distinguish:[9,14],distribut:[4,11],distro:15,doc:4,document:[0,5,12,13],doe:[1,6,7,9,11,12],done:11,dosym:4,doubt:[0,15],down:[0,10],download:12,downward:15,drop:[5,9],dropping_stable_keyword:7,due:[1,4,6,7],duplic:7,dure:[1,4],dynam:[1,3,4,5,15],each:[0,1,10,12],eapi:[5,11],earli:[4,8],easi:[0,12],easier:[0,14],easili:9,eblit:3,ebuild:[0,1,2,4,5,6,8,10,11,12],eclass:[1,5,12,15],eclassdoc:2,edit:[3,10],editor:3,educ:0,effect:12,effort:[0,7],eight:10,either:[1,4,6,7,8,12,14],ekeyword:3,elog:1,emerg:12,enabl:[1,6,12,14],encourag:3,end:[0,8,9,14],enforc:[3,5,11,12],enough:12,ensur:[1,4,8,12],entri:[3,15],equal:1,equival:1,error:[1,3,12],especi:[1,4],establish:10,etc:[0,3,4],eutil:1,eval:3,even:[1,12,14],everi:10,exampl:[1,4,6,9,12],except:[1,4,7],execut:[0,4,12],exempt:7,exist:[1,2,8,12,14,15],expect:[0,2],experi:0,experienc:[0,1],experiment:7,explan:10,explicit:[1,12],explicitli:[1,3,6,8,9,10,12,14,15],exponenti:8,express:[12,14],extend:14,extern:[3,5],fact:1,facto:10,fail:12,fallback:6,far:[0,10,12],fatal:[4,12],favor:15,featur:[1,12],few:[3,14],file:[0,2,5,7,9,10,12],filesystem:[4,11],find:[6,9,10,12],first:[6,7],fit:9,fix:[0,9,15],flag:[0,5,6],flat:[10,14],flip:1,focu:0,focus:[0,10],follow:[0,4,6,7,9,11,15],foo:[1,3],forbidden:[3,9,12],form:[3,10,14],formal:10,format:[5,11,12],former:[1,10],found:[4,10],free:15,frequent:[8,9],frobnic:4,from:[1,3,4,7,9,10,12,15],fulfil:4,full:[4,6],fulli:3,further:[0,15],furthermor:[1,3,4,9,10,12],futur:[1,7,9,11,14,15],game:5,gamestat:4,gap:15,gener:[3,4,6,11,12,14],gentoo:[0,1,2,3,4,7,8,9,10,12,13,14,15],get:1,gid:15,git:[2,4],github:3,gitweb:[2,4],give:8,glep:[0,1,5,15],global:[5,12,13,14],gnu:4,goal:[5,6],goe:3,going:[6,10],good:[1,4,12,15],govern:0,gpl:12,grab:9,gracefulli:[8,12],grant:4,graph:[1,7,8],grep:[3,9],group:[4,5,9],grow:8,gtk2:[1,14],gtk3:14,gtk:14,guarante:[8,12],gui:5,guid:[11,13],guidelin:[4,11],guix:4,hack:4,had:[1,7],hand:3,handl:[8,12],hard:[3,9,10,12,14],hardcod:[4,6],harder:3,harm:[6,12],has:[1,3,4,6,8,12,14,15],have:[1,3,6,7,8,12,15],help:[0,1,3,9],helper:8,here:[6,7,10],hierarch:14,hierarchi:4,high:4,highest:11,highlight:3,his:[0,8],histor:[1,3,4,5,6,12,14,15],histori:5,hold:4,homepag:5,host:4,hour:6,how:[1,10,11],howev:[6,7,10,11,12],http:[1,2,3,4,7,8,12,14,15],huge:6,hyphen:14,idea:1,identifi:12,imit:14,immedi:[1,7],immin:15,implement:[0,1,8,11,12],impli:4,implicitli:1,impos:11,imposs:6,improv:14,inappropri:9,incident:3,includ:[0,1,3,4,6,9,12],inconsist:4,increas:[1,9],indent:3,independ:7,index:[1,3,5,7,12,14],indic:[0,1,2,4,10,13],individu:[2,3],infer:[1,12],inform:[1,5,9,10,12],init:12,initramf:4,insid:2,instal:[0,1,5,8,12,14],install_mask:6,instead:[1,4,8],instruct:11,intend:10,interchang:1,interest:[7,9],intern:13,introduc:[6,8,14],introduct:[5,14],invalid:12,invari:12,investig:3,involv:0,ish:3,isol:4,issu:[0,6,8,14],its:[1,4,8,10,11],itself:11,ius:12,job:12,justifi:15,keep:6,kept:7,keyword:5,kind:0,knowledg:9,known:[0,7,12],lack:10,languag:5,larg:[3,9,10],larger:4,last:[7,9],later:8,latter:[1,4,10,12,14],layout:[2,5,11],lead:15,least:[1,3,7,12],leav:[3,15],lengthen:14,less:[0,3,10,12],level:[3,4,11],lib64:4,lib:[1,4,6],libbar:1,libexec:4,libfoo:1,libfrobn:1,libpython:8,librari:[1,5],libreoffic:6,libtool:5,licens:5,life:8,like:14,likeli:0,likewis:1,limit:[0,3],line:5,liner:6,link:[1,5,6,8,12],linker:[0,4],lint:[0,3],linux:11,list:[0,2,4,6,9,10,11,12,15],liter:3,littl:[3,12],load:3,loader:[4,6],local:[6,14],locat:[3,5,6,12],log:[1,4,10,14],logic:[1,10],longer:[1,4,9],lose:[1,8],lost:9,lot:10,low:14,lowest:15,made:[4,14],mai:[1,4,6,11,14],mail:[0,7,9,11],maintain:[0,2,4,5,7,8,10,11,13],mainten:[3,8,9],major:[0,8,11,12,15],make:[1,3,4,5,6,8,9,10,12,14],manag:[0,1,4,5,12],mani:[1,4,6,8,9,11,12],manual:[5,14],marker:12,match:[1,8,15],mean:[1,14],meaning:5,meant:[5,7,9,13],measur:0,meet:[1,4,10,14],member:[0,9],mention:10,mere:9,messag:[1,12,14],metadata:[2,4,5,9],method:3,mgorni:13,might:6,migrat:[2,15],minim:8,minor:[0,7],mismatch:14,miss:[1,12],mistak:[0,1,12],modern:4,modifi:3,modul:8,moment:1,more:[3,6,10,11,12,14],most:3,motiv:5,mount:4,move:[3,4],mtab:4,much:[6,12],multi:3,multilib:5,multipl:[3,12,14],multislot:5,must:[1,4,5,6,7,8,9,14,15],name:[3,4,5,6],necessari:[1,6,9,14],need:[1,4,6,9,10,11,12,14,15],needless:1,neg:[6,7],neglect:7,neither:9,never:[4,6,10],nevertheless:11,newer:2,newest:1,newli:14,next:15,nix:4,no_homepag:12,non:[0,1,3,4,7,10,12],nonfunct:1,nor:[1,9],normal:[4,12],noth:12,notic:[1,6],number:[3,8,9,15],obsolet:10,obtain:14,offer:14,often:[7,9],old:[1,4,7,8,9,12],oldid:[1,7,12,14],omit:12,onc:[1,3,7,9],one:[1,4,6,7,8,9,12],ones:15,onli:[1,3,4,6,7,10,11,12],open:[1,15],oper:[5,11],oppon:1,opportun:1,opt:4,optfeatur:1,option:[5,12,14],order:[0,1,4,6,8,10,12],org:[1,2,3,4,7,8,12,14,15],organ:10,origin:[9,10,12],other:[0,1,3,4,5,6,7,8,9,10,13,14],otherwis:[1,6],out:[1,8,9,10,14],over:[0,7],overlai:12,overlap:3,overrid:[0,11],overspecifi:12,own:4,ownership:5,packag:[0,2,3,4,5,6,7,8,12,14,15],page:[3,5,10,11],paludi:1,parallel:12,part:[1,3,4,10],partial:[3,10,11],particular:[6,10],partit:4,past:[3,10],path:[0,5,6],per:14,period:0,permit:[1,3,4,9,12],person:[0,7,14],phase:[0,3,8,14],php:[1,7,12,14],pkg:6,pkgcheck:[0,1,2,3,4,7,8,12,14,15],place:[1,6,7],plain:[1,3],pleas:[9,12],plugin:6,point:[1,4,6,10],pointless:15,polici:[1,2,6,7,9,12,13,14],port:8,portabl:[0,1,6],portag:[1,4],posix:[3,5],possibl:[0,1,3,8,9,10],potenti:[6,12],practic:[0,6],pre:12,precis:10,predict:1,prefac:5,prefer:[1,8,14],prepar:8,preprocess:3,prerequisit:12,present:12,prevent:[1,9,15],previou:[0,1,7],primari:[10,12],primit:15,principl:3,prioriti:14,privat:1,privileg:4,proactiv:[2,5],problem:[0,1],proc:4,proceed:7,process:[3,5,7,11,13,15],profil:[4,9],program:[6,8,9],proj:4,project:[0,1,3,4,5,6,7,8,9,10,11,12,13,14],prolifer:6,prone:3,propag:1,proper:14,propon:1,propos:1,protect:12,provid:[0,6,8,10,11,12,15],pull:1,purpos:[4,5,12],push:[0,15],pypi:3,python:[5,9],python_2_end:8,python_compat:8,python_gen_cond_dep:8,python_single_target:8,python_single_usedep:8,python_target:8,python_usedep:8,qt4:14,qt5:14,qualiti:0,quality_assur:[1,7,12,14],queri:[10,12],question:[0,1,4,7,9,12],rang:[1,15],rapid:15,rather:[3,10,11,14],rational:[1,3,4,5,6,7,8,9,10,12,13,14,15],reach:8,readabl:4,readi:8,readm:1,realli:[6,10],reason:[1,4,15],reassign:9,rebuild:[1,6],recommend:[3,6,11,14,15],reconsid:1,recoveri:[4,6],reduc:[0,3,8],refer:[1,2,4,5,7,8,10,12,14,15],refin:1,refus:[0,9],regard:0,regular:[14,15],reject:10,rekeyword:5,rel:4,relat:[0,10],relev:[0,7,12],reli:[1,4],reliabl:[0,8],remain:7,rememb:12,remov:[1,5,6,8,12,14,15],render:3,repair:4,repeat:[0,3],replac:[6,10,14],repo:[2,4],repoman:[0,1,2,3,4,7,15],report:[0,1,2,3,4,6,7,8,9,12,14,15],repositori:[0,10,11,12],request:[0,1,7,15],requir:[1,4,6,8,10,11,12,15],resembl:14,reserv:[14,15],resign:9,resolv:[0,12],respond:7,respons:[1,12,14,15],restrict:[1,4,5,10,11],result:[1,15],retest:7,retir:8,reus:15,revers:[1,6,8],review:[11,15],revis:[4,5],risk:0,rite:7,role:0,root:4,rootf:4,rule:[3,7,11,12,14,15],run:[0,4],runtim:[5,8,12],same:[0,12,15],sbin:4,scale:10,scan:0,scatter:10,scope:12,score:4,script:[4,8,12],search:5,second:15,section:1,secur:6,select:15,self:4,send:9,separ:[5,12],serv:15,servic:[0,6],set:[1,3,5,10,13,14],setgid:4,setup:[0,4],share:[4,6],sharealik:13,shell:6,shorter:14,should:[0,1,2,4,6,7,8,10,11,12,14,15],side:1,silent:9,similar:12,simpl:[14,15],simplest:12,simpli:1,simplifi:15,simultan:12,sinc:[3,4,6,12,14],singl:[5,10,12],size:6,skip:12,slack:7,slot:[5,8],small:[4,5,9],smaller:6,softwar:[0,4,11],sole:9,solut:1,some:[4,7,10,12],soon:8,sooner:8,sourc:[1,2,3,4,5,6,7,8,9,10,12,13,14,15],space:[4,12],span:1,special:[4,5,12,14],specif:[0,1,5,6,10,12,13,14],specifi:[1,3,11,12],spend:6,spirit:10,split:9,src:4,src_uri:5,srv:4,stabil:5,stabl:[1,5],stale:10,standard:[3,5],start:[1,10,15],state:[4,5,12],still:[1,4,7,14],store:2,strict:5,strictli:[4,12],strip:6,strongli:6,style:[1,5],sub:5,subdirectori:4,subpag:12,subsequ:11,subset:7,subslot:5,subtli:4,success:15,suffer:9,suffici:10,suffix:4,suggest:11,summari:[1,4,14],supplement:[0,6],suppli:[5,13],support:[0,1,3,5,6,8,12,14],suppos:4,sure:[3,9],surpris:[0,3],symbol:5,symlink:4,sync:15,synchron:15,syntax:3,system:[0,5,6,11,12,15],systemd:[0,6],tab:3,tag:2,take:[0,1,7,9],target:5,task:0,team:[0,3,4,5,7,9,10,13,14],technic:[4,6,9,10,11,12,14],temporarili:12,tent:1,term:8,termin:3,test:[0,3,5],text:13,than:[0,3,6,8,10,11,14],thei:[0,1,4,6,7,9,12,14],them:[0,4,6,9,10,11,14],themselv:6,therefor:[1,3,4,5,10,13],thi:[0,1,3,4,6,7,9,10,11,12,13,14,15],those:[0,3,4,8,9,12],three:[0,1],through:[8,11],tild:1,time:[0,1,7,8,10,12],timefram:1,tini:6,tip:10,titl:[1,7,12,14],todai:6,toggl:1,tool:[0,1,3,6],toolchain:[4,12],toolkit:14,top:4,tracker:12,tree:[0,2,4,5,10,11,13],trigger:[0,12],triplet:4,trivial:[0,12],turn:[10,12],two:[0,12],txt:[1,4,14,15],udev:4,uid:15,unclear:10,uncommon:[1,6],uncondition:[6,12],undefin:12,under:[1,12,13],underscor:5,understand:10,unfair:9,unit:[0,6],unless:[1,6,8,9,15],unmaintain:9,unnecessari:[3,6,7,8,14],unnecessarili:[1,14],unpredict:12,unprefix:14,unreli:1,unset:12,until:8,unus:3,unwilling:0,updat:[1,2,5,10,11,13,15],upgrad:[8,12],upon:11,upstream:[4,8,12],uri:3,usag:[1,5,10],use:[0,2,3,4,5,6,8,10,12,14,15],use_expand:14,used:[1,2,3,4,6,8,9,12,14,15],usefulness:3,user:[0,1,4,5,6,8,9,12,14],uses:[1,8,12,14],using:[0,1,2,3,4,6,8,12,15],usr:5,usual:[1,12],valid:14,valu:[1,3,4,5],variabl:[5,8],variant:4,variou:[0,9,10,14],verbatim:3,veri:[1,4,6,9,10,14,15],verifi:[1,12],version:[1,2,3,4,5,12,15],versioned_use_flag:14,via:[3,4,10,11,12,14,15],violat:[0,12],wai:[1,10,12,14],want:[7,14],warn:1,wast:4,web:[4,12],well:[3,5,7,10,11,12,13],were:[1,3,6,7,10,12,15],what:9,when:[0,1,2,3,4,6,9,11,12,14],whenev:[1,3,4,6,7,11,12,14],where:4,whether:[0,1,7],which:[1,3,5,7,10,12,13,14],who:[1,6,7,9,10,14],whole:8,why:9,wide:0,wider:10,widget:14,width:3,wiki:[1,7,8,10,11,12,14],wildcard:1,wish:[6,14],within:[1,4,5,7,9,14],without:[0,3,4,5],word:10,work:[0,3,4,7,12,13,14],world:4,wors:9,would:[4,10],wrap:3,writabl:4,written:[0,1,9,10],wrong:[4,12],www:12,xml:9,yet:1,you:1,your:1,zeroth:1},titles:["Basic information","Dependencies","Deprecations","Ebuild file format","File system layout","Gentoo Policy Guide","Installed files","Keywording and stabilization","Language-specific policies","Package Maintainers","Motivation and history","Other policy documents","Other metadata variables","Preface","USE flags","Users and groups"],titleterms:{"case":1,"new":[7,9],"static":[4,6],Adding:9,FHS:11,USE:[1,12,14],absolut:4,account:15,appeal:0,author:13,basic:0,bump:1,chang:[0,1],check:0,code:3,complianc:0,contain:3,defin:3,depend:1,deprec:[2,8],develop:11,document:[10,11],drop:7,dynam:12,eapi:2,ebuild:3,eclass:[2,3,8],enforc:0,extern:11,file:[3,4,6],flag:[1,12,14],format:3,game:4,gentoo:[5,11],glep:11,goal:0,group:15,gui:14,guid:[5,10],histor:10,histori:10,homepag:[3,12],indic:5,inform:0,instal:[4,6],introduct:13,keyword:[3,7],languag:8,layout:4,librari:[4,6],libtool:[4,6],licens:[12,13],line:3,link:4,locat:4,maintain:9,make:0,manag:11,manual:11,meaning:12,metadata:12,motiv:10,multilib:4,multislot:12,must:[3,12],name:14,oper:1,option:1,other:[11,12],ownership:4,packag:[1,9,11],path:4,polici:[0,5,8,10,11,15],posix:11,prefac:13,proactiv:1,purpos:10,python:8,refer:3,rekeyword:7,remov:[7,9],restrict:12,revis:1,runtim:1,separ:4,singl:3,slot:[1,12],small:6,special:1,specif:[8,11],src_uri:3,stabil:7,stabl:7,standard:11,state:10,strict:4,style:3,sub:1,subslot:1,support:4,symbol:4,system:4,tabl:5,target:4,test:12,todo:[4,7,14],underscor:14,usag:8,use:1,user:15,usr:4,valu:12,variabl:[3,12],version:[7,14],within:3,without:[1,9]}})
\ No newline at end of file +Search.setIndex({docnames:["basics","dependencies","deprecation","ebuild-format","filesystem","index","installed-files","keywords","languages","maintainer","motivation","other-docs","other-metadata","preface","use-flags","user-group"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":4,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.todo":2,sphinx:56},filenames:["basics.rst","dependencies.rst","deprecation.rst","ebuild-format.rst","filesystem.rst","index.rst","installed-files.rst","keywords.rst","languages.rst","maintainer.rst","motivation.rst","other-docs.rst","other-metadata.rst","preface.rst","use-flags.rst","user-group.rst"],objects:{},objnames:{},objtypes:{},terms:{"0":[13,15],"0001":1,"0002":1,"0003":1,"0011":1,"0012":1,"0021":1,"0101":3,"0102":3,"0103":3,"0104":3,"0105":3,"0201":4,"0202":4,"0203":4,"0204":4,"0205":4,"0206":4,"0301":6,"0302":6,"0303":6,"0304":6,"0401":7,"0402":7,"0403":7,"0501":8,"0502":8,"0601":9,"0602":9,"0603":9,"0701":12,"0702":12,"0703":12,"0704":12,"0801":14,"0802":14,"0803":14,"08gentoo":4,"0901":15,"1":[1,11],"100":[1,15],"1001":2,"1003":2,"101":15,"104017":1,"109991":[12,14],"126033":7,"2":[1,5,12,14],"2013":4,"20130813":4,"20130924":4,"20151011":[1,4],"20151213":4,"2016":12,"2019":8,"20191013":14,"2fuse":12,"3":[1,8,14],"4":[1,13],"48":0,"499":15,"5":1,"612630":3,"62":1,"64":4,"702460":15,"80librari":4,"80multilib":4,"81":15,"83cc5bbd7bbe8bdf04dd3c3bc7f8a035":12,"90":7,"999":15,"9cae3a92412a007febe7ac0612d50f5f":1,"break":[3,8],"case":[0,4,5,7,12],"class":0,"default":[1,6],"do":[1,3,6,8,12],"final":[0,10,11],"function":[0,3,4,8],"g\u00f3rny":13,"import":[1,8,12,15],"long":[1,7,8,12],"micha\u0142":13,"new":[2,4,5,8,10,14,15],"public":1,"static":[5,12],"switch":14,"true":15,"try":[0,3,9],"var":4,"while":[0,1,3,6,12],A:15,As:4,At:10,By:[0,1],For:[1,4,9],If:[0,1,3,4,6,7,9,12,14,15],In:[0,1,4,8,11,12,14],It:[0,1,3,5,6,8,9,10,12,13,14,15],Its:[0,10],On:3,Such:[6,12],The:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],There:[1,6,9,10],With:4,abi:[1,4],abil:[3,10,12],abolish:0,about:[6,12],absolut:5,accept:[1,4,12,15],access:4,accident:8,accord:1,account:[1,3,5],acct:15,achiev:0,across:[0,10],action:0,activ:11,actual:9,ad:[1,4,5,6,15],add:[3,9],addit:[3,4,6,10,11],addition:0,address:10,adjust:14,adopt:15,advantag:[3,14],affect:[0,3,7,12],aforement:[4,10],after:[0,1,4],afterward:14,against:[0,3,10,12],agre:9,aid:15,aim:[0,1,5,9,13,14],align:3,all:[0,1,3,5,6,7,8,9,10,11,12,13,14,15],alloc:15,allow:[3,12],along:[4,10],alreadi:[1,4,8,12],also:[0,6,8,10,14],alter:12,alwai:[3,4],amd64:4,amount:10,an:[1,3,4,6,7,9,10,14,15],analyz:0,ani:[1,3,6,9,10,11,12,14],anoth:[1,4,12],anymor:[4,7],anywher:12,api:1,app:6,appeal:5,append:3,appli:[0,1,7,9,10,11],applic:[1,4,6,10,11,12],appropri:[4,12],approv:[1,11,15],ar:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15],arbitrari:15,arch:[3,7],architectur:[0,4,7],archiv:[1,6,12,14],area:0,argu:1,aris:[10,14,15],ask:[0,7],assign:[6,9,15],assum:[1,14],assumpt:[6,12],attempt:[3,6,10,14],attribut:13,author:5,autom:0,autotool:6,avail:[1,10,12,14],avoid:[3,6],awar:9,backup:9,bad:[1,4,12],base:6,baselayout:15,bash:[3,6],basic:[5,11],becom:[1,5,9,13],been:[1,4,6,12,14,15],befor:[0,7,14,15],behavior:[0,1,6,12],being:[1,6,7,8,9,12],besid:11,better:[8,10],between:[4,8,12,14,15],bin:4,binari:12,bind:[5,10,13],bit:4,blurri:4,bodi:[0,5,10,13],boot:4,both:[0,3,5,6,8,13,14],boundari:4,bracket:3,breakag:[1,7],broken:4,brought:6,browser:4,bug:[3,7,9,12,15],build:[0,1,4,6,8,12,14],builtin:3,bump:[2,5,15],bundl:12,burden:9,cach:12,call:[1,8],can:[0,1,4,5,7,10,11,12,13,14,15],care:9,categori:6,caus:[1,6,7,8,12,14],cc:7,certain:6,cf3f5a59ac918335766632bd02438722:14,chanc:[8,9],chang:[3,5,8,11],check:[1,4,5],choic:[3,14],choos:[12,14],chosen:15,chost:4,ci:0,circumst:[1,12],claim:1,clarifi:4,clean:1,clear:[5,10,13,14],close:7,co:0,code:[0,1,5,8,12],collect:10,collis:15,combin:[0,5,10,12,13],comment:9,commit:0,common:[1,3,12,13],compar:9,compat:[4,8],compil:0,complet:[6,10,12],compli:11,complianc:5,compon:0,concept:0,concis:10,condit:[3,12],conf:2,config:6,conform:[10,11],confus:[3,7,14],consent:9,consequ:6,consid:[6,12,14],consist:[0,3,8,14],construct:3,contact:0,contain:[5,9,11,14],content:3,context:6,contrari:12,contribut:0,control:[1,4,6,12,14],controlled_optional_rdepend:1,convert:[3,14],copi:3,correct:[1,4,12],correctli:[0,3,4],correspond:[1,4],cost:[6,8],could:[6,9,12],council:[0,1,2,4,5,10,11,13,14],cover:12,creat:[0,4,10,11,14,15],creativ:13,cross:15,ctarget:4,cumbersom:1,current:[0,2,4,5,9,13],d:[4,12],dai:7,data:4,de:10,debat:1,decid:[1,12],decis:[0,10],declar:12,dedic:[9,12],defer:8,defici:10,defin:[1,5,8,11,14],definit:[5,13],delai:[8,15],delet:6,depclean:12,depend:[3,5,6,7,8,12,14],dependent_slot:12,deprec:[5,15],deriv:12,design:[3,5,13],desir:15,detail:11,detect:[0,1],dev:[1,4,9,12,14],develop:[0,1,3,4,5,7,9,10,13,14,15],devmanu:[10,11],did:[6,10,12],die:6,differ:[0,1,3,12],difficult:4,direct:[0,12],directli:[0,8,10],directori:[3,4],disabl:[1,12],disagre:[0,11],disciplinari:0,discourag:[6,14],discov:14,discuss:[11,14],distinguish:[9,14],distribut:[4,11],distro:15,doc:4,document:[0,5,12,13],doe:[1,6,7,9,11,12],done:11,dosym:4,doubt:[0,15],down:[0,10],download:12,downward:15,drop:[5,9],dropping_stable_keyword:7,due:[1,4,6,7],duplic:7,dure:[1,4],dynam:[1,3,4,5,15],e:[0,1,3,4,5,6,7,10,12,13,14],each:[0,1,10,12],eapi:[5,11],earli:[4,8],easi:[0,12],easier:[0,14],easili:9,eblit:3,ebuild:[0,1,2,4,5,6,8,10,11,12],eclass:[1,5,12,15],eclassdoc:2,ed:[6,7],edit:[3,10],editor:3,educ:0,effect:12,effort:[0,7],eight:10,either:[1,4,6,7,8,12,14],ekeyword:3,elog:1,emerg:12,empti:6,enabl:[1,6,12,14],encourag:3,end:[0,8,9,14],enforc:[3,5,11,12],enough:12,ensur:[1,4,8,12],entri:[3,15],equal:1,equival:1,error:[1,3,12],especi:[1,4],establish:10,etc:[0,3,4],eval:3,even:[1,12,14],everi:10,exampl:[1,4,6,9,12],except:[1,4,7],execut:[0,4,12],exempt:7,exist:[1,2,8,12,14,15],expect:[0,2],experi:0,experienc:[0,1],experiment:7,explan:10,explicit:[1,12],explicitli:[1,3,6,8,9,10,12,14,15],exponenti:8,express:[12,14],extend:14,extern:[3,5],fact:1,facto:10,fail:12,fallback:6,far:[0,10,12],fatal:[4,12],favor:15,featur:[1,12],few:[3,14],fh:5,file:[0,2,5,7,9,10,12],filesystem:[4,11],find:[6,9,10,12],first:[6,7],fit:9,fix:[0,9,15],flag:[0,5,6],flat:[10,14],flip:1,focu:0,focus:[0,10],follow:[0,4,6,7,9,11,15],foo:[1,3],forbidden:[3,9,12],form:[3,10,14],formal:10,format:[5,11,12],former:[1,10],found:[4,10],free:15,frequent:[8,9],frobnic:4,from:[1,3,4,7,9,10,12,15],fulfil:4,full:[4,6],fulli:3,further:[0,15],furthermor:[1,3,4,9,10,12],futur:[1,7,9,11,14,15],g:[0,1,3,4,6,7,10,12,14],game:5,gamestat:4,gap:15,gener:[3,4,6,11,12,14],gentoo:[0,1,2,3,4,7,8,9,10,12,13,14,15],get:1,gid:15,git:[2,4],github:3,gitweb:[2,4],give:8,glep:[0,1,5,15],global:[5,12,13,14],gnu:4,go:[6,10,11],goal:[5,6],goe:3,good:[1,4,12,15],govern:0,gpl:12,grab:9,gracefulli:[8,12],grant:4,graph:[1,7,8],grep:[3,9],group:[4,5,9],grow:8,gtk2:[1,14],gtk3:14,gtk:14,guarante:[8,12],gui:5,guid:[11,13],guidelin:[4,11],guix:4,ha:[1,3,4,6,8,12,14,15],hack:4,had:[1,7],hand:3,handl:[8,12],hard:[3,9,10,12,14],hardcod:[4,6],harder:3,harm:[6,12],have:[1,3,6,7,8,12,15],he:6,help:[0,1,3,9],helper:8,here:[6,7,10],hi:[0,8],hierarch:14,hierarchi:4,high:4,highest:11,highlight:3,histor:[1,3,4,5,6,12,14,15],histori:5,hold:4,homepag:5,host:4,hour:6,how:[1,10,11],howev:[6,7,10,11,12],http:[1,2,3,4,7,8,12,14,15],huge:6,hyphen:14,i:[0,1,3,5,12,13,14],idea:1,identifi:12,imag:6,imit:14,immedi:[1,7],immin:15,implement:[0,1,8,11,12],impli:4,implicitli:1,impos:11,imposs:6,improv:14,inappropri:9,incident:3,includ:[0,1,3,4,6,9,12],inconsist:4,increas:[1,9],indent:3,independ:7,index:[1,3,5,7,12,14],indic:[0,1,2,4,10,13],individu:[2,3],infer:[1,12],inform:[1,5,9,10,12],init:12,initramf:4,insid:2,instal:[0,1,5,8,12,14],install_mask:6,instead:[1,4,8],instruct:11,intend:10,interchang:1,interest:[7,9],intern:13,introduc:[6,8,14],introduct:[5,14],invalid:12,invari:12,investig:3,involv:0,ish:3,isol:4,issu:[0,6,8,14],its:[1,4,8,10,11],itself:11,ius:12,job:12,justifi:15,keep:6,kept:7,keyword:5,kind:0,knowledg:9,known:[0,7,12],la:[4,5],lack:10,languag:5,larg:[3,9,10],larger:4,last:[7,9],later:8,latter:[1,4,10,12,14],layout:[2,5,11],lead:15,least:[1,3,7,12],leav:[3,15],lengthen:14,less:[0,3,10,12],level:[3,4,11],lib64:4,lib:[1,4,6],libbar:1,libexec:4,libfoo:1,libfrobn:1,libpython:8,librari:[1,5],libreoffic:6,libtool:5,licens:[5,6],life:8,like:14,likeli:0,likewis:1,limit:[0,3],line:5,liner:6,link:[1,5,6,8,12],linker:[0,4],lint:[0,3],linux:11,list:[0,2,4,6,9,10,11,12,15],liter:3,littl:[3,12],load:3,loader:[4,6],local:[6,14],locat:[3,5,6,12],log:[1,4,10,14],logic:[1,10],longer:[1,4,9],lose:[1,8],lost:9,lot:10,low:14,lowest:15,made:[4,14],mai:[1,4,6,11,14],mail:[0,7,9,11],maintain:[0,2,4,5,7,8,10,11,13],mainten:[3,8,9],major:[0,8,11,12,15],make:[1,3,4,5,6,8,9,10,12,14],manag:[0,1,4,5,6,12],mani:[1,4,6,8,9,11,12],manual:[5,14],marker:12,match:[1,8,15],mean:[1,14],meaning:5,meant:[5,7,9,13],measur:0,meet:[1,4,10,14],member:[0,9],mention:10,mere:9,messag:[1,12,14],metadata:[2,4,5,9],method:3,mgorni:13,might:6,migrat:[2,15],minim:8,minor:[0,7],mismatch:14,miss:[1,12],mistak:[0,1,12],modern:4,modifi:3,modul:8,moment:1,more:[3,6,10,11,12,14],most:3,motiv:5,mount:4,move:[3,4],mtab:4,much:[6,12],multi:3,multilib:5,multipl:[3,12,14],multislot:5,must:[1,4,5,6,7,8,9,14,15],n:7,name:[3,4,5,6],necessari:[1,6,9,14],need:[1,4,6,9,10,11,12,14,15],needless:1,neg:[6,7],neglect:7,neither:9,never:[4,6,10],nevertheless:11,newer:2,newest:1,newli:14,next:15,nix:4,no_homepag:12,non:[0,1,3,4,7,10,12],nonfunct:1,nor:[1,9],normal:[4,12],noth:12,notic:[1,6],number:[3,8,9,15],obsolet:10,obtain:14,offer:14,often:[7,9],old:[1,4,7,8,9,12],oldid:[1,7,12,14],omit:12,onc:[1,3,7,9],one:[1,4,6,7,8,9,12],ones:15,onli:[1,3,4,6,7,10,11,12],open:[1,15],oper:[5,11],oppon:1,opportun:1,opt:4,optfeatur:1,optim:6,option:[5,12,14],order:[0,1,4,6,8,10,12],org:[1,2,3,4,7,8,12,14,15],organ:10,origin:[9,10,12],other:[0,1,3,4,5,6,7,8,9,10,13,14],otherwis:[1,6],out:[1,8,9,10,14],over:[0,7],overlai:12,overlap:3,overrid:[0,11],overspecifi:12,own:4,ownership:5,packag:[0,2,3,4,5,6,7,8,12,14,15],page:[3,5,10,11],paludi:1,parallel:12,part:[1,3,4,10],partial:[3,10,11],particular:[6,10],partit:4,past:[3,10],path:[0,5,6],per:14,period:0,permit:[1,3,4,9,12],person:[0,7,14],pf:4,pg:[1,2,3,4,6,7,8,9,12,14,15],phase:[0,3,8,14],php:[1,7,12,14],pkg:6,pkgcheck:[0,1,2,3,4,7,8,12,14,15],place:[1,6,7],plain:[1,3],pleas:[9,12],plugin:6,pm:[1,10,11,12],point:[1,4,6,10],pointless:15,polici:[1,6,7,9,12,13,14],port:8,portabl:[0,1,6],portag:[1,4],posix:[3,5],possibl:[0,1,3,8,9,10],potenti:[6,12],practic:[0,6],pre:12,precis:10,predict:1,prefac:5,prefer:[1,8,14],prepar:8,preprocess:3,prerequisit:12,present:12,prevent:[1,9,15],previou:[0,1,7],primari:[10,12],primit:15,principl:3,prioriti:14,privat:1,privileg:4,proactiv:[2,5],problem:[0,1],proc:4,proceed:7,process:[3,5,7,11,13,15],profil:[4,9],program:[6,8,9],proj:4,project:[0,1,3,4,5,6,7,8,9,10,11,12,13,14],prolifer:6,prone:3,propag:1,proper:14,propon:1,propos:1,protect:12,provid:[0,6,8,10,11,12,15],pull:1,purpos:[4,5,12],push:[0,15],pypi:3,python:[5,9],python_2_end:8,python_compat:8,python_gen_cond_dep:8,python_single_target:8,python_single_usedep:8,python_target:8,python_usedep:8,qa:[0,1,3,4,5,6,7,9,10,12,13,14,15],qt4:14,qt5:14,qt:5,qualiti:0,quality_assur:[1,7,12,14],queri:[10,12],question:[0,1,4,7,9,12],r0:1,r1:[1,8],r3:1,rang:[1,15],rapid:15,rather:[3,10,11,14],rational:[1,3,4,5,6,7,8,9,10,12,13,14,15],reach:8,readabl:4,readi:8,readm:1,realli:[6,10],reason:[1,4,15],reassign:9,rebuild:[1,6],recommend:[3,6,11,14,15],reconsid:1,recoveri:[4,6],reduc:[0,3,8],refer:[1,2,4,5,7,8,10,12,14,15],refin:1,refus:[0,9],regard:0,regular:[14,15],reject:10,rekeyword:5,rel:4,relat:[0,10],relev:[0,7,12],reli:[1,4,6],reliabl:[0,8],remain:7,rememb:12,remov:[1,5,6,8,12,14,15],render:3,repair:4,repeat:[0,3],replac:[6,10,14],repo:[2,4],repoman:[0,1,2,3,4,7,15],report:[0,1,2,3,4,6,7,8,9,12,14,15],repositori:[0,10,11,12],request:[0,1,7,15],requir:[1,4,6,8,10,11,12,15],resembl:14,reserv:[6,14,15],resign:9,resolv:[0,12],respond:7,respons:[1,12,14,15],restrict:[1,4,5,10,11],result:[1,15],retest:7,retir:8,reus:15,revers:[1,6,8],review:[11,15],revis:[4,5],risk:0,rite:7,role:0,root:4,rootf:4,rule:[3,7,11,12,14,15],run:[0,4],runtim:[5,8,12],s:[1,9,11,12,14],same:[0,12,15],sbin:4,scale:10,scan:0,scatter:10,scope:12,score:4,script:[4,8,12],search:5,second:15,section:1,secur:6,select:15,self:4,send:9,separ:[5,12],serv:15,servic:[0,6],set:[1,3,5,10,13,14],setgid:4,setup:[0,4],share:[4,6],sharealik:13,shell:6,shorter:14,should:[0,1,2,4,6,7,8,10,11,12,14,15],side:1,silent:9,similar:12,simpl:[14,15],simplest:12,simpli:1,simplifi:15,simultan:12,sinc:[3,4,6,12,14],singl:[5,10,12],size:6,skip:12,slack:7,slot:[5,8],small:[4,5,9],smaller:6,so:[0,4,6,10,12],softwar:[0,4,11],sole:9,solut:1,some:[4,6,7,10,12],soon:8,sooner:8,sourc:[1,2,3,4,5,6,7,8,9,10,12,13,14,15],space:[4,12],span:1,special:[4,5,12,14],specif:[0,1,5,6,10,12,13,14],specifi:[1,3,11,12],spend:6,spirit:10,split:9,src:4,src_uri:5,srv:4,stabil:5,stabl:[1,5],stale:10,standard:[3,5],start:[1,10,15],state:[4,5,12],still:[1,4,7,14],store:2,strict:5,strictli:[4,12],strip:6,strongli:6,style:[1,5],sub:5,subdirectori:4,subpag:12,subsequ:11,subset:7,subslot:5,subtli:4,success:15,suffer:9,suffici:10,suffix:4,suggest:11,summari:[1,4,14],supplement:[0,6],suppli:[5,13],support:[0,1,3,5,6,8,12,14],suppos:4,sure:[3,9],surpris:[0,3],symbol:5,symlink:4,sync:15,synchron:15,syntax:3,system:[0,5,6,11,12,15],systemd:[0,6],t:1,tab:3,tag:2,take:[0,1,7,9],target:5,task:0,team:[0,3,4,5,7,9,10,13,14],technic:[4,6,9,10,11,12,14],temporarili:12,tent:1,term:8,termin:3,test:[0,3,5],text:13,than:[0,3,6,8,10,11,14],thei:[0,1,4,6,7,9,12,14],them:[0,4,6,9,10,11,14],themselv:6,therefor:[1,3,4,5,10,13],thi:[0,1,3,4,6,7,9,10,11,12,13,14,15],those:[0,3,4,8,9,12],three:[0,1],through:[8,11],tild:1,time:[0,1,7,8,10,12],timefram:1,tini:6,tip:10,titl:[1,7,12,14],todai:6,toggl:1,tool:[0,1,3,6],toolchain:[4,12],toolkit:14,top:4,tracker:12,tree:[0,2,4,5,10,11,13],trigger:[0,12],triplet:4,trivial:[0,12],turn:[10,12],two:[0,12],txt:[1,4,14,15],udev:4,uid:15,unclear:10,uncommon:[1,6],uncondition:[6,12],undefin:12,under:[1,12,13],underscor:5,understand:10,unfair:9,unit:[0,6],unless:[1,6,8,9,15],unmaintain:9,unnecessari:[3,6,7,8,14],unnecessarili:[1,14],unpredict:12,unprefix:14,unreli:1,unset:12,until:8,unus:3,unwilling:0,up:9,updat:[1,2,5,10,11,13,15],upgrad:[8,12],upon:11,upstream:[4,8,12],uri:3,us:[0,2,3,4,5,6,8,9,10,15],usag:[1,5,10],use_expand:14,user:[0,1,4,5,6,8,9,12,14],usr:5,usual:[1,12],v2:1,valid:14,valu:[1,3,4,5],variabl:[5,6,8],variant:4,variou:[0,9,10,14],verbatim:3,veri:[1,4,6,9,10,14,15],verifi:[1,12],version:[1,2,3,4,5,12,15],versioned_use_flag:14,via:[3,4,10,11,12,14,15],violat:[0,12],virtual:5,wa:[0,4,7,9,10,12],wai:[1,10,12,14],want:[7,14],warn:1,wast:4,we:[1,3,12],web:[4,12],well:[3,5,7,10,11,12,13],were:[1,3,6,7,10,12,15],what:9,when:[0,1,2,3,4,6,9,11,12,14],whenev:[1,3,4,6,7,11,12,14],where:4,whether:[0,1,7],which:[1,3,5,6,7,10,12,13,14],who:[1,6,7,9,10,14],whole:8,why:9,wide:0,wider:10,widget:14,width:3,wiki:[1,7,8,10,11,12,14],wildcard:1,wish:[6,14],within:[1,4,5,7,9,14],without:[0,3,4,5],word:10,work:[0,3,4,7,12,13,14],world:4,wors:9,would:[4,6,10],wrap:3,writabl:4,written:[0,1,9,10],wrong:[4,12],www:12,x:14,xml:9,yet:1,you:1,your:1,zeroth:1},titles:["Basic information","Dependencies","Deprecations","Ebuild file format","File system layout","Gentoo Policy Guide","Installed files","Keywording and stabilization","Language-specific policies","Package Maintainers","Motivation and history","Other policy documents","Other metadata variables","Preface","USE flags","Users and groups"],titleterms:{"2":8,"case":1,"new":[7,9],"static":[4,6],absolut:4,account:15,ad:9,appeal:0,author:13,basic:0,bump:1,chang:[0,1],check:0,code:3,complianc:0,contain:3,content:5,defin:3,depend:1,deprec:[2,8],develop:11,document:[10,11],drop:7,dynam:12,eapi:2,ebuild:3,eclass:[2,3,8],enforc:0,extern:11,fh:11,file:[3,4,6],flag:[1,12,14],format:3,game:4,gentoo:[5,11],glep:11,goal:0,group:15,gui:14,guid:[5,10],histor:10,histori:10,homepag:[3,12],indic:5,inform:0,instal:[4,6],introduct:13,keyword:[3,7],la:6,languag:8,layout:4,librari:[4,6],libtool:[4,6],licens:[12,13],line:3,link:4,locat:4,maintain:9,make:0,manag:11,manual:11,meaning:12,metadata:12,motiv:10,multilib:4,multislot:12,must:[3,12],name:14,oper:1,option:1,other:[11,12],ownership:4,packag:[1,9,11],path:4,polici:[0,5,8,10,11,15],posix:11,prefac:13,proactiv:1,purpos:10,python:8,qt:1,refer:3,rekeyword:7,remov:[7,9],restrict:12,revis:1,runtim:1,separ:4,singl:3,slot:[1,12],small:6,special:1,specif:[8,11],src_uri:3,stabil:7,stabl:7,standard:11,state:10,strict:4,style:3,sub:1,subslot:1,support:4,symbol:4,system:4,tabl:5,target:4,test:12,todo:[4,7,14],underscor:14,us:[1,12,14],usag:8,user:15,usr:4,valu:12,variabl:[3,12],version:[7,14],virtual:6,within:3,without:[1,9]}})
\ No newline at end of file diff --git a/std-policy-index.html b/std-policy-index.html index b0f1c7c..93d724d 100644 --- a/std-policy-index.html +++ b/std-policy-index.html @@ -14,11 +14,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" /> @@ -257,6 +259,11 @@ <td> <a href="installed-files.html#pg0303"><code class="xref">PG0303</code></a> <em>(Installation of libtool (.la) files)</em></td><td> <em></em></td></tr> + <tr> + <td></td> + <td> + <a href="installed-files.html#pg0304"><code class="xref">PG0304</code></a> <em>(Virtuals)</em></td><td> + <em></em></td></tr> <tr class="pcap"><td></td><td> </td><td></td></tr> <tr class="cap" id="cap-Keywording and stabilization"><td></td><td> <strong>Keywording and stabilization</strong></td><td></td></tr> @@ -398,7 +405,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 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> diff --git a/use-flags.html b/use-flags.html index 99ef2d6..6cdb6a2 100644 --- a/use-flags.html +++ b/use-flags.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>USE flags — 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="Users and groups" href="user-group.html" /> @@ -130,9 +133,9 @@ - <div class="section" id="use-flags"> + <section id="use-flags"> <h1>USE flags<a class="headerlink" href="#use-flags" title="Permalink to this headline">¶</a></h1> -<div class="section" id="pg0801"> +<section id="pg0801"> <span id="versioned-use-flags"></span><span id="index-0"></span><h2>Versioned USE flags<a class="headerlink" href="#pg0801" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -162,8 +165,8 @@ with the QA team before introduction.</p> of the QA policy on gtk/gtk2/gtk3 flags. The latter policy has been removed since.</p> </div> -</div> -<div class="section" id="pg0802"> +</section> +<section id="pg0802"> <span id="use-gui-flag"></span><span id="index-1"></span><h2>USE=gui flag<a class="headerlink" href="#pg0802" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -191,8 +194,8 @@ adjust flags per package (manually discovering which flags are necessary to obtain the GUI) or enabling multiple toolkits globally which afterwards caused issues with packages supporting a choice between multiple GUIs.</p> -</div> -<div class="section" id="pg0803"> +</section> +<section id="pg0803"> <span id="underscores-in-use-flag-names"></span><span id="index-2"></span><h2>Underscores in USE flag names<a class="headerlink" href="#pg0803" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -224,8 +227,8 @@ unnecessary mismatches between global flags and local flags.</p> distinguishing USE_EXPAND and regular flags easier. It also improves consistency between flag names that historically used hyphens or underscores depending on developer’s personal preference.</p> -</div> -</div> +</section> +</section> @@ -267,7 +270,7 @@ or underscores depending on developer’s personal preference.</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> @@ -307,7 +310,7 @@ or underscores depending on developer’s personal preference.</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> diff --git a/user-group.html b/user-group.html index 87c2515..87e0c16 100644 --- a/user-group.html +++ b/user-group.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>Users and groups — 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="prev" title="USE flags" href="use-flags.html" /> @@ -127,9 +130,9 @@ - <div class="section" id="users-and-groups"> + <section id="users-and-groups"> <h1>Users and groups<a class="headerlink" href="#users-and-groups" title="Permalink to this headline">¶</a></h1> -<span class="target" id="index-0"></span><div class="section" id="pg0901"> +<span class="target" id="index-0"></span><section id="pg0901"> <span id="user-and-group-account-policy"></span><span id="index-1"></span><h2>User and group account policy<a class="headerlink" href="#pg0901" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> <dt class="field-odd">PG</dt> @@ -178,8 +181,8 @@ and using it.</p> explicitly reserved UIDs / GIDs and the ones allocated dynamically by user.eclass (starting from 999 downwards). The lowest GID range has been reserved for true system users and groups.</p> -</div> -</div> +</section> +</section> @@ -214,7 +217,7 @@ been reserved for true system users and groups.</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> @@ -252,7 +255,7 @@ been reserved for true system users and groups.</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> |