doc: improve installing dependencies

A few language fixes to the install dependencies section.
Also adding IDs to be able to link directly.

Signed-off-by: Ruth Fuchss <ruth.fuchss@nordicsemi.no>
This commit is contained in:
Ruth Fuchss 2021-05-27 11:15:53 +02:00 committed by Kumar Gala
commit 268247c069

View file

@ -57,7 +57,9 @@ Next, you'll install some host dependencies using your package manager.
.. group-tab:: Ubuntu .. group-tab:: Ubuntu
#. Use ``apt`` to install dependencies: .. _install_dependencies_ubuntu:
#. Use ``apt`` to install the required dependencies:
.. code-block:: bash .. code-block:: bash
@ -66,13 +68,13 @@ Next, you'll install some host dependencies using your package manager.
python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \ python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \
make gcc gcc-multilib g++-multilib libsdl2-dev make gcc gcc-multilib g++-multilib libsdl2-dev
#. Verify the version of cmake installed on your system using:: #. Verify the version of cmake that is installed on your system by entering::
cmake --version cmake --version
If it's not version 3.13.1 or higher, follow these steps to The version must be 3.13.1 or later. If your version is older, complete the following
add the `Kitware third-party apt repository <https://apt.kitware.com/>`__ steps to add the `Kitware third-party apt repository <https://apt.kitware.com/>`__,
to get an updated version of cmake. which contains an updated version of cmake.
a) Add the Kitware signing key: a) Add the Kitware signing key:
@ -87,7 +89,7 @@ Next, you'll install some host dependencies using your package manager.
sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ bionic main' sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ bionic main'
c) Then install the updated cmake with ``apt``: c) Then install the updated version of cmake with ``apt``:
.. code-block:: bash .. code-block:: bash
@ -96,13 +98,15 @@ Next, you'll install some host dependencies using your package manager.
.. group-tab:: macOS .. group-tab:: macOS
.. _install_dependencies_macos:
#. Install `Homebrew <https://brew.sh/>`_: #. Install `Homebrew <https://brew.sh/>`_:
.. code-block:: bash .. code-block:: bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
#. Use ``brew`` to install dependencies: #. Use ``brew`` to install the required dependencies:
.. code-block:: bash .. code-block:: bash
@ -130,27 +134,29 @@ Next, you'll install some host dependencies using your package manager.
|p| |p|
#. `Install chocolatey`_ .. _install_dependencies_windows:
#. Open an **Administrator** ``cmd.exe`` window: press the Windows key, #. `Install chocolatey`_.
type "cmd.exe", right-click the result, and choose "Run as
Administrator".
#. Disable global confirmation to avoid having to confirm #. Open a ``cmd.exe`` window as **Administrator**. To do so, press the Windows key,
type "cmd.exe", right-click the result, and choose :guilabel:`Run as
Administrator`.
#. Disable global confirmation to avoid having to confirm the
installation of individual programs: installation of individual programs:
.. code-block:: console .. code-block:: console
choco feature enable -n allowGlobalConfirmation choco feature enable -n allowGlobalConfirmation
#. Use ``choco`` to install dependencies: #. Use ``choco`` to install the required dependencies:
.. code-block:: console .. code-block:: console
choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System' choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
choco install ninja gperf python git choco install ninja gperf python git
#. Open a new ``cmd.exe`` window **as a regular user** to continue. #. Close the window and open a new ``cmd.exe`` window **as a regular user** to continue.
.. _Chocolatey: https://chocolatey.org/ .. _Chocolatey: https://chocolatey.org/
.. _Install chocolatey: https://chocolatey.org/install .. _Install chocolatey: https://chocolatey.org/install