[TASK] State since which version code is @internal/@deprecated (#723)

oliverklee · web-flow · commit 8e4e373b94de · 2024-09-19T17:45:50.000+01:00
This will help us avoid breaking things in backports. This is the v8.x backport of #722.
diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php
@@ -129,7 +129,7 @@ public function getSelectorsBySpecificity($sSpecificitySearch = null)
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandShorthands()
     {
@@ -143,7 +143,7 @@ public function expandShorthands()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createShorthands()
     {
diff --git a/src/Parser.php b/src/Parser.php
@@ -36,7 +36,7 @@ public function __construct($sText, Settings $oParserSettings = null, $iLineNo =
      *
      * @return void
      *
-     * @deprecated will be removed in version 9.0.0 with #687
+     * @deprecated since 8.7.0, will be removed in version 9.0.0 with #687
      */
     public function setCharset($sCharset)
     {
@@ -48,7 +48,7 @@ public function setCharset($sCharset)
      *
      * @return void
      *
-     * @deprecated will be removed in version 9.0.0 with #687
+     * @deprecated since 8.7.0, will be removed in version 9.0.0 with #687
      */
     public function getCharset()
     {
diff --git a/src/Parsing/Anchor.php b/src/Parsing/Anchor.php
@@ -3,7 +3,7 @@
 namespace Sabberworm\CSS\Parsing;
 
 /**
- * @internal
+ * @internal since 8.7.0
  */
 class Anchor
 {
diff --git a/src/Parsing/ParserState.php b/src/Parsing/ParserState.php
@@ -6,14 +6,14 @@
 use Sabberworm\CSS\Settings;
 
 /**
- * @internal
+ * @internal since 8.7.0
  */
 class ParserState
 {
     /**
      * @var null
      *
-     * @internal
+     * @internal since 8.5.2
      */
     const EOF = null;
 
diff --git a/src/Property/AtRule.php b/src/Property/AtRule.php
@@ -13,7 +13,7 @@ interface AtRule extends Renderable, Commentable
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     const BLOCK_RULES = 'media/document/supports/region-style/font-feature-values';
 
@@ -22,7 +22,7 @@ interface AtRule extends Renderable, Commentable
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     const SET_RULES = 'font-face/counter-style/page/swash/styleset/annotation';
 
diff --git a/src/Property/KeyframeSelector.php b/src/Property/KeyframeSelector.php
@@ -9,7 +9,7 @@ class KeyframeSelector extends Selector
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     const SELECTOR_VALIDATION_RX = '/
     ^(
diff --git a/src/Property/Selector.php b/src/Property/Selector.php
@@ -54,7 +54,7 @@ class Selector
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     const SELECTOR_VALIDATION_RX = '/
         ^(
diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php
@@ -182,7 +182,7 @@ public function getSelectors()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandShorthands()
     {
@@ -199,7 +199,7 @@ public function expandShorthands()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createShorthands()
     {
@@ -220,7 +220,7 @@ public function createShorthands()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandBorderShorthand()
     {
@@ -283,7 +283,7 @@ public function expandBorderShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandDimensionsShorthand()
     {
@@ -345,7 +345,7 @@ public function expandDimensionsShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandFontShorthand()
     {
@@ -417,7 +417,7 @@ public function expandFontShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandBackgroundShorthand()
     {
@@ -491,7 +491,7 @@ public function expandBackgroundShorthand()
     /**
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function expandListStyleShorthand()
     {
@@ -576,7 +576,7 @@ public function expandListStyleShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createShorthandProperties(array $aProperties, $sShorthand)
     {
@@ -614,7 +614,7 @@ public function createShorthandProperties(array $aProperties, $sShorthand)
     /**
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createBackgroundShorthand()
     {
@@ -631,7 +631,7 @@ public function createBackgroundShorthand()
     /**
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createListStyleShorthand()
     {
@@ -650,7 +650,7 @@ public function createListStyleShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createBorderShorthand()
     {
@@ -669,7 +669,7 @@ public function createBorderShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createDimensionsShorthand()
     {
@@ -745,7 +745,7 @@ public function createDimensionsShorthand()
      *
      * @return void
      *
-     * @deprecated This will be removed without substitution in version 9.0 in #511.
+     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
      */
     public function createFontShorthand()
     {

Original file line number	Diff line number	Diff line change
`@@ -129,7 +129,7 @@ public function getSelectorsBySpecificity($sSpecificitySearch = null)`
`129`	`129`	`*`
`130`	`130`	`* @return void`
`131`	`131`	`*`
`132`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`132`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`133`	`133`	`*/`
`134`	`134`	`public function expandShorthands()`
`135`	`135`	`{`
`@@ -143,7 +143,7 @@ public function expandShorthands()`
`143`	`143`	`*`
`144`	`144`	`* @return void`
`145`	`145`	`*`
`146`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`146`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`147`	`147`	`*/`
`148`	`148`	`public function createShorthands()`
`149`	`149`	`{`
Original file line number	Diff line number	Diff line change
`@@ -36,7 +36,7 @@ public function __construct($sText, Settings $oParserSettings = null, $iLineNo =`
`36`	`36`	`*`
`37`	`37`	`* @return void`
`38`	`38`	`*`
`39`		`- * @deprecated will be removed in version 9.0.0 with #687`
	`39`	`+ * @deprecated since 8.7.0, will be removed in version 9.0.0 with #687`
`40`	`40`	`*/`
`41`	`41`	`public function setCharset($sCharset)`
`42`	`42`	`{`
`@@ -48,7 +48,7 @@ public function setCharset($sCharset)`
`48`	`48`	`*`
`49`	`49`	`* @return void`
`50`	`50`	`*`
`51`		`- * @deprecated will be removed in version 9.0.0 with #687`
	`51`	`+ * @deprecated since 8.7.0, will be removed in version 9.0.0 with #687`
`52`	`52`	`*/`
`53`	`53`	`public function getCharset()`
`54`	`54`	`{`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`namespace Sabberworm\CSS\Parsing;`
`4`	`4`
`5`	`5`	`/**`
`6`		`- * @internal`
	`6`	`+ * @internal since 8.7.0`
`7`	`7`	`*/`
`8`	`8`	`class Anchor`
`9`	`9`	`{`
Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ interface AtRule extends Renderable, Commentable`
`13`	`13`	`*`
`14`	`14`	`* @var string`
`15`	`15`	`*`
`16`		`- * @internal`
	`16`	`+ * @internal since 8.5.2`
`17`	`17`	`*/`
`18`	`18`	`const BLOCK_RULES = 'media/document/supports/region-style/font-feature-values';`
`19`	`19`
`@@ -22,7 +22,7 @@ interface AtRule extends Renderable, Commentable`
`22`	`22`	`*`
`23`	`23`	`* @var string`
`24`	`24`	`*`
`25`		`- * @internal`
	`25`	`+ * @internal since 8.5.2`
`26`	`26`	`*/`
`27`	`27`	`const SET_RULES = 'font-face/counter-style/page/swash/styleset/annotation';`
`28`	`28`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ class KeyframeSelector extends Selector`
`9`	`9`	`*`
`10`	`10`	`* @var string`
`11`	`11`	`*`
`12`		`- * @internal`
	`12`	`+ * @internal since 8.5.2`
`13`	`13`	`*/`
`14`	`14`	`const SELECTOR_VALIDATION_RX = '/`
`15`	`15`	`^(`
Original file line number	Diff line number	Diff line change
`@@ -54,7 +54,7 @@ class Selector`
`54`	`54`	`*`
`55`	`55`	`* @var string`
`56`	`56`	`*`
`57`		`- * @internal`
	`57`	`+ * @internal since 8.5.2`
`58`	`58`	`*/`
`59`	`59`	`const SELECTOR_VALIDATION_RX = '/`
`60`	`60`	`^(`
Original file line number	Diff line number	Diff line change
`@@ -182,7 +182,7 @@ public function getSelectors()`
`182`	`182`	`*`
`183`	`183`	`* @return void`
`184`	`184`	`*`
`185`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`185`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`186`	`186`	`*/`
`187`	`187`	`public function expandShorthands()`
`188`	`188`	`{`
`@@ -199,7 +199,7 @@ public function expandShorthands()`
`199`	`199`	`*`
`200`	`200`	`* @return void`
`201`	`201`	`*`
`202`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`202`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`203`	`203`	`*/`
`204`	`204`	`public function createShorthands()`
`205`	`205`	`{`
`@@ -220,7 +220,7 @@ public function createShorthands()`
`220`	`220`	`*`
`221`	`221`	`* @return void`
`222`	`222`	`*`
`223`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`223`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`224`	`224`	`*/`
`225`	`225`	`public function expandBorderShorthand()`
`226`	`226`	`{`
`@@ -283,7 +283,7 @@ public function expandBorderShorthand()`
`283`	`283`	`*`
`284`	`284`	`* @return void`
`285`	`285`	`*`
`286`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`286`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`287`	`287`	`*/`
`288`	`288`	`public function expandDimensionsShorthand()`
`289`	`289`	`{`
`@@ -345,7 +345,7 @@ public function expandDimensionsShorthand()`
`345`	`345`	`*`
`346`	`346`	`* @return void`
`347`	`347`	`*`
`348`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`348`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`349`	`349`	`*/`
`350`	`350`	`public function expandFontShorthand()`
`351`	`351`	`{`
`@@ -417,7 +417,7 @@ public function expandFontShorthand()`
`417`	`417`	`*`
`418`	`418`	`* @return void`
`419`	`419`	`*`
`420`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`420`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`421`	`421`	`*/`
`422`	`422`	`public function expandBackgroundShorthand()`
`423`	`423`	`{`
`@@ -491,7 +491,7 @@ public function expandBackgroundShorthand()`
`491`	`491`	`/**`
`492`	`492`	`* @return void`
`493`	`493`	`*`
`494`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`494`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`495`	`495`	`*/`
`496`	`496`	`public function expandListStyleShorthand()`
`497`	`497`	`{`
`@@ -576,7 +576,7 @@ public function expandListStyleShorthand()`
`576`	`576`	`*`
`577`	`577`	`* @return void`
`578`	`578`	`*`
`579`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`579`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`580`	`580`	`*/`
`581`	`581`	`public function createShorthandProperties(array $aProperties, $sShorthand)`
`582`	`582`	`{`
`@@ -614,7 +614,7 @@ public function createShorthandProperties(array $aProperties, $sShorthand)`
`614`	`614`	`/**`
`615`	`615`	`* @return void`
`616`	`616`	`*`
`617`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`617`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`618`	`618`	`*/`
`619`	`619`	`public function createBackgroundShorthand()`
`620`	`620`	`{`
`@@ -631,7 +631,7 @@ public function createBackgroundShorthand()`
`631`	`631`	`/**`
`632`	`632`	`* @return void`
`633`	`633`	`*`
`634`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`634`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`635`	`635`	`*/`
`636`	`636`	`public function createListStyleShorthand()`
`637`	`637`	`{`
`@@ -650,7 +650,7 @@ public function createListStyleShorthand()`
`650`	`650`	`*`
`651`	`651`	`* @return void`
`652`	`652`	`*`
`653`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`653`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`654`	`654`	`*/`
`655`	`655`	`public function createBorderShorthand()`
`656`	`656`	`{`
`@@ -669,7 +669,7 @@ public function createBorderShorthand()`
`669`	`669`	`*`
`670`	`670`	`* @return void`
`671`	`671`	`*`
`672`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`672`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`673`	`673`	`*/`
`674`	`674`	`public function createDimensionsShorthand()`
`675`	`675`	`{`
`@@ -745,7 +745,7 @@ public function createDimensionsShorthand()`
`745`	`745`	`*`
`746`	`746`	`* @return void`
`747`	`747`	`*`
`748`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`748`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`749`	`749`	`*/`
`750`	`750`	`public function createFontShorthand()`
`751`	`751`	`{`