Versioning

SabreDAV is now considered stable (and 1.0 at the time of writing).

SabreDAV features are split in the following 2 major pieces:

End-user API

The End-user API is the api that consists of the following classes:

• Sabre_DAV_Server's most functions
• Sabre_DAV_INode
• Sabre_DAV_IFile
• Sabre_DAV_IDirectory
• Sabre_DAV_IQuota
• Sabre_DAV_IProperties
• Sabre_DAV_ILockable
• Sabre_DAV_Node
• Sabre_DAV_File
• Sabre_DAV_Directory
• Sabre_DAV_FS_Node
• Sabre_DAV_FS_Directory
• Sabre_DAV_FS_File
• Sabre_DAV_FSExt_Node
• Sabre_DAV_FSExt_File
• Sabre_DAV_FSExt_Directory
• Sabre_DAV_Exception (and all other exceptions)
• Sabre_DAV_Locks_Backend_FS
• Sabre_DAV_Locks_Backend_PDO
• Sabre_DAV_LockInfo
• Sabre_DAV_Tree
• Sabre_DAV_ObjectTree
• Sabre_DAV_Tree_Filesystem
• Sabre_DAV_TemporaryFileFilterPlugin
• Sabre_HTTP (and all API's in this directory).

No backwards compatible changes will be made to these classes until version 2.0 of SabreDAV.

Plugin API

The Plugin API is relates to:

• All events
• Sabre_DAV_ServerPlugin

The plugin API is constantly evolving. This is largly due to the necessary changes required by implementing RFC 3744 (ACL support). Because very little people will likely write plugins on their own, and most people will just use the End-user API, some flexibility is required here.

Therefore no backwards compatibile changes will be made in 1.0.* versions of SabreDAV.

Beta and Alpha versions

Odd-numbers in the minor version are reserved for beta and alpha-releases only. This means that the 1.1.* range will solely be dedicated for new beta and alpha versions. When features developed within the 1.1 branch reach stability, these changes will be rolled into a new 1.2 release.

1.0.*, 1.2.* are really reserved for bugfixes-only.

PHP / other dependency breaks

Currently the minimum required version for SabreDAV is 5.2. In the future SabreDAV might require 5.3 for certain new features. This might be done in a minor revision change, such as 1.2. If, in the future a switch from PEAR-style packages to PHP namespaces is made, this means the end-user API will break and thus can only roll into a 2.0 (or 3.0) release.