[CLEANUP] Deprecate DeclarationBlock::expandShorthands

The `expandShorthands`/`createShorthands` Functions are deprecated and
will be removed without substitution in version 10.0.  Expanding and
creating the shorthand notation is out of the scope of this library. If
you want to include this functionality in your project or build it into
a separate package, get the code from the v8.5.1 version of this
library.

Signed-off-by: Daniel Ziegenberg <[email protected]>

Author: ziegenberg

CHANGELOG.md

@@ -18,6 +18,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Deprecated
 
+- `DeclarationBlock::expandShorthands()` is deprecated and will be removed without substitution in version 10.0.
+
 ### Removed
 
 - Drop support for PHP < 7.2 (#420)

README.md

@@ -801,6 +801,10 @@ classDiagram
 
 The latest pre-PSR-0 version of this project can be checked with the `0.9.0` tag.
 
+The `expandShorthands`/`createShorthands` Functions are deprecated and will be removed without substitution in version 10.0.
+Expanding and creating the shorthand notation is out of the scope of this library. If you want to include this functionality
+in your project or build it into a separate package, get the code from the v8.5.1 version of this library.
+
 ### Running Tests
 
 To run all continuous integration (CI) checks for this project (including unit tests),

src/RuleSet/DeclarationBlock.php

@@ -181,15 +181,13 @@ public function getSelectors()
      * Splits shorthand declarations (e.g. `margin` or `font`) into their constituent parts.
      *
      * @return void
+     *
+     * @deprecated This will be removed without substitution in version 10.0.
      */
     public function expandShorthands()
     {
-        // border must be expanded before dimensions
-        $this->expandBorderShorthand();
-        $this->expandDimensionsShorthand();
-        $this->expandFontShorthand();
-        $this->expandBackgroundShorthand();
-        $this->expandListStyleShorthand();
+        trigger_error("Expanding Shorthands will be removed without substitution in version 10.0.");
+        return;
     }
 
     /**