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