| OLD | NEW |
| 1 A comprehensive, cross-platform path manipulation library for Dart. | 1 A comprehensive, cross-platform path manipulation library for Dart. |
| 2 | 2 |
| 3 The path package provides common operations for manipulating file paths: | 3 The path package provides common operations for manipulating file paths: |
| 4 joining, splitting, normalizing, etc. | 4 joining, splitting, normalizing, etc. |
| 5 | 5 |
| 6 We've tried very hard to make this library do the "right" thing on whatever | 6 We've tried very hard to make this library do the "right" thing on whatever |
| 7 platform you run it on. When you use the top-level functions, it will assume the | 7 platform you run it on. When you use the top-level functions, it will assume the |
| 8 current platform's path style and work with that. If you want to specifically | 8 current platform's path style and work with that. If you want to specifically |
| 9 work with paths of a specific style, you can construct a `path.Builder` for that | 9 work with paths of a specific style, you can construct a `path.Builder` for that |
| 10 style. | 10 style. |
| 11 | 11 |
| 12 ## Using | 12 ## Using |
| 13 | 13 |
| 14 The path library was designed to be imported with a prefix, though you don't | 14 The path library was designed to be imported with a prefix, though you don't |
| 15 have to if you don't want to: | 15 have to if you don't want to: |
| 16 | 16 |
| 17 import 'package:path/path.dart' as path; // TODO(bob): ??? | 17 import 'package:path/path.dart' as path; |
| 18 | 18 |
| 19 ## Top-level functions | 19 ## Top-level functions |
| 20 | 20 |
| 21 The most common way to use the library is through the top-level functions. | 21 The most common way to use the library is through the top-level functions. |
| 22 These manipulate path strings based on your current working directory and the | 22 These manipulate path strings based on your current working directory and the |
| 23 path style (POSIX, Windows, or URLs) of the host platform. | 23 path style (POSIX, Windows, or URLs) of the host platform. |
| 24 | 24 |
| 25 ### String get current | 25 ### String get current |
| 26 | 26 |
| 27 Gets the path to the current working directory. In the browser, this means the | 27 Gets the path to the current working directory. In the browser, this means the |
| (...skipping 369 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 397 * It can accurately tell if a path is absolute based on drive-letters or UNC | 397 * It can accurately tell if a path is absolute based on drive-letters or UNC |
| 398 prefix. | 398 prefix. |
| 399 | 399 |
| 400 * It understands that "/foo" is not an absolute path on Windows. | 400 * It understands that "/foo" is not an absolute path on Windows. |
| 401 | 401 |
| 402 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the | 402 * It knows that "C:\foo\one.txt" and "c:/foo\two.txt" are two files in the |
| 403 same directory. | 403 same directory. |
| 404 | 404 |
| 405 If you find a problem, surprise or something that's unclear, please don't | 405 If you find a problem, surprise or something that's unclear, please don't |
| 406 hesitate to [file a bug](http://dartbug.com/new) and let us know. | 406 hesitate to [file a bug](http://dartbug.com/new) and let us know. |
| OLD | NEW |