Leave an arm's key to template.head's doc, and reflow the arm comment

This commit is contained in:
2026-09-24 19:25:40 +02:00
committed by Lillem4n
parent 36714250f6
commit d10cb9e9f4
2 changed files with 4 additions and 6 deletions
+1 -2
View File
@@ -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
+3 -4
View File
@@ -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