drive: Stop mentioning about symlinks

chrome/browser/chromeos/drive/file_cache.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_CHROMEOS_DRIVE_FILE_CACHE_H_
 #define CHROME_BROWSER_CHROMEOS_DRIVE_FILE_CACHE_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 104 matching lines @@
   // Must be called on the UI thread.
   void AddObserver(FileCacheObserver* observer);
 
   // Removes observer.
   // Must be called on the UI thread.
   void RemoveObserver(FileCacheObserver* observer);
 
   // Gets the cache entry for file corresponding to |resource_id| and |md5|
   // and runs |callback| with true and the entry found if entry exists in cache
   // map.  Otherwise, runs |callback| with false.
-  // |md5| can be empty if only matching |resource_id| is desired, which may
-  // happen when looking for pinned entries where symlinks' filenames have no
-  // extension and hence no md5.
+  // |md5| can be empty if only matching |resource_id| is desired.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void GetCacheEntryOnUIThread(const std::string& resource_id,
                                const std::string& md5,
                                const GetCacheEntryCallback& callback);
 
   // Gets the cache entry by the given resource ID and MD5.
   // See also GetCacheEntryOnUIThread().
   bool GetCacheEntry(const std::string& resource_id,
                      const std::string& md5,
@@ skipping 61 matching lines @@
   // Stores |source_path| to the cache and mark it as dirty, i.e., needs to be
   // uploaded to the remove server for syncing.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void StoreLocallyModifiedOnUIThread(const std::string& resource_id,
                                       const std::string& md5,
                                       const base::FilePath& source_path,
                                       FileOperationType file_operation_type,
                                       const FileOperationCallback& callback);
 
-  // Modifies cache state, which involves the following:
-  // - moves |source_path| to |dest_path| in persistent dir if
-  //   file is not dirty
-  // - creates symlink in pinned dir that references downloaded or locally
-  //   modified file
+  // Pins the specified entry.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void PinOnUIThread(const std::string& resource_id,
                      const std::string& md5,
                      const FileOperationCallback& callback);
 
   // Runs Unpin() on |blocking_task_runner_|, and calls |callback| with the
   // result asynchronously.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void UnpinOnUIThread(const std::string& resource_id,
                        const std::string& md5,
                        const FileOperationCallback& callback);
 
-  // Modifies cache state, which involves the following:
-  // - moves the local file from pinned directory to unpinned directory.
-  // - update cache metadata.
+  // Unpins the specified entry.
   FileError Unpin(const std::string& resource_id, const std::string& md5);
 
   // Sets the state of the cache entry corresponding to |resource_id| and |md5|
   // as mounted.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void MarkAsMountedOnUIThread(const std::string& resource_id,
                                const std::string& md5,
                                const GetFileFromCacheCallback& callback);
 
   // Set the state of the cache entry corresponding to file_path as unmounted.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void MarkAsUnmountedOnUIThread(const base::FilePath& file_path,
                                  const FileOperationCallback& callback);
 
-  // Modifies cache state, which involves the following:
-  // - moves |source_path| to |dest_path| in persistent dir, where
-  //   |source_path| has .<md5> extension and |dest_path| has .local extension
-  // - if file is pinned, updates symlink in pinned dir to reference dirty file
+  // Marks the specified entry dirty.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void MarkDirtyOnUIThread(const std::string& resource_id,
                            const std::string& md5,
                            const FileOperationCallback& callback);
 
-  // Modifies cache state, i.e. creates symlink in outgoing
-  // dir to reference dirty file in persistent dir.
+  // Commits changes for the specified dirty entry.
   // |callback| must not be null.
   // Must be called on the UI thread.
   void CommitDirtyOnUIThread(const std::string& resource_id,
                              const std::string& md5,
                              const FileOperationCallback& callback);
 
   // Clears dirty state of the specified entry.
   FileError ClearDirty(const std::string& resource_id,
                        const std::string& md5);
 
@@ skipping 153 matching lines @@
 // this value.
 //
 // Copied from cryptohome/homedirs.h.
 // TODO(satorux): Share the constant.
 const int64 kMinFreeSpace = 512 * 1LL << 20;
 
 }  // namespace internal
 }  // namespace drive
 
 #endif  // CHROME_BROWSER_CHROMEOS_DRIVE_FILE_CACHE_H_