Document DRILL-8290: Early exit from recursive file listing for LIMIT 0 queries.
diff --git a/_docs/en/sql-reference/sql-commands/084-limit-clause.md b/_docs/en/sql-reference/sql-commands/084-limit-clause.md
index df9f995..1601286 100644
--- a/_docs/en/sql-reference/sql-commands/084-limit-clause.md
+++ b/_docs/en/sql-reference/sql-commands/084-limit-clause.md
@@ -86,6 +86,12 @@
- CONVERT_TOEXTENDEDJSON
- AVG (window function)
+**Recursive file listing in Drill 1.21+**
+Since version 1.21, Drill will exit early from recursive file listing during the planning of a query against filesystem storage if has detected a LIMIT 0 in the outermost SELECT. This optimization is aimed at queries of the following form.
+```
+SELECT * FROM dfs.`huge_directory` LIMIT 0;
+```
+
## Examples
The following example query includes the ORDER BY and LIMIT clauses and returns the top 20 sales totals by month and state:
