From 545ccdd372fedc829fd488b88936719629e6763b Mon Sep 17 00:00:00 2001
From: "carpentry-heartbeat[bot]"
 <carpentry-heartbeat[bot]@users.noreply.github.com>
Date: Wed, 26 Aug 2026 12:20:58 +0200
Subject: [PATCH] Fix the mangled append-bool docstring

The docstring carried the UTF-8 bytes of the curly quotes around true and
false as escaped octal (\342\200\234 / \342\200\235) behind a literal
backslash-backslash, so the rendered docs read

  appends a bool as \342\200\234true\342\200\235 or \342\200\234false\342\200\235.

Quote the two literals with backticks instead, which is what the rest of
strbuf.carp and the org use for a literal inside a docstring, and which
markdown renders as code. Docs regenerated with gendocs.carp.
---
 docs/StringBuf.html | 2 +-
 strbuf.carp         | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/docs/StringBuf.html b/docs/StringBuf.html
index 8710b7f..bb292a2 100644
--- a/docs/StringBuf.html
+++ b/docs/StringBuf.html
@@ -64,7 +64,7 @@ <h3 id="append-bool">
                         
                     </span>
                     <p class="doc">
-                        <p>appends a bool as \342\200\234true\342\200\235 or \342\200\234false\342\200\235.</p>
+                        <p>appends a bool as <code>true</code> or <code>false</code>.</p>
 
                     </p>
                 </div>
diff --git a/strbuf.carp b/strbuf.carp
index 5e81c0d..f6287c9 100644
--- a/strbuf.carp
+++ b/strbuf.carp
@@ -53,8 +53,7 @@ amortized O(1) appends.
   (doc append-float "appends a float as its string representation.")
   (register append-float (Fn [&StringBuf Float] ()))
 
-  (doc append-bool
-    "appends a bool as \\342\\200\\234true\\342\\200\\235 or \\342\\200\\234false\\342\\200\\235.")
+  (doc append-bool "appends a bool as `true` or `false`.")
   (register append-bool (Fn [&StringBuf Bool] ()))
 
   (doc append-crlf "appends \\r\\n (HTTP line ending).")