diff options
author | Rod Vagg <rod@vagg.org> | 2019-06-28 18:01:02 +1000 |
---|---|---|
committer | Rod Vagg <rod@vagg.org> | 2019-07-02 11:36:26 +1000 |
commit | b12528f34935d6dd45ba00f06eebf261d867e104 (patch) | |
tree | 08d8c9c1481b6eabd1ad8ae45dffee0963a05e12 /tools/bootstrap | |
parent | 1095635a8aaf8658670a0610fea5dd775bac36d1 (diff) | |
download | android-node-v8-b12528f34935d6dd45ba00f06eebf261d867e104.tar.gz android-node-v8-b12528f34935d6dd45ba00f06eebf261d867e104.tar.bz2 android-node-v8-b12528f34935d6dd45ba00f06eebf261d867e104.zip |
doc: merge bootstrap/README.md into BUILDING.md
plus some minor tweaks
PR-URL: https://github.com/nodejs/node/pull/28465
Reviewed-By: Ben Noordhuis <info@bnoordhuis.nl>
Reviewed-By: Sam Roberts <vieuxtech@gmail.com>
Reviewed-By: Richard Lau <riclau@uk.ibm.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com>
Diffstat (limited to 'tools/bootstrap')
-rw-r--r-- | tools/bootstrap/README.md | 69 |
1 files changed, 2 insertions, 67 deletions
diff --git a/tools/bootstrap/README.md b/tools/bootstrap/README.md index df69a540c1..4098b5c3a2 100644 --- a/tools/bootstrap/README.md +++ b/tools/bootstrap/README.md @@ -1,67 +1,2 @@ -# Node.js Bootstrapping Guide - -## Windows - -A [Boxstarter][] script can be used for easy setup of Windows systems with all -the required prerequisites for Node.js development. This script will install -the following [Chocolatey] packages: - * [Git for Windows][] with the `git` and Unix tools added to the `PATH` - * [Python 3.x][] and [legacy Python][] - * [Visual Studio 2017 Build Tools][] with [Visual C++ workload][] - * [NetWide Assembler][] - -To install Node.js prerequisites using [Boxstarter WebLauncher][], just open -[this link](http://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter) -with Internet Explorer or Edge browser on the target machine. - -Alternatively, you can use PowerShell. Run those commands from an elevated -PowerShell terminal: -```console -Set-ExecutionPolicy Unrestricted -Force -iex ((New-Object System.Net.WebClient).DownloadString('http://boxstarter.org/bootstrapper.ps1')) -get-boxstarter -Force -Install-BoxstarterPackage https://raw.githubusercontent.com/nodejs/node/master/tools/bootstrap/windows_boxstarter -DisableReboots -``` - -Entire installation will take up about 10 GB of disk space. - -### Why install two different versions of Python? -Python 2 will reach its _end-of-life_ at the end of 2019. Afterwards, the -interpreter will not get updates — no bugfixes, no security fixes, nothing. In -the interim, the Python ecosystem is abandoning 2.7 support. -https://python3statement.org/ In order to remain safe and current the Node.js -community is transitioning its Python code to Python 3. Having both versions of -Python in this bootstrap will allow developers and end users to test, benchmark, -and debug Node.js running on both versions to ensure a smooth and complete -transition before the yearend deadline. - -## Linux - -For building Node.js on Linux, following packages are required (note, that this -can vary from distribution to distribution): - * `git` - * `python` - * `gcc-c++` or `g++` - * `make` - -To bootstrap Node.js on Linux, run in terminal: - * OpenSUSE: `sudo zypper install git python gcc-c++ make` - * Fedora: `sudo dnf install git python gcc-c++ make` - * Ubuntu, Debian: `sudo apt-get install git python g++ make` - -## macOS - -To install required tools on macOS, run in terminal: -```console -xcode-select --install -``` - -[Boxstarter]: http://boxstarter.org/ -[Boxstarter WebLauncher]: http://boxstarter.org/WebLauncher -[Chocolatey]: https://chocolatey.org/ -[Git for Windows]: https://chocolatey.org/packages/git -[Python 3.x]: https://chocolatey.org/packages/python -[legacy Python]: https://chocolatey.org/packages/python2 -[Visual Studio 2017 Build Tools]: https://chocolatey.org/packages/visualstudio2017buildtools -[Visual C++ workload]: https://chocolatey.org/packages/visualstudio2017-workload-vctools -[NetWide Assembler]: https://chocolatey.org/packages/nasm +See the main project [README.md](../../README.md#boxstarter) for details on how +to use this script. |