---

28.2 Semantic Versioning specification ¶

The specification of Semantic Versioning is publicly available at the site:

under the terms of the Creative Commons — CC BY 3.0. The Semantic Versioning specification is authored by Tom Preston–Werner, inventor of Gravatars and cofounder of GitHub. MBFL implements a parser for version 2.0.0 of the specification; it also adds specifications for ranges. The full text of the specification is included here, with small formatting changes.

Given a version number ‘MAJOR.MINOR.PATCH’, increment the:

1. ‘MAJOR’ version when you make incompatible API changes.
2. ‘MINOR’ version when you add functionality in a backwards–compatible manner.
3. ‘PATCH’ version when you make backwards–compatible bug fixes.

Additional labels for pre–release and build metadata are available as extensions to the ‘MAJOR.MINOR.PATCH’ format.

• semver spec introduction:		Introduction.
• semver spec semver:		Semantic Versioning Specification (SemVer).
• semver spec why:		Why use semantic versioning?
• semver spec faq:		Frequently asked questions.