From a799fa51896b63339f75f9a354c2d70fa8815ac2 Mon Sep 17 00:00:00 2001
From: Sean Liao <sean@liao.dev>
Date: Fri, 19 Jul 2024 23:34:02 +0100
Subject: [PATCH] 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>
---
 src/slices/slices.go | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/slices/slices.go b/src/slices/slices.go
index 857ab46314324b..b3cd4e2c054001 100644
--- 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) {