Changeset 60264 for trunk/src/wp-includes/ms-site.php

Timestamp:

05/29/2025 11:07:35 PM (7 months ago)

Author:

johnbillion

Message:

Docs: Improvements and corrections to documentation relating to metadata.

See #63166

File:

• trunk/src/wp-includes/ms-site.php (modified) (3 diffs)

trunk/src/wp-includes/ms-site.php

@@ -1023 +1023 @@
  * Adds metadata to a site.
  *
+ * For historical reasons both the meta key and the meta value are expected to be "slashed" (slashes escaped) on input.
+ *
  * @since 5.1.0
  *
@@ -1048 +1050 @@
  * value, will keep from removing duplicate metadata with the same key. It also
  * allows removing all metadata matching key, if needed.
+ *
+ * For historical reasons both the meta key and the meta value are expected to be "slashed" (slashes escaped) on input.
  *
  * @since 5.1.0
@@ -1091 +1095 @@
  * Updates metadata for a site.
  *
- * Use the $prev_value parameter to differentiate between meta fields with the
+ * Use the `$prev_value` parameter to differentiate between meta fields with the
  * same key and site ID.
  *
  * If the meta field for the site does not exist, it will be added.
+ *
+ * For historical reasons both the meta key and the meta value are expected to be "slashed" (slashes escaped) on input.
  *
  * @since 5.1.0