diff --git a/unix-installation-and-configuration-guide/docs/apl-vnc-rdp.md b/unix-installation-and-configuration-guide/docs/apl-vnc-rdp.md index e357442fb7f..4c7a4a33599 100644 --- a/unix-installation-and-configuration-guide/docs/apl-vnc-rdp.md +++ b/unix-installation-and-configuration-guide/docs/apl-vnc-rdp.md @@ -1,5 +1,5 @@

Dyalog APL, RDP and VNC

-Due to the different ways that Microsoft Windows and Linux/UNIX handle keyboards, it is not possible to use RDP or VNC or X-Windows from a Windows client to control a Dyalog APL session running under a UNIX window manager. In particular, all of the X-Window clients that Dyalog is aware of do not fully support xkb key mappings. +Due to the different ways that Microsoft Windows and Linux/UNIX handle keyboards, it is not possible to use RDP or VNC from a Windows client to control a Dyalog APL session running under a UNIX window manager. It is possible to use VNC from a Linux client to connect to a remote Linux desktop and control an APL session running there; the keyboard support will however need to be added to the local machine. diff --git a/unix-installation-and-configuration-guide/docs/buildid.md b/unix-installation-and-configuration-guide/docs/buildid.md index f31481715d1..fe50ebc0a62 100644 --- a/unix-installation-and-configuration-guide/docs/buildid.md +++ b/unix-installation-and-configuration-guide/docs/buildid.md @@ -19,24 +19,28 @@ Both of these methods can be used for any file; they are useful and very fast wa At the command line: ``` -$ cd /opt/mdyalog/12.1/32/classic/p6 +$ cd /opt/mdyalog/20.0/64/Unicode $ ./BuildID dyalog -70a3446e +bce024d2 $ ./BuildID magic -0a744663 +227a0227 ``` In APL: ```apl +2 ⎕NQ '.' 'GetbuildID' 70a3446e - magicfile←'/opt/mdyalog/12.1/32/classic/p6/magic' - +2 ⎕NQ '.' 'GetBuildID' magicfile -0a744663 - )SH + magicfile←'/opt/mdyalog/20.0/64/unicode/magic' + +2 ⎕nq '.' 'GetBuildID' magicfile +227a0227 + + )sh $ echo $PPID +15323 $ kill -11 $PPID -/opt/mdyalog/12.1/32/classic/p6/mapl[58]: 274434 Segmentation fault(coredump) -$ strings -a -n14 core | grep BuildID= -BuildID=70a3446e +$ apl: syserror 999.Segmentation fault (core dumped) +$ strings -a -n14 core.15323 | grep BuildID= +BuildID=bce024d2 +BuildID=bce024d2 +$ ``` diff --git a/unix-installation-and-configuration-guide/docs/configuration-parameters/environment-variables.md b/unix-installation-and-configuration-guide/docs/configuration-parameters/environment-variables.md index c118360f77f..436bef657ab 100644 --- a/unix-installation-and-configuration-guide/docs/configuration-parameters/environment-variables.md +++ b/unix-installation-and-configuration-guide/docs/configuration-parameters/environment-variables.md @@ -29,11 +29,11 @@ Table: Commonly used Variables |TERM
APLK
APLK0
APLT
APLTn|Define the input and output translate tables used by Dyalog APL. The values of APLK0 and APLTn override the values of APLK and APLT if set, and they in turn override the value of (Unicode) *default*, or (Classic) TERM if set.

APLK is for input translation, APLT for output translation.

These are used in conjunction with ..| |`APLKEYS` `APLTTRANS`|Define the search path for the input and output translate tables respectively. If unset, the interpreter will default to `$DYALOG`; if `$DYALOG` too is not set, will default to `/usr/dyalog`.| |`APLNID`|This variable is ignored by the UNIX versions of Dyalog APL: `⎕AI` and `⎕AN` pick up their values from the user's uid and `/etc/passwd`.| -|`APLSTATUSFD`|If set, this defines the stream number on which all messages for the Status Window appear. It is then possible to redirect this output when APL is started.

If unset, the output will appear in the same terminal window as the APL session, although it is not part of the session; such output can be removed by hitting SR (Screen Redraw - often defined to be Ctrl-L).| +|`APLSTATUSFD`|If set, this defines the stream number on which all messages for the Status Window appear. It is then possible to redirect this output when APL is started.

If unset, the output will appear in the same terminal window as the APL session, although it is not part of the session; such output can be removed by hitting (Screen Redraw - often defined to be Ctrl-L).| |`DYALOG_NETCORE`|This parameter is a Boolean value with a default value of 1. If set to 0, it disables the .NET interface.| |`DYALOG_SERIAL`|This parameter contains your Dyalog serial number. This must be set to the serial number issued to you. If not set, then the software is unregistered. For the full licence terms and conditions, see [https://www.dyalog.com/uploads/documents/Terms_and_Conditions.pdf](https://www.dyalog.com/uploads/documents/Terms_and_Conditions.pdf) .| |`DYALOG_SERIALFILE`|This parameter specifies the full path to the text file containing your Dyalog serial number.| -|`ENABLE_CEF`|This parameter is a Boolean value with a default value of 1. If set to 0, it disables the [Chromium Embedded Framework (CEF)](https://en.wikipedia.org/wiki/Chromium_Embedded_Framework) and at attempt to create an HTMLRenderer object (see [HTMLRenderer](../../../object-reference/objects/htmlrenderer)) will fail with an error message. See Note (below).| +|`ENABLE_CEF`|This parameter is a Boolean value with a default value of 1. If set to 0, it disables the [Chromium Embedded Framework (CEF)](https://en.wikipedia.org/wiki/Chromium_Embedded_Framework) and an attempt to create an HTMLRenderer object (see [HTMLRenderer](../../../object-reference/objects/htmlrenderer)) will fail with an error message. See Note (below).| |`ERRORONEXTERNALEXCEPTION`|By default, any error when calling `⎕NA` will result in APL terminating; if `ERRORONEXTERNALEXCEPTION` is set to 1, then APL will instead generate an event 91: `EXTERNAL DLL EXCEPTION` . Be aware however that the workspace may become corrupted. This is best used when developing `⎕NA` code rather than in production.| |`LIBPATH`|A suitable entry for the Conga libraries needs to be added to the `LIBPATH` variable if Conga is to be used. For more information see the *Conga Guide*.| |`MAXWS`|Defines the size of the workspace that will be presented to the user when Dyalog APL is started. A simple integer value will be treated as being in KB. K, M and G can be appended to the value to indicate KiB, MiB and GiB (binary) respectively. If unset, the default value is 256M.| @@ -91,7 +91,7 @@ Table: Miscellaneous Variables used by non-GUI Dyalog APL |---|---| |Variable|Notes| |`APL_TEXTINAPLCORE`|If set with the value 1 the "Interesting Information" section is included in an aplcore file. Otherwise this section is omitted. By default the interpreter has this set to 0; it is the default APL script which sets it to 1.| -|`AUTOFORMAT` `TABSTOPS`|If `AUTOFORMAT` is 1, then control structures will be shown with indents, set at `TABSTOPS` spaces; the changes are reflected in the editor window when the `RD` (ReDraw) command key is hit.| +|`AUTOFORMAT` `TABSTOPS`|If `AUTOFORMAT` is 1, then control structures will be shown with indents, set at `TABSTOPS` spaces; the changes are reflected in the editor window when the key is hit.| |`AUTOINDENT`|If `AUTOINDENT` is set to 1, then if a line is added it is indented the same as the previous line.| |`AUTO_PW`|Introduced in 13.0. With `AUTO_PW=0` `⎕PW` remains fixed at the size of the terminal window when APL was started. When set to 1, or unset, `⎕PW` alters each time the terminal window is resized.| |`DYALOG`|This variable is defined in the supplied `mapl` startup script, and is used to form the default values for `APLKEYS`, `APLTRANS`, `WSPATH` etc. If it is necessary to identify the location of the Dyalog executable, then a more reliable method is to determine the full path name from the appropriate file in the `/proc//` subdirectory or from the output of `ps`.| diff --git a/unix-installation-and-configuration-guide/docs/configuring-the-editor.md b/unix-installation-and-configuration-guide/docs/configuring-the-editor.md index 5238f5c8648..b5d4b99f582 100644 --- a/unix-installation-and-configuration-guide/docs/configuring-the-editor.md +++ b/unix-installation-and-configuration-guide/docs/configuring-the-editor.md @@ -64,41 +64,10 @@ EDITOR_COLUMNS_NAMESPACE=94 shows all columns (the first example in this section Various values for EDITOR_COLUMNS_FUNCTION - - - - - - - - - - - - - - - - - - - - - - - - - -
ValueEditor window appearance
0
fn1 a
-:If a=1
-    b←2
-:EndIf
22
[0] fn1 a
-[1] :If a=1
-[2] ○   b←2
-[3] :EndIf
26
   fn1 a
- ├ :If a=1
-○│     b←2
- ├ :EndIf
40
[0]    fn1 a
-[1]  ├ :If a=1
-[2] ○│     b←2
-[3]  ├ :EndIf
+|Value|Editor window appearance| +|-----|------------------------| +|0 |

 fn1 a
 :If a=1 
     b←2
 :EndIf
| +|22 |
[0]   fn1 a
[1]   :If a=1 
[2] ○     b←2
[3]   :EndIf
| +|26 |
   fn1 a
 ├ :If a=1 
○│     b←2
 ├ :EndIf
| +|30 |
[0]    fn1 a
[1]  ├ :If a=1
[2] ○│     b←2
[3]  ├ :EndIf
| + diff --git a/unix-installation-and-configuration-guide/docs/installation.md b/unix-installation-and-configuration-guide/docs/installation.md index 268542d7ee5..395487f06f6 100644 --- a/unix-installation-and-configuration-guide/docs/installation.md +++ b/unix-installation-and-configuration-guide/docs/installation.md @@ -16,48 +16,44 @@ or, in the case of AIX: /opt/mdyalog/{{ version_majmin }}/// ``` -So for example, Dyalog APL Version {{ version_majmin }} 32 bit Unicode for POWER6 hardware on AIX will by default be installed into +So for example, Dyalog APL Version {{ version_majmin }} 64 bit Unicode for POWER9 hardware on AIX will by default be installed into ```apl -/opt/mdyalog/{{ version_majmin }}/32/unicode/p6 +/opt/mdyalog/{{ version_majmin }}/64/unicode/p9 ``` whereas on a Linux distribution the equivalent version would be installed in ```apl -/opt/mdyalog/{{ version_majmin }}/32/Unicode +/opt/mdyalog/{{ version_majmin }}/64/Unicode ``` -This naming convention began with Version 12.0, and is planned to continue into the future. This ensures that all versions and releases of Dyalog APL can be installed in parallel. +This naming convention ensures that all versions and releases of Dyalog APL can be installed in parallel. As part of installing Dyalog on Linux (including Pi) the script /usr/bin/dyalog is created; this is a copy of the $DYALOG/mapl script and can be used to start Dyalog APL. Note that this script will start the most recently installed version of Dyalog APL. This script is used in the target of the Dyalog APL icon on Linux desktops. If preferable, Dyalog can be started by calling the script mapl in the appropriate Dyalog installation directory. When supplying updates or fixes, Dyalog issues a full installation image; this means that any file under the installation subdirectory may be overwritten. It is therefore strongly recommended that users do not alter issued files, as those changes could be lost if an update is installed. -Dyalog APL version -{{ version_majmin }} for Linux is supplied as a zip file which contains both a .deb- and a .rpm-based installation image. - ## Installing under AIX -For each version of Dyalog APL on AIX three separate hardware-specific builds are created for each of the four combinations of 32 or 64 bit versions, Classic or Unicode editions. For version {{ version_majmin }} specific builds for p5, p6 and p7 are created. +For each version of Dyalog APL on AIX, separate hardware-specific builds are created for each of the four combinations of 32 or 64 bit versions, Classic or Unicode editions. For version {{ version_majmin }} specific builds for p9 are created. ```apl $ su - # cd /opt -## cpio -icdvum Example ``` -$ file -m /opt/mdyalog/{{ version_majmin }}/32/classic/p6/magic * -1_apl_j1: Dyalog APL component file 64-bit level 1 journaled non-checksummed -1_apl_j2: Dyalog APL component file 64-bit level 2 journaled checksummed -1_apl_qfile: Dyalog APL component file 64-bit non-journaled non-checksummed -1_big1: Dyalog APL component file 64-bit level 2 journaled checksummed -1_big2: Dyalog APL component file 64-bit level 1 journaled checksummed -apl64u: Dyalog APL workspace type 12 subtype 4 64-bit unicode big-endian -aplout: Dyalog APL workspace type 12 subtype 0 32-bit classic little-endian -aplcore: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -colours: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -core: data or International Language text -signals: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -utf8: Dyalog APL workspace type 12 subtype 4 32-bit unicode little-endian +$ file -m /opt/mdyalog/{{ version_majmin }}/64/unicode/p9/magic * +apl64u.dws: Dyalog APL workspace type 20 subtype 14 64-bit unicode big-endian +aplcore: Dyalog APL aplcore +j1c0.dcf: Dyalog APL component file 64-bit level 1 journaled non-checksummed +j1c1.dcf: Dyalog APL component file 64-bit level 1 journaled checksummed +j2c1.dcf: Dyalog APL component file 64-bit level 2 journaled checksummed ``` ### magic and Linux -Most Linux distributions include details about Dyalog-related files in their magic files; Dyalog has submitted two versions of the magic file for inclusion in distributions. To check whether your Linux distribution has the more recent version, create a journaled component file and then run the file command against that component file. The two examples below show the output with the earlier and later versions of magic in use. - -## Example, using the older default magic file -``` -$ file * -1_apl_j1: data -1_apl_j2: data -1_apl_qfile: data -1_big1: data -1_big2: data -apl64u: \012- Dyalog APL\012- workspace\012- version 12\012- .4 -aplout: \012- Dyalog APL\012- workspace\012- version 12\012- .0 -aplcore: \012- Dyalog APL\012- workspace\012- version 12\012- .4 -colours: \012- Dyalog APL\012- workspace\012- version 12\012- .4 -core: ELF 32-bit LSB core file Intel 80386, version 1 (SYSV), SVR4-style -signals: \012- Dyalog APL\012- workspace\012- version 12\012- .4 -utf8: \012- Dyalog APL\012- workspace\012- version 12\012- .4 -``` +Most Linux distributions include details about Dyalog-related files in their magic files. ### Example, with more recent magic file ``` $ file * -1_apl_j1: Dyalog APL component file 64-bit level 1 journaled non-checksummed -1_apl_j2: Dyalog APL component file 64-bit level 2 journaled checksummed -1_apl_qfile: Dyalog APL component file 64-bit non-journaled non-checksummed -1_big1: Dyalog APL component file 64-bit level 2 journaled checksummed -1_big2: Dyalog APL component file 64-bit level 1 journaled checksummed -apl64u: Dyalog APL workspace type 12 subtype 4 64-bit unicode big-endian -aplout: Dyalog APL workspace type 12 subtype 0 32-bit classic little-endian -aplcore: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -colours: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -core: ELF 32-bit LSB core file Intel 80386, version 1 (SYSV), SVR4-style, from '/opt/mdyalog/14.0/32/classic/dyalog' -signals: Dyalog APL workspace type 12 subtype 4 32-bit classic little-endian -utf8: Dyalog APL workspace type 12 subtype 4 32-bit unicode little-endian +apl64u.dws: Dyalog APL workspace 64-bit unicode big-endian version 20.14 +aplcore: Dyalog APL aplcore version 20.14 +j1c0.dcf: Dyalog APL component file 64-bit level 1 journaled non-checksummed version 20.0 +j1c1.dcf: Dyalog APL component file 64-bit level 1 journaled checksummed version 20.0 +j2c1.dcf: Dyalog APL component file 64-bit level 2 journaled checksummed version 20.0 ``` The most recent version of the magic file can be found in the top level of the installation directory; see the man page for the file command for details of how to update the system magic file, or use the syntax described in the /etc/magic and AIX section above to override the default magic file with the one supplied in the installation directory. diff --git a/unix-installation-and-configuration-guide/docs/miscellaneous.md b/unix-installation-and-configuration-guide/docs/miscellaneous.md index d3454793122..2a52416b48b 100644 --- a/unix-installation-and-configuration-guide/docs/miscellaneous.md +++ b/unix-installation-and-configuration-guide/docs/miscellaneous.md @@ -4,7 +4,7 @@ By default the session logfile is called default.dlf. By default this file is cr ## Status window output -By default under UNIX what would appear in the status window in the GUI versions appears in the same terminal window as the APL session, but the text is not part of the session. If such text appears, the APL session can be redrawn using the SR command, thus removing the status window text. +By default under UNIX what would appear in the status window in the GUI versions appears in the same terminal window as the APL session, but the text is not part of the session. If such text appears, the APL session can be redrawn using the command, thus removing the status window text. It is possible to redirect the status window output; to do so select an unused stream number as the stream have the status window output appear on, and then redirect that stream. Note that it will be necessary to associate a valid output translate table (usually apltrans/file) with that stream. diff --git a/unix-installation-and-configuration-guide/docs/quadna.md b/unix-installation-and-configuration-guide/docs/quadna.md index 85274f81cdc..f06edd36cdb 100644 --- a/unix-installation-and-configuration-guide/docs/quadna.md +++ b/unix-installation-and-configuration-guide/docs/quadna.md @@ -24,7 +24,7 @@ On Linux, it is a little more difficult to location the libc.so file; the functi ### Definitions -In the remainder of this section references are made to the APL variables `sharedlib` and `dyalib`; the definitions for both vary between AIX and Linux, and between 32 and 64 bit interpreters. +In the remainder of this section references are made to the APL variables `sharedlib` and `dyalib`; the definitions for both vary between AIX and Linux, and between 32 and 64 bit interpreters. Under AIX, `sharedlib` is defined as: ```apl