Index: pkg/analyzer_experimental/lib/src/generated/source_io.dart |
diff --git a/pkg/analyzer_experimental/lib/src/generated/source_io.dart b/pkg/analyzer_experimental/lib/src/generated/source_io.dart |
index 513f77fd8242f6a26763ffafa20a0e7bc9cb2508..07fa4e11709698fcf6b21affad8b2b6aa616b478 100644 |
--- a/pkg/analyzer_experimental/lib/src/generated/source_io.dart |
+++ b/pkg/analyzer_experimental/lib/src/generated/source_io.dart |
@@ -10,6 +10,7 @@ import 'engine.dart' show AnalysisContext, AnalysisEngine; |
export 'source.dart'; |
/** |
* Instances of the class `FileBasedSource` implement a source that represents a file. |
+ * |
* @coverage dart.engine.source |
*/ |
class FileBasedSource implements Source { |
@@ -38,6 +39,7 @@ class FileBasedSource implements Source { |
/** |
* Initialize a newly created source object. The source object is assumed to not be in a system |
* library. |
+ * |
* @param contentCache the content cache used to access the contents of this source |
* @param file the file represented by this source |
*/ |
@@ -50,6 +52,7 @@ class FileBasedSource implements Source { |
/** |
* Initialize a newly created source object. |
+ * |
* @param contentCache the content cache used to access the contents of this source |
* @param file the file represented by this source |
* @param flags `true` if this source is in one of the system libraries |
@@ -106,6 +109,7 @@ class FileBasedSource implements Source { |
/** |
* Return the file represented by this source. This is an internal method that is only intended to |
* be used by [UriResolver]. |
+ * |
* @return the file represented by this source |
*/ |
JavaFile get file => _file; |
@@ -117,6 +121,7 @@ class FileBasedSource implements Source { |
* For the purposes of sharing analysis, the path to each package under the "packages" directory |
* should be canonicalized, but to preserve relative links within a package, the remainder of the |
* path from the package directory to the leaf should not. |
+ * |
* @coverage dart.engine.source |
*/ |
class PackageUriResolver extends UriResolver { |
@@ -138,6 +143,7 @@ class PackageUriResolver extends UriResolver { |
/** |
* Return `true` if the given URI is a `package` URI. |
+ * |
* @param uri the URI being tested |
* @return `true` if the given URI is a `package` URI |
*/ |
@@ -146,8 +152,9 @@ class PackageUriResolver extends UriResolver { |
/** |
* Initialize a newly created resolver to resolve `package` URI's relative to the given |
* package directories. |
+ * |
* @param packagesDirectories the package directories that `package` URI's are assumed to be |
- * relative to |
+ * relative to |
*/ |
PackageUriResolver(List<JavaFile> packagesDirectories) { |
if (packagesDirectories.length < 1) { |
@@ -216,10 +223,11 @@ class PackageUriResolver extends UriResolver { |
/** |
* Answer the canonical file for the specified package. |
+ * |
* @param packagesDirectory the "packages" directory (not `null`) |
* @param pkgName the package name (not `null`, not empty) |
* @param relPath the path relative to the package directory (not `null`, no leading slash, |
- * but may be empty string) |
+ * but may be empty string) |
* @return the file (not `null`) |
*/ |
JavaFile getCanonicalFile(JavaFile packagesDirectory, String pkgName, String relPath) { |
@@ -240,6 +248,7 @@ class PackageUriResolver extends UriResolver { |
/** |
* Instances of the class [DirectoryBasedSourceContainer] represent a source container that |
* contains all sources within a given directory. |
+ * |
* @coverage dart.engine.source |
*/ |
class DirectoryBasedSourceContainer implements SourceContainer { |
@@ -247,6 +256,7 @@ class DirectoryBasedSourceContainer implements SourceContainer { |
/** |
* Append the system file separator to the given path unless the path already ends with a |
* separator. |
+ * |
* @param path the path to which the file separator is to be added |
* @return a path that ends with the system file separator |
*/ |
@@ -263,8 +273,11 @@ class DirectoryBasedSourceContainer implements SourceContainer { |
String _path; |
/** |
- * Construct a container representing the specified directory and containing any sources whose[Source#getFullName] starts with the directory's path. This is a convenience method, |
- * fully equivalent to [DirectoryBasedSourceContainer#DirectoryBasedSourceContainer]. |
+ * Construct a container representing the specified directory and containing any sources whose |
+ * [Source#getFullName] starts with the directory's path. This is a convenience method, |
+ * fully equivalent to [DirectoryBasedSourceContainer#DirectoryBasedSourceContainer] |
+ * . |
+ * |
* @param directory the directory (not `null`) |
*/ |
DirectoryBasedSourceContainer.con1(JavaFile directory) { |
@@ -275,7 +288,9 @@ class DirectoryBasedSourceContainer implements SourceContainer { |
} |
/** |
- * Construct a container representing the specified path and containing any sources whose[Source#getFullName] starts with the specified path. |
+ * Construct a container representing the specified path and containing any sources whose |
+ * [Source#getFullName] starts with the specified path. |
+ * |
* @param path the path (not `null` and not empty) |
*/ |
DirectoryBasedSourceContainer.con2(String path2) { |
@@ -289,6 +304,7 @@ class DirectoryBasedSourceContainer implements SourceContainer { |
/** |
* Answer the receiver's path, used to determine if a source is contained in the receiver. |
+ * |
* @return the path (not `null`, not empty) |
*/ |
String get path => _path; |
@@ -297,6 +313,7 @@ class DirectoryBasedSourceContainer implements SourceContainer { |
} |
/** |
* Instances of the class `FileUriResolver` resolve `file` URI's. |
+ * |
* @coverage dart.engine.source |
*/ |
class FileUriResolver extends UriResolver { |
@@ -308,6 +325,7 @@ class FileUriResolver extends UriResolver { |
/** |
* Return `true` if the given URI is a `file` URI. |
+ * |
* @param uri the URI being tested |
* @return `true` if the given URI is a `file` URI |
*/ |