Skip to content

docs: document Meson support, drop stale WrapDB badge - #48

Merged
gistrec merged 1 commit into
masterfrom
docs/meson-readme
Sep 20, 2026
Merged

gistrec merged 1 commit into
masterfrom
docs/meson-readme

Conversation

@gistrec

@gistrec gistrec commented Sep 20, 2026

Copy link
Copy Markdown
Owner

Closes the README half of #44.

Why

The badge row advertised "Meson WrapDB — pending" and linked to mesonbuild/wrapdb#2820. That PR was closed on 2026-07-08 — upstream declined to add the wrap until a downstream consumer exists — so the badge promised something that is not coming.

The opposite problem sat one section lower: meson.build has shipped in-tree since v1.2.2 (#45), but "Other package managers" listed vcpkg · xrepo · Conan · build2 and never mentioned Meson. The one ecosystem where the build actually works had no way to be discovered from the README.

Changes

  • Badge now reads Meson — supported and links to meson.build instead of the closed PR.
  • New Meson subsection between Conan and build2: the subprojects/geo-utils-cpp.wrap file, the dependency('geo-utils-cpp') call to consume it, and a note that the smoke test is skipped when built as a subproject.
  • Other package managers summary line gains Meson.

No WrapDB entry is needed for any of this — meson.override_dependency in the in-tree build makes a plain wrap-file sufficient.

The Conan badge is untouched: conan-io/conan-center-index#30152 is still genuinely open, so "pending" is accurate there.

Verification

The documented snippet was run as written, against Meson 1.11.1 / AppleClang 17 on arm64 — a scratch project containing only the .wrap and the three-line meson.build from the README:

Downloading geo-utils-cpp source from https://github.com/gistrec/geo-utils-cpp/archive/v1.2.2.tar.gz
geo-utils-cpp| Project version: 1.2.2
geo-utils-cpp| Build targets in project: 0
Dependency geo-utils-cpp for host machine found: YES 1.2.2 (overridden)
  • source_hash matches the v1.2.2 release tarball, so the download verifies.
  • The dependency resolves through override_dependency, not pkg-config or CMake.
  • Build targets in project: 0 confirms the documented claim that the subproject compiles nothing of its own.
  • A consumer calling geo::distance_between compiled, linked, and exited 0 with its assertions live.

The WrapDB PR (mesonbuild/wrapdb#2820) was closed — upstream prefers to
wait for a downstream consumer — so the 'Meson WrapDB: pending' badge
promised something that is no longer coming.

Meson itself is supported: meson.build has shipped in-tree since v1.2.2,
and a plain .wrap pointing at a release tarball consumes it with no
WrapDB entry. Point the badge at meson.build and document the wrap file
alongside the other package managers.

Verified end to end with Meson 1.11.1: the documented .wrap resolves via
override_dependency, the subproject builds no targets of its own, and a
consumer calling geo::distance_between compiles and runs.
@gistrec
gistrec merged commit 70ec7e7 into master Sep 20, 2026
12 checks passed
@gistrec
gistrec deleted the docs/meson-readme branch September 20, 2026 22: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