aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNekun <nekokun@firemail.cc>2021-04-11 01:23:26 +0000
committerZac Medico <zmedico@gentoo.org>2021-04-24 20:38:31 -0700
commitf737795e9da830d543a424ab7e74b2151e58fca8 (patch)
treeb2800a9e762420b9a3ad16775056e625d917a67b
parentportage/tests: Be a bit more fancy with argparser (diff)
downloadportage-f737795e9da830d543a424ab7e74b2151e58fca8.tar.gz
portage-f737795e9da830d543a424ab7e74b2151e58fca8.tar.bz2
portage-f737795e9da830d543a424ab7e74b2151e58fca8.zip
man/portage.5: Add userpatch documentation
Bug: https://bugs.gentoo.org/698244 Signed-off-by: Nekun <nekokun@firemail.cc> Signed-off-by: Zac Medico <zmedico@gentoo.org>
-rw-r--r--man/portage.533
1 files changed, 32 insertions, 1 deletions
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