doc: add note about import . to Go 1 compatibility notes

R=r
CC=golang-dev
https://golang.org/cl/5752065

diff --git a/doc/go1compat.html b/doc/go1compat.html
index 3804634f5da16cc44e816fe97440c84f5be2185c..1dfd382c238f70aa504526b5e391733a7fa432c0 100644 (file)
--- a/doc/go1compat.html
+++ b/doc/go1compat.html
@@ -94,6 +94,15 @@ We therefore recommend that composite literals whose type is defined
 in a separate package should use the tagged notation.
 </li>
 
+<li>
+Dot imports. If a program imports a standard package
+using <code>import . "path"</code>, additional names defined in the
+imported package in future releases may conflict with other names
+defined in the program.  We do not recommend the use of <code>import .</code>
+outside of tests, and using it may cause a program to fail
+to compile in future releases.
+</li>
+
 </ul>
 
 <p>