From 7438b5d4461edc0e9a868f03b1a3dba6fe496303 Mon Sep 17 00:00:00 2001
From: Jason Kridner <jkridner@beagleboard.org>
Date: Wed, 15 Nov 2023 22:49:34 -0500
Subject: [PATCH] librobotcontrol: start simple for now

Disabling `exhale` because it is just overloading things right now.

Hidden in this commit are a couple of other items:
* Enable .md documents for CONTRIBUTING.md to avoid same content not on
  docs.beagleboard.org
* Added graphviz to the venv setup, but that doesn't do much as I think
  it was already there
---
 conf.py                  | 5 +++--
 index.rst                | 2 +-
 projects/index.rst       | 2 +-
 projects/librobotcontrol | 2 +-
 venv-build-env.sh        | 3 ++-
 5 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/conf.py b/conf.py
index 6b20bdf1..7fea3b88 100644
--- a/conf.py
+++ b/conf.py
@@ -36,9 +36,10 @@ extensions = [
     "sphinx.ext.todo",
     "sphinx_tabs.tabs",
     "breathe",
-    "exhale"
 ]
 
+#    "exhale"
+
 #graphviz_output_format = 'svg'
 
 breathe_projects = {"librobotcontrol": "projects/librobotcontrol/docs/xml"}
@@ -70,7 +71,7 @@ LaTeXBuilder.supported_image_types = ['application/pdf', 'image/jpg', 'image/jpe
 
 templates_path = ['_templates']
 
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 numfig = True
 navigation_with_keys = True
 
diff --git a/index.rst b/index.rst
index 25695877..e208895e 100644
--- a/index.rst
+++ b/index.rst
@@ -404,7 +404,7 @@ developers. Some developers choose to host documentation for their :ref:`project
 
    /projects/simppru/index
    /projects/bb-config/index
-   /projects/librobotcontrol/index
+   /projects/librobotcontrol/docs/index
    /projects/beagleconnect/index
 
 Books
diff --git a/projects/index.rst b/projects/index.rst
index f8aaf538..1bb3de7a 100644
--- a/projects/index.rst
+++ b/projects/index.rst
@@ -10,5 +10,5 @@ This is a collection of reasonably well-supported projects useful to Beagle deve
 
    /projects/simppru/index
    /projects/bb-config/index
-   /projects/librobotcontrol/index
+   /projects/librobotcontrol/docs/index
    /projects/beagleconnect/index
diff --git a/projects/librobotcontrol b/projects/librobotcontrol
index cb13bb7c..1974b76f 160000
--- a/projects/librobotcontrol
+++ b/projects/librobotcontrol
@@ -1 +1 @@
-Subproject commit cb13bb7c843b67398a030000304e60fb5d9ca073
+Subproject commit 1974b76fd578ff9f5d1481ebd34f6801b9edeb6a
diff --git a/venv-build-env.sh b/venv-build-env.sh
index 393b2045..bea1e929 100755
--- a/venv-build-env.sh
+++ b/venv-build-env.sh
@@ -1,5 +1,5 @@
 #!/bin/sh
-# Source this script
+# Source this script like `. ./venv-build-env.sh`
 if [ ! -e ./sphinx-env ]; then
    python3 -m venv sphinx-env
 fi
@@ -8,3 +8,4 @@ python3 -m pip install --upgrade pip
 python3 -m pip install sphinx==5.3.0 sphinx-rtd-theme sphinx_design sphinx-tabs sphinxcontrib.svg2pdfconverter sphinx-reredirects
 python3 -m pip install sphinxcontrib-images
 python3 -m pip install breathe exhale
+python3 -m pip install graphviz
-- 
GitLab