From: Alan Donovan <adonovan@google.com>
Date: Tue, 21 Jun 2016 15:11:50 +0000 (-0400)
Subject: doc: describe vet -lostcancel in go1.7 release notes
X-Git-Tag: go1.7rc1~73
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=eaf4ad6f7493c222a6b27609fcb24e950eb540ab;p=gostls13.git

doc: describe vet -lostcancel in go1.7 release notes

Change-Id: Ie1c95fd0869307551bfcf76bf45c13372723fbba
Reviewed-on: https://go-review.googlesource.com/24288
Reviewed-by: Rob Pike <r@golang.org>
---

diff --git a/doc/go1.7.html b/doc/go1.7.html
index 5f6b6a6934..8a76b369bc 100644
--- a/doc/go1.7.html
+++ b/doc/go1.7.html
@@ -288,6 +288,18 @@ To avoid confusion with the new <code>-tests</code> check, the old, unadvertised
 <code>-test</code> option has been removed; it was equivalent to <code>-all</code> <code>-shadow</code>.
 </p>
 
+<p id="vet_lostcancel">
+The <code>vet</code> command also has a new check,
+<code>-lostcancel</code>, which detects failure to call the
+cancellation function returned by the <code>WithCancel</code>,
+<code>WithTimeout</code>, and <code>WithDeadline</code> functions in
+Go 1.7's new <code>context</code> package (see <a
+href='#context'>below</a>).
+Failure to call the function prevents the new <code>Context</code>
+from being reclaimed until its parent is cancelled.
+(The background context is never cancelled.)
+</p>
+
 <h3 id="cmd_dist">Go tool dist</h3>
 
 <p>