From acc055c7a75b84dc2edf6aed34e936cbc74b57dc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Reis?= Date: Tue, 14 Nov 2017 02:44:25 +0000 Subject: [PATCH 1/2] doc,win: clarify WSL support Fixes: https://github.com/nodejs/node/issues/13471 --- BUILDING.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index 52c11aa08e9adf..46c68bd745ed1f 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -66,6 +66,12 @@ note1 - The gcc4.8-libs package needs to be installed, because node In "Git bash" if you call the node shell alias (`node` without the `.exe` extension), `winpty` is used automatically. +*Note*: The Windows Subsystem for Linux (WSL) is not directly supported, but + the GNU/Linux build process and binaries should work. The community will + only address issues that reproduce on native GNU/Linux systems, issues that + only reproduce on WSL should be reported in the + [WSL issue tracker](https://github.com/Microsoft/WSL/issues). + ### Supported toolchains Depending on host platform, the selection of toolchains may vary. From 5a04eb92fcc8a48d9933666d5536c58e9897c748 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jo=C3=A3o=20Reis?= Date: Wed, 15 Nov 2017 05:26:04 +0000 Subject: [PATCH 2/2] fixup --- BUILDING.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/BUILDING.md b/BUILDING.md index 46c68bd745ed1f..cd819b4b4779c7 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -66,11 +66,13 @@ note1 - The gcc4.8-libs package needs to be installed, because node In "Git bash" if you call the node shell alias (`node` without the `.exe` extension), `winpty` is used automatically. -*Note*: The Windows Subsystem for Linux (WSL) is not directly supported, but - the GNU/Linux build process and binaries should work. The community will - only address issues that reproduce on native GNU/Linux systems, issues that - only reproduce on WSL should be reported in the - [WSL issue tracker](https://github.com/Microsoft/WSL/issues). +The Windows Subsystem for Linux (WSL) is not directly supported, but the +GNU/Linux build process and binaries should work. The community will only +address issues that reproduce on native GNU/Linux systems. Issues that only +reproduce on WSL should be reported in the +[WSL issue tracker](https://github.com/Microsoft/WSL/issues). Running the +Windows binary (`node.exe`) in WSL is not recommended, and will not work +without adjustment (such as stdio redirection). ### Supported toolchains