aboutsummaryrefslogtreecommitdiff
path: root/repository/refs.go
diff options
context:
space:
mode:
authorGravatar Runxi Yu2026-03-29 08:09:34 +0000
committerGravatar Runxi Yu2026-03-29 08:09:34 +0000
commit161d2fab0b7ddee35696c5600d3ebd5bae6e6527 (patch)
tree887cd546fe3a05489cd3b4e37f9a4bf2770e50f1 /repository/refs.go
parent*: Remove Close exception for MT-Safe (diff)
signatureNo signature
repository: Add guidance
Diffstat (limited to 'repository/refs.go')
-rw-r--r--repository/refs.go4
1 files changed, 4 insertions, 0 deletions
diff --git a/repository/refs.go b/repository/refs.go
index 2e89aed6..0403e001 100644
--- a/repository/refs.go
+++ b/repository/refs.go
@@ -4,6 +4,10 @@ import refstore "codeberg.org/lindenii/furgit/ref/store"
// Refs returns the configured ref store.
//
+// Use Refs when starting from branch names, tags, HEAD, or other references.
+// A common pattern is to resolve a reference first and then pass the resulting
+// object ID to [Repository.Fetcher] or [Repository.Objects].
+//
// Labels: Life-Parent, Close-No.
//
//nolint:ireturn