Skip to content
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.

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

doc: clarify use of deps/icu-small #43287

Closed
wants to merge 4 commits into from
Closed

Conversation

mhdawson
Copy link
Member

@mhdawson mhdawson commented Jun 1, 2022

Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson mdawson@devrus.com

Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>
@nodejs-github-bot
Copy link
Collaborator

Review requested:

  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added the doc Issues and PRs related to the documentations. label Jun 1, 2022
@mhdawson
Copy link
Member Author

mhdawson commented Jun 1, 2022

This info would have helped me undestand more easily as I was confused by the overloading of small in terms of the data (small/full) and us using a subset of the C source code (deps/icu-small)

@srl295 could you doulble check the change in the part about updating timezone data. I think that makese sense as I believe by default we use the data in deps/icu-small and that is what we would typically want to patch/commit as there is no deps/icu directory in the GitHub repo.

@srl295 srl295 self-requested a review June 1, 2022 20:05
Co-authored-by: Steven R. Loomis <srl295@gmail.com>
@mhdawson
Copy link
Member Author

mhdawson commented Jun 1, 2022

@srl295 updated.

@srl295
Copy link
Member

srl295 commented Jun 1, 2022

I think the confusion is probably because:

  • when the all-locales ICU was included in Node, the directory was still called icu-small (Maybe was not a good decision, on my part…)
  • deps/icu-small is actually still !== all of ICU. It is a subset, as you noted, trimming out things that Node doesn't use (or not use yet).
  • When downloading ICU from somewhere, deps/icu contains the "original" ICU.
  • When maintaining Node and putting in a new ICU, deps/icu contains that original ICU, and then deps/icu-small is trimmed (by data type, not by locale) from deps/icu.

@@ -11,6 +11,12 @@ functionality. To quote from icu-project.org:
> widely portable and gives applications the same results on all platforms
> and between C/C++ and Java software.

If Node.js is configured to use its built-in ICU,
it uses a strict subset of ICU which is in
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM unless it's worth noting that the subset is not by locale (and type), but by type.

It's further confusing that 'small-icu' is an option still, but is !== the small-icu directory.

mhdawson and others added 2 commits June 13, 2022 17:21
Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com>
Co-authored-by: Tobias Nießen <tniessen@tnie.de>
mhdawson added a commit that referenced this pull request Jun 14, 2022
Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: #43287
Reviewed-By: Steven R Loomis <srloomis@us.ibm.com>
@mhdawson
Copy link
Member Author

Landed in 83ffb79

@mhdawson mhdawson closed this Jun 14, 2022
danielleadams pushed a commit that referenced this pull request Jun 16, 2022
Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: #43287
Reviewed-By: Steven R Loomis <srloomis@us.ibm.com>
@danielleadams danielleadams mentioned this pull request Jun 16, 2022
targos pushed a commit that referenced this pull request Jul 12, 2022
Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: #43287
Reviewed-By: Steven R Loomis <srloomis@us.ibm.com>
targos pushed a commit that referenced this pull request Jul 31, 2022
Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: #43287
Reviewed-By: Steven R Loomis <srloomis@us.ibm.com>
guangwong pushed a commit to noslate-project/node that referenced this pull request Oct 10, 2022
Add some additional info about use of icu
subset in deps/icu-small

Signed-off-by: Michael Dawson <mdawson@devrus.com>

PR-URL: nodejs/node#43287
Reviewed-By: Steven R Loomis <srloomis@us.ibm.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Issues and PRs related to the documentations.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants