From d15ffca108b81f15e9042993b80e8b91c56968c4 Mon Sep 17 00:00:00 2001
From: Brad Fitzpatrick <bradfitz@golang.org>
Date: Wed, 2 Jan 2019 18:22:42 +0000
Subject: [PATCH] doc/go1.12: mention Conn.SetDeadline improvements,
 GODEBUG=madvdontneed=1

Fixes #29439
Updates #28466

Change-Id: Ifa0779a089a969f99f1a47127e23565f31eec24f
Reviewed-on: https://go-review.googlesource.com/c/155929
Reviewed-by: Tobias Klauser <tobias.klauser@gmail.com>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
---
 doc/go1.12.html | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/doc/go1.12.html b/doc/go1.12.html
index 527a7c73d45..975550fea4f 100644
--- a/doc/go1.12.html
+++ b/doc/go1.12.html
@@ -313,10 +313,18 @@ for {
   can't reuse existing heap space.
 </p>
 
+<p><!-- CL 146342, CL 146340, CL 146345, CL 146339, CL 146343, CL 146337, CL 146341, CL 146338 -->
+  The Go runtime's timer and deadline code is faster and scales better
+  with higher numbers of CPUs. In particular, this improves the
+  performance of manipulating network connection deadlines.
+</p>
+
 <p><!-- CL 135395 -->
-  On Linux, the runtime now uses MADV_FREE to release unused
+  On Linux, the runtime now uses <code>MADV_FREE</code> to release unused
   memory. This is more efficient but may result in higher reported
   RSS. The kernel will reclaim the unused data when it is needed.
+  To revert to the Go 1.11 behavior (<code>MADV_DONTNEED</code>), set the
+  environment variable <code>GODEBUG=madvdontneed=1</code>.
 </p>
 
 <p><!-- CL 149578 -->