Skip to content

docs(agents): record the attempt to build the Boost-shipped modules from upstream's units - #6

Merged
ZheFeng7110 merged 1 commit into
mcpplibs:mainfrom
ZheFeng7110:feat/upstream-boost-modules
Nov 18, 2026
Merged

ZheFeng7110 merged 1 commit into
mcpplibs:mainfrom
ZheFeng7110:feat/upstream-boost-modules

Conversation

@ZheFeng7110

@ZheFeng7110 ZheFeng7110 commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Adds a design record only. No code changes.

.agents/docs/2026-11-07-upstream-boost-modules.md records an attempt to build the six libraries Boost 1.92.0 ships as modules (any, conversion, dll, lexical_cast, pfr, type_index) from upstream's interface units instead of mwrap facades. The record is marked abandoned so the direction can be reconsidered later.

  • Plan (§1–§10). Build the six features from libs/<lib>/modules/boost_<lib>.cppm under a package-wide BOOST_USE_MODULES, defer stacktrace, and change the generators to match.
  • Scanner (§11). mcpp's text scanner does not see the imports headers make, and it rejects the units' conditional import std;. Since mcpp 2026.11.10.1 (scan_overrides:声明的文件属于未启用的 feature 或被 target 排除时报 "matched no source file",无法与 feature 门控的源一起使用 mcpp-community/mcpp#902), gen_features.py can generate the [scan_overrides] declarations. The record covers the rules for doing that across platforms: evaluate with the MinGW target, keep a table of POSIX-only differences, and wrap log/src/permissions.cpp.
  • Results (§11.5, §12). With clang 23.1.3, mcpp test passed 146/146. With gcc 16.1, every override passed mcpp's P1689 check, but 42 TUs failed to compile, because gcc does not merge a textual include with declarations already imported from a module's global module fragment.
  • Outcome (§13). The code was discarded: the six libraries stay mwrap facades and the mcpp pin is unchanged. §13 also lists what to check before trying again.

.agents/docs/README.md is regenerated by tools/doc-tools/gen_index.py.

Test plan

  • python3 tools/doc-tools/check_docs.py
  • CI Check Documents

…rom upstream's units

Boost 1.92.0 ships interface units for any, conversion, dll, lexical_cast,
pfr and type_index. The record describes replacing their mwrap facades with
those units under a package-wide BOOST_USE_MODULES, and generating
[scan_overrides] for the imports headers make (possible since mcpp
2026.11.10.1, mcpp#902). clang passed the full test suite; gcc 16.1 failed
42 TUs because it does not merge a textual include with declarations already
imported from a module's global module fragment. The code was not kept; the
record is marked abandoned and lists what to check before trying again.
@ZheFeng7110
ZheFeng7110 force-pushed the feat/upstream-boost-modules branch from 489045f to aa8cb4c Compare November 18, 2026 13:38
@ZheFeng7110 ZheFeng7110 changed the title Build the Boost-shipped modules from upstream's units; generate scan_overrides for header-made imports docs(agents): record the attempt to build the Boost-shipped modules from upstream's units Nov 18, 2026
@ZheFeng7110
ZheFeng7110 marked this pull request as ready for review November 18, 2026 13:38
@ZheFeng7110
ZheFeng7110 merged commit faa7d44 into mcpplibs:main Nov 18, 2026
1 check passed
@ZheFeng7110
ZheFeng7110 deleted the feat/upstream-boost-modules branch November 18, 2026 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant