autounmask: Document where changes are writen

diff --git a/man/emerge.1 b/man/emerge.1
index f7ad3ed5a8173bab29621ad5f8b0ab7f9e1bd60b..aa85a7bf27068502b7d1f6f2b4a0e186501cd36e 100644 (file)
--- a/man/emerge.1
+++ b/man/emerge.1
@@ -307,6 +307,10 @@ disable this option by default in \fBmake.conf\fR(5).
 .BR "\-\-autounmask\-write [ y | n ]"
 If \-\-autounmask is enabled, changes are written
 to config files, respecting \fBCONFIG_PROTECT\fR and \fB\-\-ask\fR.
+If the corresponding package.* is a file, the changes are appended to
+it, if it is a directory, changes are written to the lexicographically
+last file. This way it is always ensured that the new changes take
+precedence over existing changes.
 .TP
 .BR \-\-backtrack=COUNT
 Specifies an integer number of times to backtrack if

diff --git a/pym/_emerge/help.py b/pym/_emerge/help.py
index 57b376d55bbac4c0c971b19d8a5b7eb6d523ed05..1e62ccf1dc7c5ef76575c289ad7a88e3493f1533 100644 (file)
--- a/pym/_emerge/help.py
+++ b/pym/_emerge/help.py
@@ -326,7 +326,11 @@ def help(myopts, havecolor=1):
                print("       " + green("--autounmask-write") + " [ %s | %s ]" % \
                        (turquoise("y"), turquoise("n")))
                desc = "If --autounmask is enabled, changes are written " + \
-                       "to config files, respecting CONFIG_PROTECT and --ask."
+                       "to config files, respecting CONFIG_PROTECT and --ask. " + \
+                       "If the corresponding package.* is a file, the changes are " + \
+                       "appended to it, if it is a directory, changes are written to " + \
+                       "the lexicographically last file. This way it is always ensured " + \
+                       "that the new changes take precedence over existing changes."
                for line in wrap(desc, desc_width):
                        print(desc_indent + line)
                print()