ICU API proposal: Deprecate C createMetricTon/getMetricTon, J METRIC_TON

13 views
Skip to first unread message

Peter Edberg

unread,
Mar 21, 2025, 7:07:50 PMMar 21
to icu-d...@unicode.org

Dear ICU team & users,


I would like to propose the following API change for: ICU 78

Please provide feedback by: next Wednesday, 2025-03-26 (simple change, does not need a week)

Designated API reviewer: Rich G

Ticket: ICU-22142


Background:
  • The mass unit “metric-ton" was introduced in CLDR 26; in CLDR 42 it was deprecated, and replaced with “tonne”.
  • ICU 54 used data from CLDR 26, and:
    • Added for C (i18n/unicode/measunit.h), createMetricTon (now @stable ICU 54).
    • Added for J (main/core/src/main/java/com/ibm/icu/util/MeasureUnit.java), METRIC_TON (now @stable ICU 54).
  • ICU 64 added for C (getXxx methods added to parallel createXxx): getMetricTon (now @stable 64).
  • ICU 72 used data from CLDR 42, and:
    • Added for C as draft: createTonne, getTonne (now @stable ICU 72).
    • Added for J as draft: TONNE (now @stable ICU 72).
    • Added a note for createMetricTon/getMetricTon/METRIC_TON that they are replaced by the methods/constants using Tonne/TONNE, and they would be deprecated in ICU 74 (when the Tonne/TONNE items would become @stable). However, that deprecation never happened.

Proposal: We should now finally deprecate the C methods createMetricTon/getMetricTon in favor of createTonne/getTonne and deprecate the J constant METRIC_TON in favor of TONNE.

- Peter

Rich Gillam

unread,
Mar 21, 2025, 7:40:30 PMMar 21
to icu-d...@lists.sourceforge.net, icu-d...@unicode.org
Definitely no objections from me…

—Rich

--
You received this message because you are subscribed to the Google Groups "icu-design" group.
To unsubscribe from this group and stop receiving emails from it, send an email to icu-design+...@unicode.org.
To view this discussion visit https://groups.google.com/a/unicode.org/d/msgid/icu-design/FCCF7056-D20D-48D5-8D68-E76A79E2AC3E%40unicode.org.
For more options, visit https://groups.google.com/a/unicode.org/d/optout.
_______________________________________________
icu-design mailing list
icu-d...@lists.sourceforge.net
To Un/Subscribe: https://lists.sourceforge.net/lists/listinfo/icu-design

Reply all
Reply to author
Forward
0 new messages