From e3e90110fbf398b520f3c1767fdf0d038756e1cf Mon Sep 17 00:00:00 2001 From: hndrk <51416554+hendriknielaender@users.noreply.github.com> Date: Sat, 17 Feb 2024 12:53:23 +0100 Subject: [PATCH 1/3] chore: add windows encoding note --- docs/advanced.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/advanced.md b/docs/advanced.md index 5adf3a0..9ead382 100644 --- a/docs/advanced.md +++ b/docs/advanced.md @@ -1,3 +1,14 @@ -### Advanced +## Advanced + +### Note for Windows Users + +If you encounter issues with character encoding, such as misrepresentation of "plusminus" (±) or "sigma" (σ) symbols in the benchmark results, it's likely due to Windows using UTF-16 LE encoding by default. To ensure characters are displayed correctly, you can switch your system to use UTF-8 encoding by following these steps: + +1. Open **Control Panel**. +2. Navigate to **Region** > **Administrative** tab. +3. Click on **Change system locale...**. +4. Check the option for **Beta: Use Unicode UTF-8 for worldwide language support**. +5. Click **OK** and restart your computer if prompted. + +This setting will configure your system to use UTF-8 encoding for non-Unicode programs, which should resolve any character display issues in the benchmark output. -TODO From ac1e9d0ea51e5065aa613433f9704e34ffec17ff Mon Sep 17 00:00:00 2001 From: hndrk <51416554+hendriknielaender@users.noreply.github.com> Date: Sat, 17 Feb 2024 12:55:55 +0100 Subject: [PATCH 2/3] chore: add zig issue link --- docs/advanced.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/advanced.md b/docs/advanced.md index 9ead382..babe370 100644 --- a/docs/advanced.md +++ b/docs/advanced.md @@ -12,3 +12,4 @@ If you encounter issues with character encoding, such as misrepresentation of "p This setting will configure your system to use UTF-8 encoding for non-Unicode programs, which should resolve any character display issues in the benchmark output. +[Zig console output encoding issue](https://github.com/ziglang/zig/issues/7600#issuecomment-753563786) From 51096d56ebfc500e4d98ec6df0eac0e8f1e42445 Mon Sep 17 00:00:00 2001 From: hndrk <51416554+hendriknielaender@users.noreply.github.com> Date: Sat, 17 Feb 2024 12:59:09 +0100 Subject: [PATCH 3/3] chore: add windows encoding issue to README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2342893..ffbf6a6 100644 --- a/README.md +++ b/README.md @@ -165,7 +165,8 @@ zig build test_examples ``` ### Troubleshooting -If Zig doesn't detect changes in a dependency, clear the project's `zig-cache` folder and `~/.cache/zig`. +- If Zig doesn't detect changes in a dependency, clear the project's `zig-cache` folder and `~/.cache/zig`. +- [Non-ASCII characters not printed correctly on Windows](docs/advanced.md) ## Contributing