Document -preloaded and Link.Create ignoring locals

Author: mkromberg

docs/API/Link.Create.md

@@ -1,7 +1,7 @@
 # Link.Create
 
 ## Syntax
-    ]LINK.Create [ns] <dirorfile> [-source={ns|dir|auto}] [-watch={none|ns|dir|both}] [-casecode] [-forceextensions] [-forcefilenames] [-arrays] [-sysvars] [-flatten] [-beforeread=<fn>] [-beforewrite=<fn>] [-getfilename=<fn>] [-codeextensions=<var>] [-typeextensions=<var>] [-fastload] [-ignoreconfig] [-text={aplan|plain}]
+    ]LINK.Create [ns] <dirorfile> [-source={ns|dir|auto}] [-watch={none|ns|dir|both}] [-casecode] [-forceextensions] [-forcefilenames] [-arrays] [-sysvars] [-flatten] [-preloaded] [-beforeread=<fn>] [-beforewrite=<fn>] [-getfilename=<fn>] [-codeextensions=<var>] [-typeextensions=<var>] [-fastload] [-ignoreconfig] [-text={aplan|plain}]
 
     message ← {options} ⎕SE.Link.Create (namespace directory)
 
@@ -113,6 +113,14 @@ A suggested workflow is to always create a stub source file in the correct direc
 
 This option takes effect only when **source** is **dir**.
 
+### **preloaded**
+Default: **off**
+
+The **preloaded** flag skips the reading of source files when creating
+links. This is useful if you have loaded a saved workspace which is known
+to contain the latest version of the source, or have materialised the
+source using other mechanisms such as shared code files.
+
 ### **caseCode**
 
 Default: **off**

docs/ReleaseNotes41.md

@@ -9,6 +9,8 @@ fixes are discussed below,
 and the [version 4.1 milestone on GitHub](https://github.com/Dyalog/link/milestone/5?closed=1) documents the full
 set of issues that are resolved by version 4.1.
 
+## Control Reformatting
+
 In addition to fixes, Link 4.1 recognises a new environment setting `ALWAYSREFORMAT`,
 which turns on automatic reformatting of all source code as it is written to source files.
 The following values are accepted:
@@ -17,6 +19,20 @@ The following values are accepted:
 * ALWAYSREFORMAT=1: Reformat using standard tab settings (4), as returned by (`61 ⎕ATX`)
 * ALWAYSREFORMAT=2: Use user-configured tab settings, as returned by `⎕CR` or `⎕NR`.
 
+## Link.Create ignores local names
+
+`Link.Create` ignores local names in calling functions when determining whether the target namespace
+is empty. This makes it much easier to write functions that load code into a workspace at the 
+start of an application. 
+
+## Link.Create -preloaded Allows Optimised Development Environments
+
+If an application uses thousands (or tens of thousands) of source files, `Link.Create` can take a
+a significant amount of time. The `-preloaded` switch allows you to build a development workspace
+using `Link.Create`, and save this workspace or export the contents a shared code file. At the start
+of a development session, you can call `Link.Create` with the `-preloaded` switch, which will
+re-establish all metadata related to the link, but skip loading the source code.
+
 ## Significant fixes
 
 ### Improved Error Messages