From 4611289048411482e9aa7284249f1769affcf305 Mon Sep 17 00:00:00 2001 From: Oliver Klee Date: Wed, 18 Sep 2024 19:31:56 +0200 Subject: [PATCH] [TASK] State since which version code is `@internal`/`@deprecated` This will help us avoid breaking things in backports. This is the v8.x backport of #722. --- src/CSSList/Document.php | 4 ++-- src/Parser.php | 4 ++-- src/Parsing/Anchor.php | 2 +- src/Parsing/ParserState.php | 4 ++-- src/Property/AtRule.php | 4 ++-- src/Property/KeyframeSelector.php | 2 +- src/Property/Selector.php | 2 +- src/RuleSet/DeclarationBlock.php | 26 +++++++++++++------------- 8 files changed, 24 insertions(+), 24 deletions(-) diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php index 133f5fea..bc5214db 100644 --- 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 index d653b3a8..beada56e 100644 --- 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 index 9060b54e..a42893da 100644 --- 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 index 82e9006f..2427c5e1 100644 --- 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 index 77b8fd82..d946a904 100644 --- 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 index 9d4795a2..2aff8d24 100644 --- 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 index 159b64c4..44355e63 100644 --- 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 index f9de6558..46578fcf 100644 --- 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() {