From d9b7ae2263984f08c977533a34b4092f2d9cd640 Mon Sep 17 00:00:00 2001
From: Roland Conybeare <rconybeare@gmail.com>
Date: Mon, 22 Sep 2025 12:55:49 -0400
Subject: [PATCH] nix build: xo-jit: build+install docs+examples: xo-jit.nix ++

---
 pkgs/xo-jit.nix | 39 ++++++++++++++++++++++++++++++++-------
 1 file changed, 32 insertions(+), 7 deletions(-)

diff --git a/pkgs/xo-jit.nix b/pkgs/xo-jit.nix
index 0c08bc41..46963336 100644
--- a/pkgs/xo-jit.nix
+++ b/pkgs/xo-jit.nix
@@ -1,13 +1,17 @@
 {
   # dependencies
-  stdenv, cmake, catch2,
+  lib, stdenv, cmake, catch2,
+
   clang, llvm,
-  doxygen,
 
   python3Packages,
-  sphinx,
+
+  doxygen, sphinx, graphviz,
 
   xo-cmake, xo-tokenizer, xo-expression,
+
+  buildDocs ? false,
+  buildExamples ? false,
 } :
 
 stdenv.mkDerivation (finalattrs:
@@ -19,8 +23,23 @@ stdenv.mkDerivation (finalattrs:
 
     src = ../xo-jit;
 
-    cmakeFlags = ["-DCMAKE_MODULE_PATH=${xo-cmake}/share/cmake"];
+    cmakeFlags = ["-DCMAKE_MODULE_PATH=${xo-cmake}/share/cmake"]
+                 ++ lib.optionals buildDocs ["-DXO_ENABLE_DOCS=on"]
+                 ++ lib.optionals buildExamples ["-DXO_ENABLE_EXAMPLES=on"];
+
+    inherit buildDocs;
+    inherit buildExamples;
+
     doCheck = true;
+
+    propagatedBuildInputs = [
+      xo-expression
+    ];
+
+    postBuild = lib.optionalString buildDocs ''
+      cmake --build . -- docs
+    '';
+
     nativeBuildInputs = [
       cmake
       catch2
@@ -30,8 +49,14 @@ stdenv.mkDerivation (finalattrs:
       sphinx
       xo-cmake
       xo-tokenizer
+    ] ++ lib.optionals buildDocs [
+      doxygen
+      sphinx
+      graphviz
+      python3Packages.sphinx-rtd-theme
+      python3Packages.breathe
+      python3Packages.sphinxcontrib-ditaa
+      python3Packages.sphinxcontrib-plantuml
     ];
-    propagatedBuildInputs = [
-      xo-expression
-    ];
+
   })