Re: Stale URL bookmarks?

2013-08-14 Thread Tom Harrington
On Tue, Aug 13, 2013 at 10:08 PM, Quincey Morris 
quinceymor...@rivergatesoftware.com wrote:

 On Aug 13, 2013, at 19:20 , Tom Harrington atomicb...@gmail.com wrote:

 What does stale mean in this context? And if the bookmark is stale, what
 if anything should I do (or not do) in response to that?


 Stale means that the referenced file could not be found using the
 explicit information in the bookmark (such as the parent directory and file
 name), but a plausible alternative *could* be found by assuming information
 that's either not in the bookmark or that contradicts what's in the
 bookmark.

 For example, if the file was renamed, and the bookmark has recorded the
 file system node number, the original file could be be found via the file
 number. However, it now has a conflicting name, even though bookmark
 resolution has decided it's the same file.

 Now imagine, for example, that the file is accidentally deleted and then
 restored from a backup, under the newest name. It will likely have a
 different file number and the original bookmark will now be unresolvable.

 When you're told that a bookmark is stale, you're being warned that file
 metadata has changed, and that further metadata changes may break the
 bookmark. That gives you the opportunity to re-create the bookmark using
 the latest metadata, rendering the bookmark more tolerant to future
 metadata changes.

 You can choose to re-create the bookmark or not. The upside to doing so is
 that your bookmark may more robustly follow a series of file metadata
 changes. OTOH you may not want to have your bookmark cling to files that
 are moved or renamed.


Thanks for the detailed explanation, just what I needed.

-- 
Tom Harrington
atomicb...@gmail.com
AIM: atomicbird1
___

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to arch...@mail-archive.com

Stale URL bookmarks?

2013-08-13 Thread Tom Harrington
When resolving a URL bookmark, one of the options is a BOOL * that on
return tells you if the bookmark data is stale.

What does stale mean in this context? And if the bookmark is stale, what
if anything should I do (or not do) in response to that?

-- 
Tom Harrington
atomicb...@gmail.com
AIM: atomicbird1
___

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to arch...@mail-archive.com

Re: Stale URL bookmarks?

2013-08-13 Thread Quincey Morris
On Aug 13, 2013, at 19:20 , Tom Harrington atomicb...@gmail.com wrote:

 What does stale mean in this context? And if the bookmark is stale, what
 if anything should I do (or not do) in response to that?

Stale means that the referenced file could not be found using the explicit 
information in the bookmark (such as the parent directory and file name), but a 
plausible alternative *could* be found by assuming information that's either 
not in the bookmark or that contradicts what's in the bookmark.

For example, if the file was renamed, and the bookmark has recorded the file 
system node number, the original file could be be found via the file number. 
However, it now has a conflicting name, even though bookmark resolution has 
decided it's the same file.

Now imagine, for example, that the file is accidentally deleted and then 
restored from a backup, under the newest name. It will likely have a different 
file number and the original bookmark will now be unresolvable.

When you're told that a bookmark is stale, you're being warned that file 
metadata has changed, and that further metadata changes may break the bookmark. 
That gives you the opportunity to re-create the bookmark using the latest 
metadata, rendering the bookmark more tolerant to future metadata changes.

You can choose to re-create the bookmark or not. The upside to doing so is that 
your bookmark may more robustly follow a series of file metadata changes. OTOH 
you may not want to have your bookmark cling to files that are moved or renamed.

___

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to arch...@mail-archive.com