slices: explicitly document nil and empty slice equality

Fixes #68472

Change-Id: I21282621d679d9e2b032256b338c0b5ff107c8f4
Reviewed-on: https://go-review.googlesource.com/c/go/+/599816
Reviewed-by: Ian Lance Taylor <iant@google.com>
Auto-Submit: Ian Lance Taylor <iant@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>

diff --git a/src/slices/slices.go b/src/slices/slices.go
index 857ab46314324b4a228bf483a1a7f03821f298a0..b3cd4e2c054001149e49b7c4969ab558e55cfc44 100644 (file)
--- a/src/slices/slices.go
+++ b/src/slices/slices.go
@@ -15,6 +15,7 @@ import (
 // elements equal. If the lengths are different, Equal returns false.
 // Otherwise, the elements are compared in increasing index order, and the
 // comparison stops at the first unequal pair.
+// Empty and nil slices are considered equal.
 // Floating point NaNs are not considered equal.
 func Equal[S ~[]E, E comparable](s1, s2 S) bool {
        if len(s1) != len(s2) {