doc,build,win: update docs with clang#57991
Conversation
Updated BUILDING.md to make ClangCL mandatory for new versions of Node. Forcing clang-cl flag in vcbuild if not specified, thus disabling MSVC.
Co-authored-by: Joyee Cheung <joyeec9h3@gmail.com>
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
This comment was marked as outdated.
Commit Queue failed- Loading data for nodejs/node/pull/57991 ✔ Done loading data for nodejs/node/pull/57991 ----------------------------------- PR info ------------------------------------ Title doc,build,win: update docs with clang (#57991) ⚠ Could not retrieve the email or name of the PR author's from user's GitHub profile! Branch StefanStojanovic:mefi-clang-doc -> nodejs:main Labels doc, windows, build, tools, needs-ci, dont-land-on-v18.x, dont-land-on-v20.x, dont-land-on-v22.x, dont-land-on-v23.x Commits 2 - doc,build,win: update docs with clang - Update vcbuild.bat Committers 2 - StefanStojanovic <stefan.stojanovic@janeasystems.com> - GitHub <noreply@github.com> PR-URL: https://github.com/nodejs/node/pull/57991 Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> ------------------------------ Generated metadata ------------------------------ PR-URL: https://github.com/nodejs/node/pull/57991 Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> -------------------------------------------------------------------------------- ℹ This PR was created on Wed, 23 Apr 2025 14:06:54 GMT ✔ Approvals: 3 ✔ - Richard Lau (@richardlau) (TSC): https://github.com/nodejs/node/pull/57991#pullrequestreview-2787527994 ✔ - Joyee Cheung (@joyeecheung) (TSC): https://github.com/nodejs/node/pull/57991#pullrequestreview-2791118510 ✔ - Luigi Pinca (@lpinca): https://github.com/nodejs/node/pull/57991#pullrequestreview-2788669874 ✔ Last GitHub CI successful ℹ Last Full PR CI on 2025-04-28T14:55:52Z: https://ci.nodejs.org/job/node-test-pull-request/66501/ - Querying data for job/node-test-pull-request/66501/ ✔ Last Jenkins CI successful -------------------------------------------------------------------------------- ✔ No git cherry-pick in progress ✔ No git am in progress ✔ No git rebase in progress -------------------------------------------------------------------------------- - Bringing origin/main up to date... From https://github.com/nodejs/node * branch main -> FETCH_HEAD ✔ origin/main is now up-to-date - Downloading patch for 57991 From https://github.com/nodejs/node * branch refs/pull/57991/merge -> FETCH_HEAD ✔ Fetched commits as a7cbb9047455..f8bce751bbbd -------------------------------------------------------------------------------- Auto-merging BUILDING.md [main 49114546ed] doc,build,win: update docs with clang Author: StefanStojanovic <stefan.stojanovic@janeasystems.com> Date: Wed Apr 23 12:53:31 2025 +0200 3 files changed, 13 insertions(+), 9 deletions(-) [main 2f0886cb01] Update vcbuild.bat Author: Stefan Stojanovic <StefanStojanovic@users.noreply.github.com> Date: Thu Apr 24 09:38:46 2025 +0200 1 file changed, 1 insertion(+), 1 deletion(-) ✔ Patches applied There are 2 commits in the PR. Attempting autorebase. Rebasing (2/4) Executing: git node land --amend --yes --------------------------------- New Message ---------------------------------- doc,build,win: update docs with clanghttps://github.com/nodejs/node/actions/runs/14748719324 |
|
Landed in 2244a09 |
|
I guess this should be included into the 24 release and also part of the notable changes there. |
Updated BUILDING.md to make ClangCL mandatory for new versions of Node. Forcing clang-cl flag in vcbuild if not specified, thus disabling MSVC. PR-URL: #57991 Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Updated BUILDING.md to make ClangCL mandatory for new versions of Node. Forcing clang-cl flag in vcbuild if not specified, thus disabling MSVC. PR-URL: #57991 Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
This PR changes the documentation to fit the new compiler on Windows - ClangCL. The main focus is the
BUILDING.mdfile. All threeWindows Prerequisitessections are updated to reflect the compiler change (WinGet configuration already supported it, so no changes there).In addition, there are changes to
vcbuild.batto add theclang-clflag for Node.js v24+ even if not provided. Since v24 will include #57753 (or some other V8 update), compiling with MSVC will result in errors, so IMHO, there is not much use in allowing MSVC compilation at all, although I'm open to suggestions and different opinions on this.