Skip to content

Commit dd67bfc

Browse files
committed
Clarify why ignoring local names on Create is important
1 parent c059065 commit dd67bfc

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

docs/ReleaseNotes41.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,15 +21,17 @@ The following values are accepted:
2121

2222
## Link.Create ignores local names
2323

24-
`Link.Create` ignores local names in calling functions when determining whether the target namespace
25-
is empty. This makes it much easier to write functions that load code into a workspace at the
26-
start of an application.
24+
`Link.Create` ignores calling functions and names localised by such functions when determining whether the target namespace is empty.
25+
This makes it much possible to a write a startup function that creates a link to the root namespace (`#`) when an application starts.
26+
27+
Ealier versions of Link would complain that the target namespace
28+
is not empty.
2729

2830
## Link.Create -preloaded Allows Optimised Development Environments
2931

3032
If an application uses thousands (or tens of thousands) of source files, `Link.Create` can take a
3133
a significant amount of time. The `-preloaded` switch allows you to build a development workspace
32-
using `Link.Create`, and save this workspace or export the contents a shared code file. At the start
34+
using `Link.Create`, and save this workspace or export the contents to a shared code file. At the start
3335
of a development session, you can call `Link.Create` with the `-preloaded` switch, which will
3436
re-establish all metadata related to the link, but skip loading the source code.
3537

0 commit comments

Comments
 (0)