diff --git a/CHANGELOG.md b/CHANGELOG.md index 08eb305af..e0b95a165 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ This project adheres to [Semantic Versioning](https://semver.org/). ### Changed +- Mark parsing-related methods of most CSS elements as `@internal` (#90) - Mark `OutputFormat::nextLevel()` as `@internal` (#901) - Make all non-private properties `@internal` (#886) diff --git a/src/CSSList/CSSList.php b/src/CSSList/CSSList.php index d0a8bbbce..5b8f41d51 100644 --- a/src/CSSList/CSSList.php +++ b/src/CSSList/CSSList.php @@ -67,6 +67,8 @@ public function __construct($iLineNo = 0) * * @throws UnexpectedTokenException * @throws SourceException + * + * @internal since V8.8.0 */ public static function parseList(ParserState $oParserState, CSSList $oList) { diff --git a/src/CSSList/Document.php b/src/CSSList/Document.php index 7d9c6ec0a..f74c89645 100644 --- a/src/CSSList/Document.php +++ b/src/CSSList/Document.php @@ -28,6 +28,8 @@ public function __construct($iLineNo = 0) * @return Document * * @throws SourceException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState) { diff --git a/src/Parsing/ParserState.php b/src/Parsing/ParserState.php index 2427c5e1f..574f60f3f 100644 --- a/src/Parsing/ParserState.php +++ b/src/Parsing/ParserState.php @@ -141,6 +141,8 @@ public function setPosition($iPosition) * @return string * * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public function parseIdentifier($bIgnoreCase = true) { @@ -172,6 +174,8 @@ public function parseIdentifier($bIgnoreCase = true) * * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public function parseCharacter($bIsForIdentifier) { diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php index ae3c595fa..fe7061911 100644 --- a/src/Rule/Rule.php +++ b/src/Rule/Rule.php @@ -79,6 +79,8 @@ public function __construct($sRule, $iLineNo = 0, $iColNo = 0) * * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState) { diff --git a/src/RuleSet/DeclarationBlock.php b/src/RuleSet/DeclarationBlock.php index be22760b4..60d0b0c44 100644 --- a/src/RuleSet/DeclarationBlock.php +++ b/src/RuleSet/DeclarationBlock.php @@ -49,6 +49,8 @@ public function __construct($iLineNo = 0) * * @throws UnexpectedTokenException * @throws UnexpectedEOFException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState, $oList = null) { diff --git a/src/RuleSet/RuleSet.php b/src/RuleSet/RuleSet.php index e90694aed..0cf7ac959 100644 --- a/src/RuleSet/RuleSet.php +++ b/src/RuleSet/RuleSet.php @@ -56,6 +56,8 @@ public function __construct($iLineNo = 0) * * @throws UnexpectedTokenException * @throws UnexpectedEOFException + * + * @internal since V8.8.0 */ public static function parseRuleSet(ParserState $oParserState, RuleSet $oRuleSet) { diff --git a/src/Value/CSSFunction.php b/src/Value/CSSFunction.php index c7024ea5d..de8e558f2 100644 --- a/src/Value/CSSFunction.php +++ b/src/Value/CSSFunction.php @@ -47,6 +47,8 @@ public function __construct($sName, $aArguments, $sSeparator = ',', $iLineNo = 0 * @throws SourceException * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState, $bIgnoreCase = false) { diff --git a/src/Value/CSSString.php b/src/Value/CSSString.php index c19b238f5..0251dc7c0 100644 --- a/src/Value/CSSString.php +++ b/src/Value/CSSString.php @@ -36,6 +36,8 @@ public function __construct($sString, $iLineNo = 0) * @throws SourceException * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState) { diff --git a/src/Value/CalcFunction.php b/src/Value/CalcFunction.php index a3db27101..70f2f4582 100644 --- a/src/Value/CalcFunction.php +++ b/src/Value/CalcFunction.php @@ -30,6 +30,8 @@ class CalcFunction extends CSSFunction * * @throws UnexpectedTokenException * @throws UnexpectedEOFException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState, $bIgnoreCase = false) { diff --git a/src/Value/Color.php b/src/Value/Color.php index a002760b3..fbbf11a1d 100644 --- a/src/Value/Color.php +++ b/src/Value/Color.php @@ -30,6 +30,8 @@ public function __construct(array $aColor, $iLineNo = 0) * * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState, $bIgnoreCase = false) { diff --git a/src/Value/LineName.php b/src/Value/LineName.php index 588cb4cbe..5b59fce58 100644 --- a/src/Value/LineName.php +++ b/src/Value/LineName.php @@ -23,6 +23,8 @@ public function __construct(array $aComponents = [], $iLineNo = 0) * * @throws UnexpectedTokenException * @throws UnexpectedEOFException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState) { diff --git a/src/Value/Size.php b/src/Value/Size.php index 8907526a5..2e45d2721 100644 --- a/src/Value/Size.php +++ b/src/Value/Size.php @@ -92,6 +92,8 @@ public function __construct($fSize, $sUnit = null, $bIsColorComponent = false, $ * * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState, $bIsColorComponent = false) { diff --git a/src/Value/URL.php b/src/Value/URL.php index 92da97262..7d5bd8e83 100644 --- a/src/Value/URL.php +++ b/src/Value/URL.php @@ -33,6 +33,8 @@ public function __construct(CSSString $oURL, $iLineNo = 0) * @throws SourceException * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parse(ParserState $oParserState) { diff --git a/src/Value/Value.php b/src/Value/Value.php index 6232d126e..3816289df 100644 --- a/src/Value/Value.php +++ b/src/Value/Value.php @@ -36,6 +36,8 @@ public function __construct($iLineNo = 0) * * @throws UnexpectedTokenException * @throws UnexpectedEOFException + * + * @internal since V8.8.0 */ public static function parseValue(ParserState $oParserState, array $aListDelimiters = []) { @@ -112,6 +114,8 @@ public static function parseValue(ParserState $oParserState, array $aListDelimit * * @throws UnexpectedEOFException * @throws UnexpectedTokenException + * + * @internal since V8.8.0 */ public static function parseIdentifierOrFunction(ParserState $oParserState, $bIgnoreCase = false) { @@ -142,6 +146,8 @@ public static function parseIdentifierOrFunction(ParserState $oParserState, $bIg * @throws UnexpectedEOFException * @throws UnexpectedTokenException * @throws SourceException + * + * @internal since V8.8.0 */ public static function parsePrimitiveValue(ParserState $oParserState) {