From 6396a42b99daab77f6207f6c3011f7ffd7bbe173 Mon Sep 17 00:00:00 2001
From: qmuntal <quimmuntal@gmail.com>
Date: Tue, 12 Dec 2023 19:20:24 +0100
Subject: [PATCH] doc: document Windows os.ReadDir improvements

For #61422.

Change-Id: Icc1868ef9516766d0f422849866ef8de27bfa4c5
Reviewed-on: https://go-review.googlesource.com/c/go/+/549275
Reviewed-by: Mauri de Souza Meneguzzo <mauri870@gmail.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Michael Pratt <mpratt@google.com>
Reviewed-by: Bryan Mills <bcmills@google.com>
Reviewed-by: Alex Brainman <alex.brainman@gmail.com>
---
 doc/go1.22.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/go1.22.html b/doc/go1.22.html
index 3a441f4cf7..233f7e1fb0 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -691,6 +691,15 @@ defer func() {
       On Windows, passing <a href="/pkg/os#O_SYNC"><code>O_SYNC</code></a> to <a href="/pkg/os#OpenFile"><code>OpenFile</code></a> now causes write operations to go directly to disk, equivalent to <code>O_SYNC</code> on Unix platforms.
     </p>
 
+    <p><!-- CL 452995 -->
+      On Windows, the <a href="/pkg/os#ReadDir"><code>ReadDir</code></a>,
+      <a href="/pkg/os#File.ReadDir"><code>File.ReadDir</code></a>,
+      <a href="/pkg/os#File.Readdir"><code>File.Readdir</code></a>,
+      and <a href="/pkg/os#File.Readdirnames"><code>File.Readdirnames</code></a> functions
+      now read directory entries in batches to reduce the number of system calls,
+      improving performance up to 30%.
+    </p>
+
     <p><!-- https://go.dev/issue/58808 -->
       When <a href="/pkg/io#Copy"><code>io.Copy</code></a> copies
       from a <code>File</code> to a <code>net.UnixConn</code>,
-- 
2.48.1