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 e483e1e556ae8ecd68f8cce5f1682572403a1f56..421a509fea1f3f81cf331d80cb7f786e20198365 100644 (file)
--- 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>