From 93f427f6031aa6732769ef81e20a3294d4b7994d Mon Sep 17 00:00:00 2001
From: Barrett Ruth <62671086+barrettruth@users.noreply.github.com>
Date: Tue, 28 Jul 2026 05:12:01 -0500
Subject: [PATCH] docs(dir): buffer state discarded by 'bufhidden' #41014

---
 runtime/doc/plugins.txt | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/runtime/doc/plugins.txt b/runtime/doc/plugins.txt
index b80f0f454b..8523f3a032 100644
--- a/runtime/doc/plugins.txt
+++ b/runtime/doc/plugins.txt
@@ -76,7 +76,9 @@ Directory buffers follow the global 'hidden' option by default. To delete them
 after use: >vim
 	autocmd FileType directory setlocal bufhidden=delete
 <
-Use "wipe" to discard all buffer state; see 'bufhidden'.
+A discarded listing is rebuilt on the next visit, so the cursor starts at the
+first entry instead of the one it was left on. "wipe" discards the buffer
+itself, leaving no |alternate-file|; see 'bufhidden'.
 
 
 Replacing the directory browser                                  *dir-disable*