Skip to content

Commit 1dd952b

Browse files
authored
[CLEANUP] Autoformat the changelog (#750)
This allows autoformatting the changelog after adding new entries possible without introducing unrelated changes. This is the v8.x backport of #718.
1 parent 1ad9ad9 commit 1dd952b

File tree

1 file changed

+77
-32
lines changed

1 file changed

+77
-32
lines changed

CHANGELOG.md

Lines changed: 77 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -28,13 +28,15 @@ This project adheres to [Semantic Versioning](https://semver.org/).
2828
## 8.6.0
2929

3030
### Added
31+
3132
- Support arithmetic operators in CSS function arguments (#607)
3233
- Add support for inserting an item in a CSS list (#545)
3334
- Add support for the `dvh`, `lvh` and `svh` length units (#415)
3435

3536
### Changed
3637

37-
- Improve performance of Value::parseValue with many delimiters by refactoring to remove array_search() (#413)
38+
- Improve performance of Value::parseValue with many delimiters by refactoring
39+
to remove `array_search()` (#413)
3840

3941
## 8.5.2
4042

@@ -50,7 +52,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
5052

5153
### Fixed
5254

53-
- Fix PHP notice caused by parsing invalid color values having less than 6 characters (#485)
55+
- Fix PHP notice caused by parsing invalid color values having less than
56+
6 characters (#485)
5457
- Fix (regression) failure to parse at-rules with strict parsing (#456)
5558

5659
## 8.5.0
@@ -75,7 +78,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
7578

7679
* Support for PHP 8.x
7780
* PHPDoc annotations
78-
* Allow usage of CSS variables inside color functions (by parsing them as regular functions)
81+
* Allow usage of CSS variables inside color functions (by parsing them as
82+
regular functions)
7983
* Use PSR-12 code style
8084
* *No deprecations*
8185

@@ -90,7 +94,10 @@ This project adheres to [Semantic Versioning](https://semver.org/).
9094
* Allow a file to end after an `@import`
9195
* Preserve case of CSS variables as specced
9296
* Allow identifiers to use escapes the same way as strings
93-
* No longer use `eval` for the comparison in `getSelectorsBySpecificity`, in case it gets passed untrusted input (CVE-2020-13756). Also fixed in 8.3.1, 8.2.1, 8.1.1, 8.0.1, 7.0.4, 6.0.2, 5.2.1, 5.1.3, 5.0.9, 4.0.1, 3.0.1, 2.0.1, 1.0.1.
97+
* No longer use `eval` for the comparison in `getSelectorsBySpecificity`, in
98+
case it gets passed untrusted input (CVE-2020-13756). Also fixed in 8.3.1,
99+
8.2.1, 8.1.1, 8.0.1, 7.0.4, 6.0.2, 5.2.1, 5.1.3, 5.0.9, 4.0.1, 3.0.1, 2.0.1,
100+
1.0.1.
94101
* Prevent an infinite loop when parsing invalid grid line names
95102
* Remove invalid unit `vm`
96103
* Retain rule order after expanding shorthands
@@ -102,28 +109,37 @@ This project adheres to [Semantic Versioning](https://semver.org/).
102109

103110
## 8.3.0 (2019-02-22)
104111

105-
* Refactor parsing logic to mostly reside in the class files whose data structure is to be parsed (this should eventually allow us to unit-test specific parts of the parsing logic individually).
106-
* Fix error in parsing `calc` expessions when the first operand is a negative number, thanks to @raxbg.
107-
* Support parsing CSS4 colors in hex notation with alpha values, thanks to @raxbg.
112+
* Refactor parsing logic to mostly reside in the class files whose data
113+
structure is to be parsed (this should eventually allow us to unit-test
114+
specific parts of the parsing logic individually).
115+
* Fix error in parsing `calc` expessions when the first operand is a negative
116+
number, thanks to @raxbg.
117+
* Support parsing CSS4 colors in hex notation with alpha values, thanks to
118+
@raxbg.
108119
* Swallow more errors in lenient mode, thanks to @raxbg.
109-
* Allow specifying arbitrary strings to output before and after declaration blocks, thanks to @westonruter.
120+
* Allow specifying arbitrary strings to output before and after declaration
121+
blocks, thanks to @westonruter.
110122
* *No backwards-incompatible changes*
111123
* *No deprecations*
112124

113125
## 8.2.0 (2018-07-13)
114126

115127
* Support parsing `calc()`, thanks to @raxbg.
116128
* Support parsing grid-lines, again thanks to @raxbg.
117-
* Support parsing legacy IE filters (`progid:`) in lenient mode, thanks to @FMCorz
129+
* Support parsing legacy IE filters (`progid:`) in lenient mode, thanks to
130+
@FMCorz
118131
* Performance improvements parsing large files, again thanks to @FMCorz
119132
* *No backwards-incompatible changes*
120133
* *No deprecations*
121134

122135
## 8.1.0 (2016-07-19)
123136

124-
* Comments are no longer silently ignored but stored with the object with which they appear (no render support, though). Thanks to @FMCorz.
125-
* The IE hacks using `\0` and `\9` can now be parsed (and rendered) in lenient mode. Thanks (again) to @FMCorz.
126-
* Media queries with or without spaces before the query are parsed. Still no *real* parsing support, though. Sorry…
137+
* Comments are no longer silently ignored but stored with the object with which
138+
they appear (no render support, though). Thanks to @FMCorz.
139+
* The IE hacks using `\0` and `\9` can now be parsed (and rendered) in lenient
140+
mode. Thanks (again) to @FMCorz.
141+
* Media queries with or without spaces before the query are parsed. Still no
142+
*real* parsing support, though. Sorry…
127143
* PHPUnit is now listed as a dev-dependency in composer.json.
128144
* *No backwards-incompatible changes*
129145
* *No deprecations*
@@ -135,7 +151,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
135151

136152
### Backwards-incompatible changes
137153

138-
* Unrecoverable parser errors throw an exception of type `Sabberworm\CSS\Parsing\SourceException` instead of `\Exception`.
154+
* Unrecoverable parser errors throw an exception of type
155+
`Sabberworm\CSS\Parsing\SourceException` instead of `\Exception`.
139156

140157
## 7.0.3 (2016-04-27)
141158

@@ -145,7 +162,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
145162

146163
## 7.0.2 (2016-02-11)
147164

148-
* 150 time performance boost thanks to @[ossinkine](https://github.com/ossinkine)
165+
* 150 time performance boost thanks
166+
to @[ossinkine](https://github.com/ossinkine)
149167
* *No backwards-incompatible changes*
150168
* *No deprecations*
151169

@@ -162,7 +180,8 @@ This project adheres to [Semantic Versioning](https://semver.org/).
162180

163181
### Backwards-incompatible changes
164182

165-
* The `Sabberworm\CSS\Value\String` class has been renamed to `Sabberworm\CSS\Value\CSSString`.
183+
* The `Sabberworm\CSS\Value\String` class has been renamed to
184+
`Sabberworm\CSS\Value\CSSString`.
166185

167186
## 6.0.1 (2015-08-24)
168187

@@ -176,22 +195,27 @@ This project adheres to [Semantic Versioning](https://semver.org/).
176195

177196
### Deprecations
178197

179-
* The parse() method replaces __toString with an optional argument (instance of the OutputFormat class)
198+
* The parse() method replaces __toString with an optional argument (instance of
199+
the OutputFormat class)
180200

181201
## 5.2.0 (2014-06-30)
182202

183-
* Support removing a selector from a declaration block using `$oBlock->removeSelector($mSelector)`
184-
* Introduce a specialized exception (Sabberworm\CSS\Parsing\OuputException) for exceptions during output rendering
203+
* Support removing a selector from a declaration block using
204+
`$oBlock->removeSelector($mSelector)`
205+
* Introduce a specialized exception (Sabberworm\CSS\Parsing\OuputException) for
206+
exceptions during output rendering
185207

186208
* *No deprecations*
187209

188210
#### Backwards-incompatible changes
189211

190-
* Outputting a declaration block that has no selectors throws an OuputException instead of outputting an invalid ` {…}` into the CSS document.
212+
* Outputting a declaration block that has no selectors throws an OuputException
213+
instead of outputting an invalid ` {…}` into the CSS document.
191214

192215
## 5.1.2 (2013-10-30)
193216

194-
* Remove the use of consumeUntil in comment parsing. This makes it possible to parse comments such as `/** Perfectly valid **/`
217+
* Remove the use of consumeUntil in comment parsing. This makes it possible to
218+
parse comments such as `/** Perfectly valid **/`
195219
* Add fr relative size unit
196220
* Fix some issues with HHVM
197221
* *No backwards-incompatible changes*
@@ -206,13 +230,15 @@ This project adheres to [Semantic Versioning](https://semver.org/).
206230
## 5.1.0 (2013-10-24)
207231

208232
* Performance enhancements by Michael M Slusarz
209-
* More rescue entry points for lenient parsing (unexpected tokens between declaration blocks and unclosed comments)
233+
* More rescue entry points for lenient parsing (unexpected tokens between
234+
declaration blocks and unclosed comments)
210235
* *No backwards-incompatible changes*
211236
* *No deprecations*
212237

213238
## 5.0.8 (2013-08-15)
214239

215-
* Make default settings’ multibyte parsing option dependent on whether or not the mbstring extension is actually installed.
240+
* Make default settings’ multibyte parsing option dependent on whether or not
241+
the mbstring extension is actually installed.
216242
* *No backwards-incompatible changes*
217243
* *No deprecations*
218244

@@ -230,7 +256,9 @@ This project adheres to [Semantic Versioning](https://semver.org/).
230256

231257
## 5.0.5 (2013-04-17)
232258

233-
* Initial support for lenient parsing (setting this parser option will catch some exceptions internally and recover the parser’s state as neatly as possible).
259+
* Initial support for lenient parsing (setting this parser option will catch
260+
some exceptions internally and recover the parser’s state as neatly as
261+
possible).
234262
* *No backwards-incompatible changes*
235263
* *No deprecations*
236264

@@ -267,18 +295,22 @@ This project adheres to [Semantic Versioning](https://semver.org/).
267295

268296
### Backwards-incompatible changes
269297

270-
* `Sabberworm\CSS\Value\Color`’s `__toString` method overrides `CSSList`’s to maybe return something other than `type(value, …)` (see above).
298+
* `Sabberworm\CSS\Value\Color`’s `__toString` method overrides `CSSList`’s to
299+
maybe return something other than `type(value, …)` (see above).
271300

272301
## 4.0.0 (2013-03-19)
273302

274303
* Support for more @-rules
275-
* Generic interface `Sabberworm\CSS\Property\AtRule`, implemented by all @-rule classes
304+
* Generic interface `Sabberworm\CSS\Property\AtRule`, implemented by all @-rule
305+
classes
276306
* *No deprecations*
277307

278308
### Backwards-incompatible changes
279309

280310
* `Sabberworm\CSS\RuleSet\AtRule` renamed to `Sabberworm\CSS\RuleSet\AtRuleSet`
281-
* `Sabberworm\CSS\CSSList\MediaQuery` renamed to `Sabberworm\CSS\RuleSet\CSSList\AtRuleBlockList` with differing semantics and API (which also works for other block-list-based @-rules like `@supports`).
311+
* `Sabberworm\CSS\CSSList\MediaQuery` renamed to
312+
`Sabberworm\CSS\RuleSet\CSSList\AtRuleBlockList` with differing semantics and
313+
API (which also works for other block-list-based @-rules like `@supports`).
282314

283315
## 3.0.0 (2013-03-06)
284316

@@ -287,19 +319,32 @@ This project adheres to [Semantic Versioning](https://semver.org/).
287319

288320
### Backwards-incompatible changes
289321

290-
* All properties (like whether or not to use `mb_`-functions, which default charset to use and – new – whether or not to be forgiving when parsing) are now encapsulated in an instance of `Sabberworm\CSS\Settings` which can be passed as the second argument to `Sabberworm\CSS\Parser->__construct()`.
291-
* Specifying a charset as the second argument to `Sabberworm\CSS\Parser->__construct()` is no longer supported. Use `Sabberworm\CSS\Settings::create()->withDefaultCharset('some-charset')` instead.
292-
* Setting `Sabberworm\CSS\Parser->bUseMbFunctions` has no effect. Use `Sabberworm\CSS\Settings::create()->withMultibyteSupport(true/false)` instead.
293-
* `Sabberworm\CSS\Parser->parse()` may throw a `Sabberworm\CSS\Parsing\UnexpectedTokenException` when in strict parsing mode.
322+
* All properties (like whether or not to use `mb_`-functions, which default
323+
charset to use and – new – whether or not to be forgiving when parsing) are
324+
now encapsulated in an instance of `Sabberworm\CSS\Settings` which can be
325+
passed as the second argument to `Sabberworm\CSS\Parser->__construct()`.
326+
* Specifying a charset as the second argument to
327+
`Sabberworm\CSS\Parser->__construct()` is no longer supported. Use
328+
`Sabberworm\CSS\Settings::create()->withDefaultCharset('some-charset')`
329+
instead.
330+
* Setting `Sabberworm\CSS\Parser->bUseMbFunctions` has no effect. Use
331+
`Sabberworm\CSS\Settings::create()->withMultibyteSupport(true/false)` instead.
332+
* `Sabberworm\CSS\Parser->parse()` may throw a
333+
`Sabberworm\CSS\Parsing\UnexpectedTokenException` when in strict parsing mode.
294334

295335
## 2.0.0 (2013-01-29)
296336

297337
* Allow multiple rules of the same type per rule set
298338

299339
### Backwards-incompatible changes
300340

301-
* `Sabberworm\CSS\RuleSet->getRules()` returns an index-based array instead of an associative array. Use `Sabberworm\CSS\RuleSet->getRulesAssoc()` (which eliminates duplicate rules and lets the later rule of the same name win).
302-
* `Sabberworm\CSS\RuleSet->removeRule()` works as it did before except when passed an instance of `Sabberworm\CSS\Rule\Rule`, in which case it would only remove the exact rule given instead of all the rules of the same type. To get the old behaviour, use `Sabberworm\CSS\RuleSet->removeRule($oRule->getRule()`;
341+
* `Sabberworm\CSS\RuleSet->getRules()` returns an index-based array instead of
342+
an associative array. Use `Sabberworm\CSS\RuleSet->getRulesAssoc()` (which
343+
eliminates duplicate rules and lets the later rule of the same name win).
344+
* `Sabberworm\CSS\RuleSet->removeRule()` works as it did before except when
345+
passed an instance of `Sabberworm\CSS\Rule\Rule`, in which case it would only
346+
remove the exact rule given instead of all the rules of the same type. To get
347+
the old behaviour, use `Sabberworm\CSS\RuleSet->removeRule($oRule->getRule()`;
303348

304349
## 1.0
305350

0 commit comments

Comments
 (0)