Documentation: add 'make' to GSG and expand PATH for sphinx-build

Getting Started Guide: add one more bundle to be added on a Clear
Linux development machine to make sure 'make' and other development
packages are available.

ACRN Documentation Generation: expand the 'PATH' variable to include
'~/.local/bin' where 'sphinx-build' is installed.

Tracked-On: #1650

Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
This commit is contained in:
Geoffroy Van Cutsem
2018-10-30 02:36:30 +01:00
committed by David Kinder
parent 4b3b11552d
commit 469496311c
2 changed files with 20 additions and 6 deletions

View File

@@ -137,6 +137,9 @@ Our documentation processing has been tested to run with:
Depending on your Linux version, install the needed tools:
* For Clear Linux: follow the :ref:`getting-started-apl-nuc` to install
all the tools required
* For Ubuntu use:
.. code-block:: bash
@@ -150,7 +153,7 @@ Depending on your Linux version, install the needed tools:
sudo dnf install doxygen python3-pip python3-wheel make graphviz
And for either Linux environment, install the remaining python-based
And for any of these Linux environments, install the remaining python-based
tools:
.. code-block:: bash
@@ -158,6 +161,19 @@ tools:
cd ~/projectacrn/acrn-hypervisor/doc
pip3 install --user -r scripts/requirements.txt
Add ``$HOME/.local/bin`` to the front of your ``PATH`` so the system will
find expected versions of python utilities such as ``sphinx-build`` and
``breathe``:
.. code-block:: bash
printf "\nexport PATH=\$HOME/.local/bin:\$PATH" >> ~/.bashrc
.. note::
You will need to open a new terminal for this change to be effective.
Adding this to your ``~/.bashrc`` file ensures it is set by default.
And with that you're ready to generate the documentation.
.. note::