From bd88eafee170154145c55219c5eebc8cacede10a Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov@git.wordpress.org>
Date: Fri, 15 Dec 2023 12:57:07 +0000
Subject: [PATCH] Docs: Document the `$link` global in `get_bookmark()`.

Follow-up to [8758].

Props upadalavipul, mukesh27.
See #60021.

git-svn-id: https://develop.svn.wordpress.org/trunk@57191 602fd350-edb4-49c9-b593-d223f7449a82
---
 src/wp-includes/bookmark.php | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/wp-includes/bookmark.php b/src/wp-includes/bookmark.php
index 47a86d865d..66c4339638 100644
--- a/src/wp-includes/bookmark.php
+++ b/src/wp-includes/bookmark.php
@@ -11,7 +11,8 @@
  *
  * @since 2.1.0
  *
- * @global wpdb $wpdb WordPress database abstraction object.
+ * @global object $link Current link object.
+ * @global wpdb   $wpdb WordPress database abstraction object.
  *
  * @param int|stdClass $bookmark
  * @param string       $output   Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
@@ -21,11 +22,11 @@
  * @return array|object|null Type returned depends on $output value.
  */
 function get_bookmark( $bookmark, $output = OBJECT, $filter = 'raw' ) {
-	global $wpdb;
+	global $link, $wpdb;
 
 	if ( empty( $bookmark ) ) {
-		if ( isset( $GLOBALS['link'] ) ) {
-			$_bookmark = & $GLOBALS['link'];
+		if ( isset( $link ) ) {
+			$_bookmark = &$link;
 		} else {
 			$_bookmark = null;
 		}
@@ -33,8 +34,8 @@ function get_bookmark( $bookmark, $output = OBJECT, $filter = 'raw' ) {
 		wp_cache_add( $bookmark->link_id, $bookmark, 'bookmark' );
 		$_bookmark = $bookmark;
 	} else {
-		if ( isset( $GLOBALS['link'] ) && ( $GLOBALS['link']->link_id == $bookmark ) ) {
-			$_bookmark = & $GLOBALS['link'];
+		if ( isset( $link ) && ( $link->link_id == $bookmark ) ) {
+			$_bookmark = &$link;
 		} else {
 			$_bookmark = wp_cache_get( $bookmark, 'bookmark' );
 			if ( ! $_bookmark ) {