diff --git a/docs/content/docs.md b/docs/content/docs.md
index c383804dd..49180b0ed 100644
--- a/docs/content/docs.md
+++ b/docs/content/docs.md
@@ -1943,6 +1943,10 @@ with the `--stats` flag.
 This can be used with the `--stats-one-line` flag for a simpler
 display.
 
+To change the display length of filenames (for different terminal widths),
+see the `--stats-file-name-length` option.  The default output is formatted
+for 80 character wide terminals.
+
 Note: On Windows until [this bug](https://github.com/Azure/go-ansiterm/issues/26)
 is fixed all non-ASCII characters will be replaced with `.` when
 `--progress` is in use.