diff --git a/BUILDING.md b/BUILDING.md index 76e3907ed9ace3..bf5c5565a0f081 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -210,8 +210,7 @@ For use of AVX2, * llvm version 3.3 or higher * nasm version 2.10 or higher in Windows -Please refer to - for details. +Please refer to for details. If compiling without one of the above, use `configure` with the `--openssl-no-asm` flag. Otherwise, `configure` will fail. @@ -529,7 +528,7 @@ $ gdb /opt/node-debug/node core.node.8.1535359906 [ASan](https://github.com/google/sanitizers) can help detect various memory related bugs. ASan builds are currently only supported on linux. If you want to check it on Windows or macOS or you want a consistent toolchain -on Linux, you can try [Docker](https://www.docker.com/products/docker-desktop) +on Linux, you can try [Docker](https://www.docker.com/products/docker-desktop/) (using an image like `gengjiawen/node-build:2020-02-14`). The `--debug` is not necessary and will slow down build and testing, but it can @@ -622,7 +621,11 @@ vcpkg owns zlib1.dll vcpkg integrate remove ``` -Refs: #24448, , [vcpkg](https://github.com/microsoft/vcpkg/) +Refs: + +1. +2. / +3. [vcpkg](https://github.com/microsoft/vcpkg/) #### Windows Prerequisites @@ -681,9 +684,9 @@ packages: * [NetWide Assembler](https://chocolatey.org/packages/nasm) To install Node.js prerequisites using -[Boxstarter WebLauncher](https://boxstarter.org/weblauncher), open +[Boxstarter WebLauncher](https://boxstarter.org/weblauncher), visit -with Edge browser on the target machine. +with a supported browser. Alternatively, you can use PowerShell. Run those commands from an elevated (Administrator) PowerShell terminal: @@ -758,7 +761,7 @@ architecture supports \[arm, arm64/aarch64, x86, x86\_64]. ## `Intl` (ECMA-402) support -[Intl](https://github.com/nodejs/node/blob/HEAD/doc/api/intl.md) support is +[Intl](doc/api/intl.md) support is enabled by default. ### Build with full ICU support (all locales supported by ICU) @@ -824,7 +827,7 @@ that works for both your host and target environments. ### Build with a specific ICU You can find other ICU releases at -[the ICU homepage](http://site.icu-project.org/download). +[the ICU homepage](https://icu.unicode.org/download). Download the file named something like `icu4c-**##.#**-src.tgz` (or `.zip`). @@ -855,7 +858,7 @@ From a tarball URL: #### Windows First unpack latest ICU to `deps/icu` -[icu4c-**##.#**-src.tgz](http://site.icu-project.org/download) (or `.zip`) +[icu4c-**##.#**-src.tgz](https://icu.unicode.org/download) (or `.zip`) as `deps/icu` (You'll have: `deps/icu/source/...`) ```powershell @@ -878,10 +881,10 @@ configure option: ## Building Node.js with FIPS-compliant OpenSSL Node.js supports FIPS when statically or dynamically linked with OpenSSL 3 via -[OpenSSL's provider model](https://www.openssl.org/docs/man3.0/man7/crypto.html#OPENSSL-PROVIDERS). +[OpenSSL's provider model](https://docs.openssl.org/3.0/man7/crypto/#OPENSSL-PROVIDERS). It is not necessary to rebuild Node.js to enable support for FIPS. -See [FIPS mode](./doc/api/crypto.md#fips-mode) for more information on how to +See [FIPS mode](doc/api/crypto.md#fips-mode) for more information on how to enable FIPS support in Node.js. ## Building Node.js with external core modules