diff --git a/base/file.jl b/base/file.jl
index 7fa4a288c1d10..81bca9dd65577 100644
--- a/base/file.jl
+++ b/base/file.jl
@@ -1102,6 +1102,8 @@ The directory tree can be traversed top-down or bottom-up.
 If `walkdir` or `stat` encounters a `IOError` it will rethrow the error by default.
 A custom error handling function can be provided through `onerror` keyword argument.
 `onerror` is called with a `IOError` as argument.
+The returned iterator is stateful so when accessed repeatedly each access will
+resume where the last left off, like [`Iterators.Stateful`](@ref).
 
 See also: [`readdir`](@ref).