Unverified Commit c803b5cb authored by Nikita Titov's avatar Nikita Titov Committed by GitHub
Browse files

fixed links to Visual Studio for docs check at Travis (#1464)

parent 5fe2bdd7
...@@ -14,13 +14,13 @@ Note: 32-bit R/Rtools is not supported. ...@@ -14,13 +14,13 @@ Note: 32-bit R/Rtools is not supported.
Installing [Rtools](https://cran.r-project.org/bin/windows/Rtools/) is mandatory, and only support the 64-bit version. It requires to add to PATH the Rtools MinGW64 folder, if it was not done automatically during installation. Installing [Rtools](https://cran.r-project.org/bin/windows/Rtools/) is mandatory, and only support the 64-bit version. It requires to add to PATH the Rtools MinGW64 folder, if it was not done automatically during installation.
The default compiler is Visual Studio (or [MS Build](https://www.visualstudio.com/downloads/)) in Windows, with an automatic fallback to Rtools or any [MinGW64](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/) (x86_64-posix-seh) available (this means if you have only Rtools and CMake, it will compile fine). The default compiler is Visual Studio (or [MS Build](https://visualstudio.microsoft.com/downloads/)) in Windows, with an automatic fallback to Rtools or any [MinGW64](https://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/) (x86_64-posix-seh) available (this means if you have only Rtools and CMake, it will compile fine).
To force the usage of Rtools / MinGW, you can set `use_mingw` to `TRUE` in `R-package/src/install.libs.R`. To force the usage of Rtools / MinGW, you can set `use_mingw` to `TRUE` in `R-package/src/install.libs.R`.
For users who wants to install online with GPU or want to choose a specific compiler, please check the end of this document for installation using a helper package ([Laurae2/lgbdl](https://github.com/Laurae2/lgbdl/)). For users who wants to install online with GPU or want to choose a specific compiler, please check the end of this document for installation using a helper package ([Laurae2/lgbdl](https://github.com/Laurae2/lgbdl/)).
**Warning for Windows users**: it is recommended to use *Visual Studio* for its better multi-threading efficency in Windows for many core systems. For very simple systems (dual core computers or worse), MinGW64 is recommended for maximum performance. If you do not know what to choose, it is recommended to use [Visual Studio](https://www.visualstudio.com/downloads/), the default compiler. **Do not try using MinGW in Windows on many core systems. It may result in 10x slower results than Visual Studio.** **Warning for Windows users**: it is recommended to use *Visual Studio* for its better multi-threading efficency in Windows for many core systems. For very simple systems (dual core computers or worse), MinGW64 is recommended for maximum performance. If you do not know what to choose, it is recommended to use [Visual Studio](https://visualstudio.microsoft.com/downloads/), the default compiler. **Do not try using MinGW in Windows on many core systems. It may result in 10x slower results than Visual Studio.**
#### macOS Preparation #### macOS Preparation
......
...@@ -100,7 +100,7 @@ LightGBM ...@@ -100,7 +100,7 @@ LightGBM
- **Question 8**: CPU usage is low (like 10%) in Windows when using LightGBM on very large datasets with many core systems. - **Question 8**: CPU usage is low (like 10%) in Windows when using LightGBM on very large datasets with many core systems.
- **Solution 8**: Please use `Visual Studio <https://www.visualstudio.com/downloads/>`__ - **Solution 8**: Please use `Visual Studio <https://visualstudio.microsoft.com/downloads/>`__
as it may be `10x faster than MinGW <https://github.com/Microsoft/LightGBM/issues/749>`__ especially for very large trees. as it may be `10x faster than MinGW <https://github.com/Microsoft/LightGBM/issues/749>`__ especially for very large trees.
-------------- --------------
......
...@@ -374,13 +374,13 @@ This will generate a JAR file containing the LightGBM `C API <./Development-Guid ...@@ -374,13 +374,13 @@ This will generate a JAR file containing the LightGBM `C API <./Development-Guid
.. _zip archive: https://github.com/Microsoft/LightGBM/archive/master.zip .. _zip archive: https://github.com/Microsoft/LightGBM/archive/master.zip
.. _Visual Studio: https://www.visualstudio.com/downloads/ .. _Visual Studio: https://visualstudio.microsoft.com/downloads/
.. _Git for Windows: https://git-scm.com/download/win .. _Git for Windows: https://git-scm.com/download/win
.. _CMake: https://cmake.org/ .. _CMake: https://cmake.org/
.. _MSBuild: https://www.visualstudio.com/downloads/ .. _MSBuild: https://visualstudio.microsoft.com/downloads/
.. _MinGW-w64: https://mingw-w64.org/doku.php/download .. _MinGW-w64: https://mingw-w64.org/doku.php/download
......
...@@ -39,7 +39,7 @@ For Linux and macOS users, installation from sources requires installed `CMake < ...@@ -39,7 +39,7 @@ For Linux and macOS users, installation from sources requires installed `CMake <
For macOS users, you need to specify compilers by runnig ``export CXX=g++-7 CC=gcc-7`` (replace 7 with version of gcc installed on your machine) first. For macOS users, you need to specify compilers by runnig ``export CXX=g++-7 CC=gcc-7`` (replace 7 with version of gcc installed on your machine) first.
For Windows users, Visual Studio (or `MS Build <https://www.visualstudio.com/downloads/>`_) is needed. If you get any errors during installation, you may need to install `CMake <https://cmake.org/>`_ (version 3.8 or higher). For Windows users, Visual Studio (or `MS Build <https://visualstudio.microsoft.com/downloads/>`_) is needed. If you get any errors during installation, you may need to install `CMake <https://cmake.org/>`_ (version 3.8 or higher).
Build MPI Version Build MPI Version
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
...@@ -108,7 +108,7 @@ Install from GitHub ...@@ -108,7 +108,7 @@ Install from GitHub
For Linux and macOS users, installation from GitHub requires installed `CMake <https://cmake.org/>`_. For Linux and macOS users, installation from GitHub requires installed `CMake <https://cmake.org/>`_.
For Windows users, Visual Studio (or `MS Build <https://www.visualstudio.com/downloads/>`_) is needed. If you get any errors during installation and there is the warning ``WARNING:LightGBM:Compilation with MSBuild from existing solution file failed.`` in the log, you should install `CMake <https://cmake.org/>`_ (version 3.8 or higher). For Windows users, Visual Studio (or `MS Build <https://visualstudio.microsoft.com/downloads/>`_) is needed. If you get any errors during installation and there is the warning ``WARNING:LightGBM:Compilation with MSBuild from existing solution file failed.`` in the log, you should install `CMake <https://cmake.org/>`_ (version 3.8 or higher).
.. code:: sh .. code:: sh
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment