commit: f737795e9da830d543a424ab7e74b2151e58fca8 Author: Nekun <nekokun <AT> firemail <DOT> cc> AuthorDate: Sun Apr 11 01:23:26 2021 +0000 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org> CommitDate: Sun Apr 25 03:38:31 2021 +0000 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=f737795e
man/portage.5: Add userpatch documentation Bug: https://bugs.gentoo.org/698244 Signed-off-by: Nekun <nekokun <AT> firemail.cc> Signed-off-by: Zac Medico <zmedico <AT> gentoo.org> man/portage.5 | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/man/portage.5 b/man/portage.5 index 247ec5ab0..50f20454c 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -1,4 +1,4 @@ -.TH "PORTAGE" "5" "Mar 2021" "Portage VERSION" "Portage" +.TH "PORTAGE" "5" "Apr 2021" "Portage VERSION" "Portage" .SH NAME portage \- the heart of Gentoo .SH "DESCRIPTION" @@ -78,6 +78,9 @@ site-specific overrides of \fB/etc/portage/make.profile/\fR .BR /etc/portage/sets/ user\-defined package sets .TP +.BR /etc/portage/patches/ +user\-provided patches to packages +.TP .BR /var/db/repos/gentoo/ .nf sets.conf @@ -1375,6 +1378,34 @@ Also see \fB/var/lib/portage/world_sets\fR and the \fBemerge\fR(1) \fB\-\-list\-sets\fR option. .RE .TP +.BR /etc/portage/patches/ +.RS +In this directory patches to the package source tree can be created. +For each package, patches are taken from these subdirectories in the +following order: +.nr step 1 1 +.IP \n[step]. 3 +/etc/portage/patches/${CATEGORY}/${P}\-${PR}[:${SLOT}] +.IP \n+[step]. +/etc/portage/patches/${CATEGORY}/${P}[:${SLOT}] +.IP \n+[step]. +/etc/portage/patches/${CATEGORY}/${PN}[:${SLOT}] +.RE 2 + +Patches from more-specific directories overrides patches from less-specific, +i.e. if patches with the same name coexist in different directories matches +same package, only patch from directory matches the first matching pattern +will be applied. Patches for each package are applied in the POSIX +lexicographic order. Patch file name must end in ".patch" or, for +\fBEAPI\fR >= \fB6\fR, in ".diff". + +If package ebuild uses \fBEAPI\fR <= \fB5\fR, it must explicitly invoke +\fBepatch_user\fR or inherit \fBepatch.eclass\fR(5) and rely on default +\fBsrc_prepare\fR for apply patches. Otherwise, patches are silently +ignored. If package ebuild uses \fBEAPI\fR >= \fB6\fR, applying user +patches is mandatory. +.RE +.TP .BR /var/db/repos/gentoo/ .RS .TP
