From 0377f061687771eddfe8de78d6c40e17d6b21a39 Mon Sep 17 00:00:00 2001
From: "Bryan C. Mills" <bcmills@google.com>
Date: Tue, 17 Dec 2019 14:41:45 -0500
Subject: [PATCH] doc/go1.14: document changes to -mod=readonly and go.mod file
 maintenance

Fixes #36169

Change-Id: Ib9a53fdb0112635b53be38d6818834dd1775e70c
Reviewed-on: https://go-review.googlesource.com/c/go/+/211698
Run-TryBot: Bryan C. Mills <bcmills@google.com>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Jay Conrod <jayconrod@google.com>
---
 doc/go1.14.html | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/doc/go1.14.html b/doc/go1.14.html
index 7a5aff574a7ecb..e7cd53390851e3 100644
--- a/doc/go1.14.html
+++ b/doc/go1.14.html
@@ -124,6 +124,11 @@ <h4 id="go-flags">Flags</h4>
   <a href="https://golang.org/issue/32502">caused the build to fail</a>.
 </p>
 
+<p><!-- golang.org/issue/33326 -->
+  <code>-mod=readonly</code> is now set by default when the <code>go.mod</code>
+  file is read-only and no top-level <code>vendor</code> directory is present.
+</p>
+
 <p><!-- golang.org/issue/31481 -->
   <code>-modcacherw</code> is a new flag that instructs the <code>go</code>
   command to leave newly-created directories in the module cache at their
@@ -159,6 +164,30 @@ <h4 id="incompatible-versions"><code>+incompatible</code> versions</h4>
   include them if reported by a proxy.
 </p>
 
+
+<h4 id="go.mod"><code>go.mod</code> file maintenance</h4>
+<!-- golang.org/issue/34822 -->
+
+<p>
+  <code>go</code> commands other than
+  <code>go</code> <code>mod</code> <code>tidy</code> no longer
+  remove a <code>require</code> directive that specifies a version of an indirect dependency
+  that is already implied by other (transitive) dependencies of the main
+  module.
+</p>
+
+<p>
+  <code>go</code> commands other than
+  <code>go</code> <code>mod</code> <code>tidy</code> no longer
+  edit the <code>go.mod</code> file if the changes are only cosmetic.
+</p>
+
+<p>
+  When <code>-mod=readonly</code> is set, <code>go</code> commands will no
+  longer fail due to a missing <code>go</code> directive or erroneous
+  <code>// indirect</code> comment.
+</p>
+
 <h4 id="module-downloading">Module downloading</h4>
 
 <p><!-- golang.org/issue/26092 -->