Update outdated docs for ImportCache.importCanonical(). (#982)

sass · May 13, 2020 · 93dcf99 · 93dcf99
1 parent 39358fb
commit 93dcf99
Show file tree

Hide file tree

Showing 3 changed files with 7 additions and 7 deletions.
diff --git a/lib/src/async_import_cache.dart b/lib/src/async_import_cache.dart
@@ -171,8 +171,8 @@ Relative canonical URLs are deprecated and will eventually be disallowed.
   /// Otherwise returns `null`.
   ///
   /// If passed, the [originalUrl] represents the URL that was canonicalized
-  /// into [canonicalUrl]. It's used as the URL for the parsed stylesheet, which
-  /// is in turn used in error reporting.
+  /// into [canonicalUrl]. It's used to resolve a relative canonical URL, which
+  /// importers may return for legacy reasons.
   ///
   /// Caches the result of the import and uses cached results if possible.
   Future<Stylesheet> importCanonical(AsyncImporter importer, Uri canonicalUrl,

diff --git a/lib/src/import_cache.dart b/lib/src/import_cache.dart
@@ -5,7 +5,7 @@
 // DO NOT EDIT. This file was generated from async_import_cache.dart.
 // See tool/grind/synchronize.dart for details.
 //
-// Checksum: c39f68f9964e4ae03c6447d845349e276def5031
+// Checksum: 8f54034c56e0d38fc8c90ad4d5f017628cab6190
 //
 // ignore_for_file: unused_import
 
@@ -171,8 +171,8 @@ Relative canonical URLs are deprecated and will eventually be disallowed.
   /// Otherwise returns `null`.
   ///
   /// If passed, the [originalUrl] represents the URL that was canonicalized
-  /// into [canonicalUrl]. It's used as the URL for the parsed stylesheet, which
-  /// is in turn used in error reporting.
+  /// into [canonicalUrl]. It's used to resolve a relative canonical URL, which
+  /// importers may return for legacy reasons.
   ///
   /// Caches the result of the import and uses cached results if possible.
   Stylesheet importCanonical(Importer importer, Uri canonicalUrl,

diff --git a/lib/src/stylesheet_graph.dart b/lib/src/stylesheet_graph.dart
@@ -80,8 +80,8 @@ class StylesheetGraph {
   /// stylesheets it imports to this graph and returns its node.
   ///
   /// If passed, the [originalUrl] represents the URL that was canonicalized
-  /// into [canonicalUrl]. It's used as the URL for the parsed stylesheet, which
-  /// is in turn used in error reporting.
+  /// into [canonicalUrl]. It's used to resolve a relative canonical URL, which
+  /// importers may return for legacy reasons.
   ///
   /// Returns the set of nodes that need to be recompiled because their imports
   /// changed as a result of this stylesheet being added. This does not include