wp_register_custom_css_support: update PHP doc to clarify purpose

ramonjd · ramonjd · commit 5d3de27e868c · 2026-05-06T03:21:53.000Z
Clarify the purpose of the `wp_register_custom_css_support` function. "Removing styles.css" is technically correct, but the comment didn't explain the "why" in plain language. Props audrasjb, ramonopoly, peterwilsoncc. Follow-up to [64771]. git-svn-id: https://develop.svn.wordpress.org/trunk@62299 602fd350-edb4-49c9-b593-d223f7449a82
diff --git a/src/wp-includes/block-supports/custom-css.php b/src/wp-includes/block-supports/custom-css.php
@@ -125,7 +125,7 @@ function wp_register_custom_css_support( $block_type ) {
 }
 
 /**
- * Strips `style.css` attributes from all blocks in post content.
+ * Strips custom CSS (`style.css` in attributes) from all blocks in post content.
  *
  * Uses {@see WP_Block_Parser::next_token()} to scan block tokens and surgically
  * replace only the attribute JSON that changed — no parse_blocks() +

Original file line number	Diff line number	Diff line change
`@@ -125,7 +125,7 @@ function wp_register_custom_css_support( $block_type ) {`
`125`	`125`	`}`
`126`	`126`
`127`	`127`	`/**`
`128`		- * Strips `style.css` attributes from all blocks in post content.
	`128`	+ * Strips custom CSS (`style.css` in attributes) from all blocks in post content.
`129`	`129`	`*`
`130`	`130`	`* Uses {@see WP_Block_Parser::next_token()} to scan block tokens and surgically`
`131`	`131`	`* replace only the attribute JSON that changed — no parse_blocks() +`