diff --git a/core/lib/Drupal/Component/Utility/UrlHelper.php b/core/lib/Drupal/Component/Utility/UrlHelper.php
index 52b746f..c286db9 100644
--- a/core/lib/Drupal/Component/Utility/UrlHelper.php
+++ b/core/lib/Drupal/Component/Utility/UrlHelper.php
@@ -120,8 +120,8 @@ public static function filterQueryParameters(array $query, array $exclude = arra
    * @link http://tools.ietf.org/html/rfc3986#section-3 RFC 3986 @endlink for an
    * explanation of what the component parts are.
    *
-   * Note, however, that when passed an external URL, this function groups the
-   * scheme, authority and path together into the path component.
+   * Note that, unlike the RFC, when passed an external URL, this function
+   * groups the scheme, authority, and path together into the path component.
    *
    * @param string $url
    *   The internal path or external URL string to parse.
@@ -129,12 +129,12 @@ public static function filterQueryParameters(array $query, array $exclude = arra
    * @return array
    *   An associative array containing:
    *   - path: The path component of $url. If $url is an external URL, this
-   *     includes the scheme and host.
+   *     includes the scheme, authority, and path.
    *   - query: An array of query parameters from $url, if they exist.
    *   - fragment: The fragment component from $url, if it exists.
    *
    * @see l()
-   * @see \Drupal::url()
+   * @see url()
    * @see http://tools.ietf.org/html/rfc3986
    *
    * @ingroup php_wrappers