diff options
| -rw-r--r-- | man/colitur-templates.5 | 10 |
1 files changed, 8 insertions, 2 deletions
diff --git a/man/colitur-templates.5 b/man/colitur-templates.5 index a7e4992..2f42d68 100644 --- a/man/colitur-templates.5 +++ b/man/colitur-templates.5 @@ -131,8 +131,14 @@ could never reach .BR {{year}} , which lives only on the outermost object. .PP -.B The hazard: an inner key silently loses to an outer key of the SAME NAME. -Falling back outward means a name that exists at +.B The hazard: a DOTTED PATH that resolves only PART WAY inward falls back +.B WHOLESALE to an outer scope of the SAME NAME. +A bare key inside the immediately enclosing section is not at risk this way +\(em it either resolves right there or fails outright (see +.B num +below); it is specifically a dotted path, one step of which is missing from +the inner object, that abandons the whole path and restarts the lookup one +level out. Falling back outward means a name that exists at .I both levels never fails and never warns \(em it just silently resolves to the .I outer |