From d761ed56ca7cf31c44ec129e5665775196fdc331 Mon Sep 17 00:00:00 2001
From: isabel_brison <isabel_brison@git.wordpress.org>
Date: Wed, 20 Sep 2023 07:06:20 +0000
Subject: [PATCH] Editor: update docs for `css_var`.

Updates inline doc for the `css_var` key value pair in WP_Style_Engine.

Props ramonopoly.
Fixes #59401.

Built from https://develop.svn.wordpress.org/trunk@56630


git-svn-id: http://core.svn.wordpress.org/trunk@56142 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 .../style-engine/class-wp-style-engine.php    | 31 ++++++++-----------
 wp-includes/version.php                       |  2 +-
 2 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/wp-includes/style-engine/class-wp-style-engine.php b/wp-includes/style-engine/class-wp-style-engine.php
index 3c40bfd574..9974c43821 100644
--- a/wp-includes/style-engine/class-wp-style-engine.php
+++ b/wp-includes/style-engine/class-wp-style-engine.php
@@ -27,26 +27,21 @@
 #[AllowDynamicProperties]
 final class WP_Style_Engine {
 	/**
-	 * Style definitions that contain the instructions to
-	 * parse/output valid Gutenberg styles from a block's attributes.
+	 * Style definitions that contain the instructions to parse/output valid Gutenberg styles from a block's attributes.
 	 *
-	 * For every style definition, the following properties are valid:
+	 * For every style definition, the follow properties are valid:
 	 *
-	 *  - classnames    => (array) An array of classnames to be returned for block styles.
-	 *                     The key is a classname or pattern.
-	 *                     A value of `true` means the classname should be applied always.
-	 *                     Otherwise, a valid CSS property (string) to match the incoming value,
-	 *                     e.g. "color" to match var:preset|color|somePresetSlug.
-	 *  - css_vars      => (array) An array of key value pairs used to generate CSS var values.
-	 *                     The key is a CSS var pattern, whose `$slug` fragment will be replaced with a preset slug.
-	 *                     The value should be a valid CSS property (string) to match the incoming value,
-	 *                     e.g. "color" to match var:preset|color|somePresetSlug.
-	 *  - property_keys => (array) An array of keys whose values represent a valid CSS property,
-	 *                     e.g. "margin" or "border".
-	 *  - path          => (array) A path that accesses the corresponding style value in the block style object.
-	 *  - value_func    => (string) The name of a function to generate a CSS definition array
-	 *                     for a particular style object. The output of this function should be
-	 *                     `array( "$property" => "$value", ... )`.
+	 *  - classnames    => (array) an array of classnames to be returned for block styles. The key is a classname or pattern.
+	 *                    A value of `true` means the classname should be applied always. Otherwise, a valid CSS property (string)
+	 *                    to match the incoming value, e.g., "color" to match var:preset|color|somePresetSlug.
+	 *  - css_vars      => (array) an array of key value pairs used to generate CSS var values.
+	 *                     The key should be the CSS property name that matches the second element of the preset string value,
+	 *                     i.e., "color" in var:preset|color|somePresetSlug. The value is a CSS var pattern (e.g. `--wp--preset--color--$slug`),
+	 *                     whose `$slug` fragment will be replaced with the preset slug, which is the third element of the preset string value,
+	 *                     i.e., `somePresetSlug` in var:preset|color|somePresetSlug.
+	 *  - property_keys => (array) array of keys whose values represent a valid CSS property, e.g., "margin" or "border".
+	 *  - path          => (array) a path that accesses the corresponding style value in the block style object.
+	 *  - value_func    => (string) the name of a function to generate a CSS definition array for a particular style object. The output of this function should be `array( "$property" => "$value", ... )`.
 	 *
 	 * @since 6.1.0
 	 * @var array
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 236f16c87e..281857b7af 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.4-alpha-56629';
+$wp_version = '6.4-alpha-56630';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.