From 5c4e61830242a3a25e332bf623adb2eb65037f2b Mon Sep 17 00:00:00 2001
From: Runxi Yu
Date: Sun, 22 Mar 2026 23:34:38 +0000
Subject: receivepack/service: Clarify ownership and requirements

---
 receivepack/service/options.go | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'receivepack/service/options.go')

diff --git a/receivepack/service/options.go b/receivepack/service/options.go
index 21b84e2d..a49b6b95 100644
--- a/receivepack/service/options.go
+++ b/receivepack/service/options.go
@@ -16,6 +16,13 @@ type PromotedObjectPermissions struct {
 }
 
 // Options configures one protocol-independent receive-pack service.
+//
+// Service borrows all configured dependencies.
+//
+// Refs and ExistingObjects are required and must be non-nil.
+// ObjectsRoot is required if Execute may need to ingest or promote a pack.
+// Progress, ProgressFlush, Hook, and HookIO are optional; when provided they
+// are also borrowed for the duration of Execute.
 type Options struct {
 	Algorithm                 objectid.Algorithm
 	Refs                      refstore.ReadWriteStore
-- 
cgit v1.3.1-10-gc9f91