From d6fdff0cc6f94a3cb0c99b9b9f577a46691535a7 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Thu, 27 Feb 2025 12:53:01 +0100
Subject: [PATCH] [TASK] Deprecate greedy calculation of selector specificity

This constructor parameter is not used, and having the
specificity calculation always done lazily is not a problem.

This is the V8.x backport of #1018.
---
 CHANGELOG.md              | 1 +
 src/Property/Selector.php | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index caad56af..7eafae61 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Deprecated
 
+- Deprecate greedy calculation of selector specificity (#1018)
 - Deprecate the IE hack in `Rule` (#993, #1003)
 - `OutputFormat` properties for space around list separators as an array (#880)
 - Deprecate `OutputFormat::level()` (#870)
diff --git a/src/Property/Selector.php b/src/Property/Selector.php
index 44355e63..5e2dda30 100644
--- a/src/Property/Selector.php
+++ b/src/Property/Selector.php
@@ -88,7 +88,7 @@ public static function isValid($sSelector)
 
     /**
      * @param string $sSelector
-     * @param bool $bCalculateSpecificity
+     * @param bool $bCalculateSpecificity @deprecated since V8.8.0, will be removed in V9.0.0
      */
     public function __construct($sSelector, $bCalculateSpecificity = false)
     {