Improve the doc block comments

himanshupathak95 · himanshupathak95 · commit 9836c7df989f · 2025-09-13T00:28:58.000+05:30
diff --git a/src/wp-includes/link-template.php b/src/wp-includes/link-template.php
@@ -3665,12 +3665,10 @@ function content_url( $path = '' ) {
  * or, when requested, the URL to the current time-based subdirectory
  * (e.g. https://example.com/wp-content/uploads/2025/09) if year/month folders are enabled.
  *
- * This is a convenience wrapper around wp_upload_dir().
- *
  * @since 6.9.0
  *
  * @param bool $with_subdir Optional. Whether to include the time-based subdirectory
- *                          when it is configured (mirrors wp_upload_dir()['url'] vs ['baseurl']). Default true.
+ *                          when it is configured. Default true.
  * @return string Uploads URL. Empty string on failure.
  */
 function upload_url( $with_subdir = true ) {

Original file line number	Diff line number	Diff line change
`@@ -3665,12 +3665,10 @@ function content_url( $path = '' ) {`
`3665`	`3665`	`* or, when requested, the URL to the current time-based subdirectory`
`3666`	`3666`	`* (e.g. https://example.com/wp-content/uploads/2025/09) if year/month folders are enabled.`
`3667`	`3667`	`*`
`3668`		`- * This is a convenience wrapper around wp_upload_dir().`
`3669`		`- *`
`3670`	`3668`	`* @since 6.9.0`
`3671`	`3669`	`*`
`3672`	`3670`	`* @param bool $with_subdir Optional. Whether to include the time-based subdirectory`
`3673`		`- * when it is configured (mirrors wp_upload_dir()['url'] vs ['baseurl']). Default true.`
	`3671`	`+ * when it is configured. Default true.`
`3674`	`3672`	`* @return string Uploads URL. Empty string on failure.`
`3675`	`3673`	`*/`
`3676`	`3674`	`function upload_url( $with_subdir = true ) {`