file.reconcileFolder
| Syntax |
file.reconcileFolder (original, clone, copyFilter)
|
| Params |
original is the full path to a folder or alias of a folder. clone is the full path to a folder or alias of a folder. copyFilter is the address of a Frontier script.
|
| Action |
Updates the clone folder so that it contains all the files in the original folder. Two passes are made. First the clone folder is traversed to see if it's missing any files in the original. Any missing files are copied into the clone. Any files or sub-folders that were modified more recently than the files in the clone are also copied. In the second pass, the clone folder is traversed to see if it contains any files or sub-folders that don't exist in the original. Those files are moved to the "Extra Files" sub-folder in the clone, which is created if it doesn't already exist. The copyFilter callback routine is passed to file.filteredCopy, allowing you to override any copying, or to create a report of any files that were copied. See the docs for file.filteredCopy for details.
|
| Returns |
True.
|
| Examples |
file.reconcileFolder ("C:\\Program Files\\Frontier\\", "D:\\Frontier\\") » true
|
| Notes |
This capability is important for any user with more than one computer, especially notebook users. file.reconcileFolder is implemented as a Frontier script, so you can examine the source code to see how it works. This verb is used in the FinderMenu package to implement the "Reconcile Folders" command. It's provided separately so that script writers can easily write custom scripts that reconcile specific pairs of folders. Matt Neuburg calls this verb "the greatest single script in the whole database."
|
| See Also |
file.filteredCopy
|
