Merge pull request #289 from oliverklee/task/deprecated

Mention when deprecated code will be removed

Author: sabberworm

src/CSSList/Document.php

@@ -47,7 +47,7 @@ public function getAllDeclarationBlocks()
     }
 
     /**
-     * @deprecated use getAllDeclarationBlocks()
+     * @deprecated will be removed in version 9.0; use `getAllDeclarationBlocks()` instead
      */
     public function getAllSelectors()
     {

src/Rule/Rule.php

@@ -193,7 +193,8 @@ public function setValue($mValue)
      *
      * @return RuleValueList
      *
-     * @deprecated Old-Style 2-dimensional array given. Retained for (some) backwards-compatibility.
+     * @deprecated will be removed in version 9.0
+     *             Old-Style 2-dimensional array given. Retained for (some) backwards-compatibility.
      *             Use `setValue()` instead and wrap the value inside a RuleValueList if necessary.
      */
     public function setValues(array $aSpaceSeparatedValues)
@@ -232,7 +233,8 @@ public function setValues(array $aSpaceSeparatedValues)
     /**
      * @return array<int, array<int, RuleValueList>>
      *
-     * @deprecated Old-Style 2-dimensional array returned. Retained for (some) backwards-compatibility.
+     * @deprecated will be removed in version 9.0
+     *             Old-Style 2-dimensional array returned. Retained for (some) backwards-compatibility.
      *             Use `getValue()` instead and check for the existence of a (nested set of) ValueList object(s).
      */
     public function getValues()

src/RuleSet/DeclarationBlock.php

@@ -146,7 +146,7 @@ public function removeSelector($mSelector)
     /**
      * @return array<int, Selector|string>
      *
-     * @deprecated use `getSelectors()`
+     * @deprecated will be removed in version 9.0; use `getSelectors()` instead
      */
     public function getSelector()
     {
@@ -159,7 +159,7 @@ public function getSelector()
      *
      * @return void
      *
-     * @deprecated use `setSelectors()`
+     * @deprecated will be removed in version 9.0; use `setSelectors()` instead
      */
     public function setSelector($mSelector, $oList = null)
     {