mirror of
https://github.com/golang/go
synced 2024-09-05 16:04:50 +00:00
doc: add release note for module deprecation
Fixes #40357 Change-Id: I876edd7364530b77343ebcdd4032390493f8d031 Reviewed-on: https://go-review.googlesource.com/c/go/+/309549 Trust: Jay Conrod <jayconrod@google.com> Run-TryBot: Jay Conrod <jayconrod@google.com> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Bryan C. Mills <bcmills@google.com>
This commit is contained in:
parent
52df9291aa
commit
cde92846e2
|
@ -43,6 +43,21 @@ Do not send CLs removing the interior tags from such phrases.
|
|||
|
||||
<h3 id="go-command">Go command</h3>
|
||||
|
||||
<h4 id="modules">Modules</h4>
|
||||
|
||||
<p><!-- golang.org/issue/40357 -->
|
||||
Module authors may deprecate a module by adding a
|
||||
<a href="/ref/mod#go-mod-file-module-deprecation"><code>// Deprecated:</code>
|
||||
comment</a> to <code>go.mod</code>, then tagging a new version.
|
||||
<code>go</code> <code>get</code> now prints a warning if a module needed to
|
||||
build packages named on the command line is deprecated. <code>go</code>
|
||||
<code>list</code> <code>-m</code> <code>-u</code> prints deprecations for all
|
||||
dependencies (use <code>-f</code> or <code>-json</code> to show the full
|
||||
message). The <code>go</code> command considers different major versions to
|
||||
be distinct modules, so this mechanism may be used, for example, to provide
|
||||
users with migration instructions for a new major version.
|
||||
</p>
|
||||
|
||||
<h4 id="go-get"><code>go</code> <code>get</code></h4>
|
||||
|
||||
<p><!-- golang.org/issue/37519 -->
|
||||
|
|
Loading…
Reference in a new issue