Skip to content

Link.Refresh

]LINK.Refresh <ns> [-source={ns|dir|auto}]

msg ← {opts} ⎕SE.Link.Refresh ns

Refresh will break and re-create a link by using one one side of the link as source, and bringing the other side into line.

BEWARE: Refresh has the potential to lose changes: if there are un-synchronised changes on both sides of the link, then Refresh will destroy one set of changes (the non-source side will be overwritten by the source side). Link.Resync provides better control, allowing you to review the differences before selecting how they should be resolved, and is now recommended in place of Refresh in most scenarios.

Refresh is useful when you have decided not to watch one side of a link, but now want to pick up any changes that have occurred:

  • To bring the workspace into line with the source directories, use source=dir.
  • If you have made changes to linked namespaces using other mechanisms than the editor (such as using ⎕FIX, ⎕FX, ⎕NS, ⎕CY or assignment), you can Refresh with source=ns to update the directory.

Arguments

  • namespace(s)

Options

  • source {ns|dir|auto}

    Whether to consider the ns or dir as the source for the link. - dir means that items in the namespace will be overwritten by items in files. - ns means that items in files will be overwritten by items in the namespace. - auto re-uses the same source that was determined at Create time.

    The default is to use the setting that was specified at creation (auto).

Result

  • String describing the established link, along with possible failures