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

oliverklee · web-flow · commit 74df2cd893ed · 2024-09-18T18:31:56.000+01:00
This will help us avoid breaking things in backports.
diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php
@@ -114,7 +114,7 @@ public function getSelectorsBySpecificity($sSpecificitySearch = null)
     /**
      * Expands all shorthand properties to their long value.
      *
-     * @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(): void
     {
@@ -126,7 +126,7 @@ public function expandShorthands(): void
     /**
      * Create shorthands properties whenever possible.
      *
-     * @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(): void
     {
diff --git a/src/Parser.php b/src/Parser.php
@@ -36,7 +36,7 @@ public function __construct($sText, ?Settings $oParserSettings = null, $iLineNo
      *
      * @param string $sCharset
      *
-     * @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): void
     {
@@ -46,7 +46,7 @@ public function setCharset($sCharset): void
     /**
      * Returns the charset that is used if the CSS does not contain an `@charset` declaration.
      *
-     * @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(): void
     {
diff --git a/src/Parsing/Anchor.php b/src/Parsing/Anchor.php
@@ -5,7 +5,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
@@ -8,14 +8,14 @@
 use Sabberworm\CSS\Settings;
 
 /**
- * @internal
+ * @internal since 8.7.0
  */
 class ParserState
 {
     /**
      * @var null
      *
-     * @internal
+     * @internal since 8.5.2
      */
     public const EOF = null;
 
diff --git a/src/Property/AtRule.php b/src/Property/AtRule.php
@@ -15,7 +15,7 @@ interface AtRule extends Renderable, Commentable
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     public const BLOCK_RULES = 'media/document/supports/region-style/font-feature-values';
 
@@ -24,7 +24,7 @@ interface AtRule extends Renderable, Commentable
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     public const SET_RULES = 'font-face/counter-style/page/swash/styleset/annotation';
 
diff --git a/src/Property/KeyframeSelector.php b/src/Property/KeyframeSelector.php
@@ -11,7 +11,7 @@ class KeyframeSelector extends Selector
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     public const SELECTOR_VALIDATION_RX = '/
     ^(
diff --git a/src/Property/Selector.php b/src/Property/Selector.php
@@ -52,7 +52,7 @@ class Selector
      *
      * @var string
      *
-     * @internal
+     * @internal since 8.5.2
      */
     public const SELECTOR_VALIDATION_RX = '/
         ^(
diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php
@@ -157,7 +157,7 @@ public function getSelectors()
     /**
      * Splits shorthand declarations (e.g. `margin` or `font`) into their constituent parts.
      *
-     * @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(): void
     {
@@ -172,7 +172,7 @@ public function expandShorthands(): void
     /**
      * Creates shorthand declarations (e.g. `margin` or `font`) whenever possible.
      *
-     * @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(): void
     {
@@ -191,7 +191,7 @@ public function createShorthands(): void
      *
      * Multiple borders are not yet supported as of 3.
      *
-     * @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(): void
     {
@@ -252,7 +252,7 @@ public function expandBorderShorthand(): void
      *
      * Handles `margin`, `padding`, `border-color`, `border-style` and `border-width`.
      *
-     * @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(): void
     {
@@ -312,7 +312,7 @@ public function expandDimensionsShorthand(): void
      * (e.g. `font: 300 italic 11px/14px verdana, helvetica, sans-serif;`)
      * into their constituent parts.
      *
-     * @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(): void
     {
@@ -381,7 +381,7 @@ public function expandFontShorthand(): void
      *
      * @see http://www.w3.org/TR/21/colors.html#propdef-background
      *
-     * @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(): void
     {
@@ -453,7 +453,7 @@ public function expandBackgroundShorthand(): 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(): void
     {
@@ -536,7 +536,7 @@ public function expandListStyleShorthand(): void
      * @param array<array-key, string> $aProperties
      * @param string $sShorthand
      *
-     * @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): void
     {
@@ -572,7 +572,7 @@ public function createShorthandProperties(array $aProperties, $sShorthand): 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(): void
     {
@@ -587,7 +587,7 @@ public function createBackgroundShorthand(): 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(): void
     {
@@ -604,7 +604,7 @@ public function createListStyleShorthand(): void
      *
      * Should be run after `create_dimensions_shorthand`!
      *
-     * @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(): void
     {
@@ -621,7 +621,7 @@ public function createBorderShorthand(): void
      * (margin, padding, border-color, border-style and border-width)
      * and converts them into shorthand CSS properties.
      *
-     * @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(): void
     {
@@ -695,7 +695,7 @@ public function createDimensionsShorthand(): void
      *
      * At least `font-size` AND `font-family` must be present in order to create a shorthand declaration.
      *
-     * @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(): void
     {

Original file line number	Diff line number	Diff line change
`@@ -114,7 +114,7 @@ public function getSelectorsBySpecificity($sSpecificitySearch = null)`
`114`	`114`	`/**`
`115`	`115`	`* Expands all shorthand properties to their long value.`
`116`	`116`	`*`
`117`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`117`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`118`	`118`	`*/`
`119`	`119`	`public function expandShorthands(): void`
`120`	`120`	`{`
`@@ -126,7 +126,7 @@ public function expandShorthands(): void`
`126`	`126`	`/**`
`127`	`127`	`* Create shorthands properties whenever possible.`
`128`	`128`	`*`
`129`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`129`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`130`	`130`	`*/`
`131`	`131`	`public function createShorthands(): void`
`132`	`132`	`{`
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`	`* @param string $sCharset`
`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): void`
`42`	`42`	`{`
`@@ -46,7 +46,7 @@ public function setCharset($sCharset): void`
`46`	`46`	`/**`
`47`	`47`	* Returns the charset that is used if the CSS does not contain an `@charset` declaration.
`48`	`48`	`*`
`49`		`- * @deprecated will be removed in version 9.0.0 with #687`
	`49`	`+ * @deprecated since 8.7.0, will be removed in version 9.0.0 with #687`
`50`	`50`	`*/`
`51`	`51`	`public function getCharset(): void`
`52`	`52`	`{`
Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`namespace Sabberworm\CSS\Parsing;`
`6`	`6`
`7`	`7`	`/**`
`8`		`- * @internal`
	`8`	`+ * @internal since 8.7.0`
`9`	`9`	`*/`
`10`	`10`	`class Anchor`
`11`	`11`	`{`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ interface AtRule extends Renderable, Commentable`
`15`	`15`	`*`
`16`	`16`	`* @var string`
`17`	`17`	`*`
`18`		`- * @internal`
	`18`	`+ * @internal since 8.5.2`
`19`	`19`	`*/`
`20`	`20`	`public const BLOCK_RULES = 'media/document/supports/region-style/font-feature-values';`
`21`	`21`
`@@ -24,7 +24,7 @@ interface AtRule extends Renderable, Commentable`
`24`	`24`	`*`
`25`	`25`	`* @var string`
`26`	`26`	`*`
`27`		`- * @internal`
	`27`	`+ * @internal since 8.5.2`
`28`	`28`	`*/`
`29`	`29`	`public const SET_RULES = 'font-face/counter-style/page/swash/styleset/annotation';`
`30`	`30`
Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@ class KeyframeSelector extends Selector`
`11`	`11`	`*`
`12`	`12`	`* @var string`
`13`	`13`	`*`
`14`		`- * @internal`
	`14`	`+ * @internal since 8.5.2`
`15`	`15`	`*/`
`16`	`16`	`public const SELECTOR_VALIDATION_RX = '/`
`17`	`17`	`^(`
Original file line number	Diff line number	Diff line change
`@@ -52,7 +52,7 @@ class Selector`
`52`	`52`	`*`
`53`	`53`	`* @var string`
`54`	`54`	`*`
`55`		`- * @internal`
	`55`	`+ * @internal since 8.5.2`
`56`	`56`	`*/`
`57`	`57`	`public const SELECTOR_VALIDATION_RX = '/`
`58`	`58`	`^(`
Original file line number	Diff line number	Diff line change
`@@ -157,7 +157,7 @@ public function getSelectors()`
`157`	`157`	`/**`
`158`	`158`	* Splits shorthand declarations (e.g. `margin` or `font`) into their constituent parts.
`159`	`159`	`*`
`160`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`160`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`161`	`161`	`*/`
`162`	`162`	`public function expandShorthands(): void`
`163`	`163`	`{`
`@@ -172,7 +172,7 @@ public function expandShorthands(): void`
`172`	`172`	`/**`
`173`	`173`	* Creates shorthand declarations (e.g. `margin` or `font`) whenever possible.
`174`	`174`	`*`
`175`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`175`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`176`	`176`	`*/`
`177`	`177`	`public function createShorthands(): void`
`178`	`178`	`{`
`@@ -191,7 +191,7 @@ public function createShorthands(): void`
`191`	`191`	`*`
`192`	`192`	`* Multiple borders are not yet supported as of 3.`
`193`	`193`	`*`
`194`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`194`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`195`	`195`	`*/`
`196`	`196`	`public function expandBorderShorthand(): void`
`197`	`197`	`{`
`@@ -252,7 +252,7 @@ public function expandBorderShorthand(): void`
`252`	`252`	`*`
`253`	`253`	* Handles `margin`, `padding`, `border-color`, `border-style` and `border-width`.
`254`	`254`	`*`
`255`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`255`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`256`	`256`	`*/`
`257`	`257`	`public function expandDimensionsShorthand(): void`
`258`	`258`	`{`
`@@ -312,7 +312,7 @@ public function expandDimensionsShorthand(): void`
`312`	`312`	* (e.g. `font: 300 italic 11px/14px verdana, helvetica, sans-serif;`)
`313`	`313`	`* into their constituent parts.`
`314`	`314`	`*`
`315`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`315`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`316`	`316`	`*/`
`317`	`317`	`public function expandFontShorthand(): void`
`318`	`318`	`{`
`@@ -381,7 +381,7 @@ public function expandFontShorthand(): void`
`381`	`381`	`*`
`382`	`382`	`* @see http://www.w3.org/TR/21/colors.html#propdef-background`
`383`	`383`	`*`
`384`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`384`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`385`	`385`	`*/`
`386`	`386`	`public function expandBackgroundShorthand(): void`
`387`	`387`	`{`
`@@ -453,7 +453,7 @@ public function expandBackgroundShorthand(): void`
`453`	`453`	`}`
`454`	`454`
`455`	`455`	`/**`
`456`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`456`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`457`	`457`	`*/`
`458`	`458`	`public function expandListStyleShorthand(): void`
`459`	`459`	`{`
`@@ -536,7 +536,7 @@ public function expandListStyleShorthand(): void`
`536`	`536`	`* @param array<array-key, string> $aProperties`
`537`	`537`	`* @param string $sShorthand`
`538`	`538`	`*`
`539`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`539`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`540`	`540`	`*/`
`541`	`541`	`public function createShorthandProperties(array $aProperties, $sShorthand): void`
`542`	`542`	`{`
`@@ -572,7 +572,7 @@ public function createShorthandProperties(array $aProperties, $sShorthand): void`
`572`	`572`	`}`
`573`	`573`
`574`	`574`	`/**`
`575`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`575`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`576`	`576`	`*/`
`577`	`577`	`public function createBackgroundShorthand(): void`
`578`	`578`	`{`
`@@ -587,7 +587,7 @@ public function createBackgroundShorthand(): void`
`587`	`587`	`}`
`588`	`588`
`589`	`589`	`/**`
`590`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`590`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`591`	`591`	`*/`
`592`	`592`	`public function createListStyleShorthand(): void`
`593`	`593`	`{`
`@@ -604,7 +604,7 @@ public function createListStyleShorthand(): void`
`604`	`604`	`*`
`605`	`605`	* Should be run after `create_dimensions_shorthand`!
`606`	`606`	`*`
`607`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`607`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`608`	`608`	`*/`
`609`	`609`	`public function createBorderShorthand(): void`
`610`	`610`	`{`
`@@ -621,7 +621,7 @@ public function createBorderShorthand(): void`
`621`	`621`	`* (margin, padding, border-color, border-style and border-width)`
`622`	`622`	`* and converts them into shorthand CSS properties.`
`623`	`623`	`*`
`624`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`624`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`625`	`625`	`*/`
`626`	`626`	`public function createDimensionsShorthand(): void`
`627`	`627`	`{`
`@@ -695,7 +695,7 @@ public function createDimensionsShorthand(): void`
`695`	`695`	`*`
`696`	`696`	* At least `font-size` AND `font-family` must be present in order to create a shorthand declaration.
`697`	`697`	`*`
`698`		`- * @deprecated This will be removed without substitution in version 9.0 in #511.`
	`698`	`+ * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511`
`699`	`699`	`*/`
`700`	`700`	`public function createFontShorthand(): void`
`701`	`701`	`{`