From dae52d718f51f9a90d15d48fc80d9674346721c8 Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Thu, 29 Jan 2026 22:17:30 +0100
Subject: tree: Document TreeEntryNameCompare

---
 obj_tree.go | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'obj_tree.go')

diff --git a/obj_tree.go b/obj_tree.go
index 2475b237..99a560f3 100644
--- a/obj_tree.go
+++ b/obj_tree.go
@@ -259,6 +259,10 @@ func (tree *Tree) RemoveEntry(name []byte) error {
 	return ErrNotFound
 }
 
+// TreeEntryNameCompare compares names using Git's tree ordering rules.
+//
+// If an entry or search name is a tree, it is compared as if it has a trailing
+// '/'.
 func TreeEntryNameCompare(entryName []byte, entryMode FileMode, searchName []byte, searchIsTree bool) int {
 	isEntryTree := entryMode == FileModeDir
 
-- 
cgit v1.3.1-10-gc9f91