diff --git a/core/lib/Drupal/Core/Menu/MenuLinkInterface.php b/core/lib/Drupal/Core/Menu/MenuLinkInterface.php index a0f500c..2141b45 100644 --- a/core/lib/Drupal/Core/Menu/MenuLinkInterface.php +++ b/core/lib/Drupal/Core/Menu/MenuLinkInterface.php @@ -11,7 +11,7 @@ use Drupal\Component\Plugin\DerivativeInspectionInterface; /** - * Interface for classes providing a type of menu link. + * Defines an interface for classes providing a type of menu link. */ interface MenuLinkInterface extends PluginInspectionInterface, DerivativeInspectionInterface { @@ -213,7 +213,8 @@ public function getDeleteRoute(); * visible from the edit form. * * @return array|null - * An array with keys route_name and route_parameters, or NULL. + * An array with keys route_name and route_parameters, or NULL if there is + * no route. */ public function getEditRoute(); diff --git a/core/lib/Drupal/Core/Menu/MenuLinkManagerInterface.php b/core/lib/Drupal/Core/Menu/MenuLinkManagerInterface.php index c213fda..ec9fed6 100644 --- a/core/lib/Drupal/Core/Menu/MenuLinkManagerInterface.php +++ b/core/lib/Drupal/Core/Menu/MenuLinkManagerInterface.php @@ -10,7 +10,7 @@ use Drupal\Component\Plugin\PluginManagerInterface; /** - * Defines an interface for storing menu link definitions and creating menu links. + * Defines an interface for creating menu links and storing their definitions. */ interface MenuLinkManagerInterface extends PluginManagerInterface { @@ -55,7 +55,7 @@ public function deleteLink($id, $persist = TRUE); * @param string $route_name * The route name. * @param array $route_parameters - * (optional) The route parameters, defaults to an empty array. + * (optional) The route parameters. Defaults to an empty array. * @param string $menu_name * (optional) Restricts the found links to just those in the named menu. * @@ -123,7 +123,7 @@ public function resetLink($id); * Counts the total number of menu links. * * @param string $menu_name - * (optional) The menu name to count by, defaults to all menus. + * (optional) The menu name to count by. Defaults to all menus. * * @return int * The number of menu links in the named menu, or in all menus if the diff --git a/core/lib/Drupal/Core/Menu/MenuTreeParameters.php b/core/lib/Drupal/Core/Menu/MenuTreeParameters.php index d6b6eaa..98d4e87 100644 --- a/core/lib/Drupal/Core/Menu/MenuTreeParameters.php +++ b/core/lib/Drupal/Core/Menu/MenuTreeParameters.php @@ -166,7 +166,7 @@ public function setActiveTrail(array $active_trail) { * is a scalar. For more complex options, it is an array. The meaning of * each element in the array is dependent on the $operator. * @param string|NULL $operator - * (Optional) The comparison operator, such as =, <, or >=. It also accepts + * (optional) The comparison operator, such as =, <, or >=. It also accepts * more complex options such as IN, LIKE, or BETWEEN. If NULL, defaults to * the = operator. * diff --git a/core/lib/Drupal/Core/Menu/MenuTreeStorage.php b/core/lib/Drupal/Core/Menu/MenuTreeStorage.php index 43b65c0..d6b20f9 100644 --- a/core/lib/Drupal/Core/Menu/MenuTreeStorage.php +++ b/core/lib/Drupal/Core/Menu/MenuTreeStorage.php @@ -1068,7 +1068,7 @@ protected function doBuildTreeData(array $links, array $parents = array(), $dept * A flat array of menu links that are part of the menu. Each array element * is an associative array of information about the menu link, containing * the fields from the $this->table. This array must be ordered - * depth-first. + * depth-first. MenuTreeStorage::loadTreeData() includes a sample query. * * @param array $parents * An array of the menu link ID values that are in the path from the current @@ -1079,7 +1079,7 @@ protected function doBuildTreeData(array $links, array $parents = array(), $dept * @return array * The fully built tree. * - * @see MenuTreeStorage::loadTreeData() for a sample query. + * @see \Drupal\Core\Menu\MenuTreeStorage::loadTreeData() */ protected function treeDataRecursive(array &$links, array $parents, $depth) { $tree = array(); @@ -1141,7 +1141,7 @@ protected function ensureTableExists() { } /** - * Determines serialized fields. + * Determines serialized fields in the storage. * * @return array * A list of fields that are serialized in the database. diff --git a/core/lib/Drupal/Core/Menu/MenuTreeStorageInterface.php b/core/lib/Drupal/Core/Menu/MenuTreeStorageInterface.php index 1326d8b..f937ddc 100644 --- a/core/lib/Drupal/Core/Menu/MenuTreeStorageInterface.php +++ b/core/lib/Drupal/Core/Menu/MenuTreeStorageInterface.php @@ -74,7 +74,7 @@ public function loadByProperties(array $properties); * @param string $route_name * The route name. * @param array $route_parameters - * (optional) The route parameters, defaults to an empty array. + * (optional) The route parameters. Defaults to an empty array. * @param string $menu_name * (optional) Restricts the found links to just those in the named menu. * @@ -242,7 +242,7 @@ public function getMenuNames(); * Counts the total number of menu links in one menu or all menus. * * @param string $menu_name - * (optional) The menu name to count by, defaults to all menus. + * (optional) The menu name to count by. Defaults to all menus. * * @return int * The number of menu links in the named menu, or in all menus if the