From 91eca649a6850c6c2554c929d92e1380d27d7984 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Sun, 27 Jun 2021 18:13:23 +0200
Subject: [PATCH] Mention when deprecated code will be removed

Mark the code as to be removed in the next major version (which would
be in line with Semantic versioning).
---
 src/CSSList/Document.php         | 2 +-
 src/Rule/Rule.php                | 6 ++++--
 src/RuleSet/DeclarationBlock.php | 4 ++--
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php
index 77a15a2b..8bf15b9e 100644
--- a/src/CSSList/Document.php
+++ b/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()
     {
diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php
index 41ba7e7a..5fa6764e 100644
--- a/src/Rule/Rule.php
+++ b/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()
diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php
index 5fa19773..c27cdd4c 100644
--- a/src/RuleSet/DeclarationBlock.php
+++ b/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)
     {