24.2 Versionsnummern in PEAR 

Wie in anderen Projekten auch gibt es einen fest definierten Aufbau für Versionsnummern, an den Sie sich halten müssen.

Eine Versionsnummer setzt sich aus »Major Version«, »Minor Version«, dem »Patch Level« und dem »Release State« zusammen. Eine Major Version ist also eine neue »Haupt-Version«, in der sich größere Änderungen ergeben haben oder in der der Code komplett neu implementiert wurde. Kleinere Änderungen werden jeweils durch eine neue Minor Version beschrieben. Der Patch Level sollte nur neue Releases markieren, in denen Fehler korrigiert wurden. Mit dem Release State können das Development-, Alpha-, Beta- und Release-Candidate-Stadium festgelegt werden. Diese Status werden mit dev, a, b und RC abgekürzt. Zusätzlich kann noch der Status Pl für Patch Level genutzt werden. Damit werden ganz geringfügige Änderungen deutlich gemacht, die keine neue Versionsnummer im Patch Level rechtfertigen würden. Die Nutzung von Pl ist aber eher selten. Die Status können auch noch durchnummeriert werden, so dass Sie beispielsweise mehrere Alpha-Versionen von a1 bis a9 nutzen können.

Die Major-Versionsnummer ist als einzige erforderlich. Alle anderen Angaben sind optional.

Die beiden Versionsnummern sowie der Patch Level werden dabei jeweils durch Punkte voneinander getrennt. Der Release-Status wird direkt an die letzte Zahl angehängt.