src/cmd/5a/doc.go | 4 ++++
 src/cmd/6a/doc.go | 6 +++++-
 src/cmd/8a/doc.go | 5 +++++

diff --git a/src/cmd/5a/doc.go b/src/cmd/5a/doc.go
index 29725db04e06d2d3680ecbff1c394f23c0d28d34..74d025fe2cf426f242a4abebedde532229724e88 100644
--- a/src/cmd/5a/doc.go
+++ b/src/cmd/5a/doc.go
@@ -10,6 +10,10 @@ 5a is a version of the Plan 9 assembler.  The original is documented at
 
 	http://plan9.bell-labs.com/magic/man2html/1/8a
 
+Go-specific considerations are documented at
+
+	http://golang.org/doc/asm.html
+
 Its target architecture is the ARM, referred to by these tools as arm.
 
 */
diff --git a/src/cmd/6a/doc.go b/src/cmd/6a/doc.go
index a5f3f87f09a1c7bfeaa69fb1b3133764701351a4..9fdc6ed3a58ae78ff405d1882252ace5048c1dfa 100644
--- a/src/cmd/6a/doc.go
+++ b/src/cmd/6a/doc.go
@@ -10,7 +10,11 @@ 6a is a version of the Plan 9 assembler.  The original is documented at
 
 	http://plan9.bell-labs.com/magic/man2html/1/8a
 
-Its target architecture is the x86-64, referred to by these tools as amd64.
+Go-specific considerations are documented at
+
+	http://golang.org/doc/asm.html
+
+IIts target architecture is the x86-64, referred to by these tools as amd64.
 
 */
 package main
diff --git a/src/cmd/8a/doc.go b/src/cmd/8a/doc.go
index 737c56f1337e711bd947fec8716d8bded6f98f5e..bdf2fcfbb7bc0fb1e954564485a9ba12839d5185 100644
--- a/src/cmd/8a/doc.go
+++ b/src/cmd/8a/doc.go
@@ -10,6 +10,11 @@ 8a is a version of the Plan 9 assembler.  The original is documented at
 
 	http://plan9.bell-labs.com/magic/man2html/1/8a
 
+Go-specific considerations are documented at
+
+	http://golang.org/doc/asm.html
+
+I
 Its target architecture is the x86, referred to by these tools for historical reasons as 386.
 
 */