Link.Resync
]LINK.Resync
msg ← {opts} ⎕SE.Link.Resync ⍬
Link.Resync
will re-synchronise your workspace and source directories. It is the best way to resume work if you have used Link.Pause to temporarily stop watching the file system, or you have loaded a checkpoint workspace that might contain obsolete code, or you have any other reason to suspect that the contents of the active workspace no longer match the source directories.
If you had previously used Link.Pause, your links will no longer be in a paused state following a Resync - unless you explicitly set the pause=yes
option.
WARNING: Resync is one of the most recent items of functionality added to Link, and should be considered somewhat experimental in Link 3.0. While this is the case, the default value for the confirm
option will be list
, which means that Resync will display output documenting the updates that it intends to make. If there are any outstanding differences, you need to explicitly set confirm=yes
to execute the synchronisation.
The current plan is that, once Resync reaches maturity, the default will become confirm=yes
, and an optional Crawler will become available. The Crawler will run Resync in the background, from time to time, to keep. It is likely that this will happen in Link version 3.1, hopefully during the summer of 2021.
Arguments
- Currently unused, reserved for future enhancements
Options
- confirm
Whether to execute the synchronisation, list the changes required, or both. -
list
means that a list of actions that would be performed will be displayed. -yes
means that the actions will be performed. -copy
means that the actions will be performed and the list of actions will also be returned.Defaults to
list
in 3.0, this is expected to change in Link 3.1.
- pause
Whether the link should be in a paused state following the resync.
Defaults to
no
.
Result
- String describing the changes made, if requested.