| 1 |
Version Numbers and Releases |
| 2 |
============================ |
| 3 |
|
| 4 |
Curl is not only curl. Curl is also libcurl. They're actually individually |
| 5 |
versioned, but they mostly follow each other rather closely. |
| 6 |
|
| 7 |
The version numbering is always built up using the same system: |
| 8 |
|
| 9 |
X.Y.Z |
| 10 |
|
| 11 |
- X is main version number |
| 12 |
- Y is release number |
| 13 |
- Z is patch number |
| 14 |
|
| 15 |
## Bumping numbers |
| 16 |
|
| 17 |
One of these numbers will get bumped in each new release. The numbers to the |
| 18 |
right of a bumped number will be reset to zero. If Z is zero, it may not be |
| 19 |
included in the version number. |
| 20 |
|
| 21 |
The main version number will get bumped when *really* big, world colliding |
| 22 |
changes are made. The release number is bumped when changes are performed or |
| 23 |
things/features are added. The patch number is bumped when the changes are |
| 24 |
mere bugfixes. |
| 25 |
|
| 26 |
It means that after release 1.2.3, we can release 2.0 if something really big |
| 27 |
has been made, 1.3 if not that big changes were made or 1.2.4 if mostly bugs |
| 28 |
were fixed. |
| 29 |
|
| 30 |
Bumping, as in increasing the number with 1, is unconditionally only |
| 31 |
affecting one of the numbers (except the ones to the right of it, that may be |
| 32 |
set to zero). 1 becomes 2, 3 becomes 4, 9 becomes 10, 88 becomes 89 and 99 |
| 33 |
becomes 100. So, after 1.2.9 comes 1.2.10. After 3.99.3, 3.100 might come. |
| 34 |
|
| 35 |
All original curl source release archives are named according to the libcurl |
| 36 |
version (not according to the curl client version that, as said before, might |
| 37 |
differ). |
| 38 |
|
| 39 |
As a service to any application that might want to support new libcurl |
| 40 |
features while still being able to build with older versions, all releases |
| 41 |
have the libcurl version stored in the curl/curlver.h file using a static |
| 42 |
numbering scheme that can be used for comparison. The version number is |
| 43 |
defined as: |
| 44 |
|
| 45 |
#define LIBCURL_VERSION_NUM 0xXXYYZZ |
| 46 |
|
| 47 |
Where XX, YY and ZZ are the main version, release and patch numbers in |
| 48 |
hexadecimal. All three number fields are always represented using two digits |
| 49 |
(eight bits each). 1.2 would appear as "0x010200" while version 9.11.7 |
| 50 |
appears as "0x090b07". |
| 51 |
|
| 52 |
This 6-digit hexadecimal number is always a greater number in a more recent |
| 53 |
release. It makes comparisons with greater than and less than work. |
| 54 |
|
| 55 |
This number is also available as three separate defines: |
| 56 |
`LIBCURL_VERSION_MAJOR`, `LIBCURL_VERSION_MINOR` and `LIBCURL_VERSION_PATCH`. |