From bccdea623d8314f1890cec2f4c6c7a98d234b018 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] doc,win: clarify WSL support Fixes: https://github.com/nodejs/node/issues/13471 PR-URL: https://github.com/nodejs/node/pull/17008 Reviewed-By: Gireesh Punathil Reviewed-By: Joyee Cheung Reviewed-By: Timothy Gu Reviewed-By: Richard Lau Reviewed-By: Gibson Fahnestock Reviewed-By: James M Snell Reviewed-By: Hitesh Kanwathirtha Reviewed-By: Colin Ihrig --- BUILDING.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/BUILDING.md b/BUILDING.md index 52c11aa08e9adf..cd819b4b4779c7 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -66,6 +66,14 @@ 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. +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 Depending on host platform, the selection of toolchains may vary.