From 11d481252db8972e3921a00fa03633effd3388bb Mon Sep 17 00:00:00 2001 From: Guillaume Lessard Date: Thu, 17 Oct 2024 13:17:08 -0700 Subject: [PATCH] [1.4.0] Updates to the README file --- README.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 452ad86d..30b60f70 100644 --- a/README.md +++ b/README.md @@ -55,7 +55,15 @@ let package = Package( ## Source Stability -The Swift System package is source stable. The version numbers follow [Semantic Versioning][semver] -- source breaking changes to public API can only land in a new major version. +The Swift System package supports three types of operating systems: Darwin, POSIX, and Windows. The source-stability status of the package differs according to the platform: + +| Platform type | Stability | +| ----------------- | --------------- | +| Darwin | Source stable | +| POSIX | Source stable | +| Windows | Source unstable | + +The package version numbers follow [Semantic Versioning][semver] -- source breaking changes to public API can only land in a new major version. However, platforms for which support has not reached source stability can have source-breaking changes in a new minor version. [semver]: https://semver.org @@ -79,7 +87,7 @@ The following table maps existing package releases to their minimum required Swi | Package version | Swift version | Xcode release | | ----------------------- | --------------- | ------------- | | swift-system 1.3.x | >= Swift 5.8 | >= Xcode 14.3 | -| swift-system 1.4.x (unreleased) | >= Swift 5.9 | >= Xcode 15.0 | +| swift-system 1.4.x | >= Swift 5.9 | >= Xcode 15.0 | We'd like this package to quickly embrace Swift language and toolchain improvements that are relevant to its mandate. Accordingly, from time to time, new versions of this package require clients to upgrade to a more recent Swift toolchain release. (This allows the package to make use of new language/stdlib features, build on compiler bug fixes, and adopt new package manager functionality as soon as they are available.) Patch (i.e., bugfix) releases will not increase the required toolchain version, but any minor (i.e., new feature) release may do so.