diff --git a/doc/go1.html b/doc/go1.html
index 23ed3709fb..d839b7a278 100644
--- a/doc/go1.html
+++ b/doc/go1.html
@@ -875,6 +875,19 @@ in crypto/elliptic that take an elliptic.Curve
as their first argument.
+In Go 1, the hash-specific functions, such as hmac.NewMD5, have
+been removed from crypto/hmac. Instead, hmac.New takes
+a function that returns a hash.Hash, such as md5.New.
+
+Updating: +Gofix will perform the needed changes. +
+
diff --git a/doc/go1.tmpl b/doc/go1.tmpl
index fd005b102d..f1203f1907 100644
--- a/doc/go1.tmpl
+++ b/doc/go1.tmpl
@@ -779,6 +779,19 @@ in crypto/elliptic that take an elliptic.Curve
as their first argument.
+In Go 1, the hash-specific functions, such as hmac.NewMD5, have
+been removed from crypto/hmac. Instead, hmac.New takes
+a function that returns a hash.Hash, such as md5.New.
+
+Updating: +Gofix will perform the needed changes. +
+