From ef43c651f4d7a181f78fa34fb2a5f4f7fefda396 Mon Sep 17 00:00:00 2001 From: Matt Van Horn Date: Tue, 14 Apr 2026 22:38:57 -0400 Subject: [PATCH 1/4] docs: recommend ponyup default before ponyup update for non-default platforms Issue #185 reported that on non-default Linux distributions (e.g., Debian Buster on WSL2 with glibc 2.28), 'ponyup update' fails with an 'unexpected selection' error because the auto-detected target triple does not match an available package. Setting the platform manually with 'ponyup default ' first fixes it. The README already documents 'ponyup default' under the Platform section, but that section sits below 'Install Pony' in the install flow, so first-time users hit the failure before reaching the workaround. Add a single sentence right after the install command pointing them to Platform when their distro isn't auto-detected. Closes #185 --- .release-notes/next-release.md | 4 ++++ README.md | 2 ++ 2 files changed, 6 insertions(+) diff --git a/.release-notes/next-release.md b/.release-notes/next-release.md index f28050c..e5c3767 100644 --- a/.release-notes/next-release.md +++ b/.release-notes/next-release.md @@ -1,3 +1,7 @@ +## Document setting platform before installing + +The README now points users with non-default platforms to `ponyup default` before they run `ponyup update`. This helps avoid the "unexpected selection" error mid-install on systems whose target triple doesn't match an available package, such as Linux distributions with an older `glibc`. + ## Drop Alpine 3.20 Support Alpine 3.20 is about to reach its end of life date. We've dropped it as a supported platform for `ponyc` and `ponyup`. diff --git a/README.md b/README.md index 09660cd..31331c6 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,8 @@ ponyup update ponyc release These commands will download the chosen version of ponyc and install it to `$HOME/.local/share/ponyup/bin` by default. See the instructions below for how to set the install path and manage Pony applications. +If you're on a non-default platform (for example, a Linux distribution that isn't auto-detected, or one with an older `glibc`), set the platform with `ponyup default ` before running `ponyup update`. See [Platform](#platform) below for details. + ### Set install prefix On Unix: From bd1250fb9ddce15afb1ada46984932440f17fea6 Mon Sep 17 00:00:00 2001 From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> Date: Wed, 15 Apr 2026 08:05:14 -0400 Subject: [PATCH 2/4] docs: remove release notes entry per maintainer feedback Signed-off-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> --- .release-notes/next-release.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/.release-notes/next-release.md b/.release-notes/next-release.md index e5c3767..f28050c 100644 --- a/.release-notes/next-release.md +++ b/.release-notes/next-release.md @@ -1,7 +1,3 @@ -## Document setting platform before installing - -The README now points users with non-default platforms to `ponyup default` before they run `ponyup update`. This helps avoid the "unexpected selection" error mid-install on systems whose target triple doesn't match an available package, such as Linux distributions with an older `glibc`. - ## Drop Alpine 3.20 Support Alpine 3.20 is about to reach its end of life date. We've dropped it as a supported platform for `ponyc` and `ponyup`. From 2317071d851163e998a04f27830c9019604c0523 Mon Sep 17 00:00:00 2001 From: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> Date: Tue, 21 Apr 2026 09:31:05 -0700 Subject: [PATCH 3/4] docs: pivot to 'Requesting support for additional platforms' per @SeanTAllen Replaces the earlier one-sentence pointer at 'Install Pony' (which the maintainer flagged as not useful) with a new 'Requesting support for additional platforms' subsection under 'Common Issues'. The new section directs users to the #release stream on the Pony Zulip with the output of `cc -dumpmachine` (or `uname -a` + `ldd --version`) and the exact error they hit, so the team can either point them at an existing platform identifier or add detection support in a future release. Ref #185 (to be closed per maintainer direction). Signed-off-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com> --- README.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 31331c6..fa8266f 100644 --- a/README.md +++ b/README.md @@ -45,8 +45,6 @@ ponyup update ponyc release These commands will download the chosen version of ponyc and install it to `$HOME/.local/share/ponyup/bin` by default. See the instructions below for how to set the install path and manage Pony applications. -If you're on a non-default platform (for example, a Linux distribution that isn't auto-detected, or one with an older `glibc`), set the platform with `ponyup default ` before running `ponyup update`. See [Platform](#platform) below for details. - ### Set install prefix On Unix: @@ -133,6 +131,15 @@ ponyup default x86_64-linux-ubuntu24.04 This is likely caused by a target triple that does not specify the libc ABI for the platform, as detected by `cc -dumpmachine`. The solution is to manually set the platform identifier using `ponyup default `, where `` is a platform identifier such as `x86_64-linux-ubuntu24.04`. +### Requesting support for additional platforms + +If ponyup does not recognize your platform or you cannot install ponyc, drop into the `#release` stream on the [Pony Zulip](https://ponylang.zulipchat.com/) with: + +- The output of `cc -dumpmachine` (or `uname -a` and `ldd --version` on Linux). +- The command you ran and the error you got. + +From there the team can either point you at an existing platform identifier or add detection support for your platform in a future release. + ## Development Building from source requires ponyc 0.63.1 or later. From d99bc845f84aba8d2e7ccc46169dd2639f9671be Mon Sep 17 00:00:00 2001 From: Sean T Allen Date: Tue, 28 Apr 2026 19:42:55 -0400 Subject: [PATCH 4/4] Apply suggestion from @SeanTAllen --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fa8266f..d24550a 100644 --- a/README.md +++ b/README.md @@ -133,7 +133,7 @@ ponyup default x86_64-linux-ubuntu24.04 ### Requesting support for additional platforms -If ponyup does not recognize your platform or you cannot install ponyc, drop into the `#release` stream on the [Pony Zulip](https://ponylang.zulipchat.com/) with: +If ponyup does not recognize your platform or you cannot install ponyc, drop into the [`#release` stream](https://ponylang.zulipchat.com/#narrow/channel/190364-release) on the [Pony Zulip](https://ponylang.zulipchat.com/) with: - The output of `cc -dumpmachine` (or `uname -a` and `ldd --version` on Linux). - The command you ran and the error you got.