Dyalog APL V21.0 Issue 1 READ ME FIRST

• Summary
• Documentation
• Notable Fixes

• Dyalog APL 21.0 onwards is not supported on 32-bit Raspberry Pi O/S; 64-bit Raspberry Pi O/S is supported; you must use the Dyalog APL for Linux/ARM64 version instead, which can be downloaded from my.dyalog.com rather than packages.dyalog.com
• You can no longer write to non-journalled, non-checksummed ("J0CO") component files
• Dyalog has announced that within the next few versions support for external variables will be withdrawn. If you would like to see what impact this will have on your applications, you can set DYALOG_EXTVAR_SUPPORTED=0; when set to 0 all calls to ⎕xt will generate a SYNTAX ERROR. The default is 1; external variables are enabled. The deprecated features feature (109⌶ etc) already supports identifying calls to ⎕xt
• For Windows users, information about the layout of dockable items in the session is now saved in a binary layout file (defaults to default.layout but can be overridden by setting the configuration parameter LAYOUT_FILE). In addition, a "Layout" menu has been added to the session menubar which allows you to select some pre-defined layouts. Note that layout files are specific to each interpreter and cannot be used with a different version/width/edition
• Version 21.0 for Windows includes experimental support for dark mode. We are keen to have feedback on the new mode from users who have applications that they would like to try to create a dark mode for. For instructions on how to enable dark mode, please send a message to darkmode@dyalog.com, briefly describing the experiments that you intend to perform. Note that this feature is still under development. The implementation (and thus the appearance of individual elements) may change at any time throughout the life of Version 21.0.
• In v20.0 we introduced a new font, APL387 (see New APL Font); to complete the set there is now a proportional equivalent, APL335. It is included in all 21.0 installation images, and is subject to the same licencing terms as APL385
• Changes have been made to the thread handling code in preparation for new features in future releases, and to improve thread handling; these changes are not visible to the end user. We would be very grateful therefore if you could test all of your code which uses multiple threads and report any issues to us.
  If you set a log file for deprecations by calling 109⌶ then additional information about thread handling may appear in the log file; we would again appreciate it if you could send us all such information in the log file.
  The APL thread scheduler checks that its own record of each thread's scheduling status is consistent. 4061⌶0 returns a two-element vector: the number of inconsistent thread statuses and the number of missed thread wakeups that have been detected. A non-zero count means that the interpreter detected an inconsistency in its own scheduling, not that the application is at fault. Note that this I_beam is very much temporary! Additionally if logging via 109⌶ has been enabled, then entries will appear in the log each time one of these inconsistenacies is detected; if logging has not been enabled, then a message will be printed to the status window on the first time only.

The online documentation can be found at https://docs.dyalog.com/21.0/.

ID	Description
2626	⍋ of N identical DateTime .NET objects should be like in APL and return ⍳N
5016	With "confirm before overwrite" selected in Keyboard shortcuts, should not be asked if there's nothing already defined
13837	<AO> inserts first comment symbol at beginning of selection instead of beginning of first (partially selected) line
16630	Grid comments are not DPI scaled correctly
16656	Syserror getting or setting an OLE property if you copy a workspace which contains a saved OLEClient object
17845	:EndSection cannot be abbreviated to :End in either the session or in a function - a SYNTAX ERROR will be signalled
18421	Rank operator generates a NONCE ERROR in this expression {⎕NS ⍬}⍤¯1⊢⍳0
18553	⎕THIS not understood by ⎕NC nor ⎕NS nor ⎕WG nor ⎕ATX
18621	cannot fix script of several functions if only one is defined
19130	Non-Windows: ⎕DMX.(InternalLocation Message) fields are mangled when saved in classic and then loaded in unicode
20657	When running from Ride, calls to ⎕NEW System.DateTime result in errors appearing in the session rather than the status Window
21572	HTMLRenderer WebSocketUpgrade does not happen unless you add a ⎕DL delay
21693	Disable ⎕ED in shell scripts
21778	Stack is inappropriately cut when executing modified assignment with derived modifier containing a dfn operand
21787	Misplaced caret on error in :If statement
22469	Cannot see what has been typed into ⎕SR ⎕SM form on Mac until you press enter
22470	Cannot exit the ⎕SM form screen on Mac if use ⎕SR
22475	Bind should give a better error message when the target file is not writeable
22521	Rank operator (⍤) allows propagation of prototypical namespaces
22574	Syntax colouring of combined dfn and arraynotation is incorrect
22597	Inconsistencies in assignments during inline tracing
22609	Improve DMX error message for when @ is incorrectly given a function right operand which does not return a boolean result
22659	Inline tracing, with 'trace idioms' on, does not trace into optimised forms in the rank operator
22661	200⌶,⊂'{a}←foo' returns '}' rather than '{' (201⌶output) for the opening brace
22678	Syntax colouring of dfns/dops/mops does not update as ⍺⍺ and ⍵⍵ are added or removed from the text
22737	Stencil optimised form {E cmp +/⍪A×⍤2⊢⍵}⌺ erroneously RANK ERRORs when E is a vector
22762	(∧⌿2 0⍴0)≤0J1 (and others) incorrectly DOMAIN ERROR
22763	Left argument to left operand of ⌺ is not always a vector
22779	A config "file" name which is a directory causes a segfault / AIX can erroneously generate a config file name as a directory
22787	Stencil special case {⍵}⌺ gives wrong result on nested vector ⍵ with ⎕ML←2
22795	⎕CSV drops imaginary part of complex numbers
22852	00429 Better support for IDE Classic Mode
22854	A Form docked in the session does not dock correctly after a session save and load
22878	JSON strings (generated using 1∘⎕JSON or other places where the interpreter generates JSON) should not contain non-Unicode chars
22882	We need a magic number for session layout files, which are new binary files in 21.0
22925	⎕JSON should not demangle names from matrix representation
22933	⎕USING←'System' ⋄ ValueTuple.Create () causes a syserror 999 on linux
22966	Clean up raw text injection in ⎕JSON
22971	SYNTAX ERROR when pass-through value of assignment is used as value in array notation in dfn
22983	Dyalog not yet tolerant to moving Documents directory (Windows; v21.0 project 00433)
22985	Make ⎕JSON tolerant of invalid surrogate pairs in string escape sequences
22998	Inconsistent behaviour of editor on dfn2 in # which is a copy of #.ns.dfn
23077	⎕CSV trims escaped whitespace, contrary to its documentation
23123	Heap buffer over-reads in the JSON Parser Helper