search

dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.27k stars 5.9k forks source link

Add DOTNET_CLI_UI_LANGUAGE and DOTNET_ROOT to the list of environment variables #8988

Closed josefpihrt closed 4 years ago

josefpihrt commented 5 years ago

Add DOTNET_CLI_UI_LANGUAGE to the list of environment variables.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

mairaw commented 5 years ago

Thanks for your feedback @JosefPihrt. @livarcocc @dsplaisted @KathleenDollard @nguerrera since when this env variable has been supported? Also, anything we should add in regards to this such as use cases, etc. besides a basic description that it sets the language of the CLI UI using a locale value such as en-us, etc.? Do we have a list of locales supported by the CLI for me to add? Thanks!

mairaw commented 5 years ago

Still waiting for confirmation on this one. Moved to a later sprint.

nguerrera commented 5 years ago

since when this env variable has been supported?

Since .NET Core SDK 2.0.

Also, anything we should add in regards to this such as use cases, etc. besides a basic description that it sets the language of the CLI UI using a locale value such as en-us, etc.?

No, that's it. :)

Do we have a list of locales supported by the CLI for me to add?

It is the same list as the languages supported by Visual Studio: https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2017#step-6---install-language-packs-optional.

https://github.com/dotnet/xliff-tasks/blob/master/src/XliffTasks/build/XliffTasks.props#L26

.NET resource manager rules apply, so you don't have to pick an exact match, you can also pick descendants in the CultureInfo tree. For example, if I set it to fr-CA, then it will find and use the fr translations. Also, if you set it to a language that is not supported, then the CLI will fall back to English.

mairaw commented 5 years ago

Thanks @nguerrera!

Bartolomeus-649 commented 5 years ago

Please include what is used for, only for localization and resolving resources to the correct language, or does it affect other things as well? Like regional settings? Date and time format?

Also, how does it relate to other settings for language on OS level (system, user and so on).

Also, what if you set the language to, for example russian, how will you then display stuff when the default codepage is 437?

So perhaps @nguerrera s "No, that's it. :)" remark was a bit hasty...and remember, Murphy would never let "No, that's it." get past him ;)

AdvancedPowerArmor commented 5 years ago

It looks like it is still open. It would be great to update the list and add some examples.

mairaw commented 5 years ago

I also need to add the DOTNET_ROOT environment variable to this article. Would need confirmation of when this was introduced.

wli3 commented 4 years ago

it is a runtime feature. First seem in SDK 2.1.300

wli3 commented 4 years ago

We need to bump the priority for DOTNET_ROOT. It is been a year. And we don't have any official document for what it is for and what to set to. The only meaningful explanation is on a twitter thread. cc @richlander

mairaw commented 4 years ago

Yeah I know 😢 I'll schedule this one for this month and see if we can make that happen. Having your and @richlander's help to get those values accurately documented would be great. I'll ping you for review.

wli3 commented 4 years ago

I am happy to help review, although SDK team does not own this feature, runtime team does