esp-idf/docs/en/get-started-legacy/toolchain-setup-scratch.rst

.. _get-started-customized-setup-legacy:

***********************************************
Customized Setup of Toolchain (Legacy GNU Make)
***********************************************

Instead of downloading binary toolchain from Espressif website (see :ref:`get-started-setup-toolchain-legacy`) you may build the toolchain yourself.

.. include:: ../gnu-make-legacy.rst

If you can't think of a reason why you need to build it yourself, then probably it's better to stick with the binary version. However, here are some of the reasons why you might want to compile it from source:

- if you want to customize toolchain build configuration
- if you want to use a different GCC version (such as 4.8.5)
- if you want to hack gcc or newlib or libstdc++
- if you are curious and/or have time to spare
- if you don't trust binaries downloaded from the Internet

In any case, here are the instructions to compile the toolchain yourself.

.. toctree::
    :maxdepth: 1

    windows-setup-scratch
    linux-setup-scratch
    macos-setup-scratch
docs: Make CMake build system default, mark GNU Make as legacy option All `-cmake` suffixes are removed Where a GNU Make option is renamed, the `-legacy` suffix is used 2019-06-24 21:26:53 -04:00			`.. _get-started-customized-setup-legacy:`
docs: Copy CMake docs to a separate set of directories Required first step before merging back to mainline. 2018-08-08 03:58:00 -04:00
docs: Make CMake build system default, mark GNU Make as legacy option All `-cmake` suffixes are removed Where a GNU Make option is renamed, the `-legacy` suffix is used 2019-06-24 21:26:53 -04:00			`***********************************************`
			`Customized Setup of Toolchain (Legacy GNU Make)`
			`***********************************************`
docs: Copy CMake docs to a separate set of directories Required first step before merging back to mainline. 2018-08-08 03:58:00 -04:00
docs: Make CMake build system default, mark GNU Make as legacy option All `-cmake` suffixes are removed Where a GNU Make option is renamed, the `-legacy` suffix is used 2019-06-24 21:26:53 -04:00			Instead of downloading binary toolchain from Espressif website (see :ref:`get-started-setup-toolchain-legacy`) you may build the toolchain yourself.

			`.. include:: ../gnu-make-legacy.rst`
docs: Copy CMake docs to a separate set of directories Required first step before merging back to mainline. 2018-08-08 03:58:00 -04:00
			`If you can't think of a reason why you need to build it yourself, then probably it's better to stick with the binary version. However, here are some of the reasons why you might want to compile it from source:`

			`- if you want to customize toolchain build configuration`
			`- if you want to use a different GCC version (such as 4.8.5)`
			`- if you want to hack gcc or newlib or libstdc++`
			`- if you are curious and/or have time to spare`
			`- if you don't trust binaries downloaded from the Internet`

			`In any case, here are the instructions to compile the toolchain yourself.`

			`.. toctree::`
			`:maxdepth: 1`

			`windows-setup-scratch`
			`linux-setup-scratch`
			`macos-setup-scratch`