Skip to content

Commit 65904e3

Browse files
jll63claude
andcommitted
doc: inline the final_virtual_ptr example instead of linking to it
The explicit-`Registry` overload pointed at the default-registry overload's example with a hardcoded page name, `final_virtual_ptr-08.adoc`. MrDocs disambiguates overload pages with a content-derived hash, so adding the `any` overloads renamed that page to `final_virtual_ptr-08ea.adoc` and the link went dead. It went dead silently: mrdocs-addons rewrites `xref:reference:` into a plain `link:` on nested pages, to work around cppalliance/mrdocs#1245, and Antora does not validate a link macro. Any cross-reference to an *overload* page is therefore a link that rots without warning -- the two in macros.hpp are safe only because macro page names carry no hash. Pull in the snippet instead, with the same `include:` directive the default-registry overload already uses. There is no page name left to rot, and the example now comes from a file the build compiles and runs. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent a735c45 commit 65904e3

1 file changed

Lines changed: 1 addition & 2 deletions

File tree

include/boost/openmethod/core.hpp

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -624,8 +624,7 @@ inline vptr_type null_vptr = nullptr;
624624
//!
625625
//! @par Example
626626
//!
627-
//! See [the default-registry overload](xref:reference:boost/openmethod/final_virtual_ptr-08.adoc#_example)
628-
//! for an example.
627+
//! include:virtual_ptr.cpp#non_polymorphic_classes;final_virtual_ptr
629628
//!
630629
//! @tparam Registry A @ref registry.
631630
//! @tparam Arg The type of the argument.

0 commit comments

Comments
 (0)