From d10cb9e9f4d3e688f0dbd8659e7c35b1e1af520c Mon Sep 17 00:00:00 2001
From: Lilleman auf Larv <lilleman@larvit.se>
Date: Thu, 24 Sep 2026 19:25:40 +0200
Subject: [PATCH] Leave an arm's key to template.head's doc, and reflow the arm
 comment

---
 hold.go     | 3 +--
 template.go | 7 +++----
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/hold.go b/hold.go
index 62b3ab1..42c7d0f 100644
--- a/hold.go
+++ b/hold.go
@@ -20,8 +20,7 @@ type draw struct {
 	null bool
 }
 
-// readField renders one arm of a token. An arm's key is a sibling field or a
-// reference linkRefs bound into refHeads. A name the expansion holds — a level some
+// readField renders one arm of a token. A name the expansion holds — a level some
 // token addresses by dotted path, or a field an operand reads — is drawn once and
 // kept, so {place.postal-code} and {place.locality} read one row, either read twice
 // gives one value, and a shown operand is the operand computed. Every other name is
diff --git a/template.go b/template.go
index 257edda..ce6792c 100644
--- a/template.go
+++ b/template.go
@@ -268,10 +268,9 @@ func fieldTokens(format string) []string {
 }
 
 // arm is one alternative of a {a|b} token or one operand, split into the key
-// `template.head` resolves (a sibling field, or the head a reference is bound
-// under) and the tail of a dotted path into it. A non-empty
-// tail is what makes the arm a bound draw: its head is drawn once per expansion
-// (see compileOps).
+// `template.head` resolves and the tail of a dotted path into it. A non-empty tail
+// is what makes the arm a bound draw: its head is drawn once per expansion (see
+// compileOps).
 type arm struct {
 	name   string // as written, for messages
 	key    string