doc: west: move advanced content out of 'basics'

With the documentation for west 0.9, the 'basics' page is completely
out of control. Reorganize it so it fits in a few pages, moving many
details out into other pages for the truly curious.

As part of this, create new pages for built-in commands (built-in.rst)
and esoteric details about workspaces (workspaces.rst).

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
This commit is contained in:
Martí Bolívar 2021-02-06 13:18:02 -08:00 committed by Anas Nashif
commit 353efd04b1
13 changed files with 770 additions and 658 deletions

View file

@ -77,19 +77,19 @@ Glossary of Terms
west manifest
A YAML file, usually named :file:`west.yml`, which describes projects, or
the Git repositories which make up a :term:`west workspace`, along with
additional metadata. See :ref:`west-multi-repo` for general information
additional metadata. See :ref:`west-basics` for general information
and :ref:`west-manifests` for details.
west manifest repository
The Git repository in a :term:`west workspace` which contains the
:term:`west manifest`. Its location is given by the :ref:`manifest.path
configuration option <west-config-index>`. See :ref:`west-multi-repo`.
configuration option <west-config-index>`. See :ref:`west-basics`.
west workspace
A directory on your system with a :file:`.west` subdirectory and
a :term:`west manifest repository`. You clone the Zephyr source
code onto your system by creating a west workspace using the
``west init`` command. See :ref:`west-multi-repo`.
``west init`` command. See :ref:`west-basics`.
XIP
(eXecute In Place) a method of executing programs directly from long