1 |
Signed-off-by: Nekun <nekokun@××××××××.cc> |
2 |
--- |
3 |
Also document eapply|eapply_user|PATCHES and fix override logic description |
4 |
|
5 |
man/portage.5 | 31 +++++++++++++++++++++++++++++++ |
6 |
1 file changed, 31 insertions(+) |
7 |
|
8 |
diff --git a/man/portage.5 b/man/portage.5 |
9 |
index 247ec5ab0..257dc9d17 100644 |
10 |
--- a/man/portage.5 |
11 |
+++ b/man/portage.5 |
12 |
@@ -78,6 +78,9 @@ site-specific overrides of \fB/etc/portage/make.profile/\fR |
13 |
.BR /etc/portage/sets/ |
14 |
user\-defined package sets |
15 |
.TP |
16 |
+.BR /etc/portage/patches/ |
17 |
+user-provided patches to packages |
18 |
+.TP |
19 |
.BR /var/db/repos/gentoo/ |
20 |
.nf |
21 |
sets.conf |
22 |
@@ -1375,6 +1378,34 @@ Also see \fB/var/lib/portage/world_sets\fR and the \fBemerge\fR(1) |
23 |
\fB\-\-list\-sets\fR option. |
24 |
.RE |
25 |
.TP |
26 |
+.BR /etc/portage/patches/ |
27 |
+.RS |
28 |
+In this directory patches to the package source tree can be created. |
29 |
+For each package, patches are taken from these subdirectories in the |
30 |
+following order: |
31 |
+.nr step 1 1 |
32 |
+.IP \n[step]. 3 |
33 |
+/etc/portage/patches/${CATEGORY}/${P}-${PR}[:${SLOT}] |
34 |
+.IP \n+[step]. |
35 |
+/etc/portage/patches/${CATEGORY}/${P}[:${SLOT}] |
36 |
+.IP \n+[step]. |
37 |
+/etc/portage/patches/${CATEGORY}/${PN}[:${SLOT}] |
38 |
+.RE 2 |
39 |
+ |
40 |
+Patches from more-specific directories overrides patches from less-specific, |
41 |
+i.e. if patches with the same name coexist in different directories matches |
42 |
+same package, only patch from directory matches the first matching pattern |
43 |
+will be applied. Patches for each package are applied in the POSIX |
44 |
+lexicographic order. Patch file name must end in ".patch" or, for |
45 |
+\fBEAPI\fR >= \fB6\fR, in ".diff". |
46 |
+ |
47 |
+If package ebuild uses \fBEAPI\fR <= \fB5\fR, it must explicitly invoke |
48 |
+\fBepatch_user\fR or inherit \fBepatch.eclass\fR(5) and rely on default |
49 |
+\fBsrc_prepare\fR for apply patches. Otherwise, patches are silently |
50 |
+ignored. If package ebuild uses \fBEAPI\fR >= \fB6\fR, applying user |
51 |
+patches is mandatory. |
52 |
+.RE |
53 |
+.TP |
54 |
.BR /var/db/repos/gentoo/ |
55 |
.RS |
56 |
.TP |
57 |
-- |
58 |
2.26.3 |