Tag v4.4.1

I forgot to bump the cache_version in the 4.4.0 release. Without this
bump, users will keep getting CSS output from the previous Less.php
release even after updating, when a cache is used.

To prevent this in the future, I've documented the release steps.

While at it, I've also added the "v" prefix to the CHANGES headings
for consistency with the tags in this repository.

Bug: T365481
Change-Id: Ibe6a3aee585bb22b644b49aeb781e376815fc703

CHANGES.md

@@ -1,6 +1,11 @@
 # Changelog
 
-## 4.4.0
+## v4.4.1
+
+Fixed:
+* Update `Less_Version::version` and bump `Less_Version::cache_version` (Timo Tijhof)
+
+## v4.4.0
 
 Added:
 * Add `image-size()` function, disable base64 for SVG `data-uri()` (Hannah Okwelum) [T353147](https://phabricator.wikimedia.org/T353147)
@@ -14,7 +19,7 @@ Fixed:
 * Fix checking of guard conditions in nested mixins (Hannah Okwelum) [T352867](https://phabricator.wikimedia.org/T352867)
 * Less_Functions: Avoid clobbering `clamp()` with internal helper (Timo Tijhof) [T363728](https://phabricator.wikimedia.org/T363728)
 
-## 4.3.0
+## v4.3.0
 
 Added:
 * Support interpolated variable imports, via ImportVisitor (Hannah Okwelum) [T353133](https://phabricator.wikimedia.org/T353133)
@@ -48,7 +53,7 @@ Fixed:
 * Less_Parser: Faster matching by inlining `matcher()` chains (Timo Tijhof)
 * Less_Parser: Faster matching with `matchStr()` method (Timo Tijhof)
 
-## 4.2.1
+## v4.2.1
 
 Added:
 * Add support for `/deep/` selectors (Hannah Okwelum) [T352862](https://phabricator.wikimedia.org/T352862)
@@ -58,7 +63,7 @@ Fixed:
 * Fix `when()` matching between string and non-string (Timo Tijhof) [T358159](https://phabricator.wikimedia.org/T358159)
 * Preserve whitespace before `;` or `!` in simple rules (Hannah Okwelum) [T352911](https://phabricator.wikimedia.org/T352911)
 
-## 4.2.0
+## v4.2.0
 
 Added:
 * Add `isruleset()` function (Hannah Okwelum) [T354895](https://phabricator.wikimedia.org/T354895)
@@ -83,91 +88,91 @@ Fixed:
 * Fix string comparison to ignore quote type (Timo Tijhof) [T357160](https://phabricator.wikimedia.org/T357160)
 * Fix string interpolation in selectors (Hannah Okwelum) [T353142](https://phabricator.wikimedia.org/T353142)
 
-## 4.1.1
+## v4.1.1
 
 * Less_Parser: Faster `MatchQuoted` by using native `strcspn`. (Thiemo Kreuz)
 * Less_Parser: Faster `parseEntitiesQuoted` by inlining `MatchQuoted`. (Thiemo Kreuz)
 * Less_Parser: Faster `parseUnicodeDescriptor` and `parseEntitiesJavascript` by first-char checks. (Thiemo Kreuz)
 * Less_Tree_Mixin_Call: Include mixin name in error message (Jeremy P)
 * Fix mismatched casing in class names to fix autoloading on case-sensitive filesystems (Jeremy P)
 
-## 4.1.0
+## v4.1.0
 
 * Add support for `@supports` blocks. (Anne Tomasevich) [T332923](http://phabricator.wikimedia.org/T332923)
 * Less_Parser: Returning a URI from `SetImportDirs()` callbacks is now optional. (Timo Tijhof)
 
-## 4.0.0
+## v4.0.0
 
 * Remove support for PHP 7.2 and 7.3. Raise requirement to PHP 7.4+.
 * Remove support for `cache_method=php` and `cache_method=var_export`, only the faster and more secure `cache_method=serialize` is now available. The built-in cache remains disabled by default.
 * Fix `url(#myid)` to be treated as absolute URL. [T331649](https://phabricator.wikimedia.org/T331688)
 * Fix "Undefined property" PHP 8.1 warning when `calc()` is used with CSS `var()`. [T331688](https://phabricator.wikimedia.org/T331688)
 * Less_Parser: Improve performance by removing MatchFuncs and NewObj overhead. (Timo Tijhof)
 
-## 3.2.1
+## v3.2.1
 
 * Tree_Ruleset: Fix support for nested parent selectors (Timo Tijhof) [T204816](https://phabricator.wikimedia.org/T204816)
 * Fix ParseError when interpolating variable after colon in selector (Timo Tijhof) [T327163](https://phabricator.wikimedia.org/T327163)
 * Functions: Fix "Undefined property" warning on bad minmax arg
 * Tree_Call: Include previous exception when catching functions (Robert Frunzke)
 
-## 3.2.0
+## v3.2.0
 
 * Fix "Implicit conversion" PHP 8.1 warnings (Ayokunle Odusan)
 * Fix "Creation of dynamic property" PHP 8.2 warnings (Bas Couwenberg)
 * Fix "Creation of dynamic property" PHP 8.2 warnings (Rajesh Kumar)
 * Tree_Url: Add support for "Url" type to `Parser::getVariables()` (ciroarcadio) [#51](https://github.com/wikimedia/less.php/pull/51)
 * Tree_Import: Add support for importing URLs without file extension (Timo Tijhof) [#27](https://github.com/wikimedia/less.php/issues/27)
 
-## 3.1.0
+## v3.1.0
 
 * Add PHP 8.0 support: Drop use of curly braces for sub-string eval (James D. Forrester)
 * Make `Directive::__construct` $rules arg optional (fix PHP 7.4 warning) (Sam Reed)
 * ProcessExtends: Improve performance by using a map for selectors and parents (Andrey Legayev)
 
-## 3.0.0
+## v3.0.0
 
 * Raise PHP requirement from 7.1 to 7.2.9 (James Forrester)
 
-## 2.0.0
+## v2.0.0
 
 * Relax PHP requirement down to 7.1, from 7.2.9 (Franz Liedke)
 * Reflect recent breaking changes properly with the semantic versioning (James Forrester)
 
-## 1.8.2
+## v1.8.2
 
 * Require PHP 7.2.9+, up from 5.3+ (James Forrester)
 * release: Update Version.php with the current release ID (COBadger)
 * Fix access array offset on value of type null (Michele Locati)
 * Fix test suite on PHP 7.4 (Sergei Morozov)
 
-## 1.8.1
+## v1.8.1
 
 * Another PHP 7.3 compatibility tweak
 
-## 1.8.0
+## v1.8.0
 
 Library forked by Wikimedia, from [oyejorge/less.php](https://github.com/oyejorge/less.php).
 
 * Supports up to PHP 7.3
 * No longer tested against PHP 5, though it's still remains allowed in `composer.json` for HHVM compatibility
 * Switched to [semantic versioning](https://semver.org/), hence version numbers now use 3 digits
 
-## 1.7.0.13
+## v1.7.0.13
 
 * Fix composer.json (PSR-4 was invalid)
 
-## 1.7.0.12
+## v1.7.0.12
 
 * set bin/lessc bit executable
 * Add `gettingVariables` method to `Less_Parser`
 
-## 1.7.0.11
+## v1.7.0.11
 
 * Fix realpath issue (windows)
 * Set Less_Tree_Call property back to public ( Fix 258 266 267 issues from oyejorge/less.php)
 
-## 1.7.0.10
+## v1.7.0.10
 
 * Add indentation option
 * Add `optional` modifier for `@import`
@@ -176,7 +181,7 @@ Library forked by Wikimedia, from [oyejorge/less.php](https://github.com/oyejorg
 * urlArgs should be string no array()
 * fix missing on NameValue type [#269](https://github.com/oyejorge/less.php/issues/269)
 
-## 1.7.0.9
+## v1.7.0.9
 
 * Remove space at beginning of Version.php
 * Revert require() paths in test interface

CONTRIBUTING.md

@@ -1,5 +1,21 @@
 # Maintainers guide
 
+## Release process
+
+1. **Changelog.** Add a new section to the top of `CHANGES.md` with the output from `composer changelog`.
+
+   Edit your new section by following the [Keep a changelog](https://keepachangelog.com/en/1.0.0/) conventions, where by bullet points are under one of the "Added", "Changed", "Fixed", "Deprecated", or "Removed" labels.
+
+   Review each point and make sure it is phrased in a way that explains the impact on end-users of the library. If the change does not affect the public API or CSS output, remove the bullet point.
+
+2. **Version bump.** Update `/lib/Less/Version.php` and set `version` to the version that you're about to release. Also increase `cache_version` to increment the last number.
+
+3. **Commit.** Stage and commit your changes with the message `Tag vX.Y.Z`, and then push the commit for review.
+
+4. **Tag.** After the above release commit is merged, checkout the master branch and pull down the latest changes. Then create a `vX.Y.Z` tag and push the tag.
+
+   Remember to, after the commit is merged, first checkout the master branch and pull down the latest changes. This is to make sure you have the merged version and not the draft commit that you pushed for review.
+
 ## Internal overview
 
 This is an overview of the high-level steps during the transformation

lib/Less/Version.php

@@ -6,11 +6,11 @@
 class Less_Version {
 
 	/* Current release version of less.php */
-	public const version = '4.2.1';
+	public const version = '4.4.1';
 
 	/* Upstream less.js version that this release should be compatible with */
 	public const less_version = '2.5.3';
 
 	/* Parser cache version */
-	public const cache_version = '253-2';
+	public const cache_version = '253-3';
 }