Merge pull request #603 from wmde/release500

Release 5.0.0

Author: Benestar

RELEASE-NOTES.md

@@ -1,6 +1,6 @@
 # Wikibase DataModel release notes
 
-## Version 5.0.0 (alpha)
+## Version 5.0.0 (2016-02-15)
 
 * Removed `Claims` class (deprecated since 1.0)
 * Removed `getClaims` and `setClaims` methods from `Entity`, `Item` and `Property` (deprecated since 1.0)
@@ -16,9 +16,11 @@
     * Added `getIterator` method
 * Removed `ReferenceList::removeDuplicates`
 * `ReferenceList::addReference` now throws an `InvalidArgumentException` for negative indices
-* `EntityDocument` now implements `Comparable`
-    * Added `equals` method
-* Added `copy` to `EntityDocument`
+* Added `EntityDocument::equals`, and `EntityDocument` now implements `Comparable`
+* Added `EntityDocument::copy`
+* Fixed `Property::clear` not clearing statements
+* `TermList` now skips and removes empty terms
+* Deprecated `ByPropertyIdArray`
 
 ## Version 4.4.0 (2016-01-20)
 

WikibaseDataModel.php

@@ -7,7 +7,7 @@
  * @author Jeroen De Dauw < jeroendedauw@gmail.com >
  */
 
-define( 'WIKIBASE_DATAMODEL_VERSION', '5.0.0 alpha' );
+define( 'WIKIBASE_DATAMODEL_VERSION', '5.0.0' );
 
 if ( defined( 'MEDIAWIKI' ) && function_exists( 'wfLoadExtension' ) ) {
 	wfLoadExtension( 'WikibaseDataModel', __DIR__ . '/mediawiki-extension.json' );

mediawiki-extension.json

@@ -1,6 +1,6 @@
 {
 	"name": "Wikibase DataModel",
-	"version": "5.0.0 alpha",
+	"version": "5.0.0",
 	"author": [
 		"[https://www.mediawiki.org/wiki/User:Jeroen_De_Dauw Jeroen De Dauw]",
 		"Thiemo Mättig"

src/ByPropertyIdArray.php

@@ -37,6 +37,7 @@
  * o3 (p2) ---> move to index 0 -/   o1 (p1)
  *
  * @since 0.2
+ * @deprecated since 5.0, use a DataModel Service instead
  *
  * @licence GNU GPL v2+
  * @author H. Snater < mediawiki@snater.com >

src/Term/TermList.php

@@ -13,6 +13,7 @@
 /**
  * Unordered list of Term objects.
  * If multiple terms with the same language code are provided, only the last one will be retained.
+ * Empty terms are skipped and treated as non-existing.
  *
  * @since 0.7.3
  *
@@ -115,6 +116,11 @@ private function assertIsLanguageCode( $languageCode ) {
 		}
 	}
 
+	/**
+	 * Replaces non-empty or removes empty terms.
+	 *
+	 * @param Term $term
+	 */
 	public function setTerm( Term $term ) {
 		if ( $term->getText() === '' ) {
 			unset( $this->terms[$term->getLanguageCode()] );