Skip to content

Commit 9d56bee

Browse files
committed
Tighten up language about fallback values, their string representations, and options
1 parent a63c6a2 commit 9d56bee

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

spec/formatting.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -413,7 +413,8 @@ The resolution of _markup_ MUST always succeed.
413413
414414
A **_<dfn>fallback value</dfn>_** is the _resolved value_ for
415415
an _expression_ or _variable_ when that _expression_ or _variable_ fails to resolve.
416-
It has a string representation that is used for its formatting.
416+
It contains a string representation that is used for its formatting,
417+
and no option values.
417418
418419
The _resolved value_ of _text_, _literal_, and _markup_ MUST NOT be a _fallback value_.
419420
@@ -439,36 +440,38 @@ The string representation of the _fallback value_ of an _expression_ depends on
439440
440441
> Examples:
441442
> In a context where `:func` fails to resolve,
442-
> `{42 :func}` resolves to the _fallback value_ `|42|` and
443-
> `{|C:\\| :func}` resolves to the _fallback value_ `|C:\\|`.
443+
> `{42 :func}` resolves to a _fallback value_ with a string representation `|42|` and
444+
> `{|C:\\| :func}` resolves to a _fallback value_ with a string representation `|C:\\|`.
444445
445446
- _expression_ with _variable_ _operand_:
446447
the _fallback value_ representation of that _variable_,
447448
U+0024 DOLLAR SIGN `$` followed by the _name_ of the _variable_
448449
449450
> Examples:
450451
> In a context where `$var` fails to resolve, `{$var}` and `{$var :number}`
451-
> both resolve to the _fallback value_ `$var`
452+
> both resolve to a _fallback value_ with a string representation `$var`
452453
> (even if `:number` fails to resolve).
453454
>
454455
> In a context where `:func` fails to resolve,
455456
> the _placeholder_ in `.local $var = {|val| :func} {{{$var}}}`
456-
> resolves to the _fallback value_ `$var`.
457+
> resolves to a _fallback value_ with a string representation `$var`.
457458
>
458459
> In a context where either `:now` or `:pretty` fails to resolve,
459460
> the _placeholder_ in
460461
> ```
461462
> .local $time = {:now format=iso8601}
462463
> {{{$time :pretty}}}
463464
> ```
464-
> resolves to the _fallback value_ `$time`.
465+
> resolves to a _fallback value_ with a string representation `$time`.
465466
466467
- _function_ _expression_ with no _operand_:
467468
U+003A COLON `:` followed by the _function_ _identifier_
468469
469470
> Examples:
470-
> In a context where `:func` fails to resolve, `{:func}` resolves to the _fallback value_ `:func`.
471-
> In a context where `:ns:func` fails to resolve, `{:ns:func}` resolves to the _fallback value_ `:ns:func`.
471+
> In a context where `:func` fails to resolve,
472+
> `{:func}` resolves to a _fallback value_ with a string representation `:func`.
473+
> In a context where `:ns:func` fails to resolve,
474+
> `{:ns:func}` resolves to a _fallback value_ with a string representation `:ns:func`.
472475
473476
- Otherwise: the U+FFFD REPLACEMENT CHARACTER `�`
474477

0 commit comments

Comments
 (0)