Skip to content

docs: a build plugin names the libraries its modules import in [dependencies] (mcpp 2026.10.11.1) - #520

Merged
Sunrisepeak merged 1 commit into
mainfrom
docs/plugins-dependencies-2026.10.11.1
Oct 11, 2026
Merged

Sunrisepeak merged 1 commit into
mainfrom
docs/plugins-dependencies-2026.10.11.1

Conversation

@Sunrisepeak

Copy link
Copy Markdown
Member

mcpp 2026.10.11.1 (mcpp-community/mcpp#797, #798, #800) compiles a build plugin's [dependencies] with it, in the build programs' graph.

What changes for a plugin author

  • New spelling. A plugin built on mcpp.plugins' plugins-core names it in [dependencies].
  • Handing it on. reexport = true passes the library on to the consumers' build.mcpp.
  • Old spelling. [build-dependencies] with host-module = true is still read as a dependency of the plugin, reported as deprecated (plugin-imports-from-build-dependencies), and no longer read from mcpp 2027.1.
  • Consumers. A [build-dependencies] edge gives the build program the package's library without host-module = true. The explicit key stays valid.

Updated: docs/package-types.md §I and its zh counterpart.

Not changed: toml++. marzer.tomlplusplus keeps its Form A descriptor and relative include. mcpp 2026.10.11.1 would accept <toml++/toml.hpp> and a Form B lib key, but releases before it compile a build program's module without the package's include directories, and the index floor does not move for one package. Measured with 2026.10.11.1: the package in both tables, imported by the target and by build.mcpp, builds and runs.

…dencies] (mcpp 2026.10.11.1)

From mcpp 2026.10.11.1 (mcpp-community/mcpp#797) a build plugin's
[dependencies] are compiled with it for the build programs that use it, and
reexport = true hands one on to their build.mcpp. A plugin built on
mcpp.plugins' plugins-core names it there. The [build-dependencies] entry
with host-module = true, the spelling before that release, is read as a
dependency as well, reported as deprecated, and no longer read from mcpp
2027.1. A [build-dependencies] edge gives the build program the library
without host-module = true.
@Sunrisepeak
Sunrisepeak merged commit 985b7ca into main Oct 11, 2026
1 check passed
@Sunrisepeak
Sunrisepeak deleted the docs/plugins-dependencies-2026.10.11.1 branch October 11, 2026 05:56
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