Link.Create

Arguments

• name of or ref to namespace
• dir path

Options

• source { ns|dir|both}

​ Whether to consider the ns or dir as the source (both will synchronise) ​ Defaults to "both" except when linking #, when it must be specified ​ NB: "both" will first copy from ns to dir, and then the other way

• watch {none|ns|dir|both} (after initial copying, default=both where supported, else ns)

​ Watching a dir is currently only supported under Microsoft Windows

• codeExtensions File extensions considered to be APL source code.

          Note that customExtensions can add to this list if beforeRead and
          beforeWrite are used to add handlers for custom file formats.
  

  • default is 'aplf' 'aplo' 'apln' 'aplc' 'apli' 'dyalog' 'apl' 'mipage'

• flatten (default off) Loads everything into ns without creating sub-namespaces (default=off).

          If Link is to be able to manage new names when flatten is set, the beforeWrite
          setting should be used to specify a function which will determine where to store new code.
  

• caseCode (default off) filename followed by octal encoding of reverse per-letter case

• forceExtensions (default off) flag to normalise extensions on import

• forceFilenames (default off) flag to normalise filenames on import

• typeExtensions default:

  Type	extension
  2	apla
  3	aplf
  4	aplo
  9.1	apln
  9.4	aplc
  9.5	apli

• beforeWrite ns.hookname name of function to call before writing to file

  • Arguments
    • filename
    • source
    • item name
    • old name
    • container ns
    • item ⎕NC (with decimal)
    • ref to ⎕SE.Link.Links[n]
    • File name request? 0/1
  • Results
    • 0 Don't proceed. All done; don't do anything
    • 1 Do proceed as you do normally do
    • If file name request: 'filename.ext'

• beforeRead ns.hookname name of function to call before before reading a file

  • Arguments
    • filename
    • path
    • target ns
    • ref to ⎕SE.Link.Links[n]
    • Item name request? 0/1
  • Results
    • 0 Don't proceed. All done; don't do anything
    • 1 Do proceed as you do normally do
    • If item name request: 'ns.itemname'

• customExtensions Additional extensions handled by beforeRead & beforeWrite functions

  • default is '' - no custom extensions supported

Result

• messages: matrix if linking was successful, vector if not