diff --git a/Documentation/git-filter-repo.txt b/Documentation/git-filter-repo.txt
index bc0652b..6c3ae7a 100644
--- a/Documentation/git-filter-repo.txt
+++ b/Documentation/git-filter-repo.txt
@@ -106,7 +106,8 @@ Filtering based on paths (see also --filename-callback)
 
 --use-base-name::
 	Match on file base name instead of full path from the top of
-	the repo.  Incompatible with --path-rename.
+	the repo.  Incompatible with --path-rename, and incompatible
+	with matching against directory names.
 
 Renaming based on paths (see also --filename-callback)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/git-filter-repo b/git-filter-repo
index 476cfcf..a7eca70 100755
--- a/git-filter-repo
+++ b/git-filter-repo
@@ -1777,7 +1777,8 @@ EXAMPLES
                "paths"))
     path.add_argument('--use-base-name', action='store_true',
         help=_("Match on file base name instead of full path from the top "
-               "of the repo.  Incompatible with --path-rename."))
+               "of the repo.  Incompatible with --path-rename, and "
+               "incompatible with matching against directory names."))
 
     rename = parser.add_argument_group(title=_("Renaming based on paths "
                                              "(see also --filename-callback)"))