Re: More questions on FileSystem directories

2014-06-30 Thread julio cesar sanchez
If you read this immediately after reading the docs for
cordova.file.dataDirectory, you may think that files there do NOT
survive app restarts.


Which ones, the files from dataDirectory or the files from cacheDirectory?

If you mean dataDirectory, maybe the doc should be something like this:

cordova.file.dataDirectory - Persistent data directory where to put
app-specific data files. (iOS, Android)

cordova.file.cacheDirectory - Directory for cached data files or any
files that your app can re-create easily. The OS may delete these
files when the device runs low on storage, nevertheless, apps should
not rely on the OS to delete files in here. (iOS, Android)

It's a mix from the apple
https://developer.apple.com/library/ios/Documentation/FileManagement/Conceptual/FileSystemProgrammingGUide/AccessingFilesandDirectories/AccessingFilesandDirectories.html#//apple_ref/doc/uid/TP40010672-CH3-SW11
and android doc
http://developer.android.com/guide/topics/data/data-storage.html

2014-06-29 19:08 GMT+02:00 Ray Camden rayca...@adobe.com:
 According to the docs, cordova.file.cacheDirectory is: Cached files that 
 should survive app restarts. Apps should not rely on the OS to delete files 
 in here. 

 If you read this immediately after reading the docs for 
 cordova.file.dataDirectory, you may think that files there do NOT survive app 
 restarts.

 Can we flesh out this a bit more perhaps?


RE: More questions on FileSystem directories

2014-06-30 Thread Ray Camden
Yes, I meant that the doc for cacheDirectory implies, at least to me, that the 
previous entry (dataDirectorry) will not persist. I think your modification 
makes sense. Do you want to make a PR for the doc or should I?


From: julio cesar sanchez jcesarmob...@gmail.com
Sent: Monday, June 30, 2014 2:19 AM
To: dev@cordova.apache.org
Subject: Re: More questions on FileSystem directories

If you read this immediately after reading the docs for
cordova.file.dataDirectory, you may think that files there do NOT
survive app restarts.


Which ones, the files from dataDirectory or the files from cacheDirectory?

If you mean dataDirectory, maybe the doc should be something like this:

cordova.file.dataDirectory - Persistent data directory where to put
app-specific data files. (iOS, Android)

cordova.file.cacheDirectory - Directory for cached data files or any
files that your app can re-create easily. The OS may delete these
files when the device runs low on storage, nevertheless, apps should
not rely on the OS to delete files in here. (iOS, Android)

It's a mix from the apple
https://developer.apple.com/library/ios/Documentation/FileManagement/Conceptual/FileSystemProgrammingGUide/AccessingFilesandDirectories/AccessingFilesandDirectories.html#//apple_ref/doc/uid/TP40010672-CH3-SW11
and android doc
http://developer.android.com/guide/topics/data/data-storage.html

2014-06-29 19:08 GMT+02:00 Ray Camden rayca...@adobe.com:
 According to the docs, cordova.file.cacheDirectory is: Cached files that 
 should survive app restarts. Apps should not rely on the OS to delete files 
 in here. 

 If you read this immediately after reading the docs for 
 cordova.file.dataDirectory, you may think that files there do NOT survive app 
 restarts.

 Can we flesh out this a bit more perhaps?


Re: More questions on FileSystem directories

2014-06-30 Thread julio cesar sanchez
Maybe we can wait to hear more opinios about my modification. Or you
can create the pull request and they will merge if they agree.

2014-06-30 16:44 GMT+02:00 Ray Camden rayca...@adobe.com:
 Yes, I meant that the doc for cacheDirectory implies, at least to me, that 
 the previous entry (dataDirectorry) will not persist. I think your 
 modification makes sense. Do you want to make a PR for the doc or should I?

 
 From: julio cesar sanchez jcesarmob...@gmail.com
 Sent: Monday, June 30, 2014 2:19 AM
 To: dev@cordova.apache.org
 Subject: Re: More questions on FileSystem directories

 If you read this immediately after reading the docs for
 cordova.file.dataDirectory, you may think that files there do NOT
 survive app restarts.


 Which ones, the files from dataDirectory or the files from cacheDirectory?

 If you mean dataDirectory, maybe the doc should be something like this:

 cordova.file.dataDirectory - Persistent data directory where to put
 app-specific data files. (iOS, Android)

 cordova.file.cacheDirectory - Directory for cached data files or any
 files that your app can re-create easily. The OS may delete these
 files when the device runs low on storage, nevertheless, apps should
 not rely on the OS to delete files in here. (iOS, Android)

 It's a mix from the apple
 https://developer.apple.com/library/ios/Documentation/FileManagement/Conceptual/FileSystemProgrammingGUide/AccessingFilesandDirectories/AccessingFilesandDirectories.html#//apple_ref/doc/uid/TP40010672-CH3-SW11
 and android doc
 http://developer.android.com/guide/topics/data/data-storage.html

 2014-06-29 19:08 GMT+02:00 Ray Camden rayca...@adobe.com:
 According to the docs, cordova.file.cacheDirectory is: Cached files that 
 should survive app restarts. Apps should not rely on the OS to delete files 
 in here. 

 If you read this immediately after reading the docs for 
 cordova.file.dataDirectory, you may think that files there do NOT survive 
 app restarts.

 Can we flesh out this a bit more perhaps?


RE: More questions on FileSystem directories

2014-06-30 Thread Ray Camden
Kerri Shotts is going to be filing one soon.

From: julio cesar sanchez jcesarmob...@gmail.com
Sent: Monday, June 30, 2014 1:44 PM
To: dev@cordova.apache.org
Subject: Re: More questions on FileSystem directories

Maybe we can wait to hear more opinios about my modification. Or you
can create the pull request and they will merge if they agree.

2014-06-30 16:44 GMT+02:00 Ray Camden rayca...@adobe.com:
 Yes, I meant that the doc for cacheDirectory implies, at least to me, that 
 the previous entry (dataDirectorry) will not persist. I think your 
 modification makes sense. Do you want to make a PR for the doc or should I?

 
 From: julio cesar sanchez jcesarmob...@gmail.com
 Sent: Monday, June 30, 2014 2:19 AM
 To: dev@cordova.apache.org
 Subject: Re: More questions on FileSystem directories

 If you read this immediately after reading the docs for
 cordova.file.dataDirectory, you may think that files there do NOT
 survive app restarts.


 Which ones, the files from dataDirectory or the files from cacheDirectory?

 If you mean dataDirectory, maybe the doc should be something like this:

 cordova.file.dataDirectory - Persistent data directory where to put
 app-specific data files. (iOS, Android)

 cordova.file.cacheDirectory - Directory for cached data files or any
 files that your app can re-create easily. The OS may delete these
 files when the device runs low on storage, nevertheless, apps should
 not rely on the OS to delete files in here. (iOS, Android)

 It's a mix from the apple
 https://developer.apple.com/library/ios/Documentation/FileManagement/Conceptual/FileSystemProgrammingGUide/AccessingFilesandDirectories/AccessingFilesandDirectories.html#//apple_ref/doc/uid/TP40010672-CH3-SW11
 and android doc
 http://developer.android.com/guide/topics/data/data-storage.html

 2014-06-29 19:08 GMT+02:00 Ray Camden rayca...@adobe.com:
 According to the docs, cordova.file.cacheDirectory is: Cached files that 
 should survive app restarts. Apps should not rely on the OS to delete files 
 in here. 

 If you read this immediately after reading the docs for 
 cordova.file.dataDirectory, you may think that files there do NOT survive 
 app restarts.

 Can we flesh out this a bit more perhaps?