From: Cherry Mui <cherryyz@google.com>
Date: Tue, 16 May 2023 21:26:53 +0000 (-0400)
Subject: doc/go1.21: document wasip1 port
X-Git-Tag: go1.21rc1~482
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=16a0b7fddb63d407b735e23dd7866b3d071e14d5;p=gostls13.git

doc/go1.21: document wasip1 port

Updates #58141.

Change-Id: Iad11e7880efb37e9a1e17daf48d36b886725f75d
Reviewed-on: https://go-review.googlesource.com/c/go/+/495476
Run-TryBot: Cherry Mui <cherryyz@google.com>
Reviewed-by: Eli Bendersky <eliben@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
---

diff --git a/doc/go1.21.html b/doc/go1.21.html
index e483e1e556..421a509fea 100644
--- a/doc/go1.21.html
+++ b/doc/go1.21.html
@@ -31,8 +31,21 @@ Do not send CLs removing the interior tags from such phrases.
 
 <h2 id="ports">Ports</h2>
 
+<h3 id="wasip1">WebAssembly System Interface</h3>
+
+<p><!-- https://go.dev/issue/58141 -->
+  Go 1.21 adds an experimental port to the <a href="https://wasi.dev/">
+  WebAssembly System Interface (WASI)</a>, Preview 1
+  (<code>GOOS=wasip1</code>, <code>GOARCH=wasm</code>).
+</p>
+
 <p>
-  TODO: complete this section, or delete if not needed
+  As a result of the addition of the new <code>GOOS</code> value
+  "<code>wasip1</code>", Go files named <code>*_wasip1.go</code>
+  will now be <a href="/pkg/go/build/#hdr-Build_Constraints">ignored
+  by Go tools</a> except when that GOOS value is being used. If you
+  have existing filenames matching that pattern, you will need to
+  rename them.
 </p>
 
 <h2 id="tools">Tools</h2>