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`. 57
