|
1 | 1 | # SPM version numbers
|
2 |
| -SPM has a **version** and a **release**. At the time of writing, the version is **SPM12** and the release is **dev**. |
| 2 | +SPM has a **version** and a **release**. For example, the version may be **SPM25** and the release may be **25.01**. |
3 | 3 |
|
4 | 4 | Other toolboxes that depend on SPM use this information to check whether a compatible SPM version is installed. A common pattern is to split the version string into two parts, e.g. SPM12 becomes **SPM** and **12**, and then the latter part is compared to the desired version number.
|
5 | 5 |
|
6 |
| -## Transition to calendar versioning |
7 |
| -SPM is moving towards [calendar versioning](https://calver.org/). |
| 6 | +## Calendar versioning |
| 7 | +With the introduction of SPM25, SPM moved to [calendar versioning](https://calver.org/). The format is **YY.0M[.MICRO]**, where YY is the short year (e.g. 25 for the year 2025), 0M is the zero padded month (e.g. 06 for June or 12 for December) and .MICRO is an optional integer for patches. |
8 | 8 |
|
9 |
| -The proposed new format is **YY.0M[.MICRO]**, where YY is the short year (e.g. 24 for the year 2024), 0M is the zero padded month (e.g. 06 for June or 12 for December) and .MICRO is an optional integer for patches. |
| 9 | +For backward compatibility, the version and release are set as follows: |
10 | 10 |
|
11 |
| -For backward compatibility, the proposal is to set the version and release as follows: |
12 |
| - |
13 |
| -- **Version**: SPMYY, where YY is the year of the most recent release, e.g. SPM24 |
14 |
| -- **Release**: either 00.00 for the development version on Github or for a release: YY.0M[.MICRO], e.g. 24.07 for July 2024 |
| 11 | +- **Version**: SPMYY, where YY is the year of the most recent release, e.g. SPM25 |
| 12 | +- **Release**: either 00.00 for the development version on Github or for a release: YY.0M[.MICRO], e.g. 25.07 for July 2025 |
15 | 13 |
|
16 | 14 | ## Where the SPM version number is stored
|
17 | 15 | The SPM version is stored on the second line of the file Contents.m in the root directory, or Contents.txt when SPM is in deployed mode (i.e., compiled).
|
|
0 commit comments