diff --git a/core/includes/theme.inc b/core/includes/theme.inc
index 35af8e0..d4d9742 100644
--- a/core/includes/theme.inc
+++ b/core/includes/theme.inc
@@ -575,14 +575,12 @@ function template_preprocess_datetime_wrapper(&$variables) {
  *     - url: (optional) The url object to link to. If omitted, no a tag is
  *       printed out.
  *     - attributes: (optional) Attributes for the anchor, or for the <span>
- *       tag used in its place if no 'href' is supplied. If element 'class' is
+ *       tag used in its place if no 'url' is supplied. If element 'class' is
  *       included, it must be an array of one or more class names.
- *     If the 'href' element is supplied, the entire link array is passed to
- *     l() as its $options parameter.
  *   - attributes: A keyed array of attributes for the UL containing the
  *     list of links.
  *   - set_active_class: (optional) Whether each link should compare the
- *     route_name + route_parameters or href (path), language and query options
+ *     route_name + route_parameters or url (path), language and query options
  *     to the current URL, to determine whether the link is "active". If so, an
  *     "active" class will be applied to the list item containing the link, as
  *     well as the link itself. It is important to use this sparingly since it
diff --git a/core/modules/system/templates/links.html.twig b/core/modules/system/templates/links.html.twig
index 86713b5..4520106 100644
--- a/core/modules/system/templates/links.html.twig
+++ b/core/modules/system/templates/links.html.twig
@@ -8,11 +8,10 @@
  * - links: Links to be output.
  *   Each link will have the following elements:
  *   - title: The link text.
- *   - href: The link URL. If omitted, the 'title' is shown as a plain text
- *     item in the links list. If 'href' is supplied, the entire link is passed
- *     to l() as its $options parameter.
+ *   - link: The link URL. If omitted, the 'title' is shown as a plain text
+ *     item in the links list.
  *   - attributes: (optional) HTML attributes for the anchor, or for the <span>
- *     tag if no 'href' is supplied.
+ *     tag if no 'link' is supplied.
  *   - link_key: The link CSS class.
  * - heading: (optional) A heading to precede the links.
  *   - text: The heading text.
diff --git a/core/themes/classy/templates/navigation/links.html.twig b/core/themes/classy/templates/navigation/links.html.twig
index f82f41a..076625c 100644
--- a/core/themes/classy/templates/navigation/links.html.twig
+++ b/core/themes/classy/templates/navigation/links.html.twig
@@ -8,11 +8,10 @@
  * - links: Links to be output.
  *   Each link will have the following elements:
  *   - title: The link text.
- *   - href: The link URL. If omitted, the 'title' is shown as a plain text
- *     item in the links list. If 'href' is supplied, the entire link is passed
- *     to l() as its $options parameter.
+ *   - link: The link URL. If omitted, the 'title' is shown as a plain text
+ *     item in the links list.
  *   - attributes: (optional) HTML attributes for the anchor, or for the <span>
- *     tag if no 'href' is supplied.
+ *     tag if no 'link' is supplied.
  *   - link_key: The link CSS class.
  * - heading: (optional) A heading to precede the links.
  *   - text: The heading text.
diff --git a/core/themes/stable/templates/navigation/links.html.twig b/core/themes/stable/templates/navigation/links.html.twig
index f82f41a..076625c 100644
--- a/core/themes/stable/templates/navigation/links.html.twig
+++ b/core/themes/stable/templates/navigation/links.html.twig
@@ -8,11 +8,10 @@
  * - links: Links to be output.
  *   Each link will have the following elements:
  *   - title: The link text.
- *   - href: The link URL. If omitted, the 'title' is shown as a plain text
- *     item in the links list. If 'href' is supplied, the entire link is passed
- *     to l() as its $options parameter.
+ *   - link: The link URL. If omitted, the 'title' is shown as a plain text
+ *     item in the links list.
  *   - attributes: (optional) HTML attributes for the anchor, or for the <span>
- *     tag if no 'href' is supplied.
+ *     tag if no 'link' is supplied.
  *   - link_key: The link CSS class.
  * - heading: (optional) A heading to precede the links.
  *   - text: The heading text.