Fixed #27439 -- Documented macOS locale configuration for Django tests.

[alixmartineau]

No description provided.

[frgtn]

LGTM, just need to fix spell-checking.

[frgtn]

You'll need to add macOS to https://github.com/django/django/blob/master/docs/spelling_wordlist to for spell-check to pass.

[alixmartineau]

Done 👍

[jarshwah]

macOS is a replacement of Mac OSX as of Sierra.

[jarshwah]

I haven't actually run into this problem before, but I do tend to run tests within a linux VM these days. Are there any particular tests that fail without these languages exported so we can target specific tests when verifying this?

[hoylemd]

🚀

[timgraham]

I don't think the issue is specific to Mac OS. For example, it's mentioned here: https://docs.djangoproject.com/en/1.10/ref/unicode/#files.

[alixmartineau]

Indeed, it's not specific to macOS.
However, on Debian-based systems, it is generally recommended to use dpkg-reconfigure, as already stated in the docs.
On macOS, you don't have this option, so I think it's beneficial to mention LANG and LC_ALL env variables in this "troubleshooting tests" chapter.

[rfleschenberg]

I did not verify this, but I suspect that it can also affect Linux (and *BSD?) systems with certain values for LANG / LC_ALL.

IMHO we should document the export way, because it also works on shells other than bash. In addition to that, maybe add a note like this:

You can add these commands to your shell's startup file (for example, ~/.bashrc) so you don't have to retype them.

[timgraham]

@alix-, could you update as per the last comment or do you disagree with it?

[alixmartineau]

@timgraham Updated.