| Index: dart/editor/tools/plugins/com.google.dart.tools.core/src/com/google/dart/tools/core/analysis/model/ContextManager.java
|
| ===================================================================
|
| --- dart/editor/tools/plugins/com.google.dart.tools.core/src/com/google/dart/tools/core/analysis/model/ContextManager.java (revision 31563)
|
| +++ dart/editor/tools/plugins/com.google.dart.tools.core/src/com/google/dart/tools/core/analysis/model/ContextManager.java (working copy)
|
| @@ -1,11 +1,11 @@
|
| /*
|
| * Copyright (c) 2013, the Dart project authors.
|
| - *
|
| + *
|
| * Licensed under the Eclipse Public License v1.0 (the "License"); you may not use this file except
|
| * in compliance with the License. You may obtain a copy of the License at
|
| - *
|
| + *
|
| * http://www.eclipse.org/legal/epl-v10.html
|
| - *
|
| + *
|
| * Unless required by applicable law or agreed to in writing, software distributed under the License
|
| * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
|
| * or implied. See the License for the specific language governing permissions and limitations under
|
| @@ -27,21 +27,21 @@
|
| /**
|
| * Instances of {@code ContextManager} manage and provide access to multiple instances of
|
| * {@link AnalysisContext}.
|
| - *
|
| + *
|
| * @coverage dart.tools.core.model
|
| */
|
| public interface ContextManager {
|
|
|
| /**
|
| * Add the given {@link AnalysisWorker} to the context's list of active workers.
|
| - *
|
| + *
|
| * @param worker the analysis worker
|
| */
|
| void addWorker(AnalysisWorker worker);
|
|
|
| /**
|
| * Answer the {@link AnalysisContext} used to analyze the specified resource.
|
| - *
|
| + *
|
| * @param resource a resource (not {@code null})
|
| * @return the context used for analysis or {@code null} if the context was not cached and could
|
| * not be created because the container's location could not be determined
|
| @@ -50,21 +50,21 @@
|
|
|
| /**
|
| * Answer with all the library sources that can be launched on the browser
|
| - *
|
| + *
|
| * @return library sources that can be launched on the browser
|
| */
|
| Source[] getLaunchableClientLibrarySources();
|
|
|
| /**
|
| * Answer with all the library sources that can be launched on the VM
|
| - *
|
| + *
|
| * @return library sources that can be launched on the VM
|
| */
|
| Source[] getLaunchableServerLibrarySources();
|
|
|
| /**
|
| * Answer the LibraryElement associated with the specified file
|
| - *
|
| + *
|
| * @param file the file (not {@code null})
|
| * @return the {@link LibraryElement} associated with the file or {@code null} if it could not be
|
| * determined because the location is {@code null}
|
| @@ -73,7 +73,7 @@
|
|
|
| /**
|
| * Answer the LibraryElement associated with the specified file
|
| - *
|
| + *
|
| * @return the {@link LibraryElement} or {@code null} if file has not been resolved yet or the
|
| * location is {@code null}
|
| */
|
| @@ -81,7 +81,7 @@
|
|
|
| /**
|
| * Answer the {@link PubFolder} containing the specified resource.
|
| - *
|
| + *
|
| * @param resource the resource (not {@code null})
|
| * @return the pub folder or {@code null} if no pub folder contains this resource
|
| */
|
| @@ -89,14 +89,14 @@
|
|
|
| /**
|
| * Answer the underlying Eclipse resource associated with this object
|
| - *
|
| + *
|
| * @return the resource (not {@code null})
|
| */
|
| IContainer getResource();
|
|
|
| /**
|
| * Answer the resource associated with the specified source.
|
| - *
|
| + *
|
| * @param source the source
|
| * @return the resource or {@code null} if it could not be determined
|
| */
|
| @@ -105,7 +105,7 @@
|
| /**
|
| * Answer the bi-directional map for translating between sources and resources for the specified
|
| * analysis context.
|
| - *
|
| + *
|
| * @param context the analysis context (not {@code null})
|
| * @return the resource map (not {@code null})
|
| */
|
| @@ -114,7 +114,7 @@
|
| /**
|
| * Answer the bi-directional map for translating between sources and resources for the specified
|
| * resource.
|
| - *
|
| + *
|
| * @param resource the resource (not {@code null})
|
| * @return the resource map, may be {@code null} if enclosing project doesn't exist
|
| */
|
| @@ -122,21 +122,21 @@
|
|
|
| /**
|
| * Answer the {@link DartSdk} associated with this manager.
|
| - *
|
| + *
|
| * @return the sdk (not {@code null})
|
| */
|
| DartSdk getSdk();
|
|
|
| /**
|
| * Answer the context containing analysis of sources in the SDK.
|
| - *
|
| + *
|
| * @return the context (not {@code null})
|
| */
|
| AnalysisContext getSdkContext();
|
|
|
| /**
|
| * Answer the source for the specified file
|
| - *
|
| + *
|
| * @param file the file (not {@code null})
|
| * @return the source or {@code null} if the source could not be determined because the location
|
| * is {@code null}
|
| @@ -145,7 +145,7 @@
|
|
|
| /**
|
| * Answer the source kind for the given file.
|
| - *
|
| + *
|
| * @return the {@link SourceKind} of the given file, may be {@link SourceKind#UNKNOWN} if not
|
| * analyzed yet.
|
| */
|
| @@ -153,21 +153,21 @@
|
|
|
| /**
|
| * Answer the context's list of active workers.
|
| - *
|
| + *
|
| * @return the list (not {@code null}, contains no {@code null}s)
|
| */
|
| AnalysisWorker[] getWorkers();
|
|
|
| /**
|
| * Remove the {@link AnalysisWorker} from the project's active workers list.
|
| - *
|
| + *
|
| * @param analysisWorker
|
| */
|
| void removeWorker(AnalysisWorker analysisWorker);
|
|
|
| /**
|
| * Locate a {@link IFileInfo} for the given package uri relative to the given resource
|
| - *
|
| + *
|
| * @param relativeTo the resource to use to locate an analysis context
|
| * @param uri a package: uri
|
| * @return the file information or null if the resource is null or does not exist
|
| @@ -177,7 +177,7 @@
|
| /**
|
| * Set the hint option for all the analysis context, based on changes to the hint preference
|
| * DartCore.ENABLE_HINTS_DART2JS_PREFERENCE
|
| - *
|
| + *
|
| * @param enableDart2JSHints
|
| */
|
| void setDart2JSHintOption(boolean enableDart2JSHints);
|
| @@ -185,14 +185,14 @@
|
| /**
|
| * Set the hint option for all the analysis context, based on changes to the hint preference
|
| * DartCore.ENABLE_HINT_PREFERENCE
|
| - *
|
| + *
|
| * @param enableHint
|
| */
|
| void setHintOption(boolean enableHint);
|
|
|
| /**
|
| * Stop workers for the specified context.
|
| - *
|
| + *
|
| * @param context the context
|
| */
|
| void stopWorkers(AnalysisContext context);
|
|
|