Minimize dependency of user scripts....

base/file_path.h

 // Copyright (c) 2008 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.
 
 // FilePath is a container for pathnames stored in a platform's native string
 // type, providing containers for manipulation in according with the
 // platform's conventions for pathnames.  It supports the following path
 // types:
 //
 //                   POSIX            Windows
@@ skipping 160 matching lines @@
   bool empty() const { return path_.empty(); }
 
   // Returns true if |character| is in kSeparators.
   static bool IsSeparator(CharType character);
 
   // Returns a vector of all of the components of the provided path. It is
   // equivalent to calling DirName().value() on the path's root component,
   // and BaseName().value() on each child component.
   void GetComponents(std::vector<FilePath::StringType>* components) const;
 
+  // Returns true, and sets *path to resulting full path, if relative_path can
+  // be applied to current path by resolving any '..' it may contain. Returns
+  // false otherwise, e.g., if relative path is absolute, or if it climbs back
+  // up the hierarchy too far (i.e., beyond the root of current path).
+  // Note that if the current path ends with a file name, we won't try to

[brettw, 2009/10/20 06:06:19]

Can you put a blank line separating these two paragraphs to make it easier to
read?

[MAD, 2009/10/20 13:43:29]

Done.

+  // figure it out (so this method doesn't go to the disk) and we will blindly
+  // append relative_path at the end of the current path, including the file
+  // name in the current path (if any).
+  bool AppendAndResolveRelative(const FilePath& relative_path,
+                                FilePath* path) const;
+
   // Returns true if this FilePath is a strict parent of the |child|. Absolute
   // and relative paths are accepted i.e. is /foo parent to /foo/bar and
   // is foo parent to foo/bar. Does not convert paths to absolute, follow
   // symlinks or directory navigation (e.g. ".."). A path is *NOT* its own
   // parent.
   bool IsParent(const FilePath& child) const;
 
   // If IsParent(child) holds, appends to path (if non-NULL) the
   // relative path to child and returns true.  For example, if parent
   // holds "/Users/johndoe/Library/Application Support", child holds
@@ skipping 133 matching lines @@
 namespace stdext {
 
 inline size_t hash_value(const FilePath& f) {
   return hash_value(f.value());
 }
 
 }  // namespace stdext
 #endif  // COMPILER
 
 #endif  // BASE_FILE_PATH_H_