From 6c8431c0ec1bf179e41db2fb83f41fe5e40b1552 Mon Sep 17 00:00:00 2001
From: xjm <xjm@65776.no-reply.drupal.org>
Date: Wed, 25 Jan 2023 17:59:01 -0600
Subject: [PATCH] Issue #3126127 by stefanos.petrakis, andypost, xjm, pooja
 saraah, Kristen Pol: Fix LanguageNegotiationMethodInterface::getLangcode()
 result docblock

---
 .../src/LanguageNegotiationMethodInterface.php        | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/core/modules/language/src/LanguageNegotiationMethodInterface.php b/core/modules/language/src/LanguageNegotiationMethodInterface.php
index 0488516f2dd6..2c1cf3ac8e79 100644
--- a/core/modules/language/src/LanguageNegotiationMethodInterface.php
+++ b/core/modules/language/src/LanguageNegotiationMethodInterface.php
@@ -44,8 +44,15 @@ public function setCurrentUser(AccountInterface $current_user);
    *   (optional) The current request. Defaults to NULL if it has not been
    *   initialized yet.
    *
-   * @return string
-   *   A valid language code or FALSE if the negotiation was unsuccessful.
+   * @return string|null|false
+   *   A valid language code if the negotiation was successful and either NULL
+   *    or FALSE otherwise.
+   *
+   * @todo Determine whether string|false or string|null should be the
+   *   normalized result across all implementations and update the @return and
+   *   its comment accordingly.
+   *
+   * @see https://www.drupal.org/node/3329952
    */
   public function getLangcode(Request $request = NULL);
 
-- 
GitLab