From b16784b6fd273bee3976a79b20413a4871efd2df Mon Sep 17 00:00:00 2001
From: catch <catch@35733.no-reply.drupal.org>
Date: Fri, 26 Mar 2021 09:20:09 +0000
Subject: [PATCH] Issue #2850057 by Munavijayalakshmi, gaurav.kapoor,
 ankithashetty, Pavan B S, ritzz, joachim, xjm, amateescu, Vishalghyv: all
 methods in SelectionInterface() are missing @param docs

---
 .../SelectionInterface.php                     | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/core/lib/Drupal/Core/Entity/EntityReferenceSelection/SelectionInterface.php b/core/lib/Drupal/Core/Entity/EntityReferenceSelection/SelectionInterface.php
index d9fcb06f7c10..0c2ee046a2d4 100644
--- a/core/lib/Drupal/Core/Entity/EntityReferenceSelection/SelectionInterface.php
+++ b/core/lib/Drupal/Core/Entity/EntityReferenceSelection/SelectionInterface.php
@@ -17,6 +17,15 @@ interface SelectionInterface extends PluginFormInterface {
   /**
    * Gets the list of referenceable entities.
    *
+   * @param string|null $match
+   *   (optional) Text to match the label against. Defaults to NULL.
+   * @param string $match_operator
+   *   (optional) Operator to be used for string matching. Defaults to
+   *   "CONTAINS".
+   * @param int $limit
+   *   (optional) Limit the query to a given number of items. Defaults to 0,
+   *   which indicates no limiting.
+   *
    * @return array
    *   A nested array of entities, the first level is keyed by the
    *   entity bundle, which contains an array of entity labels (escaped),
@@ -27,6 +36,12 @@ public function getReferenceableEntities($match = NULL, $match_operator = 'CONTA
   /**
    * Counts entities that are referenceable.
    *
+   * @param string $match
+   *   (optional) Text to match the label against. Defaults to NULL.
+   * @param string $match_operator
+   *   (optional) Operator to be used for string matching. Defaults to
+   *   "CONTAINS".
+   *
    * @return int
    *   The number of referenceable entities.
    */
@@ -35,6 +50,9 @@ public function countReferenceableEntities($match = NULL, $match_operator = 'CON
   /**
    * Validates which existing entities can be referenced.
    *
+   * @param array $ids
+   *   An array of IDs to validate.
+   *
    * @return array
    *   An array of valid entity IDs.
    */
-- 
GitLab