Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(223)

Unified Diff: sdk/lib/_internal/pub/lib/src/system_cache.dart

Issue 344493003: Update doc comments to follow style guide. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Created 6 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « sdk/lib/_internal/pub/lib/src/source_registry.dart ('k') | sdk/lib/_internal/pub/lib/src/utils.dart » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: sdk/lib/_internal/pub/lib/src/system_cache.dart
diff --git a/sdk/lib/_internal/pub/lib/src/system_cache.dart b/sdk/lib/_internal/pub/lib/src/system_cache.dart
index 4c48fbad859612912fca43d9125b477a4f2cbb4d..650861522274b37a151e5b3a53a404d73f272ede 100644
--- a/sdk/lib/_internal/pub/lib/src/system_cache.dart
+++ b/sdk/lib/_internal/pub/lib/src/system_cache.dart
@@ -37,8 +37,9 @@ class SystemCache {
/// user's file system.
SystemCache(this.rootDir);
- /// Creates a system cache and registers the standard set of sources. If
- /// [isOffline] is `true`, then the offline hosted source will be used.
+ /// Creates a system cache and registers the standard set of sources.
+ ///
+ /// If [isOffline] is `true`, then the offline hosted source will be used.
/// Defaults to `false`.
factory SystemCache.withSources(String rootDir, {bool isOffline: false}) {
var cache = new SystemCache(rootDir);
@@ -55,8 +56,10 @@ class SystemCache {
return cache;
}
- /// Registers a new source. This source must not have the same name as a
- /// source that's already been registered.
+ /// Registers a new source.
+ ///
+ /// This source must not have the same name as a source that's already been
+ /// registered.
void register(Source source) {
source.bind(this);
sources.register(source);
@@ -73,11 +76,12 @@ class SystemCache {
return source.isInSystemCache(id);
}
- /// Create a new temporary directory within the system cache. The system
- /// cache maintains its own temporary directory that it uses to stage
- /// packages into while downloading. It uses this instead of the OS's system
- /// temp directory to ensure that it's on the same volume as the pub system
- /// cache so that it can move the directory from it.
+ /// Create a new temporary directory within the system cache.
+ ///
+ /// The system cache maintains its own temporary directory that it uses to
+ /// stage packages into while downloading. It uses this instead of the OS's
+ /// system temp directory to ensure that it's on the same volume as the pub
+ /// system cache so that it can move the directory from it.
String createTempDir() {
var temp = ensureDir(tempDir);
return io.createTempDir(temp, 'dir');
« no previous file with comments | « sdk/lib/_internal/pub/lib/src/source_registry.dart ('k') | sdk/lib/_internal/pub/lib/src/utils.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698