From 1ca988b8e38fd4923ac8c7a437f29c497deac853 Mon Sep 17 00:00:00 2001 From: Jean-Louis Leroy Date: Thu, 17 Sep 2026 19:56:13 -0400 Subject: [PATCH] doc: repair the cross-reference to the Registry affinity section #111 added `see <> below` and hard-wrapped it at the 79-column margin, putting a newline inside the macro. Asciidoctor does not match a title reference across the break, so it fell back to the unresolved form: the page rendered a literal `[Registry affinity]` in square brackets, linking to `#Registry affinity` - a fragment with a space in it, which matches no anchor. The section's own id is the generated `_registry_affinity`. The build says so ("possible invalid reference: Registry\naffinity"), but among the section-title-out-of-sequence warnings the line is easy to miss, and the rendered page still looks plausible. Use an explicit anchor, as the page's siblings do (`<>`, `<>`, `<>` all pair with a `[#id]` line above the heading). That spelling also survives rewrapping, and it does not break if the heading is ever reworded. Verified by rebuilding: the link now renders as `Registry affinity` -> `#registry_affinity`, and the build reports no invalid references. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01JrW75AraKw18w6dcLjTuZB --- doc/modules/ROOT/pages/registries_and_policies.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/modules/ROOT/pages/registries_and_policies.adoc b/doc/modules/ROOT/pages/registries_and_policies.adoc index 647be560..534863a8 100644 --- a/doc/modules/ROOT/pages/registries_and_policies.adoc +++ b/doc/modules/ROOT/pages/registries_and_policies.adoc @@ -15,8 +15,8 @@ xref:reference:BOOST_OPENMETHOD_DEFAULT_REGISTRY.adoc[BOOST_OPENMETHOD_DEFAULT_R _before_ including `` (or any header that includes it, like ``). The value of the symbol is used as a default template parameter for `use_classes`, and for `method` and `virtual_ptr` where -the classes involved declare no affinity of their own - see <> below. Once it has been included, changing +the classes involved declare no affinity of their own - see +<> below. Once it has been included, changing `BOOST_OPENMETHOD_DEFAULT_REGISTRY` has no effect. For a registry the library provides, that is the whole recipe: @@ -51,6 +51,7 @@ declaration must use the same class-key as the definition. Qualify the name if it could also be found in namespace `boost::openmethod` - `registry` in particular. +[#registry_affinity] ### Registry affinity `BOOST_OPENMETHOD_DEFAULT_REGISTRY` is a whole-program answer: one registry, for