@@ -, +, @@ 
 dodir/keepdir usage.
---
 function-reference/install-functions/text.xml | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)
--- a/function-reference/install-functions/text.xml	
+++ a/function-reference/install-functions/text.xml	
@@ -117,7 +117,9 @@ the first is the source name, the second the name to use when installing.
       <c>dodir</c>
     </ti>
     <ti>
-      Install a directory
+      Install a directory that will be non-empty when the package is
+      merged. For directories that will be empty, please use
+      <c>keepdir</c> instead.
     </ti>
   </tr>
   <tr>
@@ -288,9 +290,13 @@ the first is the source name, the second the name to use when installing.
       <c>keepdir</c>
     </ti>
     <ti>
-      Create a directory which will be preserved by the package
-      manager (This is typically accomplished by inserting an empty
-      <c>.keep_${CATEGORY}_${PN}-${SLOT%/*}</c> file in the directory)
+      Install a directory that will be empty when the package is
+      merged. This is like <c>dodir</c>, but for empty directories
+      instead. As of EAPI 7, <uri
+      link="https://projects.gentoo.org/pms/7/pms.html#x1-14200013.2.2">the
+      handling of empty directories is undefined by the package
+      manager specification</uri>, and the <c>keepdir</c> function
+      exists to ensure that the (otherwise empty) directory is tracked.
     </ti>
   </tr>
   <tr>
--