diff options
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.md | 48 |
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 | |||
5 | SDL follows an "odd/even" versioning policy, similar to GLib, GTK, Flatpak | ||
6 | and 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 | |||