[jll63]

(Written by Claude Code, on behalf of @jll63.)

Follow-up to #134.

Three columns for the dispatch comparison

The "Compare the three calls on Compiler Explorer" link on performance.adoc used to open two columns: the virtual function call beside a translation unit holding both method calls, whose assembly pane showed both together. It now opens one column per call, each with its source above its assembly:

virtual_function	method_via_ref	method_via_virtual_ptr
source	source	source
assembly	assembly	assembly

dev/ce_link.py replaces --beside and --beside-tag with --column EXAMPLE:TAG, given once per column. A column holds the content region of its example minus every nested tagged region except TAG, so it compiles that one function only:

dev/ce_link.py \
    --column doc/modules/ROOT/examples/dispatch_virtual_function.cpp:virtual_function \
    --column doc/modules/ROOT/examples/dispatch_open_method.cpp:method_via_ref \
    --column doc/modules/ROOT/examples/dispatch_open_method.cpp:method_via_virtual_ptr

The "Library functions" filter stays off in all three columns: it would hide method_via_virtual_ptr completely, since every one of its instructions is dispatch code inlined from the headers. With the filter off, the method columns carry about 1,000 lines of library code, but each function still appears within the first screen.

Function names

call_virtual_function, call_via_ref and call_via_virtual_ptr become virtual_function, method_via_ref and method_via_virtual_ptr. The rename covers their tags, the listings and prose of performance.adoc, and the helpers with the same names in ast.cpp, ast_virtual_function_2.cpp and both custom RTTI examples. No page shows those helpers.

CLAUDE.md

A new section, "Compiler Explorer links in the documentation", says that doc-page links use normal includes, with Boost picked from CE's Libraries list. The flattened headers are for the ce/ examples only. It also says what follows from that:

• a link runs the Boost release CE offers (1.92), not this tree;
• nothing regenerates a link when its example changes.

Testing

• Examples: the six changed examples build with -Wall -Wextra -Werror under gcc and clang-22, at -O2 -DNDEBUG, and print what they did before.
• Compiler Explorer: each of the three columns compiles through CE's API, with the link's compiler, options, libraries and filters, and its assembly pane opens on its function. CE accepts the link.
• Docs: doc/build_antora.sh reports no warnings for performance.adoc. The rendered href matches the generated URL, and the page has no old names left. The basics and motivation links come out of the script unchanged.

🤖 Generated with Claude Code

https://claude.ai/code/session_01958YRGfNfb6SfQS9v4hWTr

[cppalliance-bot]

An automated preview of the documentation is available at https://141.openmethod.prtest3.cppalliance.org/libs/openmethod/doc/html/index.html

If more commits are pushed to the pull request, the docs will rebuild at the same URL.

2026-11-04 22:43:14 UTC

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.57%. Comparing base (b681217) to head (eea7e9c).
⚠️ Report is 24 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop     #141   +/-   ##
========================================
  Coverage    92.56%   92.57%           
========================================
  Files           29       29           
  Lines         2314     2316    +2     
  Branches       699      699           
========================================
+ Hits          2142     2144    +2     
  Misses         111      111           
  Partials        61       61           

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 456d95c...eea7e9c. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.