diff --git a/core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php b/core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php
index d3c41b9..c44e203 100644
--- a/core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php
+++ b/core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php
@@ -85,6 +85,10 @@ public function generateFromPath($path = NULL, $options = array());
   /**
    * Gets the internal path (system path) of a route.
    *
+   * This method is intended to use when you really need the path, like for
+   * setting the destination to a link. In most cases generateFromRoute is the
+   * recommended method.
+   *
    * @param string $name
    *  The route name.
    * @param array $parameters
@@ -93,9 +97,6 @@ public function generateFromPath($path = NULL, $options = array());
    *
    * @return string
    *  The internal Drupal path corresponding to the route.
-   *
-   * @deprecated in Drupal 8.x-dev, will be removed before Drupal 8.0.
-   *   System paths should not be used - use route names and parameters.
    */
   public function getPathFromRoute($name, $parameters = array());