build: prepare for subtree split #276

We can use a subtree split to export only a subset of this repository to downstream projects. The only thing we need to do is publish and maintain a branch, e.g. lib, generated as follows:

git subtree split --prefix=lib -b lib

I published such a branch here: https://github.com/Sjors/libmultiprocess/commits/lib/

Commits that don't touch the prefix directory are skipped entirely. Others are stripped of content outside the prefix. This of course breaks PGP signatures, but the lib branch commits are deterministically generated. On the Bitcoin Core side I plan to update the subtree linter to verify this.

Because we can only export one directory, this PR moves the following library sources to lib/:

• CMakeLists.txt
• cmake
• include
• pkgconfig
• src
• test

This leaves examples, documentation and CI outside the export. Tests could be moved out as well, but it seems useful to offer downstream projects an easy way to run these tests as part of their own CI.

A new top-level CMakeLists.txt wrapper preserves 'cmake -S .' for standalone builds; this is also the only way to build the example/ subdirectory. See comments in CMakeLists.txt and lib/CMakeLists.txt for details on how lib/ adapts between the two build modes. This can use some CMake expertise eyes. Most of the existing CMakeList.txt content is simply moved, so it's best reviewed with --color-moved=dimmed-zebra.

Commit 66d7b4871d47e77e89c80cb691436f4f86974971 can be avoided if we drop examples from cmake/libmultiprocess.cmake in Bitcoin Core in a separate PR first.

Bitcoin Core side: https://github.com/Sjors/bitcoin/pull/113 (will upstream later)

Fixes #232

<!--e57a25ab6845829454e8d69fc972939a-->

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

<!--021abf342d371248e50ceaed478a90ca-->

Reviews

See the guideline for information on the review process. A summary of reviews will appear here.

<!--174a7506f384e20aa4161008e828411d-->

Conflicts

Reviewers, this pull request conflicts with the following ones:

• #277 (Add std::unordered_set support and a helper BuildList to dedup list build handlers by ViniciusCestarii)
• #274 (Add nonunix platform support by ryanofsky)
• #272 (ci: add Windows job by Sjors)
• #269 (proxy: add local connection limit to ListenConnections by enirox001)
• #238 (cmake, ci: updates for recent nixpkgs by ryanofsky)
• #231 (Add windows support by ryanofsky)
• #212 (ci: add newdeps job testing newer versions of cmake and capnproto by ryanofsky)
• #209 (cmake: Increase cmake policy version by ryanofsky)
• #204 (cmake: support default build and test workflow by purpleKarrot)
• #175 (Set cmake_minimum_required(VERSION 3.22) by maflcko)
• #163 (build: set cmake policy version to 3.31 by purpleKarrot)

If you consider this pull request important, please also help to review the conflicting pull requests. Ideally, start with the one that should be merged first.

<!--5faf32d7da4f0f540f40219e4f7537a3-->

LLM Linter (✨ experimental)

Possible typos and grammar issues:

• Capn'Proto -> Cap'n Proto [misspelled project name; the intended name is clearly “Cap'n Proto”]

^{2026-05-12 09:59:26}