cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From i..@apache.org
Subject [1/2] git commit: Fixed toURL() toInternalURL() information in the doku
Date Fri, 23 May 2014 19:48:50 GMT
Repository: cordova-plugin-file
Updated Branches:
  refs/heads/master 2165395ee -> 890d8d221


Fixed toURL() toInternalURL() information in the doku


Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/commit/94ad2dea
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/tree/94ad2dea
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/diff/94ad2dea

Branch: refs/heads/master
Commit: 94ad2deabca64fc808f49fafe9f5c56009e1bb2b
Parents: 2165395
Author: Dominik Pesch <d.pesch@11com7.de>
Authored: Wed May 14 18:02:07 2014 +0200
Committer: Ian Clelland <iclelland@chromium.org>
Committed: Fri May 23 15:44:13 2014 -0400

----------------------------------------------------------------------
 doc/index.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-plugin-file/blob/94ad2dea/doc/index.md
----------------------------------------------------------------------
diff --git a/doc/index.md b/doc/index.md
index c24e11a..e05ff38 100644
--- a/doc/index.md
+++ b/doc/index.md
@@ -166,11 +166,7 @@ object with a `fullPath` of
 
 If your application works with device-absolute-paths, and you previously retrieved those
 paths through the `fullPath` property of `Entry` objects, then you should update your code
-to use `entry.toURL()` instead. This method will now return filesystem URLs of the form
-
-    cdvfile://localhost/persistent/path/to/file
-
-which can be used to identify the file uniquely.
+to use `entry.toURL()` instead.
 
 For backwards compatibility, the `resolveLocalFileSystemURL()` method will accept a
 device-absolute-path, and will return an `Entry` object corresponding to it, as long as that
@@ -181,6 +177,14 @@ device-absolute-paths (and can still accept them). It has been updated
to work c
 with FileSystem URLs, so replacing `entry.fullPath` with `entry.toURL()` should resolve any
 issues getting that plugin to work with files on the device.
 
+In v1.1.0 the return value of `toURL()` was changed (see [CB-6394] (https://issues.apache.org/jira/browse/CB-6394))
+and return an absolute 'file://' URL. To get a 'cdvfile:'-URL you have to use `toInternalURL()`
now.
+This method will now return filesystem URLs of the form
+
+    cdvfile://localhost/persistent/path/to/file
+
+which can be used to identify the file uniquely.
+
 ## List of Error Codes and Meanings
 When an error is thrown, one of the following codes will be used. 
 
@@ -226,4 +230,3 @@ Android also supports a special filesystem named "documents", which represents
a
 * root: The entire device filesystem
 
 By default, the library and documents directories can be synced to iCloud. You can also request
two additional filesystems, "library-nosync" and "documents-nosync", which represent a special
non-synced directory within the Library or Documents filesystem.
-


Mime
View raw message