From: Austin Clements <austin@google.com>
Date: Mon, 2 Nov 2020 16:43:50 +0000 (-0500)
Subject: doc/go1.16: document switch to MADV_DONTNEED
X-Git-Tag: go1.16beta1~352
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=4fcb5068f6aa907166535531862cfd4a3dec6be7;p=gostls13.git

doc/go1.16: document switch to MADV_DONTNEED

Updates #42330.

Change-Id: Ifda10a5c3dca30acf1258e9e0af202e9beffc68e
Reviewed-on: https://go-review.googlesource.com/c/go/+/267137
Trust: Austin Clements <austin@google.com>
Reviewed-by: Michael Knyszek <mknyszek@google.com>
---

diff --git a/doc/go1.16.html b/doc/go1.16.html
index 3592d0b663..5d29307886 100644
--- a/doc/go1.16.html
+++ b/doc/go1.16.html
@@ -161,6 +161,18 @@ Do not send CLs removing the interior tags from such phrases.
   TODO
 </p>
 
+<p><!-- CL 267100 -->
+  On Linux, the runtime now defaults to releasing memory to the
+  operating system promptly (using <code>MADV_DONTNEED</code>), rather
+  than lazily when the operating system is under memory pressure
+  (using <code>MADV_FREE</code>). This means process-level memory
+  statistics like RSS will more accurately reflect the amount of
+  physical memory being used by Go processes. Systems that are
+  currently using <code>GODEBUG=madvdontneed=1</code> to improve
+  memory monitoring behavior no longer need to set this environment
+  variable.
+</p>
+
 <h2 id="compiler">Compiler</h2>
 
 <p>