[gentoo-portage-dev] [PATCH v2 1/2] portage.5: Describe userpatch applying rules in more clean wording

[Nekun]

Bug: https://bugs.gentoo.org/698244
Signed-off-by: Nekun <nekokun@××××××××.cc>
---
Tried to be more compact and precise, as suggested in the Bugzilla discussion
// v2: fix some minor grammar issues

 man/portage.5 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/man/portage.5 b/man/portage.5
index 50f20454c..4e7d8c802 100644
--- a/man/portage.5
+++ b/man/portage.5
@@ -1392,12 +1392,12 @@ following order:
 /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 patches with the same filename exist in multiple directories
+matching the same package, only the patch from the most specific
+directory is applied. An empty patch from a more-specific directory
+discards patches with the same filename from less-specific directories.
+Patches for each package are applied in POSIX lexicographic order. Patch
+filenames 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
-- 
2.26.3