[TASK] Deprecate __toString() (#1012)

Part of #998

This is the V8.x backport of #1006.

Author: oliverklee

CHANGELOG.md

@@ -18,6 +18,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Deprecated
 
+- Deprecate `__toString()` (#1006)
 - 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)

src/CSSList/AtRuleBlockList.php

@@ -50,6 +50,8 @@ public function atRuleArgs()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/CSSList/CSSList.php

@@ -416,6 +416,8 @@ public function removeDeclarationBlockBySelector($mSelector, $bRemoveAll = false
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/CSSList/KeyFrame.php

@@ -61,6 +61,8 @@ public function getAnimationName()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Comment/Comment.php

@@ -59,6 +59,8 @@ public function setComment($sComment)
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Property/CSSNamespace.php

@@ -55,6 +55,8 @@ public function getLineNo()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Property/Charset.php

@@ -75,6 +75,8 @@ public function getCharset()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Property/Import.php

@@ -76,6 +76,8 @@ public function getLocation()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Property/Selector.php

@@ -121,6 +121,8 @@ public function setSelector($sSelector)
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Renderable.php

@@ -6,6 +6,8 @@ interface Renderable
 {
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString();
 

src/Rule/Rule.php

@@ -359,6 +359,8 @@ public function getIsImportant()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/RuleSet/AtRuleSet.php

@@ -53,6 +53,8 @@ public function atRuleArgs()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/RuleSet/DeclarationBlock.php

@@ -831,6 +831,8 @@ public function createFontShorthand()
      * @return string
      *
      * @throws OutputException
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/RuleSet/RuleSet.php

@@ -268,6 +268,8 @@ public function removeRule($mRule)
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/CSSFunction.php

@@ -88,6 +88,8 @@ public function getArguments()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/CSSString.php

@@ -94,6 +94,8 @@ public function getString()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/Color.php

@@ -155,6 +155,8 @@ public function getColorDescription()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/LineName.php

@@ -51,6 +51,8 @@ public static function parse(ParserState $oParserState)
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/Size.php

@@ -222,6 +222,8 @@ public function isRelative()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/URL.php

@@ -81,6 +81,8 @@ public function getURL()
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {

src/Value/ValueList.php

@@ -90,6 +90,8 @@ public function setListSeparator($sSeparator)
 
     /**
      * @return string
+     *
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
      */
     public function __toString()
     {