Skip to content

Address "implementation-defined" literal and type values #944

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Nov 18, 2024
Merged

Address "implementation-defined" literal and type values #944

Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
085eb23
Address "implementation-defined" literal and type values
aphillips Nov 17, 2024
6d4223b
Address comments, remove "literal"
aphillips Nov 18, 2024
f88c5d6
and => or for clarity
aphillips Nov 18, 2024
8cafaee
Update spec/registry.md
aphillips Nov 18, 2024
6127516
Address comment via a rewrite of the example
aphillips Nov 18, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion spec/registry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,26 @@ by any version of this specification
for **standard** and **optional** functions.
Such _options_ MUST use an implementation-specific _namespace_.

Implementations MAY _accept_ additional _option_ values for _options_ defined here.
Implementations MAY _accept_, for _options_ defined in this specification,
_option_ values which are not defined in this specification.
However, such values might become defined with a different meaning in the future,
including with a different, incompatible name
or using an incompatible value space.
Supporting implementation-specific _option_ values for **standard** or **optional** functions is NOT RECOMMENDED.

Implementations MAY _accept_, for _operands_ or _option_ values defined in this specification,
implementation-defined types.
Such values can be useful to users in cases where local usage and support exists
(including cases in which details vary from those defined by Unicode and CLDR).

> For example, implementations are encouraged to _accept_ a native representation
> for currency amounts as the _operand_ in the _function_ `:currency`.
> Or a Java implementation might _accept_ a `java.time.chrono.Chronology` object
> as a value for the date/time option `calendar`
> or ICU4J's implementation might _accept_ a `com.ibm.icu.text.NumberingSystem` object
> instead of using a [Unicode Numbering System Identifier](https://cldr-smoke.unicode.org/spec/main/ldml/tr35.html#UnicodeNumberSystemIdentifier)
> for the option `numberingSystem` in _functions_ such as `:number` or `:integer`.

Future versions of this specification MAY define additional _options_ and _option_ values,
subject to the rules in the [Stability Policy](#stability-policy),
for _functions_ found in this specification.
Expand Down