summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitlab-ci.yml1
-rw-r--r--doc/source/conf.py1
-rw-r--r--doc/source/index.rst1
-rw-r--r--doc/source/invoking.rst8
4 files changed, 11 insertions, 0 deletions
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 765437273..b1b51b282 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -25,6 +25,7 @@ tests:
pages:
script:
- pip3 install sphinx
+ - pip3 install sphinx-click
- pip3 install --user -e .
- make -C doc
- mv doc/build/html public
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 7d3ed6468..f702ecd0f 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -33,6 +33,7 @@ sys.path.insert(0, os.path.abspath('..'))
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.napoleon',
+ 'sphinx_click.ext'
]
# Add any paths that contain templates here, relative to this directory.
diff --git a/doc/source/index.rst b/doc/source/index.rst
index c7651f473..648edd06d 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -30,6 +30,7 @@ Here are some resources to help understand the BuildStream format and also to ge
off the ground installing it on a new host.
* :ref:`installing`
+* :ref:`invoking`
* :ref:`config`
* :ref:`projectconf`
* :ref:`format`
diff --git a/doc/source/invoking.rst b/doc/source/invoking.rst
new file mode 100644
index 000000000..ca14f24bd
--- /dev/null
+++ b/doc/source/invoking.rst
@@ -0,0 +1,8 @@
+.. _invoking:
+
+Invoking BuildStream
+====================
+
+.. click:: buildstream._frontend.main:cli
+ :prog: bst
+ :show-nested: