From abd633bd268db512a39e93063610bb74d3fd6d49 Mon Sep 17 00:00:00 2001
From: Ingvar Stepanyan <me@rreverser.com>
Date: Fri, 4 Oct 2024 19:54:38 +0100
Subject: [PATCH] Mark code blocks in docs as text

---
 src/api/autogen/index.ts | 2 ++
 src/api/mod.rs           | 4 ++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/api/autogen/index.ts b/src/api/autogen/index.ts
index 641c5d9..fd4533c 100644
--- a/src/api/autogen/index.ts
+++ b/src/api/autogen/index.ts
@@ -698,6 +698,8 @@ function stringifyDoc(doc: string | undefined = '') {
       .replace(/^`(.+?)\.?`\s*(.*)$/s, '$2\n\n_$1._')
       // If there is no summary, split out first sentence as summary.
       .replace(/^(.*?(?<!e\.g|i\.e)\.) (?=[A-Z])/, '$1\n\n')
+      // Mark code blocks as text so that they're not picked up as Rust.
+      .replace(/^(```)(\n.*?\n```)$/gms, '$1text$2')
       // Add doc-comment markers to each line.
       .replace(/^/gm, '/// ')
   );
diff --git a/src/api/mod.rs b/src/api/mod.rs
index 43e8c39..d0c8ab9 100644
--- a/src/api/mod.rs
+++ b/src/api/mod.rs
@@ -806,7 +806,7 @@ pub trait Camera: Device + Send + Sync {
     ///
     /// Please note that this is "column-major" order (column changes most rapidly) from the image's row and column perspective, while, from the array's perspective, serialisation is actually effected in "row-major" order (rightmost index changes most rapidly).  This unintuitive outcome arises because the ASCOM Camera Interface specification defines the image column dimension as the rightmost array dimension.
     ///
-    /// ```
+    /// ```text
     /// [
     ///   [P00,P01,P02,P03,P04],
     ///
@@ -828,7 +828,7 @@ pub trait Camera: Device + Send + Sync {
     ///
     /// When the `SensorType` is Color, the serialised JSON array will have 3 dimensions. For example, the returned array should appear as below if `NumX = 7`, `NumY = 5`  and `Rxy`, `Gxy` and `Bxy` represent the red, green and blue pixel values at the zero based position x across and y down the image with the origin in the top left corner of the image.  Please see note above regarding element ordering.
     ///
-    /// ```
+    /// ```text
     /// [
     ///   [[R00,G00,B00],[R01,G01,B01],[R02,G02,B02],[R03,G03,B03],[R04,G04,B04]],
     ///