summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* dependencies: Fix a typo in PG 0021HEADmasterUlrich Müller2024-05-181-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tox: Use our fork of tyrian-sphinx-themeMichał Górny2023-09-011-2/+3
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* tox.ini, conf.py: Make it buildUlrich Müller2023-08-172-2/+2
| | | | | | Depend on sphinx<7 and change language to 'en'. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* filesystem: Disallow subdirs in /bin and its friends (PG 0201)Ulrich Müller2023-08-171-0/+4
| | | | | | | | | | | | | | | The FHS says that directories /bin, /sbin and their counterparts in /usr don't contain any subdirectories: https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch03s04.html#requirements2 https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch03s16.html#requirements8 https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch04s04.html#requirements9a https://refspecs.linuxfoundation.org/FHS_3.0/fhs/ch04s10.html#requirements10a Packages that need specific subdirs for binaries should install them in /usr/lib or /usr/libexec. Bug: https://bugs.gentoo.org/912354 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* installed-files: Policy against use-conditional manpagesUlrich Müller2023-01-181-0/+20
| | | | | Closes: https://bugs.gentoo.org/689684 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* installed-files: Indicate when .a files can be removed in installMichał Górny2023-01-141-0/+8
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/18 Signed-off-by: Sam James <sam@gentoo.org>
* tox.ini: Call `make clean`Michał Górny2023-01-141-1/+1
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/23 Signed-off-by: Sam James <sam@gentoo.org>
* Makefile: use a custom `clean` targetMichał Górny2023-01-141-1/+5
| | | | | | | | Replace the Sphinx's `clean` target with a custom one that does not remove the git repository from _build/html. Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Sam James <sam@gentoo.org>
* Add a section on editing and publishingMichał Górny2023-01-142-0/+87
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/10 Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-format: D in other phases is reported by pkgcheckUlrich Müller2023-01-141-1/+1
| | | | | | VariableScope: version 1: variable 'D' used in 'src_configure' on line: 23 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tox.ini: whitelist was renamed to allowlistUlrich Müller2023-01-141-1/+1
| | | | | | ... wasting everybody's time for no reason. :( Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* preface: Add myself as authorUlrich Müller2023-01-131-0/+1
| | | | | | | Main author of PG 0106, 0107, 0304, and some contributions to other policies. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-format: Restrict D to src_install and pkg_preinstUlrich Müller2023-01-131-0/+18
| | | | | | | | | | | | This used to be specified in PMS (see commit ede65b5 in proj/pms.git), but makes more sense as a tree policy. Also exclude pkg_postinst, because nothing in the Gentoo repository appears to use D there, and in the postinst phase the directory will be empty of files anyway. Bug: https://bugs.gentoo.org/890624 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* other-metadata: Sync with the updated LICENSE policy in the devmanualUlrich Müller2022-07-251-11/+8
| | | | | | | | | | | | | | | | | | | | | | | See commit 4a74d85 in the proj/devmanual repository: By the FSF's definition (see for example GPL-3): "The 'Corresponding Source' for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities." It makes much sense to apply this as a general definition. Applying it only to GPL licensed packages would mean: - We would need another case distinction, making the rules for LICENSE even more complicated. - As an example, consider a MIT licensed package with a CDDL licensed (i.e., GPL incompatible) build script: If that package was a library, then it couldn't be linked against a GPL licensed package, whereas a LICENSE variable listing only MIT would falsely indicate that it could. Closes: https://bugs.gentoo.org/860552 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* installed-files: Restrict find to regular filesUlrich Müller2022-04-261-1/+1
| | | | | | | Rationale: libtool .la files are regular files, therefore find -type f is more correct in this context. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-format: LICENSE must not contain variable referencesUlrich Müller2022-04-231-0/+18
| | | | | | As discussed in #gentoo-qa. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* user-group: Update according to today's Council decisionUlrich Müller2021-11-151-3/+3
| | | | | | | | | | Also change the order from downwards to upwards, so that we start allocation in the new range 500..749 progressing upwards. For the existing range 101..499 order doesn't really matter, because it is practically full (as of today, 15 free UIDs and no free GIDs). Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* other-metadata: Add bug reference re multislot flagSam James2021-11-151-1/+1
| | | | | Bug: https://bugs.gentoo.org/174407 Signed-off-by: Sam James <sam@gentoo.org>
* deprecation: Remove obsolete qa-policy.conf linkMichał Górny2021-08-151-1/+0
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* installed-files: Virtuals must not install any files.Ulrich Müller2021-01-261-0/+18
| | | | | Closes: https://bugs.gentoo.org/716970 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* dependencies: update eutils.eclass into optfeature.eclassJoonas Niilola2021-01-261-2/+2
| | | | | | Closes: https://github.com/gentoo/policy-guide/pull/20 Signed-off-by: Joonas Niilola <juippis@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* deprecation: Eclass deprecation is now indicated in eclassdocMichał Górny2020-11-061-3/+2
| | | | | Closes: https://github.com/gentoo/policy-guide/pull/19 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* installed-files: Fix -remove → -deleteMichał Górny2020-09-131-1/+1
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* deprecation: Include deprecated eclassesMichał Górny2020-03-051-0/+18
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/16 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Sort Policy Index keys by PGxx identifiersMichał Górny2020-03-021-1/+3
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/15 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Cover deprecated EAPIsMichał Górny2020-03-021-0/+19
| | | | | | | While this is probably too obvious to require an explicit policy, it makes sense to assign a PG identifier for it. Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Use #pg links in TOCMichał Górny2020-02-251-0/+6
| | | | | | | | Thanks for arzano for the solution. Signed-off-by: Michał Górny <mgorny@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/14 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Copy singlehtml into html directoryMichał Górny2020-02-252-2/+5
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Generate a Policy IndexMichał Górny2020-02-251-3/+75
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Introduce PGnnnn identifiers for policiesMichał Górny2020-02-2513-5/+93
| | | | | | | Introduce stable numeric identifiers for policies, and create permalinks from them. Signed-off-by: Michał Górny <mgorny@gentoo.org>
* ebuild-format: Require KEYWORDS to be on one lineMichał Górny2020-02-211-1/+17
| | | | | | Bug: https://bugs.gentoo.org/639724 Closes: https://github.com/gentoo/policy-guide/pull/13 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* other-metadata: LICENSEMichał Górny2020-02-211-0/+49
| | | | | | Closes: https://bugs.gentoo.org/709020 Closes: https://github.com/gentoo/policy-guide/pull/12 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Use pypi for installing the tyrian-sphinx-themeMax Magorsch2020-01-261-1/+1
| | | | | | Signed-off-by: Max Magorsch <max@magorsch.de> Closes: https://github.com/gentoo/policy-guide/pull/11 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* index: Display full TOCMichał Górny2020-01-221-1/+0
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* other-metadata: RESTRICT="!test? ( test )"Michał Górny2020-01-221-0/+31
| | | | | | Closes: https://bugs.gentoo.org/705892 Closes: https://github.com/gentoo/policy-guide/pull/9 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* other-metadata: meaningful homepage policyMichał Górny2020-01-221-0/+27
| | | | | | Closes: https://bugs.gentoo.org/705866 Closes: https://github.com/gentoo/policy-guide/pull/7 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* dependencies: policy on 4-style USE depsMichał Górny2020-01-211-0/+41
| | | | | | Closes: https://bugs.gentoo.org/705890 Closes: https://github.com/gentoo/policy-guide/pull/8 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* dependencies: include optfeatureJoonas Niilola2020-01-211-2/+3
| | | | | | | | Still used from eutils.eclass before it gets built into EAPI. Signed-off-by: Joonas Niilola <juippis@gentoo.org> Closes: https://github.com/gentoo/policy-guide/pull/3 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* dependencies: =-deps with no revisionMichał Górny2020-01-191-0/+28
| | | | | | Closes: https://bugs.gentoo.org/705842 Closes: https://github.com/gentoo/policy-guide/pull/6 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* filesystem: Policy against absolute symlink targetsMichał Górny2020-01-191-0/+26
| | | | | | Closes: https://bugs.gentoo.org/705830 Closes: https://github.com/gentoo/policy-guide/pull/5 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Rekeywording & stabilization rulesMichał Górny2020-01-191-0/+45
| | | | | | Closes: https://bugs.gentoo.org/705474 Closes: https://github.com/gentoo/policy-guide/pull/2 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Add a chapter on maintainersMichał Górny2020-01-191-0/+73
| | | | | | Closes: https://bugs.gentoo.org/705472 Closes: https://github.com/gentoo/policy-guide/pull/1 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Use a Sphinx theme based on TyrianMax Magorsch2020-01-192-2/+8
| | | | | | | | | | | A Sphinx theme based on Tyrian is used. The theme is automatically installed and applied when using tox. If you are not using tox. please refer to the documentaion of the theme for further installation instructions. Signed-off-by: Max Magorsch <max@magorsch.de> Closes: https://github.com/gentoo/policy-guide/pull/4 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Clean builds upMichał Górny2020-01-132-4/+5
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Separate /usrMichał Górny2020-01-091-0/+19
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Include tox.ini to build via virtualenvMichał Górny2020-01-093-1/+12
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Keep _static and _templates directoriesMichał Górny2020-01-092-0/+0
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Policy making, changing, appealingMichał Górny2020-01-091-0/+16
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Add preface with metadataMichał Górny2020-01-092-0/+33
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Installed file policiesMichał Górny2020-01-092-2/+90
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>