From b1c7703f266a2d72f80f3b55eff822ad7980ce31 Mon Sep 17 00:00:00 2001
From: Hana <hyangah@gmail.com>
Date: Wed, 15 Dec 2021 08:40:30 -0500
Subject: [PATCH] doc/go1.18: discuss embedded build info compatibility

Fixes #50085

Change-Id: I9be8ddb983fb4fe598becbb0b93bb5b7e1f8438f
Reviewed-on: https://go-review.googlesource.com/c/go/+/372214
Trust: Hyang-Ah Hana Kim <hyangah@gmail.com>
Run-TryBot: Hyang-Ah Hana Kim <hyangah@gmail.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Bryan Mills <bcmills@google.com>
---
 doc/go1.18.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/go1.18.html b/doc/go1.18.html
index 9cb3cae20d..2ec5fae8c7 100644
--- a/doc/go1.18.html
+++ b/doc/go1.18.html
@@ -250,6 +250,15 @@ Do not send CLs removing the interior tags from such phrases.
   package.
 </p>
 
+<p><!-- CL 369977 -->
+  The underlying data format of the embedded build information can change with
+  new go releases, so an older version of <code>go</code> may not handle the
+  build information produced with a newer version of <code>go</code>.
+  To read the version information from a binary built with <code>go</code> 1.18,
+  use the <code>go</code> <code>version</code> command and the
+  <code>debug/buildinfo</code> package from <code>go</code> 1.18+.
+</p>
+
 <p><!-- https://golang.org/issue/44435 -->
   If the main module's <code>go.mod</code> file
   specifies <a href="/ref/mod#go-mod-file-go"><code>go</code> <code>1.17</code></a>
-- 
2.52.0