Skip to content

Commit 272113b

Browse files
committed
Add module_filter to modules.instructions.md
1 parent b0f6665 commit 272113b

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

.github/instructions/modules.instructions.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,18 @@ The version assert at the top of each namespace header:
9898
All module test projects use v143 toolset. `import std;` requires `BuildStlModules=true`
9999
and either v145 toolset or `/std:c++latest` on v143.
100100

101+
## Module Namespace Filtering (-module_filter)
102+
103+
The `-module_filter` cppwinrt.exe arg controls which namespaces go into
104+
`winrt.ixx` and `winrt_module_namespaces.h`. All namespace headers are still
105+
generated for textual inclusion — only the module contents are filtered.
106+
107+
- NuGet property: `CppWinRTModuleFilter` (space-separated prefixes)
108+
- cppwinrt.exe arg: `-module_filter <prefix>` (can be repeated)
109+
- Implementation: `settings.ixx_filter` in `main.cpp`/`settings.h`
110+
- The repo test builders use `-module_filter Windows.Foundation` to speed up
111+
the inner loop (5 namespaces instead of 339).
112+
101113
## NuGet Module Integration (test/nuget/)
102114

103115
The NuGet targets split module support into two properties:

0 commit comments

Comments
 (0)