From 1cf37e79b56f02bcdc5fc398144b2174960ab10b Mon Sep 17 00:00:00 2001
From: Jean-Louis Leroy <jl@leroy.nyc>
Date: Tue, 16 Sep 2025 19:58:35 -0400
Subject: [PATCH] xref out of mrdocs

---
 doc/build_antora.sh                           | 9 ++++++++-
 include/boost/openmethod/default_registry.hpp | 5 +++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/build_antora.sh b/doc/build_antora.sh
index b0dc2c9..cf3b6e5 100755
--- a/doc/build_antora.sh
+++ b/doc/build_antora.sh
@@ -7,7 +7,7 @@
 # Official repository: https://github.com/boostorg/openmethod
 #
 
-set -xe
+set -e
 
 if [ $# -eq 0 ]
   then
@@ -25,4 +25,11 @@ echo "Building docs in custom dir..."
 PATH="$(pwd)/node_modules/.bin:${PATH}"
 export PATH
 npx antora --clean --fetch "$PLAYBOOK" --stacktrace --log-level all
+
+echo "Fixing links to non-mrdocs URIs..."
+
+for f in $(find build/site -name '*.html'); do
+  perl -i -pe 's{&lsqb;(.*?)&rsqb;\(([^)]+)\)}{<a href="../../$2">$1</a>}g' "$f"
+done
+
 echo "Done"
diff --git a/include/boost/openmethod/default_registry.hpp b/include/boost/openmethod/default_registry.hpp
index d4bb25e..28eaa85 100644
--- a/include/boost/openmethod/default_registry.hpp
+++ b/include/boost/openmethod/default_registry.hpp
@@ -21,6 +21,11 @@ struct release_registry
           policies::vptr_vector, policies::default_error_handler,
           policies::stderr_output> {};
 
+//! Registry with runtime checks and trace enabled
+//!
+//! This is the default value of
+//! [BOOST_OPENMETHOD_DEFAULT_REGISTRY](../BOOST_OPENMETHOD_DEFAULT_REGISTRY.html) when NDEBUG
+//! is not defined.
 struct debug_registry
     : release_registry::with<policies::runtime_checks, policies::trace> {};