From 3f37a09cbb3fe5d42e9a2d96276cb425fcd7da02 Mon Sep 17 00:00:00 2001 From: parkerault Date: Wed, 23 Sep 2020 00:28:24 -0500 Subject: [PATCH] Recommend using Windows Terminal instead of mintty The [Microsoft Terminal](https://github.com/microsoft/terminal) app is a vast improvement over the default Bash for Windows app that ships with WSL distros, and fixes all of the issues with text rendering. Also, the previously recommended mintty for WSL is a f**king mess (it's barely functional and the uninstall batch script is broken. I personally had to spend over an hour reading through it to manually remove all of the files and revert the registry changes it made. I'm still pissed off about it, in case you can't tell). --- README.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index d4e2b0e..15e33b1 100644 --- a/README.md +++ b/README.md @@ -83,19 +83,15 @@ Troubleshooting `tmux_conf_theme_left_separator_XXX` values. - **I'm using Bash On Windows (WSL), colors and Powerline look are broken.** - - There is currently a [bug][1681] in the new console powering Bash On Windows - preventing text attributes (bold, underscore, ...) to combine properly with - colors. The workaround is to search your `~/.tmux.conf.local` copy and - replace attributes with `'none'`. - - Also, until Window's console replaces its GDI based render with a DirectWrite - one, Powerline symbols will be broken. - - The alternative is to use the [Mintty terminal for WSL][wsltty]. + + The Bash On Windows terminal that ships with WSL distros has problems + displaying certain text attributes and powerline code points. It's highly + recommended to use the [Windows Terminal][microsoft-terminal] application + instead (also installable from the [Microsoft Store][microsoft-store]). [1681]: https://github.com/Microsoft/BashOnWindows/issues/1681 -[wsltty]: https://github.com/mintty/wsltty +[microsoft-terminal]: https://github.com/microsoft/terminal +[microsoft-store]: https://aka.ms/terminal Features --------