Issue #3350922 by Ranjit1032002, Akram Khan, quietone, geek-merlin, larowlan: Deprecate unused MatchingRouteNotFoundException

core/lib/Drupal/Core/Routing/MatchingRouteNotFoundException.php

@@ -6,7 +6,11 @@ use Symfony\Component\Routing\Exception\ResourceNotFoundException;
 
 /**
  * No matching route was found.
+ *
+ * @deprecated in drupal:11.1.0 and is removed from drupal:12.0.0. There is no
+ *  replacement.
+ *
+ * @see https://www.drupal.org/node/3462776
  */
 class MatchingRouteNotFoundException extends ResourceNotFoundException {
-
 }

core/lib/Drupal/Core/Url.php

@@ -482,8 +482,12 @@ class Url implements TrustedCallbackInterface {
    *   would get an access denied running the same request via the normal page
    *   flow.
    *
-   * @throws \Drupal\Core\Routing\MatchingRouteNotFoundException
-   *   Thrown when the request cannot be matched.
+   * @throws Symfony\Component\Routing\Exception\NoConfigurationException
+   *   If no routing configuration could be found.
+   * @throws Symfony\Component\Routing\Exception\ResourceNotFoundException
+   *   If no matching resource could be found.
+   * @throws Symfony\Component\Routing\Exception\MethodNotAllowedException
+   *   If a matching resource was found but the request method is not allowed.
    */
   public static function createFromRequest(Request $request) {
     // We use the router without access checks because URL objects might be