doc: Windows building officially supported only on x64 hosts #21443

refack · 2018-06-21T15:00:20Z

Since we are CI testing on x64 hosts, we can only commit to x64 hosts.
We could add x86_x86 and x86_x64 as Experimental, to indicate willingness to accept community PRs.

Ref: #21402
Ref: #21437

Checklist

make -j4 test (UNIX), or vcbuild test (Windows) passes
documentation is changed or added
commit message follows commit guidelines

nodejs-github-bot · 2018-06-21T15:00:22Z

@refack build started: https://ci.nodejs.org/blue/organizations/jenkins/node-test-pull-request-lite-pipeline/detail/node-test-pull-request-lite-pipeline/111/pipeline

refack · 2018-06-21T15:00:51Z

/CC @nodejs/platform-windows @nodejs/build

seishun · 2018-06-21T15:06:37Z

BUILDING.md

@@ -42,7 +42,7 @@ platforms in production.
 | GNU/Linux    | Tier 1       | kernel >= 2.6.32, glibc >= 2.12  | x64, arm             |                  |
 | GNU/Linux    | Tier 1       | kernel >= 3.10, glibc >= 2.17    | arm64                |                  |
 | macOS        | Tier 1       | >= 10.10                         | x64                  |                  |
-| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x86, x64             | vs2017           |
+| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x86_x86, x64         | vs2017           |


What is x86_x86?

seishun · 2018-06-21T15:07:00Z

BUILDING.md

@@ -89,7 +89,7 @@ Depending on host platform, the selection of toolchains may vary.

 #### Windows

-* Visual Studio 2017 or the Build Tools thereof
+* Visual Studio 2017 or the "Build Tools" thereof, on an x64 host.


Why add quotes?

Unless this is supposed to imply that Visual Studio 2017 is not required on a non-x64 host, "on an x64 host" doesn't belong here.

It's a proper product name.

Visual Studio 2017 is a product name, why isn't it in quotes?

seishun · 2018-06-21T15:08:57Z

BUILDING.md

@@ -42,7 +42,7 @@ platforms in production.
 | GNU/Linux    | Tier 1       | kernel >= 2.6.32, glibc >= 2.12  | x64, arm             |                  |
 | GNU/Linux    | Tier 1       | kernel >= 3.10, glibc >= 2.17    | arm64                |                  |
 | macOS        | Tier 1       | >= 10.10                         | x64                  |                  |
-| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x86, x64             | vs2017           |
+| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x64_x86, x64         | vs2017           |


What is "x64_x86"?

refack · 2018-06-21T15:09:03Z

BUILDING.md

@@ -89,7 +89,7 @@ Depending on host platform, the selection of toolchains may vary.

 #### Windows

-* Visual Studio 2017 or the Build Tools thereof
+* Visual Studio 2017 or the "Build Tools" thereof, on an x64 host.


It's a proper product name.

refack · 2018-06-21T15:11:18Z

BUILDING.md

@@ -42,7 +42,7 @@ platforms in production.
 | GNU/Linux    | Tier 1       | kernel >= 2.6.32, glibc >= 2.12  | x64, arm             |                  |
 | GNU/Linux    | Tier 1       | kernel >= 3.10, glibc >= 2.17    | arm64                |                  |
 | macOS        | Tier 1       | >= 10.10                         | x64                  |                  |
-| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x86, x64             | vs2017           |
+| Windows      | Tier 1       | >= Windows 7/2008 R2/2012 R2     | x64_x86, x64         | vs2017           |


x86_x86 was a typo
x64_x86 is Microsoft designation for cross compiling x86 (32bit) target, on an x64(64bit) host.

calling: "C:\Program Files\VSCommunity2017\VC\\Auxiliary\Build\vcvarsall.bat" x86_x86 [ERROR:vcvarsall.bat] Invalid argument found : x86_x86 [ERROR:vcvarsall.bat] Error in script usage. The correct usage is: Syntax: vcvarsall.bat [arch] [platform_type] [winsdk_version] [-vcvars_ver=vc_version] where : [arch]: x86 | amd64 | x86_amd64 | x86_arm | x86_arm64 | amd64_x86 | amd64_arm | amd64_arm64

"x64_x86" is a Microsoft-specific thing, it will confuse people. They expect the Architectures column to list the architecture on which Node runs, not how it's built.

I also think this is confusing. IMHO we should keep this as it is, and add the note about x64 host.

bzoz

I'm -1 on x64_x86. IMHO we should put note about only support compilation on 64bit machines in the "Notes" column

refack · 2018-07-19T20:33:32Z

@seishun @bzoz @mmarchini @jasnell PTAL.
I Moved the change to a note. Since there were already a few heterogeneous notes, I made them uniform, but I'd be happy to hear comments about the style.

seishun · 2018-07-19T20:35:34Z

BUILDING.md

@@ -89,7 +92,7 @@ Depending on host platform, the selection of toolchains may vary.

 #### Windows

-* Visual Studio 2017 or the Build Tools thereof
+* "Visual Studio 2017" or the "Build Tools" thereof, on a 64 bit host.


I should have been more explicit: please don't put product names in quotes.

We actually don't test with the Build Tools package anymore. And we only use Windows SDK 10.

vsemozhetbyt · 2018-07-19T20:32:51Z

BUILDING.md

-*Note*: On Windows, running Node.js in windows terminal emulators like `mintty`
-  requires the usage of [winpty](https://github.com/rprichard/winpty) for
-  Node's tty channels to work correctly (e.g. `winpty node.exe script.js`).
+<em id="fn2">2</em>: Teir 1 support for building on Windows is only on 64 bit


Teir -> Tier

vsemozhetbyt · 2018-07-19T20:35:03Z

BUILDING.md

+<em id="fn2">2</em>: Teir 1 support for building on Windows is only on 64 bit
+  hosts. Support is experimental for 32 bit hosts.
+
+<em id="fn3">3</em>: On Windows, running Node.js in windows terminal emulators


windows -> Windows

vsemozhetbyt · 2018-07-19T20:39:00Z

BUILDING.md

+
+<em id="fn3">3</em>: On Windows, running Node.js in windows terminal emulators
+  like `mintty` requires the usage of [winpty](https://github.com/rprichard/winpty)
+  for Node's tty channels to work correctly (e.g. `winpty node.exe script.js`).


Node's -> Node.js's? (A bit awkward, but it seems we try to be consistent here.)

How about Node's -> the

Seems good.

seishun · 2018-07-19T20:55:13Z

BUILDING.md

@@ -89,7 +92,7 @@ Depending on host platform, the selection of toolchains may vary.

 #### Windows

-* Visual Studio 2017 or the Build Tools thereof
+* Visual Studio 2017 with the Windows 10 SDK on a 64 bit host.


This is under "Supported Toolchains". There is no need to mention Windows 10 SDK or bitness here. The specific requirements are listed in a separate section. Why change this line at all?

IMHO SDK and host bitness are parts of the toolchain 🤷‍♂️

I'm on vacation, so I can't review this. I'm dismissing my -1 to not block this

gibfahn · 2018-07-22T23:50:11Z

I Moved the change to a note. Since there were already a few heterogeneous notes, I made them uniform, but I'd be happy to hear comments about the style.

Notes look really good FWIW.

mmarchini

Still LGTM. Nice job improving the notes!

refack · 2018-08-16T22:16:26Z

CI: https://ci.nodejs.org/job/node-test-pull-request-lite-pipeline/577/
(+ https://ci.nodejs.org/job/node-test-commit-linux-containered/6343/)

Since we are CI testing on x64 hosts, we can only commit to x64 hosts. PR-URL: nodejs#21443 Refs: nodejs#21402 Refs: nodejs#21437 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Matheus Marchini <[email protected]> Reviewed-By: João Reis <[email protected]>

Since we are CI testing on x64 hosts, we can only commit to x64 hosts. PR-URL: #21443 Refs: #21402 Refs: #21437 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Matheus Marchini <[email protected]> Reviewed-By: João Reis <[email protected]>

nodejs-github-bot added build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations. labels Jun 21, 2018

refack added windows Issues and PRs related to the Windows platform. and removed build Issues and PRs related to build files or the CI. doc Issues and PRs related to the documentations. labels Jun 21, 2018

seishun reviewed Jun 21, 2018

View reviewed changes

refack commented Jun 21, 2018

View reviewed changes

jasnell approved these changes Jun 21, 2018

View reviewed changes

mmarchini approved these changes Jun 21, 2018

View reviewed changes

bzoz previously requested changes Jun 25, 2018

View reviewed changes

refack added doc Issues and PRs related to the documentations. build Issues and PRs related to build files or the CI. meta Issues and PRs related to the general management of the project. labels Jul 19, 2018

seishun reviewed Jul 19, 2018

View reviewed changes

refack mentioned this pull request Jul 19, 2018

doc: Windows and Visual Studio supported versions nodejs/build#1407

Closed

vsemozhetbyt reviewed Jul 19, 2018

View reviewed changes

seishun reviewed Jul 19, 2018

View reviewed changes

joaocgreis approved these changes Jul 23, 2018

View reviewed changes

mmarchini approved these changes Jul 23, 2018

View reviewed changes

refack force-pushed the refack-patch-3 branch 2 times, most recently from 2bc2c58 to 796d510 Compare August 16, 2018 22:00

refack force-pushed the refack-patch-3 branch from 796d510 to 0eb4a4e Compare August 16, 2018 23:07

refack force-pushed the refack-patch-3 branch from 0eb4a4e to 73b8dde Compare August 16, 2018 23:08

refack merged commit 73b8dde into nodejs:master Aug 16, 2018

refack deleted the refack-patch-3 branch August 16, 2018 23:09

targos mentioned this pull request Sep 5, 2018

Release proposal: v10.10.0 #22716

Merged

This was referenced Sep 6, 2018

2018-09-06 Version 10.10.0 (Current) @targos beevelop/docker-android-nodejs#236

Closed

2018-09-06 Version 10.10.0 (Current) @targos beevelop/docker-nodejs#221

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc: Windows building officially supported only on x64 hosts #21443

doc: Windows building officially supported only on x64 hosts #21443

refack commented Jun 21, 2018

nodejs-github-bot commented Jun 21, 2018

refack commented Jun 21, 2018

seishun Jun 21, 2018

seishun Jun 21, 2018

seishun Jun 21, 2018

refack Jun 21, 2018

seishun Jun 21, 2018

seishun Jun 21, 2018

refack Jun 21, 2018

refack Jun 21, 2018

seishun Jun 21, 2018

bzoz Jun 21, 2018

bzoz left a comment

refack commented Jul 19, 2018

seishun Jul 19, 2018 •

edited

Loading

refack Jul 19, 2018

vsemozhetbyt Jul 19, 2018

vsemozhetbyt Jul 19, 2018

vsemozhetbyt Jul 19, 2018

refack Jul 19, 2018

vsemozhetbyt Jul 19, 2018

seishun Jul 19, 2018

refack Jul 19, 2018

gibfahn commented Jul 22, 2018

mmarchini left a comment

refack commented Aug 16, 2018

doc: Windows building officially supported only on x64 hosts #21443

doc: Windows building officially supported only on x64 hosts #21443

Conversation

refack commented Jun 21, 2018

Checklist

nodejs-github-bot commented Jun 21, 2018

refack commented Jun 21, 2018

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

bzoz left a comment

Choose a reason for hiding this comment

refack commented Jul 19, 2018

seishun Jul 19, 2018 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gibfahn commented Jul 22, 2018

mmarchini left a comment

Choose a reason for hiding this comment

refack commented Aug 16, 2018

seishun Jul 19, 2018 •

edited

Loading