Merge pull request #426 from wmde/whatInstead

More specific deprecation tags

Author: JeroenDeDauw

src/Entity/Entity.php

@@ -350,7 +350,7 @@ public function copy() {
 
 	/**
 	 * @since 0.3
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use getStatements()->addStatement() instead.
 	 *
 	 * @param Claim $claim
 	 *
@@ -363,7 +363,7 @@ public function addClaim( Claim $claim ) {
 
 	/**
 	 * @since 0.3
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use getStatements()->toArray() instead.
 	 *
 	 * @return Claim[]
 	 */
@@ -378,7 +378,7 @@ public function getClaims() {
 	 * the check without forcing an unstub in contrast to count( $this->getClaims() ).
 	 *
 	 * @since 0.2
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use getStatements()->isEmpty() instead.
 	 *
 	 * @return bool
 	 */
@@ -388,7 +388,7 @@ public function hasClaims() {
 
 	/**
 	 * @since 0.3
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use new Statement() instead.
 	 *
 	 * @param Snak $mainSnak
 	 *

src/Entity/Item.php

@@ -110,7 +110,7 @@ public function setSiteLinkList( SiteLinkList $siteLinks ) {
 	 * If there already is a site link with the site id of the provided site link,
 	 * then that one will be overridden by the provided one.
 	 *
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList()->addSiteLink() instead.
 	 * @since 0.6
 	 *
 	 * @param SiteLink $siteLink
@@ -126,7 +126,7 @@ public function addSiteLink( SiteLink $siteLink ) {
 	/**
 	 * Removes the sitelink with specified site ID if the Item has such a sitelink.
 	 *
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList()->removeLinkWithSiteId() instead.
 	 * @since 0.1
 	 *
 	 * @param string $siteId the target site's id
@@ -136,7 +136,7 @@ public function removeSiteLink( $siteId ) {
 	}
 
 	/**
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList() instead,
 	 * @since 0.6
 	 *
 	 * @return SiteLink[]
@@ -146,7 +146,7 @@ public function getSiteLinks() {
 	}
 
 	/**
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList()->getBySiteId() instead.
 	 * @since 0.6
 	 *
 	 * @param string $siteId
@@ -159,7 +159,7 @@ public function getSiteLink( $siteId ) {
 	}
 
 	/**
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList()->hasLinkWithSiteId() instead.
 	 * @since 0.4
 	 *
 	 * @param string $siteId
@@ -171,7 +171,7 @@ public function hasLinkToSite( $siteId ) {
 	}
 
 	/**
-	 * @deprecated since 0.8, use getSiteLinkList and setSiteLinkList instead
+	 * @deprecated since 0.8, use getSiteLinkList()->isEmpty() instead.
 	 * @since 0.5
 	 *
 	 * @return bool
@@ -201,7 +201,7 @@ public function getType() {
 	}
 
 	/**
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use new Statement() instead.
 	 *
 	 * @param Snak $mainSnak
 	 *

src/Entity/Property.php

@@ -233,7 +233,7 @@ public function hasClaims() {
 	}
 
 	/**
-	 * @deprecated since 1.0
+	 * @deprecated since 1.0, use new Statement() instead.
 	 *
 	 * @param Snak $mainSnak
 	 *