Get Gentoo!
gentoo.org sites
gentoo.org Wiki Bugs Forums Packages
Planet Archives Sources
Infra Status
aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc: fix typosSam James2023-11-113-6/+6
| | | | | | Thanks to codespell. Signed-off-by: Sam James <sam@gentoo.org>
* Migrate from setuptools to Meson and meson-pythonJames Le Cuirot2023-08-025-2/+106
| | | | | | | | | | | This makes Portage PEP 517 compliant. When building via meson-python, the man pages and logrotate config are no longer included as there seems little point. Bug: https://bugs.gentoo.org/910035 Signed-off-by: James Le Cuirot <chewi@gentoo.org> Signed-off-by: Sam James <sam@gentoo.org>
* pyupgrade everythingJohn Helmert III2022-12-031-3/+3
| | | | | Signed-off-by: John Helmert III <ajak@gentoo.org> Signed-off-by: Sam James <sam@gentoo.org>
* doc: ebuild.docbook: drop references to removed EAPIs 4-python and 5-progressSam James2022-07-111-2/+0
| | | | | | Fixes: 328a87e50b0559517ca4b6c016617afc5ac7a2f4 Bug: https://bugs.gentoo.org/857486 Signed-off-by: Sam James <sam@gentoo.org>
* Remove support for EAPIs "4-python" and "5-progress"Matt Turner2022-04-013-409/+0
| | | | Signed-off-by: Matt Turner <mattst88@gentoo.org>
* Reformat to use spaces instead of tabs. Also, use blackWolfgang E. Sanyer2021-09-191-10/+14
| | | | | | | | | | | The following command was used to reformat: autopep8 --in-place --select=E101,E11,E121,E122,E123,E124,E125,E126,E127,E128,E129,E131,E133,E20,E211,E22,E224,E224,E226,E227,E228,E231,E241,E242,E251,E252,E26,E265,E266,E27,E301,E302,E303,E304,E305,E306,W291,W293,W391 -r . black was run as `black .`, using the default configurations Signed-off-by: Wolfgang E. Sanyer <WolfgangESanyer@gmail.com> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Add @changed-subslot package setMatt Turner2021-01-171-0/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This set is the upgradable packages for which the highest visible version has a different subslot than the currently installed version. The primary purpose of this feature is for use in catalyst builds. We update the "seed" stage3 before using it to build a new stage1. Updating the entire stage is expensive and unnecessary (since we're going to build the latest packages in stage1 and then rebuild everything in stage3). What we definitely do need to update in the original stage3 however, is any package that would trigger a subslot rebuild. For example: gcc links with libmpfr.so from dev-libs/mpfr. mpfr's SONAME changes from libmpfr.so.4 (SLOT="0/4") to libmpfr.so.6 (SLOT="0/6"). If the seed stage's dev-libs/mpfr is not updated before emerging gcc, gcc will link with libmpfr.so.4, but the latest version of dev-libs/mpfr will be built and libmpfr.so.6 included into the stage1. Since the old libmpfr.so.4 is not included in the stage1, gcc will not work, breaking subsequent stage builds. Our current options to update the seed are too large a hammer (e.g., "--update --deep --newuse @world" or "--update --deep --newuse --complete-graph --rebuild-if-new-ver gcc") and spend too much time updating seed stages for no gain beyond updating only packages for whom the subslot has changed. With this set, catalyst will likely use emerge @changed-subslot --ignore-built-slot-operator-deps y to update the seed stage. Thank you to Zac Medico for showing me how to do this. Bug: https://bugs.gentoo.org/739004 Signed-off-by: Matt Turner <mattst88@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Typofix: Use just one definite articlePetr Šabata2020-11-211-1/+1
| | | | | | | | | I first noticed this in make.conf(5) but it turned out there were many more occurences of these; fixed with find & sed. Closes: https://github.com/gentoo/portage/pull/634 Signed-off-by: Petr Šabata <contyk@redhat.com> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* doc/api/conf.py: silence redefined-builtin for copyrightAaron Bauman2020-08-021-1/+1
| | | | | | | | * This locally silences the W0622 warning for the override of the copyright which is required. Signed-off-by: Aaron Bauman <bman@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* doc: replace epydoc with sphinx-apidoc + sphinx-epytextZac Medico2020-02-034-0/+117
| | | | | Bug: https://bugs.gentoo.org/707820 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Add QA check for unresolved soname dependencies (bug 704320)Zac Medico2020-01-221-0/+98
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Example output for maven-bin-3.6.2 (bug 704618): * QA Notice: Unresolved soname dependencies: * * /usr/share/maven-bin-3.6/lib/jansi-native/freebsd32/libjansi.so: libc.so.7 libutil.so.9 * /usr/share/maven-bin-3.6/lib/jansi-native/freebsd64/libjansi.so: libc.so.7 libutil.so.9 * This warning comes up when a library or executable has one or more soname dependencies (found in its NEEDED.ELF.2 metadata) that could not be resolved by usual means. If you run ldd on files like these then it will report a "not found" error for each unresolved soname dependency. In order to correct problems with soname dependency resolution, use one or more of the approaches described in the following sections. Content of the NEEDED.ELF.2 metadata file may be useful for debugging purposes. Find the NEEDED.ELF.2 file in the ${D}/../build-info/ directory after the ebuild src_install phase completes, or in the /var/db/pkg/*/*/ directory for an installed package. Each line of the NEEDED.ELF.2 file contains semicolon separated values for a single ELF file. The soname dependencies are found in the DT_NEEDED column: E_MACHINE;path;DT_SONAME;DT_RUNPATH;DT_NEEDED;multilib category External dependencies For packages that install pre-built binaries, it may be possible to resolve soname dependencies simply by adding dependencies for one or more other packages that are known to provide the needed sonames. Removal of unecessary files For packages that install pre-built binaries, it may be possible to resolve soname dependencies simply by removing unnecessary files which have unresolved soname dependencies. For example, some pre-built binary packages include binaries intended for irrelevant architectures or operating systems, and these files can simply be removed because they are unnecessary. Addition of DT_RUNPATH entries If the relevant dependencies are installed in a location that is not included in the dynamic linker search path, then it's necessary for files to include a DT_RUNPATH entry which refers to the appropriate directory. The special $ORIGIN value can be used to create a relative path reference in DT_RUNPATH, where $ORIGIN is a placeholder for the directory where the file having the DT_RUNPATH entry is located. For pre-built binaries, it may be necessary to fix up DT_RUNPATH using patchelf --set-rpath. For example, use patchelf --set-rpath '$ORIGIN' if a given binary should link to libraries found in the same directory as the binary itself, or use patchelf --set-rpath '$ORIGIN/libs' if a given binary should link to libraries found in a subdirectory named libs found in the same directory as the binary itself. For binaries built from source, a flag like -Wl,-rpath,/path/of/directory/containing/libs will create binaries with the desired DT_RUNPATH entry. Addition of DT_SONAME settings If a package installs dynamic libraries which do not set DT_SONAME, then this can lead to unresolved soname dependencies. For dynamic libraries built from source, a flag like -Wl,-soname=foo.so.1 will create a DT_SONAME setting. For pre-built dynamic libraries, it may be necessary to fix up DT_SONAME using patchelf --set-soname. Adjustment to Portage soname resolution logic It may be necessary to adjust Portage soname resolution logic in order to account for special circumstances. For example, Portage soname resolution tolerates missing DT_SONAME for dynamic libraries that a package installs in a directory that its binaries reference via DT_RUNPATH. This behavior is useful for packages that have internal dynamic libraries stored in a private directory. An example is ebtables, as discussed in bug 646190. Bug: https://bugs.gentoo.org/704320 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Clean up remnants of eapi5-hdepend, HDEPEND and targetrootMichał Górny2019-12-263-34/+0
| | | | | | Reviewed-by: Zac Medico <zmedico@gentoo.org> Closes: https://github.com/gentoo/portage/pull/490 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* doc/config/bashrc: document register_die_hook and register_success_hookZac Medico2017-10-241-0/+15
|
* doc: Revert URI changes related to docbook schemaMike Gilbert2016-09-192-2/+2
| | | | | | | This partially reverts b5365341dad167e314023df95d2c5e0f955962f0. X-Gentoo-Bug: 589210 X-Gentoo-Bug-URL: https://bugs.gentoo.org/589210
* refresh many URIs in the code baseMike Frysinger2016-06-286-12/+12
| | | | | Use https where available, and update old links (like www.gentoo.org) to point to the new location.
* Revert "Colorize packages in user sets (bug 577720)"Adam Mills2016-05-271-3/+1
| | | | | | | | | | | | | | | | | | This reverts commit 739845a6eab95fbc44eab1b7b938c860563631d7. The feature implemented in this commit for bug 577720 was determined to be an overcomplicated method of colorizing user sets. Instead, this feature will be implemented as in bug 583164. The configuration options implemented in this reverted commit will be removed. Per bug 583164, packages that belong to a set listed in world_sets will be colorized as world packages. This eliminates the extra configuration and associated complications. See bug 583164 for more details. Acked-by: Alexander Berntsen <bernalex@gentoo.org> Acked-by: Zac Medico <zmedico@gentoo.org Signed-off-by: Alexander Berntsen <bernalex@gentoo.org>
* Colorize packages in user sets (bug 577720)Adam Mills2016-04-251-1/+3
| | | | | | | | | | | | | | Three new settings were added to /etc/portage/color.map: PKG_MERGE_USER_SET, PKG_BINARY_MERGE_USER_SET, and PKG_NOMERGE_USER_SET. These colors are applied when the package is selected from a set in /etc/portage/sets/ X-Gentoo-bug: 577720 X-Gentoo-bug-url: https://bugs.gentoo.org/show_bug.cgi?id=577720 Signed-off-by: Alexander Berntsen <bernalex@gentoo.org> Acked-by: Zac Medico <zmedico@gentoo.org> Reviewed-by: Alexander Berntsen <bernalex@gentoo.org>
* doc: add another strict aliasing linkMike Frysinger2015-07-301-1/+2
|
* Support @profile package set for bug #532224Zac Medico2014-12-111-2/+19
| | | | | | | | | | | | | | | | | | | | | | Add support for a new @profile set which allows the profile to pull in additional packages that do not belong to the @system set. The motivation to have @profile separate from @system is that @system packages may have incomplete dependency specifications (due to long-standing Gentoo policy), and incomplete dependency specifications have deleterious effects on the ability of emerge --jobs to parallelize builds. So, unlike @system, packages added to @profile do not hurt emerge --jobs parallelization. Packages are added to the @profile set in the same way that they are added to the @system set, except that atoms in the @profile set are not preceded with a '*' character. Also, the @profile package set is only supported when 'profile-set' is listed in the layout.conf profile-formats field of the containing repository. X-Gentoo-Bug: 532224 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=532224 Acked-by: Alexander Berntsen <bernalex@gentoo.org>
* docbook: Add missing section tailMichał Górny2014-12-091-1/+9
| | | | | Add missing section tail that I failed to copy properly and that causes docbook to be synctactically incorrect.
* Split @selected into @selected-packages and @selected-setsMichał Górny2014-12-071-5/+13
| | | | | | | Split the big @selected set into separate @selected-packages for plain packages and @selected-sets for subsets. The @selected set is still provided as compatibility wrapper for both, though the new sets are preferred for more flexibility.
* Install Portage using setup.pyMichał Górny2014-09-113-12/+0
|
* Delete some references to deprecated PORTDIR and PORTDIR_OVERLAY variables ↵Arfrever Frehtes Taifersar Arahesis2014-01-061-3/+2
| | | | in documentation.
* EAPI="5-progress": Support case-insensitive matching of extensions in unpack().Arfrever Frehtes Taifersar Arahesis2013-09-111-0/+6
|
* Make keepdir an external ebuild helper program.Ulrich Müller2013-08-222-2/+0
| | | | | This is required by PMS section 11.3.3.8 "Installation commands". Fixes bug #481762.
* Update GNU-stack URLs.Zac Medico2013-02-171-1/+1
|
* EAPI="5-progress": Add automatic unpack dependencies.Arfrever Frehtes Taifersar Arahesis2012-11-241-0/+30
|
* EAPI="5-progress": Add package_manager_build_user() and ↵Arfrever Frehtes Taifersar Arahesis2012-11-161-0/+12
| | | | package_manager_build_group().
* EAPI="4-python" and EAPI="5-progress": Add support for use.aliases and ↵Arfrever Frehtes Taifersar Arahesis2012-11-152-0/+72
| | | | package.use.aliases.
* EAPI="5-progress": Add master_repositories(), repository_path(),Arfrever Frehtes Taifersar Arahesis2012-10-141-0/+30
| | | | available_eclasses(), eclass_path() and license_path() functions.
* Add EAPI 5-hdepend.docbookZac Medico2012-09-243-0/+34
|
* Include usex in the list of helpers banned in global scope inArfrever Frehtes Taifersar Arahesis2012-09-221-0/+1
| | | | documentation of EAPI="5-progress".
* Support EAPI="5-progress".Arfrever Frehtes Taifersar Arahesis2012-09-213-0/+135
|
* Improve allowing of directories on profile level and repository level in ↵Arfrever Frehtes Taifersar Arahesis2012-09-211-2/+5
| | | | EAPI="4-python".
* Enable official EAPI 5 support.v2.2.0_alpha130Zac Medico2012-09-201-20/+20
| | | | | | The council has officialy approved EAPI 5 in PMS: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=99c78a51ff4c9737cdd399620072abdc14f8df11
* Add EAPI 5_pre2 with features approved by councilZac Medico2012-09-111-48/+20
| | | | | | In the 9/11 council meeting, they approved everything in EAPI 5_pre1 except user patches. So, add EAPI 5_pre2 which is identical to EAPI 5_pre1 but with user patches (apply_user_patches) support removed.
* Document EAPI 5_pre1.Zac Medico2012-09-013-0/+262
|
* Rename slot-abi stuff to refer to slot-operator.Zac Medico2012-08-291-6/+6
| | | | | This makes it consistent with the language in the PMS eapi-5 branch: http://git.overlays.gentoo.org/gitweb/?p=proj/pms.git;a=commit;h=5d6749ac9e5ddc5b1daaad7737b65fa81c6ece47
* dohtml: Add .ico, .svg, .xhtml and .xml extensions to default list in ↵Arfrever Frehtes Taifersar Arahesis2012-06-251-0/+6
| | | | EAPI="4-python".
* Reformat documentation of EAPI="4-python".Arfrever Frehtes Taifersar Arahesis2012-06-251-110/+114
|
* Add experimental EAPI 4-slot-abi support.Zac Medico2012-06-223-0/+72
| | | | Refer to 4-slot-abi.docbook for a full description.
* Allow dots in package names in EAPI="4-python".Arfrever Frehtes Taifersar Arahesis2012-05-121-0/+6
|
* Enable globstar shell option by default in EAPI="4-python".Arfrever Frehtes Taifersar Arahesis2012-05-051-0/+6
|
* phases.docbook: add phases for new EAPIsZac Medico2012-04-111-0/+9
|
* Support repository dependencies in EAPI="4-python".Arfrever Frehtes Taifersar Arahesis2012-01-161-2/+36
|
* Update documentation of EAPI="4-python".Arfrever Frehtes Taifersar Arahesis2012-01-081-0/+17
|
* Add some EAPI 4-python docs.Zac Medico2011-12-203-0/+51
|
* sets.docbook: fix 'strictly' spellingZac Medico2011-12-061-1/+1
|
* Fix some typos.Arfrever Frehtes Taifersar Arahesis2011-05-151-2/+2
|
* _eapi4_src_install: handle empty DOCS like PMSZac Medico2011-02-191-1/+1
| | | | This will fix bug #355635.