summaryrefslogtreecommitdiff
path: root/src/contrib/SDL-3.2.20/docs/README-versions.md
diff options
context:
space:
mode:
author3gg <3gg@shellblade.net>2025-08-30 16:53:58 -0700
committer3gg <3gg@shellblade.net>2025-08-30 16:53:58 -0700
commit6aaedb813fa11ba0679c3051bc2eb28646b9506c (patch)
tree34acbfc9840e02cb4753e6306ea7ce978bf8b58e /src/contrib/SDL-3.2.20/docs/README-versions.md
parent8f228ade99dd3d4c8da9b78ade1815c9adf85c8f (diff)
Update to SDL3
Diffstat (limited to 'src/contrib/SDL-3.2.20/docs/README-versions.md')
-rw-r--r--src/contrib/SDL-3.2.20/docs/README-versions.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/src/contrib/SDL-3.2.20/docs/README-versions.md b/src/contrib/SDL-3.2.20/docs/README-versions.md
new file mode 100644
index 0000000..6c2d920
--- /dev/null
+++ b/src/contrib/SDL-3.2.20/docs/README-versions.md
@@ -0,0 +1,48 @@
1# Versioning
2
3## Since 3.2.0
4
5SDL follows an "odd/even" versioning policy, similar to GLib, GTK, Flatpak
6and older versions of the Linux kernel:
7
8* If the minor version (second part) and the patch version (third part) is
9 divisible by 2 (for example 3.2.6, 3.4.0), this indicates a version of
10 SDL that is believed to be stable and suitable for production use.
11
12 * In stable releases, the patchlevel or micro version (third part)
13 indicates bugfix releases. Bugfix releases may add small changes
14 to the ABI, so newer patch versions are backwards-compatible but
15 not fully forwards-compatible. For example, programs built against
16 SDL 3.2.0 should work fine with SDL 3.2.8, but programs built against
17 SDL 3.2.8 may not work with 3.2.0.
18
19 * The minor version increases when significant changes are made that
20 require longer development or testing time, e.g. major new functionality,
21 or revamping support for a platform. Newer minor versions are
22 backwards-compatible, but not fully forwards-compatible. For example,
23 programs built against SDL 3.2.x should work fine with SDL 3.4.x,
24 but programs built against SDL 3.4.x may not work with 3.2.x.
25
26* If the minor version (second part) or patch version (third part) is not
27 divisible by 2 (for example 3.2.9, 3.3.x), this indicates a development
28 prerelease of SDL that is not suitable for stable software distributions.
29 Use with caution.
30
31 * The patchlevel or micro version (third part) increases with each prerelease.
32
33 * Prereleases are backwards-compatible with older stable branches.
34 For example, programs built against SDL 3.2.x should work fine with
35 SDL 3.3.x, but programs built against SDL 3.3.x may not work with 3.2.x.
36
37 * Prereleases are not guaranteed to be backwards-compatible with each other.
38 For example, new API or ABI added in 3.3.0 might be removed or changed in
39 3.3.1. If this would be a problem for you, please do not use prereleases.
40
41 * Only use a prerelease if you can guarantee that you will promptly upgrade
42 to the stable release that follows it. For example, do not use 3.3.x
43 unless you will be able to upgrade to 3.4.0 when it becomes available.
44
45 * Software distributions that have a freeze policy (in particular Linux
46 distributions with a release cycle, such as Debian and Fedora)
47 should only package stable releases, and not prereleases.
48