|
|
|
|
|
|
|
|
This page provides an introduction on how one can make use of toolchains most |
|
|
This page provides an introduction on how one can make use of toolchains most |
|
|
effectively in your project. |
|
|
effectively in your project. |
|
|
|
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
|
|
**IMPORTANT**: ``dds`` will *not* automatically load the Visual C++ |
|
|
|
|
|
environment. To use Visual C++, ``dds`` must be executed from the |
|
|
|
|
|
appropriate environment in order for the Visual C++ toolchain executables |
|
|
|
|
|
and files to be available. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Passing a Toolchain |
|
|
Passing a Toolchain |
|
|
******************* |
|
|
******************* |
|
|
|
|
|
|
|
|
convention. When running a build for a project, the ``dds`` executable will |
|
|
convention. When running a build for a project, the ``dds`` executable will |
|
|
look for a file named ``toolchain.tc.dds`` by default, and will error out if |
|
|
look for a file named ``toolchain.tc.dds`` by default, and will error out if |
|
|
this file does not exist. A different toolchain can be provided by passing the |
|
|
this file does not exist. A different toolchain can be provided by passing the |
|
|
toolchain file for the ``--toolchain`` (or ``-T``) option on the command line:: |
|
|
|
|
|
|
|
|
toolchain file for the ``--toolchain`` (or ``-t``) option on the command line:: |
|
|
|
|
|
|
|
|
$ dds build -T my-toolchain.tc.dds |
|
|
|
|
|
|
|
|
$ dds build -t my-toolchain.tc.dds |
|
|
|
|
|
|
|
|
Alternatively, you can pass the name of a built-in toolchain. See below. |
|
|
Alternatively, you can pass the name of a built-in toolchain. See below. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The following pseudo-toolchains are also available: |
|
|
The following pseudo-toolchains are also available: |
|
|
|
|
|
|
|
|
|
|
|
``:debug:XYZ`` |
|
|
|
|
|
Uses built-in toolchain ``:XYZ``, but generates debugging information. |
|
|
|
|
|
|
|
|
``:ccache:XYZ`` |
|
|
``:ccache:XYZ`` |
|
|
Uses built-in toolchain ``:XYZ``, but prefixes all compile commands with |
|
|
Uses built-in toolchain ``:XYZ``, but prefixes all compile commands with |
|
|
``ccache``. |
|
|
``ccache``. |
|
|
|
|
|
|
|
|
.. note:: |
|
|
|
|
|
**IMPORTANT**: ``dds`` will *not* automatically load the Visual C++ |
|
|
|
|
|
environment. To use Visual C++, ``dds`` must be executed from the |
|
|
|
|
|
appropriate environment in order for the Visual C++ toolchain executables |
|
|
|
|
|
and files to be available. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
``:c++UV:XYZ`` (for two integers ``UV``) |
|
|
|
|
|
Sets the C++ version to ``C++UV`` and uses the ``:XYZ`` toolchain. |