2022-05-03 13:09:12 +00:00
|
|
|
# Release checklist
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
## New feature release
|
|
|
|
|
2022-05-03 13:09:12 +00:00
|
|
|
* Update `WhatsNew.txt`
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
* Bump version number to 2.EVEN.0 in all these locations:
|
2022-05-03 13:09:12 +00:00
|
|
|
|
|
|
|
* `configure.ac`, `CMakeLists.txt`: `SDL_*_VERSION`
|
|
|
|
* `Xcode/SDL/Info-Framework.plist`: `CFBundleShortVersionString`,
|
|
|
|
`CFBundleVersion`
|
|
|
|
* `Makefile.os2`: `VERSION`
|
2022-06-16 19:42:45 +00:00
|
|
|
* `Makefile.w32`: `*_VERSION`
|
2022-05-03 13:09:12 +00:00
|
|
|
* `include/SDL_version.h`: `SDL_*_VERSION`, `SDL_PATCHLEVEL`
|
|
|
|
* `src/main/windows/version.rc`: `FILEVERSION`, `PRODUCTVERSION`,
|
|
|
|
`FileVersion`, `ProductVersion`
|
|
|
|
|
|
|
|
* Bump ABI version information
|
|
|
|
|
2022-09-05 15:48:16 +00:00
|
|
|
* `Xcode/SDL/SDL.xcodeproj/project.pbxproj`:
|
2022-05-04 15:40:11 +00:00
|
|
|
`DYLIB_CURRENT_VERSION`, `DYLIB_COMPATIBILITY_VERSION`
|
|
|
|
* set first number in `DYLIB_CURRENT_VERSION` to
|
|
|
|
(100 * *minor*) + 1
|
2022-05-03 14:16:11 +00:00
|
|
|
* set second number in `DYLIB_CURRENT_VERSION` to 0
|
2022-09-05 15:28:06 +00:00
|
|
|
* set `DYLIB_COMPATIBILITY_VERSION` to the same value
|
2022-05-03 13:09:12 +00:00
|
|
|
|
|
|
|
* Regenerate `configure`
|
|
|
|
|
2022-09-05 18:25:10 +00:00
|
|
|
* Run test/versioning.sh to verify that everything is consistent
|
|
|
|
|
2022-05-03 13:09:12 +00:00
|
|
|
* Do the release
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
## New bugfix release
|
|
|
|
|
|
|
|
* Check that no new API/ABI was added
|
|
|
|
|
|
|
|
* If it was, do a new feature release (see above) instead
|
|
|
|
|
|
|
|
* Bump version number from 2.Y.Z to 2.Y.(Z+1) (Y is even)
|
|
|
|
|
|
|
|
* Same places as listed above
|
|
|
|
|
|
|
|
* Bump ABI version information
|
|
|
|
|
2022-09-05 15:48:16 +00:00
|
|
|
* `Xcode/SDL/SDL.xcodeproj/project.pbxproj`:
|
2022-05-04 15:40:11 +00:00
|
|
|
`DYLIB_CURRENT_VERSION`, `DYLIB_COMPATIBILITY_VERSION`
|
|
|
|
* set second number in `DYLIB_CURRENT_VERSION` to *patchlevel*
|
2022-09-05 18:21:13 +00:00
|
|
|
* Leave `DYLIB_COMPATIBILITY_VERSION` unchanged
|
2022-05-03 14:16:11 +00:00
|
|
|
|
|
|
|
* Regenerate `configure`
|
|
|
|
|
2022-09-05 18:25:10 +00:00
|
|
|
* Run test/versioning.sh to verify that everything is consistent
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
* Do the release
|
|
|
|
|
|
|
|
## After a feature release
|
|
|
|
|
|
|
|
* Create a branch like `release-2.24.x`
|
|
|
|
|
|
|
|
* Bump version number to 2.ODD.0 for next development branch
|
|
|
|
|
|
|
|
* Same places as listed above
|
|
|
|
|
|
|
|
* Bump ABI version information
|
|
|
|
|
|
|
|
* Same places as listed above
|
|
|
|
* Assume that the next feature release will contain new API/ABI
|
|
|
|
|
2022-05-04 15:43:59 +00:00
|
|
|
* Run test/versioning.sh to verify that everything is consistent
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
## New development prerelease
|
|
|
|
|
|
|
|
* Bump version number from 2.Y.Z to 2.Y.(Z+1) (Y is odd)
|
2022-05-03 13:09:12 +00:00
|
|
|
|
|
|
|
* Same places as listed above
|
|
|
|
|
|
|
|
* Bump ABI version information
|
|
|
|
|
2022-09-05 15:48:16 +00:00
|
|
|
* `Xcode/SDL/SDL.xcodeproj/project.pbxproj`:
|
2022-05-04 15:40:11 +00:00
|
|
|
`DYLIB_CURRENT_VERSION`, `DYLIB_COMPATIBILITY_VERSION`
|
|
|
|
* set first number in `DYLIB_CURRENT_VERSION` to
|
|
|
|
(100 * *minor*) + *patchlevel* + 1
|
|
|
|
* set second number in `DYLIB_CURRENT_VERSION` to 0
|
2022-09-05 15:48:16 +00:00
|
|
|
* set `DYLIB_COMPATIBILITY_VERSION` to the same value
|
2022-05-03 14:16:11 +00:00
|
|
|
|
|
|
|
* Regenerate `configure`
|
|
|
|
|
2022-09-05 18:25:10 +00:00
|
|
|
* Run test/versioning.sh to verify that everything is consistent
|
|
|
|
|
2022-05-03 14:16:11 +00:00
|
|
|
* Do the release
|