Skip to content

Commit 86456e4

Browse files
committed
Change internationalization to localization in terminology to reflect what is
actually being removed
1 parent 141fb3b commit 86456e4

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

active/0000-remove-format-intl.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,27 @@
44

55
# Summary
66

7-
Remove internationalization features from format!, and change the set of escapes
7+
Remove localization features from format!, and change the set of escapes
88
accepted by format strings. The `plural` and `select` methods would be removed,
99
`#` would no longer need to be escaped, and `{{`/`}}` would become escapes for
1010
`{` and `}`, respectively.
1111

1212
# Motivation
1313

14-
Internationalization is difficult to implement correctly, and doing so will
14+
Localization is difficult to implement correctly, and doing so will
1515
likely not be done in the standard library, but rather in an external library.
16-
After talking with others much more familiar with internationalization, it has
17-
come to light that our ad-hoc "internationalization support" in our format
16+
After talking with others much more familiar with localization, it has
17+
come to light that our ad-hoc "localization support" in our format
1818
strings are woefully inadequate for most real use cases of support for
19-
internationalization.
19+
localization.
2020

2121
Instead of having a half-baked unused system adding complexity to the compiler
2222
and libraries, the support for this functionality would be removed from format
2323
strings.
2424

2525
# Detailed design
2626

27-
The primary internationalization features that `format!` supports today are the
27+
The primary localization features that `format!` supports today are the
2828
`plural` and `select` methods inside of format strings. These methods are
2929
choices made at format-time based on the input arguments of how to format a
3030
string. This functionality would be removed from the compiler entirely.
@@ -59,7 +59,7 @@ see the diff between the two
5959
Upon landing, there was a significant amount of discussion about the escape
6060
sequence that would be used in format strings. Some context can be found on some
6161
[old pull requests][1], and the current escape mechanism has been the source of
62-
[much confusion][2]. With the removal of internationalization methods, and
62+
[much confusion][2]. With the removal of localization methods, and
6363
namely nested format directives, it is possible to reconsider the choices of
6464
escaping again.
6565

@@ -77,8 +77,8 @@ the comments of an [old PR][1].
7777

7878
# Drawbacks
7979

80-
The internationalization methods of select/plural are genuinely used for
81-
applications that do not involve internationalization. For example, the compiler
80+
The localization methods of select/plural are genuinely used for
81+
applications that do not involve localization. For example, the compiler
8282
and rustdoc often use plural to easily create plural messages. Removing this
8383
functionality from format strings would impose a burden of likely dynamically
8484
allocating a string at runtime or defining two separate format strings.
@@ -90,20 +90,20 @@ with for today.
9090

9191
# Alternatives
9292

93-
The major internationalization approach explored has been l20n, which has shown
93+
The major localization approach explored has been l20n, which has shown
9494
itself to be fairly incompatible with the way format strings work today.
95-
Different internationalization systems, however, have not been explored. Systems
95+
Different localization systems, however, have not been explored. Systems
9696
such as gettext would be able to leverage format strings quite well, but it
97-
was claimed that gettext for internationalization is inadequate for modern
97+
was claimed that gettext for localization is inadequate for modern
9898
use-cases.
9999

100100
It is also an unexplored possibility whether the current format string syntax
101101
could be leveraged by l20n. It is unlikely that time will be allocated to polish
102-
off an internationalization library before 1.0, and it is currently seen as
102+
off an localization library before 1.0, and it is currently seen as
103103
undesirable to have a half-baked system in the libraries rather than a
104104
first-class well designed system.
105105

106106
# Unresolved questions
107107

108-
* Should internationalization support be left in `std::fmt` as a "poor man's"
108+
* Should localization support be left in `std::fmt` as a "poor man's"
109109
implementation for those to use as they see fit?

0 commit comments

Comments
 (0)