From 3a7d0cbff082b6c8d3101c7d433c3e778a76b998 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 19:37:02 +0100 Subject: [PATCH 01/37] Scaffold the Dyalog Configuration Guide subsite Add a new cross-platform guide subsite dyalog-configuration-guide/ (mkdocs.yml at version 21.0, About page) and register it under a new "Cross-platform Environment" category in the root nav, after "Core Reference". Implements abrudz/documentation#5 and abrudz/documentation#6. Part of Dyalog/documentation#719 (Step One). --- dyalog-configuration-guide/docs/index.md | 10 +++++ dyalog-configuration-guide/mkdocs.yml | 55 ++++++++++++++++++++++++ mkdocs.yml | 2 + 3 files changed, 67 insertions(+) create mode 100644 dyalog-configuration-guide/docs/index.md create mode 100644 dyalog-configuration-guide/mkdocs.yml diff --git a/dyalog-configuration-guide/docs/index.md b/dyalog-configuration-guide/docs/index.md new file mode 100644 index 00000000000..fb180ca12d9 --- /dev/null +++ b/dyalog-configuration-guide/docs/index.md @@ -0,0 +1,10 @@ +--- +search: + exclude: true +--- + +# About + +The _Dyalog Configuration Guide_ describes how Dyalog is configured across operating systems. It explains how configuration parameters are set and the order of precedence between the different sources, the configuration files that Dyalog reads, and it provides a reference page for each configuration parameter, noting any differences between operating systems. + +Assumed knowledge: A basic understanding of Dyalog APL and of the operating system in use. diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml new file mode 100644 index 00000000000..023d0aa3765 --- /dev/null +++ b/dyalog-configuration-guide/mkdocs.yml @@ -0,0 +1,55 @@ +site_name: Dyalog Configuration Guide +theme: + favicon: documentation-assets/images/favicon-32.png + logo: documentation-assets/images/dyalog-logo_white.svg + features: + - navigation.instant + - navigation.tracking + - navigation.path + - navigation.indexes + - navigation.footer + name: material + font: + text: Be Vietnam Pro +extra_css: + - documentation-assets/css/main.css + - documentation-assets/css/extra.css +extra_javascript: + - javascripts/mathjax.js + - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js +plugins: + - privacy + - search + - macros + - site-urls + - caption: + table: + enable: true + start_index: 1 + increment_index: 1 + position: top + reference_text: 'Table {index}' + caption_prefix: 'Table {index}:' +extra: + version_maj: 21 + version_majmin: "21.0" +markdown_extensions: + - admonition + - pymdownx.details + - pymdownx.keys + - pymdownx.superfences + - pymdownx.highlight: + pygments_lang_class: true + - pymdownx.arithmatex: + generic: true + - pymdownx.highlight: + use_pygments: false + - attr_list + - abbr + - footnotes + - md_in_html + - markdown_tables_extended + - toc: + title: On this page +nav: + - index.md diff --git a/mkdocs.yml b/mkdocs.yml index 97e1608424a..a9ac4cd3730 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,6 +79,8 @@ nav: - 'Core Reference': - 'Dyalog APL Language': "!include ./language-reference-guide/mkdocs.yml" - 'Programming': "!include ./programming-reference-guide/mkdocs.yml" + - 'Cross-platform Environment': + - 'Configuration': "!include ./dyalog-configuration-guide/mkdocs.yml" - 'Code Tooling': - '.NET Interface': "!include ./dotnet-interface-guide/mkdocs.yml" - 'Compiler': "!include ./compiler-user-guide/mkdocs.yml" From 4f70cc7d6c20a12a9f6f25375c2e2aa2fed48956 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 19:57:49 +0100 Subject: [PATCH 02/37] Add Introduction and How to Set Configuration Parameters section Add the Introduction page and the "How to Set Configuration Parameters" section (Overview, Order of Precedence, Command Line, Application Configuration Files, Environment Variables, User Configuration Files, Windows Registry, Built-in Defaults, and Configuration File Structure), synthesised from the Windows and Unix Installation & Configuration guides so the precedence and file-format material is stated once, cross-platform. Implements abrudz/documentation#7 and abrudz/documentation#8. Part of Dyalog/documentation#719 (Step One). --- .../application-configuration-files.md | 16 ++++++ .../docs/how-to-set/built-in-defaults.md | 5 ++ .../docs/how-to-set/command-line.md | 7 +++ .../configuration-file-structure.md | 57 +++++++++++++++++++ .../docs/how-to-set/environment-variables.md | 8 +++ .../docs/how-to-set/order-of-precedence.md | 15 +++++ .../docs/how-to-set/overview.md | 14 +++++ .../docs/how-to-set/registry.md | 10 ++++ .../how-to-set/user-configuration-files.md | 18 ++++++ .../docs/introduction.md | 9 +++ dyalog-configuration-guide/mkdocs.yml | 11 ++++ 11 files changed, 170 insertions(+) create mode 100644 dyalog-configuration-guide/docs/how-to-set/application-configuration-files.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/built-in-defaults.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/command-line.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/environment-variables.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/overview.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/registry.md create mode 100644 dyalog-configuration-guide/docs/how-to-set/user-configuration-files.md create mode 100644 dyalog-configuration-guide/docs/introduction.md diff --git a/dyalog-configuration-guide/docs/how-to-set/application-configuration-files.md b/dyalog-configuration-guide/docs/how-to-set/application-configuration-files.md new file mode 100644 index 00000000000..f3833475db3 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/application-configuration-files.md @@ -0,0 +1,16 @@ +# Application Configuration Files + +An *application configuration file* holds the configuration values associated with a specific application. It is created by the user and is normally stored alongside the application. + +When Dyalog starts, it derives the name of the application configuration file as follows: + +- the name given in the **ConfigFile** parameter, if it is set; otherwise +- the name of the workspace or script loaded at start-up (through the **Load** parameter) with its extension replaced by `.dcfg`, if that file exists; otherwise +- no application configuration file is used. + +An application configuration file setting overrides an environment variable, a user configuration file, the Registry, and the built-in default (see [Order of Precedence](order-of-precedence.md)). + +Configuration files use JSON5 (a superset of JSON) syntax and are portable across all platforms that Dyalog supports. Both application and user configuration files can *cascade*: a file can extend another with the `Extend` key, inheriting its settings and optionally overriding them. For the file format, cascading, arrays, and references between parameters, see [Configuration File Structure](configuration-file-structure.md). + +!!! Warning "Warning" + Although user credentials such as login details or passwords can be placed in a configuration file, Dyalog strongly recommends against this, even when the credentials are encrypted, as it is a significant security risk. diff --git a/dyalog-configuration-guide/docs/how-to-set/built-in-defaults.md b/dyalog-configuration-guide/docs/how-to-set/built-in-defaults.md new file mode 100644 index 00000000000..714b7da3cc4 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/built-in-defaults.md @@ -0,0 +1,5 @@ +# Built-in Defaults + +Every configuration parameter has a built-in default that the interpreter uses when the parameter is not set by any other source. The built-in default therefore has the lowest precedence (see [Order of Precedence](order-of-precedence.md)). + +A parameter's default can differ between operating systems. Each parameter's own page states its default, and notes any per-platform differences. diff --git a/dyalog-configuration-guide/docs/how-to-set/command-line.md b/dyalog-configuration-guide/docs/how-to-set/command-line.md new file mode 100644 index 00000000000..9bf9edf4a06 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/command-line.md @@ -0,0 +1,7 @@ +# Command Line + +A configuration parameter can be set on the command line that starts Dyalog, by giving the parameter name and its value. A command line setting takes precedence over every other source (see [Order of Precedence](order-of-precedence.md)), which makes it convenient for temporarily overriding a value defined elsewhere. + +For example, a usual workspace size can be defined in a [user configuration file](user-configuration-files.md) through the **MAXWS** parameter and then superseded for a single Session by giving a different **MAXWS** on the command line. + +Parameter names given on the command line are not case-sensitive. diff --git a/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md new file mode 100644 index 00000000000..05127d9051e --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md @@ -0,0 +1,57 @@ +# Configuration File Structure + +Both [application](application-configuration-files.md) and [user](user-configuration-files.md) configuration files use JSON5 (a superset of standard JSON) syntax, and are portable across all platforms that Dyalog supports. A file can be written directly or produced by `⎕JSON` (which supports JSON5). + +A JSON object holds data as key/value pairs and other JSON objects. A key and its value are separated by a colon (`:`); entries are separated by commas (`,`). + +The top-level object defines an optional key `Extend` and an optional object `Settings`: + +- `Extend` is a string naming another configuration file to import. The imported file can itself extend a further file. Imported values can be overridden by redefining them. The file name is relative to the file that imports it, and any extension must be given explicitly. +- `Settings` is an object holding configuration parameter names and their values. A value can be a string, a number, or an array of strings. Names are not case-sensitive. + +If the same name is defined more than once within a file, the first definition is used and a warning is generated. + +

Example

+```apl +{ + Extend: "my_default_configuration.dcfg", + Settings: { + // maximum workspace + MAXWS: "2GB", + WSPATH: ["/dir1", "/dir2", ""], + UserOption: 123, + ROOTDIR: "/my/root/directory", + // reference to another configuration parameter + FNAME: "[rootdir]/filename", + } +} +``` + +## Arrays + +A value can be an array of strings, used mainly for file paths, for example `WSPATH: ["/dir1", "/dir2"]`. The only parameters that can be defined as arrays are **WSPATH**, **WSEXT**, and **CFEXT**. + +## References to Other Configuration Parameters + +A string value can refer to another configuration parameter, wherever it is defined, using square-bracket delimiters. For example, `MySetting: "[DYALOG]/MyFile"` replaces `[DYALOG]` with the value of the **DYALOG** parameter. If the string inside the brackets is `.`, it is replaced with the path of the directory containing the configuration file itself. + +If the referenced parameter is not defined, no substitution takes place and the reference, including its brackets, remains in place. To include a literal square bracket in a string, prefix it with a `\` character. + +## File Names + +Path names in configuration files should use portable forward slashes (`/`) rather than back-slashes (`\`), because JSON uses the back-slash as an escape character. For example, `WSPATH: ["c:/Dyalog21.0"]` (or `["c:\\Dyalog21.0"]`) specifies `c:\Dyalog21.0`, whereas `["c:\Dyalog21.0"]` means `c:Dyalog21.0`. + +## Nested Structures + +A configuration file represents a nested parameter structure (for example, a Windows Registry sub-folder) as a nested object: +```apl +Captions: { + Session: "My Dyalog Session", + Status: "My Status window", +} +``` +The value is then queried with a back-slash separator: +```apl + +2 ⎕NQ '.' 'GetEnvironment' 'Captions\Session' +My Dyalog Session +``` diff --git a/dyalog-configuration-guide/docs/how-to-set/environment-variables.md b/dyalog-configuration-guide/docs/how-to-set/environment-variables.md new file mode 100644 index 00000000000..909f334efd7 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/environment-variables.md @@ -0,0 +1,8 @@ +# Environment Variables + +A configuration parameter can be set as an environment variable in the environment from which Dyalog is started. An environment variable setting overrides a user configuration file, the Registry, and the built-in default, but is itself overridden by an application configuration file and by the command line (see [Order of Precedence](order-of-precedence.md)). + +On UNIX and macOS, environment variable names are given in upper case, for example `MAXWS`. On Microsoft Windows, parameter names are not case-sensitive. + +!!! Hint "Hints and Recommendations" + Dyalog Ltd recommends that [configuration files](application-configuration-files.md) are used for all run-time applications, and that the use of environment variables for this purpose is eliminated. Configuration files are text-based, portable across platforms, and easily managed alongside application source code. diff --git a/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md b/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md new file mode 100644 index 00000000000..3c5d233e7c2 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md @@ -0,0 +1,15 @@ +# Order of Precedence + +When a configuration parameter is set in more than one place, Dyalog applies the following order of precedence. Each source overrides those below it: + +1. [Command line](command-line.md) settings, which override +2. [Application configuration file](application-configuration-files.md) settings, which override +3. [Environment variable](environment-variables.md) settings, which override +4. [User configuration file](user-configuration-files.md) settings, which override +5. [Windows Registry](registry.md) settings (Microsoft Windows only), which override +6. [Built-in defaults](built-in-defaults.md). + +!!! Info "Information" + The Registry step applies to Microsoft Windows only. On UNIX and macOS there is no Registry, so a user configuration file setting is overridden only by the sources above it. + +The value actually in force for a given parameter, after the precedence rules have been applied, can be queried from within Dyalog with `2 ⎕NQ '.' 'GetEnvironment' name` or with the `]Config` user command. diff --git a/dyalog-configuration-guide/docs/how-to-set/overview.md b/dyalog-configuration-guide/docs/how-to-set/overview.md new file mode 100644 index 00000000000..4136fe76122 --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/overview.md @@ -0,0 +1,14 @@ +# How to Set Configuration Parameters + +A configuration parameter can be set from any of the following sources: + +- the [command line](command-line.md) used to start Dyalog; +- an [application configuration file](application-configuration-files.md); +- an [environment variable](environment-variables.md); +- a [user configuration file](user-configuration-files.md); +- the [Windows Registry](registry.md) (Microsoft Windows only); +- the interpreter's [built-in defaults](built-in-defaults.md). + +When the same parameter is set in more than one source, the [order of precedence](order-of-precedence.md) determines which value is used. This gives a great deal of flexibility: a usual value can be defined in a configuration file and then temporarily overridden from the command line. + +Dyalog Ltd recommends configuration files for all run-time applications, in preference to environment variables. diff --git a/dyalog-configuration-guide/docs/how-to-set/registry.md b/dyalog-configuration-guide/docs/how-to-set/registry.md new file mode 100644 index 00000000000..8529afa163d --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/registry.md @@ -0,0 +1,10 @@ +# Registry + +!!! Info "Information" + The Windows Registry applies to Microsoft Windows only. On UNIX and macOS there is no Registry. + +On Microsoft Windows, configuration parameters can be stored in the Registry. A Registry setting overrides only the built-in default; every other source overrides it (see [Order of Precedence](order-of-precedence.md)). + +The Configuration Dialog reflects the values stored in the Registry and ignores any overriding values defined on the command line, in configuration files, or in environment variables. When a parameter is changed through the Configuration Dialog, the new value is recorded in the Registry, but it remains overridden by any source that takes precedence over the Registry. + +Some parameters are stored in Registry sub-folders. A [configuration file](application-configuration-files.md) represents such a parameter as a nested object; see [Configuration File Structure](configuration-file-structure.md). diff --git a/dyalog-configuration-guide/docs/how-to-set/user-configuration-files.md b/dyalog-configuration-guide/docs/how-to-set/user-configuration-files.md new file mode 100644 index 00000000000..7df06d056dd --- /dev/null +++ b/dyalog-configuration-guide/docs/how-to-set/user-configuration-files.md @@ -0,0 +1,18 @@ +# User Configuration Files + +A *user configuration file* defines configuration values for the current (and possibly only) user of the system. It typically configures the development environment, providing settings that are the same for all of that user's applications. + +A user configuration file setting overrides the Registry and the built-in default, but is overridden by an environment variable, an application configuration file, and the command line (see [Order of Precedence](order-of-precedence.md)). + +## UNIX and macOS + +The first time a new version of Dyalog is launched it creates and initialises a version-specific user configuration file `$HOME/.dyalog/dyalog..dcfg`, where the version-specific part comprises the version number, edition, and width. For example, a 64-bit Unicode edition of Dyalog 21.0 is identified as `210U64`. The name of this file should not be changed. + +The first time any version of Dyalog is run, an additional file `$HOME/.dyalog/dyalog.dcfg` is created. Settings placed here apply irrespective of Dyalog version, so they need not be repeated in each version-specific file. + +!!! Legacy "Legacy" + Before Dyalog 18.0, configuration parameters could be set as environment variables in a `$HOME/.dyalog/dyalog.config` script. That script is no longer referenced; any settings to be retained must be moved into the appropriate `$HOME/.dyalog/dyalog..dcfg` file. + +## Microsoft Windows + +The name of the user configuration file is given by the **UserConfigFile** parameter. On Windows this parameter is not set by default, but can be defined by the user. diff --git a/dyalog-configuration-guide/docs/introduction.md b/dyalog-configuration-guide/docs/introduction.md new file mode 100644 index 00000000000..79760fa54a1 --- /dev/null +++ b/dyalog-configuration-guide/docs/introduction.md @@ -0,0 +1,9 @@ +# Introduction + +Dyalog is customised through *configuration parameters*. A configuration parameter controls some aspect of the interpreter or the development environment, from the maximum workspace size to the location of the Session log. + +The same parameters apply across all supported operating systems, but a few are specific to one platform, and some take different default values on different platforms. Each parameter's own page states any such differences. + +A configuration parameter can be set in several ways: on the command line, in an application configuration file, as an environment variable, in a user configuration file, in the Windows Registry (Microsoft Windows only), or left at its built-in default. When a parameter is set in more than one of these, a fixed [order of precedence](how-to-set/order-of-precedence.md) determines which setting wins. [How to Set Configuration Parameters](how-to-set/overview.md) describes each source in turn. + +Parameter names are not case-sensitive when given on the command line, in configuration files, or in the Windows Registry. When a parameter is set as an environment variable on UNIX or macOS, its name is given in upper case. diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml index 023d0aa3765..7f4556de5e2 100644 --- a/dyalog-configuration-guide/mkdocs.yml +++ b/dyalog-configuration-guide/mkdocs.yml @@ -53,3 +53,14 @@ markdown_extensions: title: On this page nav: - index.md + - Introduction: introduction.md + - How to Set Configuration Parameters: + - Overview: how-to-set/overview.md + - Order of Precedence: how-to-set/order-of-precedence.md + - Command Line: how-to-set/command-line.md + - Application Configuration Files: how-to-set/application-configuration-files.md + - Environment Variables: how-to-set/environment-variables.md + - User Configuration Files: how-to-set/user-configuration-files.md + - Windows Registry: how-to-set/registry.md + - Built-in Defaults: how-to-set/built-in-defaults.md + - Configuration File Structure: how-to-set/configuration-file-structure.md From cba926b976807386451a517c2ec680cd2356e5be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:16:53 +0100 Subject: [PATCH 03/37] Migrate configuration parameters into the Configuration Guide Move all 148 Windows configuration-parameter pages (including the AutoComplete and ValueTips groups) into the new Dyalog Configuration Guide with git mv, preserving history, and move their nav block from the Windows guide into the new guide. Repair every affected link: repoint the ~26 inbound cross-guide references and the Windows guide's own internal references to the new location, rewrite the moved pages' relative links to the Windows Configuration Dialog and other Windows pages as cross-guide links, and copy the two images the moved pages use. All guide links resolve and the Windows guide no longer references the removed pages. This is the relocation and link-repair pass; the per-parameter template and per-OS annotation follow per category tranche. Implements abrudz/documentation#11 and the link repair of abrudz/documentation#23. Part of Dyalog/documentation#719. --- .../addclassheaders.md | 2 +- .../apl-code-e-magnitude.md | 0 .../apl-complex-as-v12.md | 0 .../configuration-parameters/apl-fast-fchk.md | 0 .../apl-fcreate-props-c.md | 0 .../apl-fcreate-props-j.md | 0 .../apl-max-threads.md | 0 .../apl-textinaplcore.md | 0 .../aplan-for-editor.md | 2 +- .../aplan-for-output.md | 2 +- .../configuration-parameters/aplcorename.md | 0 .../docs/configuration-parameters/aplk.md | 2 +- .../docs/configuration-parameters/aplkeys.md | 2 +- .../docs/configuration-parameters/aplnid.md | 0 .../docs/configuration-parameters/aplt.md | 5 + .../docs/configuration-parameters/apltrans.md | 2 +- .../docs/configuration-parameters/auto-pw.md | 2 +- .../autocomplete/cancelkey1.md | 5 + .../autocomplete/cancelkey2.md | 5 + .../autocomplete/cols.md | 5 + .../autocomplete/commonkey1.md | 2 +- .../autocomplete/completekey1.md | 5 + .../autocomplete/completekey2.md | 5 + .../autocomplete/enabled.md | 5 + .../autocomplete/history.md | 5 + .../autocomplete/historysize.md | 5 + .../autocomplete/prefixsize.md | 5 + .../autocomplete/rows.md | 5 + .../autocomplete/showfiles.md | 5 + .../docs/configuration-parameters/autodpi.md | 2 +- .../configuration-parameters/autoformat.md | 2 +- .../configuration-parameters/autoindent.md | 2 +- .../docs/configuration-parameters/cfext.md | 0 .../configuration-parameters/classicmode.md | 2 +- .../classicmodesaveposition.md | 2 +- .../cmd-prefix-and-cmd-postfix.md | 0 .../configuration-parameters/configfile.md | 3 + .../configuration-parameters.md | 2 +- .../configuration-parameters/confirm-abort.md | 2 +- .../configuration-parameters/confirm-close.md | 2 +- .../configuration-parameters/confirm-fix.md | 2 +- .../confirm-session-delete.md | 2 +- .../configuration-parameters/default-div.md | 5 + .../configuration-parameters/default-io.md | 5 + .../configuration-parameters/default-ml.md | 5 + .../configuration-parameters/default-pp.md | 5 + .../configuration-parameters/default-pw.md | 0 .../configuration-parameters/default-rtl.md | 5 + .../configuration-parameters/default-wx.md | 2 +- .../dmxoutputonerror.md | 2 +- .../dockableeditwindows.md | 2 +- .../doubleclickedit.md | 2 +- .../dyalog-discard-fn-source.md | 0 .../dyalog-eventlogginglevel.md | 0 .../dyalog-eventlogname.md | 0 .../dyalog-gutter-enable.md | 0 .../dyalog-lineeditor-mode.md | 5 + .../dyalog-netcore.md | 0 .../dyalog-nopopups.md | 0 .../dyalog-pixel-type.md | 2 +- .../configuration-parameters/dyalog-serial.md | 0 .../docs/configuration-parameters/dyalog.md | 0 .../dyalogemailaddress.md | 0 .../configuration-parameters/dyaloghelpdir.md | 0 .../dyaloginstalldir.md | 0 .../configuration-parameters/dyaloglink.md | 0 .../dyalogstartup-x.md | 0 .../configuration-parameters/dyalogstartup.md | 0 .../dyalogstartupse.md | 0 .../configuration-parameters/dyalogwebsite.md | 0 .../configuration-parameters/edit-cols.md | 5 + .../configuration-parameters/edit-first-x.md | 2 +- .../configuration-parameters/edit-first-y.md | 2 +- .../configuration-parameters/edit-offset-x.md | 5 + .../configuration-parameters/edit-offset-y.md | 5 + .../configuration-parameters/edit-rows.md | 5 + .../configuration-parameters/editorstate.md | 0 .../configuration-parameters/enable-cef.md | 0 .../erroronexternalexception.md | 0 .../externalhelpurl.md | 2 +- .../file-stack-size.md | 3 + .../configuration-parameters/greet-bitmap.md | 0 .../configuration-parameters/history-size.md | 2 +- .../docs/configuration-parameters/inifile.md | 2 +- .../initfullscriptnormal.md | 2 +- .../initfullscriptsusp.md | 2 +- .../initialkeyboardlayout.md | 2 +- .../initialkeyboardlayoutinuse.md | 2 +- .../initialkeyboardlayoutshowall.md | 2 +- .../configuration-parameters/input-size.md | 2 +- .../keyboardinputdelay.md | 2 +- .../docs/configuration-parameters/load.md | 2 +- .../localdyalogdir.md | 0 .../log-file-inuse.md | 2 +- .../docs/configuration-parameters/log-file.md | 2 +- .../docs/configuration-parameters/log-size.md | 2 +- .../docs/configuration-parameters/lx.md | 0 .../docs/configuration-parameters/mapchars.md | 0 .../configuration-parameters/maxaplcores.md | 0 .../docs/configuration-parameters/maxws.md | 2 +- .../overstrikespopup.md | 0 .../passexceptionstoopsys.md | 0 .../configuration-parameters/pfkey-size.md | 2 +- .../configuration-parameters/programfolder.md | 0 .../propertyexposeroot.md | 2 +- .../propertyexposese.md | 2 +- .../configuration-parameters/qcmd-timeout.md | 0 .../resolveoverstrikes.md | 0 .../configuration-parameters/ride-init.md | 0 .../configuration-parameters/ride-spawned.md | 0 .../configuration-parameters/runasservice.md | 0 .../savecontinueonexit.md | 0 .../configuration-parameters/savelogonexit.md | 0 .../savesessiononexit.md | 0 .../docs/configuration-parameters/serial.md | 0 .../configuration-parameters/session-file.md | 2 +- .../configuration-parameters/sessionontop.md | 2 +- .../showstatusonerror.md | 0 .../configuration-parameters/singletrace.md | 2 +- .../configuration-parameters/skiplines.md | 6 +- .../docs/configuration-parameters/sm-cols.md | 0 .../docs/configuration-parameters/sm-rows.md | 0 .../configuration-parameters/statusonedit.md | 5 + .../docs/configuration-parameters/tabstops.md | 5 + .../toolbarsonedit.md | 5 + .../configuration-parameters/trace-first-x.md | 2 +- .../configuration-parameters/trace-first-y.md | 2 +- .../trace-level-warn.md | 2 +- .../trace-offset-x.md | 2 +- .../trace-offset-y.md | 2 +- .../trace-on-error.md | 2 +- .../tracestopmonitor.md | 0 .../configuration-parameters/ucmdcachefile.md | 0 .../unicodetoclipboard.md | 2 +- .../configuration-parameters/urlhighlight.md | 2 +- .../useexternalhelpurl.md | 2 +- .../userconfigfile.md | 3 + .../docs/configuration-parameters/usexcv.md | 0 .../valuetips/colourscheme.md | 5 + .../valuetips/delay.md | 5 + .../valuetips/enabled.md | 2 +- .../wantsspecialkeys.md | 0 .../configuration-parameters/wrapsearch.md | 2 +- .../wrapsearchmsgbox.md | 5 + .../docs/configuration-parameters/wsext.md | 0 .../docs/configuration-parameters/wspath.md | 2 +- .../configuration-parameters/xplookandfeel.md | 0 .../configuration-parameters/yy-window.md | 0 .../docs/img/object_arraynotation.png | Bin 0 -> 16139 bytes .../docs/img/session_arraynotation.png | Bin 0 -> 12669 bytes dyalog-configuration-guide/mkdocs.yml | 151 ++++++++++++++++++ .../i-beam/aplcore-parameters.md | 2 +- .../i-beam/number-of-threads.md | 2 +- .../docs/system-commands/continue.md | 2 +- .../docs/system-commands/load.md | 2 +- .../docs/system-commands/save.md | 2 +- .../docs/system-functions/dt.md | 2 +- .../docs/system-functions/fchk.md | 2 +- .../docs/system-functions/fcopy.md | 2 +- .../docs/system-functions/fcreate.md | 2 +- .../docs/system-functions/frename.md | 2 +- .../docs/system-functions/fstie.md | 2 +- .../docs/system-functions/ftie.md | 2 +- .../docs/system-functions/load.md | 2 +- .../docs/system-functions/na.md | 2 +- .../docs/system-functions/system.md | 2 +- .../docs/system-functions/wx.md | 4 +- object-reference/docs/objects/font.md | 2 +- object-reference/docs/objects/root.md | 2 +- object-reference/docs/properties/coord.md | 2 +- .../docs/error-messages/system-errors.md | 14 +- .../introduction/arrays/display-of-arrays.md | 2 +- .../docs/introduction/workspaces.md | 2 +- .../docs/apl-command-line.md | 6 +- .../docs/configuration-parameters/aplt.md | 5 - .../autocomplete/cancelkey1.md | 5 - .../autocomplete/cancelkey2.md | 5 - .../autocomplete/cols.md | 5 - .../autocomplete/completekey1.md | 5 - .../autocomplete/completekey2.md | 5 - .../autocomplete/enabled.md | 5 - .../autocomplete/history.md | 5 - .../autocomplete/historysize.md | 5 - .../autocomplete/prefixsize.md | 5 - .../autocomplete/rows.md | 5 - .../autocomplete/showfiles.md | 5 - .../configuration-parameters/configfile.md | 3 - .../configuration-parameters/default-div.md | 5 - .../configuration-parameters/default-io.md | 5 - .../configuration-parameters/default-ml.md | 5 - .../configuration-parameters/default-pp.md | 5 - .../configuration-parameters/default-rtl.md | 5 - .../dyalog-lineeditor-mode.md | 5 - .../configuration-parameters/edit-cols.md | 5 - .../configuration-parameters/edit-offset-x.md | 5 - .../configuration-parameters/edit-offset-y.md | 5 - .../configuration-parameters/edit-rows.md | 5 - .../file-stack-size.md | 3 - .../configuration-parameters/statusonedit.md | 5 - .../docs/configuration-parameters/tabstops.md | 5 - .../toolbarsonedit.md | 5 - .../userconfigfile.md | 3 - .../valuetips/colourscheme.md | 5 - .../valuetips/delay.md | 5 - .../wrapsearchmsgbox.md | 5 - .../configuration-dialog-auto-complete-tab.md | 22 +-- .../configuration-dialog-general-tab.md | 16 +- .../configuration-dialog-help-dmx-tab.md | 6 +- ...n-dialog-input-tab-classic-edition-only.md | 4 +- .../configuration-dialog-object-syntax-tab.md | 6 +- ...-dialog-output-tab-classic-edition-only.md | 4 +- .../configuration-dialog-session-tab.md | 32 ++-- .../configuration-dialog-trace-edit-tab.md | 50 +++--- ...-unicode-input-tab-unicode-edition-only.md | 12 +- .../configuration-dialog-windows-tab.md | 24 +-- .../configuration-dialog-workspace-tab.md | 4 +- .../runtime-applications-and-components.md | 4 +- .../mkdocs.yml | 151 ------------------ .../docs/file-explorer-integration.md | 2 +- .../docs/multiline-session-input.md | 2 +- .../session-initialisation.md | 6 +- .../docs/the-session-object/session-object.md | 2 +- 222 files changed, 491 insertions(+), 491 deletions(-) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/addclassheaders.md (72%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-code-e-magnitude.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-complex-as-v12.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-fast-fchk.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-fcreate-props-c.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-fcreate-props-j.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-max-threads.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apl-textinaplcore.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplan-for-editor.md (93%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplan-for-output.md (92%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplcorename.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplk.md (73%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplkeys.md (68%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/aplnid.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/aplt.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/apltrans.md (65%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/auto-pw.md (72%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/autocomplete/commonkey1.md (61%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/autodpi.md (70%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/autoformat.md (80%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/autoindent.md (67%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/cfext.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/classicmode.md (65%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/classicmodesaveposition.md (67%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/configfile.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/configuration-parameters.md (93%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/confirm-abort.md (58%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/confirm-close.md (57%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/confirm-fix.md (57%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/confirm-session-delete.md (56%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/default-div.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/default-io.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/default-ml.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/default-pp.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/default-pw.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/default-wx.md (55%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dmxoutputonerror.md (55%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dockableeditwindows.md (60%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/doubleclickedit.md (58%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-discard-fn-source.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-eventlogginglevel.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-eventlogname.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-gutter-enable.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-netcore.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-nopopups.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-pixel-type.md (69%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog-serial.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalog.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalogemailaddress.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyaloghelpdir.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyaloginstalldir.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyaloglink.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalogstartup-x.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalogstartup.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalogstartupse.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/dyalogwebsite.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/edit-first-x.md (59%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/edit-first-y.md (59%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/editorstate.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/enable-cef.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/erroronexternalexception.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/externalhelpurl.md (74%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/greet-bitmap.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/history-size.md (65%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/inifile.md (78%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/initfullscriptnormal.md (86%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/initfullscriptsusp.md (85%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/initialkeyboardlayout.md (61%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/initialkeyboardlayoutinuse.md (53%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/initialkeyboardlayoutshowall.md (52%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/input-size.md (62%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/keyboardinputdelay.md (68%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/load.md (95%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/localdyalogdir.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/log-file-inuse.md (62%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/log-file.md (90%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/log-size.md (59%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/lx.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/mapchars.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/maxaplcores.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/maxws.md (89%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/overstrikespopup.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/passexceptionstoopsys.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/pfkey-size.md (68%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/programfolder.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/propertyexposeroot.md (72%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/propertyexposese.md (71%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/qcmd-timeout.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/resolveoverstrikes.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/ride-init.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/ride-spawned.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/runasservice.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/savecontinueonexit.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/savelogonexit.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/savesessiononexit.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/serial.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/session-file.md (73%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/sessionontop.md (53%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/showstatusonerror.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/singletrace.md (52%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/skiplines.md (61%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/sm-cols.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/sm-rows.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/tabstops.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-first-x.md (60%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-first-y.md (59%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-level-warn.md (78%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-offset-x.md (57%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-offset-y.md (57%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/trace-on-error.md (64%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/tracestopmonitor.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/ucmdcachefile.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/unicodetoclipboard.md (74%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/urlhighlight.md (79%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/useexternalhelpurl.md (68%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/usexcv.md (100%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/valuetips/enabled.md (56%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/wantsspecialkeys.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/wrapsearch.md (57%) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/wsext.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/wspath.md (79%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/xplookandfeel.md (100%) rename {windows-installation-and-configuration-guide => dyalog-configuration-guide}/docs/configuration-parameters/yy-window.md (100%) create mode 100644 dyalog-configuration-guide/docs/img/object_arraynotation.png create mode 100644 dyalog-configuration-guide/docs/img/session_arraynotation.png delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/aplt.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cols.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/history.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/rows.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/configfile.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/default-div.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/default-io.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/default-ml.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/default-pp.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/default-rtl.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/edit-cols.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-x.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-y.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/edit-rows.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/file-stack-size.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/statusonedit.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/tabstops.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/toolbarsonedit.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/userconfigfile.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/delay.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/addclassheaders.md b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md similarity index 72% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/addclassheaders.md rename to dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md index e6ae2c21246..7c46f6126bc 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/addclassheaders.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md @@ -2,4 +2,4 @@ This parameter specifies what the Tracer displays when tracing the execution of a function in a script. If set to 1, the Tracer displays just the first line of the script and the function in question. If set to 0, the entire script is shown in the Tracer window. -See also [Limit tracer display to current function in script](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) +See also [Limit tracer display to current function in script](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-max-threads.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-max-threads.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md rename to dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-editor.md b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md similarity index 93% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-editor.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md index 646b88e37e0..890cb4cb5d7 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-editor.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md @@ -8,4 +8,4 @@ The setting can be toggled with the `]APLAN.Editor` user command. In Ride and the Microsoft Windows IDE, once an **Edit** window is open, its mode can be toggled by clicking the ![](../img/object_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the Editor's toolbar. -See also [APLAN_FOR_OUTPUT](../aplan-for-output). +See also [APLAN_FOR_OUTPUT](aplan-for-output). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-output.md b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md similarity index 92% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-output.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md index 9199bb62c92..9e61b9d9cd2 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplan-for-output.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md @@ -8,4 +8,4 @@ The setting can be toggled with the `]APLAN.Output` user command In the Microsoft Windows IDE, the setting can also be toggled by clicking the ![](../img/session_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the session toolbar. -See also [APLAN_FOR_EDITOR](../aplan-for-editor). +See also [APLAN_FOR_EDITOR](aplan-for-editor). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplcorename.md b/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplcorename.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplk.md b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md similarity index 73% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplk.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplk.md index 867ca693164..fc980994c47 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplk.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md @@ -4,4 +4,4 @@ This parameter specifies the name of your Input Translate Table, which defines your keyboard layout. The keyboard combo in the *Configure* dialog box displays all the files with the .DIN extension in the directory specified by the **APLKEYS** parameter. You may choose any one of the supplied tables, and you may add your own to the directory. Note that the FILE.DIN table is intended for input from **file** , and should not normally be chosen as a keyboard table. -See also [Input table file](../configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). +See also [Input table file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md similarity index 68% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplkeys.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md index d43a0950c17..ed666a2084a 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplkeys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md @@ -4,4 +4,4 @@ This parameter specifies a search path for the Input Translate Table and is useful for configuring a run-time application. The directory paths are specified using Operating System specific conventions and separated by ";" (Windows) or ":" (UNIX). Its default value is the `aplkeys` sub-directory of the directory in which Dyalog APL/W is installed (defined by **Dyalog** ). -See also [Input table search path](../configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). +See also [Input table search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplnid.md b/dyalog-configuration-guide/docs/configuration-parameters/aplnid.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/aplnid.md rename to dyalog-configuration-guide/docs/configuration-parameters/aplnid.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplt.md b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md new file mode 100644 index 00000000000..b5ca426d66e --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md @@ -0,0 +1,5 @@ +# APLT + +This parameter specifies the name of the Output Translate Table. On Windows the default is WIN.DOT and there is rarely a need to alter it. + +See also [Output table file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apltrans.md b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md similarity index 65% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/apltrans.md rename to dyalog-configuration-guide/docs/configuration-parameters/apltrans.md index 06747069f17..a9243e26d46 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/apltrans.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md @@ -2,4 +2,4 @@ This parameter specifies a search path for the Output Translate Table and is useful for configuring a run-time application. The directory paths are specified using Operating System specific conventions and separated by ";" (Windows) or ":" (UNIX). Its default value is the sub-directory `apltrans` in the directory in which Dyalog APL/W is installed. -See also [Output table search path](../configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). +See also [Output table search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/auto-pw.md b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md similarity index 72% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/auto-pw.md rename to dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md index 3c155e69573..6824c6d32f0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/auto-pw.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md @@ -2,4 +2,4 @@ This parameter specifies whether or not the value of `⎕PW` is derived automatically from the current width of the Session Window. If **Auto_PW** is 1, the value of `⎕PW` changes whenever the Session Window is resized and reflects the number of characters that can be displayed on a single line. If **Auto_PW** is 0 (the default under Windows) `⎕PW` is independent of the Session Window size. -See also [Auto PW](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Auto PW](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md new file mode 100644 index 00000000000..c2d7c419949 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md @@ -0,0 +1,5 @@ +# AutoComplete/CancelKey1 + +Specifies the first of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. + +See also [Cancel Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md new file mode 100644 index 00000000000..faac97c7b7c --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md @@ -0,0 +1,5 @@ +# AutoComplete/CancelKey2 + +Specifies the second of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. + +See also [Cancel Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md new file mode 100644 index 00000000000..2399d5c68aa --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md @@ -0,0 +1,5 @@ +# AutoComplete/Cols + +This parameter specifies the maximum number of columns (width) in the Auto Complete pop-up suggestions box. + +See also [Show up to](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md similarity index 61% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md rename to dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md index 4247ca75fe2..fcfb54b7ad5 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md @@ -2,4 +2,4 @@ Specifies the key that will auto-complete the *common prefix*. This is defined to be the longest string of leading characters in the currently selected name that is shared by at least one other name in the Auto Complete suggestion box. -See also [Common Key](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +See also [Common Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md new file mode 100644 index 00000000000..c8b32685db9 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md @@ -0,0 +1,5 @@ +# AutoComplete/CompleteKey1 + +Specifies the first of two possible keys that may be used to select the current option from the Auto Complete suggestion box. + +See also [OK Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md new file mode 100644 index 00000000000..2c39003ec68 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md @@ -0,0 +1,5 @@ +# AutoComplete/CompleteKey2 + +Specifies the second of two possible keys that may be used to select the current option from the Auto Complete suggestion box. + +See also [OK Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md new file mode 100644 index 00000000000..3a6d4971475 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md @@ -0,0 +1,5 @@ +# AutoComplete/Enabled + +This parameter specifies whether or not Auto Completion is enabled + +See also [Use Auto Complete](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md new file mode 100644 index 00000000000..427cf520aba --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md @@ -0,0 +1,5 @@ +# AutoComplete/History + +Specifies whether or not Auto Complete maintains a list of previous Auto Completions. + +See also [Keep History](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md new file mode 100644 index 00000000000..6712b8ddd2f --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md @@ -0,0 +1,5 @@ +# AutoComplete/HistorySize + +Specifies the number of previous Auto Completions that are maintained when History is 1. See [History](history.md). + +See also [History Length](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md new file mode 100644 index 00000000000..6adb08bd9e7 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md @@ -0,0 +1,5 @@ +# AutoComplete/PrefixSize + +This parameter specifies the threshold (number of characters) before Auto Completeion displays suggestions. + +See also [Make suggestions after](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md new file mode 100644 index 00000000000..c603c81d538 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md @@ -0,0 +1,5 @@ +# AutoComplete/Rows + +This parameter specifies the maximum number of rows (height) in the Auto Complete pop-up suggestions box. + +See also [Suggest up to](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md new file mode 100644 index 00000000000..853bf7717f9 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md @@ -0,0 +1,5 @@ +# AutoComplete/ShowFiles + +Specifies whether or not Auto Completion suggests directory and file names for `)LOAD`, `)COPY` and `)DROP` system commands. + +See also [Include filenames](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autodpi.md b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md similarity index 70% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/autodpi.md rename to dyalog-configuration-guide/docs/configuration-parameters/autodpi.md index 55bc35bd381..3c6a2622161 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autodpi.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md @@ -1,3 +1,3 @@ # AutoDPI -This parameter determines whether or not the Dyalog program registers the application as DPI-Aware when it initialises. If 1, (the default), Dyalog performs the auto-scaling; if 0, scaling is the responsibility of the programmer or operating system. See also [Enable DPI Scaling of the interpreter and development environment](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +This parameter determines whether or not the Dyalog program registers the application as DPI-Aware when it initialises. If 1, (the default), Dyalog performs the auto-scaling; if 0, scaling is the responsibility of the programmer or operating system. See also [Enable DPI Scaling of the interpreter and development environment](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autoformat.md b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md similarity index 80% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/autoformat.md rename to dyalog-configuration-guide/docs/configuration-parameters/autoformat.md index a0510fac45c..54b18dc38c3 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autoformat.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you want automatic formatting of Control Structures in functions. The default value is 1 which means that formatting is done automatically for you when a function is opened for editing or converted to text by `⎕CR`, `⎕NR` and `⎕VR`. Automatic formatting first discards all leading spaces in the function body. It then prefixes all lines with a single space except those beginning with a label or a comment symbol (this has the effect of making labels and comments stand out). The third step is to indent Control Structures. The size of the indent depends upon the **TabStops** parameter. To turn off automatic formatting, set **AutoFormat** to 0. -See also [Autoformat functions](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Autoformat functions](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autoindent.md b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md similarity index 67% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/autoindent.md rename to dyalog-configuration-guide/docs/configuration-parameters/autoindent.md index 8e50d07e986..5527ef428aa 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autoindent.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you want semi-automatic indenting during editing. The default value is 1. This means that when you enter a new line in a function, it is automatically indented by the same amount as the previous line. This option simplifies the entry of indented Control Structures. -See also [Autoindent](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Autoindent](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/cfext.md b/dyalog-configuration-guide/docs/configuration-parameters/cfext.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/cfext.md rename to dyalog-configuration-guide/docs/configuration-parameters/cfext.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md similarity index 65% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md rename to dyalog-configuration-guide/docs/configuration-parameters/classicmode.md index 1c0e3d080e4..63c2b16cf76 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md @@ -4,4 +4,4 @@ This parameter specifies whether or not the Session operates in *Dyalog Classic Note that in this mode, a maximum of 50 Trace windows may be displayed. -See also [Classic Dyalog mode](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Classic Dyalog mode](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md similarity index 67% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md rename to dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md index 9c280156b00..40b9cad5431 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md @@ -5,4 +5,4 @@ This parameter specifies whether or not the current size and location of the fir The size and location of the windows are saved in the registry in the subfolder WindowRects/EditWindow and TraceWindow. -See also [Remember previous window position](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Remember previous window position](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md b/dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md rename to dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configfile.md b/dyalog-configuration-guide/docs/configuration-parameters/configfile.md new file mode 100644 index 00000000000..a4a2666a474 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/configfile.md @@ -0,0 +1,3 @@ +# ConfigFile + +This parameter specifies the name of the Application Configuration file. See [Configuration Files](../../../windows-installation-and-configuration-guide/configuration-files.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md similarity index 93% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md rename to dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md index 06fd7dede0f..89f7f73d330 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md @@ -37,5 +37,5 @@ Specifying an invalid value will prevent Dyalog APL from starting. You can change parameters in the Registry in one of two ways: -- Using the Configuration dialog box that is obtained by selecting *Configure* from the *Options* menu on the Dyalog APL/W session. See ["The Configuration Dialog Box"](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) for details. +- Using the Configuration dialog box that is obtained by selecting *Configure* from the *Options* menu on the Dyalog APL/W session. See ["The Configuration Dialog Box"](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) for details. - By directly editing the Windows Registry using `REGEDIT.EXE` or `REGEDIT32.EXE`. This is necessary for parameters that are not editable via the Configuration dialog box. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-abort.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md similarity index 58% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-abort.md rename to dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md index 1d5aa3a0b33..46f6f3b2b16 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-abort.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you will be prompted for confirmation when you attempt to abort an edit session after making changes to the object being edited. Its value is either 1 (confirmation is required) or 0. The default is 0. -See also [Confirm edit window close on Abort](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Confirm edit window close on Abort](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-close.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md similarity index 57% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-close.md rename to dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md index 45131cec426..5bb817ff660 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-close.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you will be prompted for confirmation when you close an edit window after making changes to the object being edited. Its value is either 1 (confirmation is required) or 0. The default is 0. -See also [Confirm edit window close on Close](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Confirm edit window close on Close](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-fix.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md similarity index 57% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-fix.md rename to dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md index 5ccef4df7f8..533371d9b23 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-fix.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you will be prompted for confirmation when you attempt to fix an object in the workspace after making changes in the editor. Its value is either 1 (confirmation is required) or 0. The default is 0. -See also [Confirm edit window close on Edit (and Fix)](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Confirm edit window close on Edit (and Fix)](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-session-delete.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md similarity index 56% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-session-delete.md rename to dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md index a0f487337fb..75b6b85d1e3 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/confirm-session-delete.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md @@ -2,4 +2,4 @@ This parameter specifies whether or not you will be prompted for confirmation when you attempt to delete lines from the Session Log. Its value is either 1 (confirmation is required) or 0. The default is 1. -See also [Confirm on Deletion from Session log](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Confirm on Deletion from Session log](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-div.md b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md new file mode 100644 index 00000000000..948b231bfbe --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md @@ -0,0 +1,5 @@ +# Default_DIV + +This parameter specifies the value of `⎕DIV` in a clear workspace. Its default value is 0. + +See also [⎕DIV](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-io.md b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md new file mode 100644 index 00000000000..0eb06b403a3 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md @@ -0,0 +1,5 @@ +# Default_IO + +This parameter specifies the value of `⎕IO` in a clear workspace. Its default value is 1. + +See also [⎕IO](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md new file mode 100644 index 00000000000..f2a38867059 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md @@ -0,0 +1,5 @@ +# Default_ML + +This parameter specifies the value of `⎕ML` in a clear workspace. Its default value is 1. + +See also [⎕ML](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md new file mode 100644 index 00000000000..b3ce576bdf2 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md @@ -0,0 +1,5 @@ +# Default_PP + +This parameter specifies the value of `⎕PP` in a clear workspace. Its default value is 10. + +See also [⎕PP](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-pw.md b/dyalog-configuration-guide/docs/configuration-parameters/default-pw.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/default-pw.md rename to dyalog-configuration-guide/docs/configuration-parameters/default-pw.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md new file mode 100644 index 00000000000..a32ef693645 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md @@ -0,0 +1,5 @@ +# Default_RTL + +This parameter specifies the value of `⎕RTL` in a clear workspace. Its default value is 0. + +See also [⎕RTL](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-wx.md b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md similarity index 55% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/default-wx.md rename to dyalog-configuration-guide/docs/configuration-parameters/default-wx.md index 2a26b812839..a383ed381e3 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-wx.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md @@ -2,4 +2,4 @@ This parameter specifies the value of `⎕WX` in a clear workspace. This in turn determines whether or not the names of properties, methods and events of GUI objects are exposed. If set (`⎕WX` is 1), you may query/set properties and invoke methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in GUI objects. -See also [Expose properties of GUI Namespaces](../configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) and [⎕WX](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Expose properties of GUI Namespaces](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) and [⎕WX](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md similarity index 55% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md rename to dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md index 79d39683c1c..ff9b9d4b0fa 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md @@ -2,4 +2,4 @@ This parameter specifies in which windows DMX error messages are displayed. It is an integer whose value is the sum of the specified windows where 1 = Status Window and 2 = Session Window. -See also [DMX messages should go to](../configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +See also [DMX messages should go to](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md similarity index 60% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md rename to dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md index f78a101fb04..bde03f528ee 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md @@ -3,4 +3,4 @@ This parameter specifies whether or not individual edit windows can be undocked from (and docked back into) the (MDI) Editor window. Its default value is 0. This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). -See also [Allow floating edit windows](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Allow floating edit windows](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/doubleclickedit.md b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md similarity index 58% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/doubleclickedit.md rename to dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md index c412185207f..7c68792e43b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/doubleclickedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md @@ -2,4 +2,4 @@ This parameter specifies whether or not double-clicking over a name invokes the editor. Its default is 1. If DoubleClickEdit is set to 0, double-clicking selects a word and triple-clicking selects the entire line. -See also [Double-click to Edit](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Double-click to Edit](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md new file mode 100644 index 00000000000..e52f6bf158f --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md @@ -0,0 +1,5 @@ +# Dyalog_LineEditor_Mode + +This Boolean parameter specifies whether or not multi-line input is enabled in the Session. + +See also [Multiline Input](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) and [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-netcore.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-netcore.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md similarity index 69% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md index a60cdad1ce8..f6e1fff6eab 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md @@ -2,4 +2,4 @@ When the Coord property is set to `'Pixel'` , this parameter specifies how it is interpreted. If the value of **Dyalog_Pixel_Type** is RealPixel or if Dyalog_Pixel_Type is undefined, the object behaves as if Coord was `'RealPixel'` . If the value of **Dyalog_Pixel_Type** is ScaledPixel, the object behaves as if Coord were `'ScaledPixel'`. See [Coord](../../../object-reference/properties/coord). -See also [Enable DPI scaling of GUI application](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +See also [Enable DPI scaling of GUI application](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-serial.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-serial.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalog.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloglink.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyaloglink.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartup.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartup.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartupse.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogstartupse.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogwebsite.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/dyalogwebsite.md rename to dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md new file mode 100644 index 00000000000..8037a2f281e --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md @@ -0,0 +1,5 @@ +# Edit_Cols + +This parameter specifies the initial width of an edit window in character units. + +See also [Width](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md similarity index 59% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md rename to dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md index 7f6904a08c2..f6ebe346142 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md @@ -2,4 +2,4 @@ This parameters specify the initial x-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. -See also [X Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [X Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md similarity index 59% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md rename to dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md index fbc7262c0d1..cd70cd89c7c 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md @@ -2,4 +2,4 @@ This parameters specify the initial y-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. -See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md new file mode 100644 index 00000000000..4a4f8f30c6c --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md @@ -0,0 +1,5 @@ +# Edit_Offset_X + +This parameter specify the number of characters by which an edit window is staggered horizontally from the previous one. + +See also [X Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md new file mode 100644 index 00000000000..4f2f1888f47 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md @@ -0,0 +1,5 @@ +# Edit_Offset_Y + +This parameter specify the number of characters by which an edit window is staggered vertically from the previous one. + +See also [Y Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md new file mode 100644 index 00000000000..d170dff910e --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md @@ -0,0 +1,5 @@ +# Edit_Rows + +This parameter specifies the initial height of an edit window in character units. + +See also [Height](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/editorstate.md b/dyalog-configuration-guide/docs/configuration-parameters/editorstate.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/editorstate.md rename to dyalog-configuration-guide/docs/configuration-parameters/editorstate.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/enable-cef.md b/dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/enable-cef.md rename to dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/erroronexternalexception.md b/dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/erroronexternalexception.md rename to dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/externalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md similarity index 74% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/externalhelpurl.md rename to dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md index 3f9f5b9fe4c..c7c690ca0e0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/externalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md @@ -2,4 +2,4 @@ If **UseExternalHelpURL** is 1, Dyalog attempts to use the Microsoft Document Explorer and online help, for example from Visual Studio (if installed), to display help for external objects, such as .Net Types. This parameter specifies the URL to be used. In most cases the default setting will be sufficient. On some configurations it may be necessary to change this. See [ UseExternalHelpURL](useexternalhelpurl.md). -See also [URL](../configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +See also [URL](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md new file mode 100644 index 00000000000..09e435549d0 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md @@ -0,0 +1,3 @@ +# File_Stack_Size + +This parameter specifies the number of the most recently used workspaces displayed in the Session File menu. See [Recently used file list size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/greet-bitmap.md b/dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/greet-bitmap.md rename to dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/history-size.md b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md similarity index 65% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/history-size.md rename to dyalog-configuration-guide/docs/configuration-parameters/history-size.md index f267ae8dbee..0cd49d404f2 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/history-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md @@ -2,4 +2,4 @@ This parameter specifies the size of the buffer used to store previously entered (input) lines in the Session. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. The maximum value is 2Gb. -See also [History size](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [History size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/inifile.md b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md similarity index 78% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/inifile.md rename to dyalog-configuration-guide/docs/configuration-parameters/inifile.md index a8d7566ccfc..565a249a9fb 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/inifile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md @@ -19,4 +19,4 @@ The default values for **IniFile**, for the 64-bit and 32-bit versions respectiv Software\Dyalog\Dyalog APL/W {{ version_majmin }} ``` -See also [Configuration saved in](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +See also [Configuration saved in](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md similarity index 86% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md rename to dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md index 83f17b29d88..e010c4e978e 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md @@ -11,4 +11,4 @@ In both cases, you may select either *Only Functions* or *Everything*. The label for the corresponding items on the Editor File menu (see Editor (The File Menu, editing a script)) will change according to which behaviour applies. Note that if you specify a keystroke for in the *Keyboard Shortcuts* tab, this will be associated with the unselected action. -See also [If not ...](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [If not ...](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md similarity index 85% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md rename to dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md index 1a00249a3cc..83eee5c8cb8 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md @@ -11,4 +11,4 @@ In both cases, you may select either *Only Functions* or *Everything*. The label for the corresponding items on the Editor File menu (see Editor (The File Menu, editing a script)) will change according to which behaviour applies. Note that if you specify a keystroke for in the *Keyboard Shortcuts* tab, this will be associated with the unselected action. -See also [Exit and fix ...](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Exit and fix ...](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md similarity index 61% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md rename to dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md index d12494db146..4bcd10a3a4f 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md @@ -4,4 +4,4 @@ This parameter specifies the name of the keyboard to be selected on startup. When you start an APL session, this layout will automatically be selected as the current keyboard layout if the value of **InitialKeyboardLayoutInUse** is 1. -See also [Keyboard](../configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +See also [Keyboard](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md similarity index 53% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md rename to dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md index 73c6070f65b..fe3aba6c4c0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md @@ -4,4 +4,4 @@ This Boolean parameter specifies whether or not the keyboard specified by **InitialKeyboardLayout** is selected as the current keyboard layout when you start an APL session. -See also [Activate selected keyboard](../configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +See also [Activate selected keyboard](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md similarity index 52% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md rename to dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md index 52facf34430..3d0b475cf3b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md @@ -4,4 +4,4 @@ This Boolean parameter specifies whether or not all installed keyboards are listed in the choice of keyboards in the Configuration dialog box (Unicode Input tab). -See also [Show keyboards for all Languages](../configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +See also [Show keyboards for all Languages](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/input-size.md b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md similarity index 62% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/input-size.md rename to dyalog-configuration-guide/docs/configuration-parameters/input-size.md index 8f35d5ca4ae..0bed354c726 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/input-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md @@ -2,4 +2,4 @@ This parameter specifies the size of the buffer used to store marked lines (lines awaiting execution) in the Session. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. -See also [Input buffer size](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Input buffer size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md similarity index 68% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md rename to dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md index d70471d24a8..5052974a9cf 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md @@ -3,4 +3,4 @@ This parameter specifies the delay (in milliseconds) before the system reacts to a user keystroke by: - updating the name of the Current Object in the Session statusbar. See [The Current Object](../../../windows-ui-guide/session-manager). -- offering a list of names for auto-completion. See [ Auto Complete Tab](../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) +- offering a list of names for auto-completion. See [ Auto Complete Tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/load.md b/dyalog-configuration-guide/docs/configuration-parameters/load.md similarity index 95% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/load.md rename to dyalog-configuration-guide/docs/configuration-parameters/load.md index b68002c6a12..39d90e11971 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/load.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/load.md @@ -11,7 +11,7 @@ The **Load** parameter will normally be specified on the command line or in a Co Having loaded the workspace, or fixed the code from the named file or directory, Dyalog executes the expression specified by the `LX` parameter if it is set. See [LX](lx.md). -If `LX` is not set, Dyalog checks whether or not the **-x** command line option was specified. If so, no further action is taken. See [-x](../apl-command-line.md#command-line). +If `LX` is not set, Dyalog checks whether or not the **-x** command line option was specified. If so, no further action is taken. See [-x](../../../windows-installation-and-configuration-guide/apl-command-line.md#command-line). Otherwise, Dyalog executes an expression which is derived as follows. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/localdyalogdir.md b/dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/localdyalogdir.md rename to dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file-inuse.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md similarity index 62% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/log-file-inuse.md rename to dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md index 7474d460b5e..34b1ade930b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file-inuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md @@ -2,4 +2,4 @@ This Boolean parameter specifies whether or not the Session log is saved. The default is 1 meaning that the Session log is saved in a Session log file and loaded the next time a Session is started. If set to 0, the Session log is not saved -See also [Use log file](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Use log file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md similarity index 90% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md rename to dyalog-configuration-guide/docs/configuration-parameters/log-file.md index 43209765b71..88aa7e0ce2b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md @@ -10,4 +10,4 @@ NOTE: The LogFile property of `⎕SE` reports the name of the log file that is b The default is __\Dyalog APL- Files\default_\*.dlfx__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 20.0 Unicode Files\default_\*.dlfx__ -See also [Use log file](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Use log file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-size.md b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md similarity index 59% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/log-size.md rename to dyalog-configuration-guide/docs/configuration-parameters/log-size.md index 958d9ae6512..85921db522c 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md @@ -2,4 +2,4 @@ This parameter specifies the size of the Session log buffer. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. The maximum value is 2Gb. -See also [Session log size](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Session log size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/lx.md b/dyalog-configuration-guide/docs/configuration-parameters/lx.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/lx.md rename to dyalog-configuration-guide/docs/configuration-parameters/lx.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/mapchars.md b/dyalog-configuration-guide/docs/configuration-parameters/mapchars.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/mapchars.md rename to dyalog-configuration-guide/docs/configuration-parameters/mapchars.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/maxaplcores.md b/dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/maxaplcores.md rename to dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/maxws.md b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md similarity index 89% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/maxws.md rename to dyalog-configuration-guide/docs/configuration-parameters/maxws.md index a1b49880531..0d37d1d41bf 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/maxws.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md @@ -17,4 +17,4 @@ Note that the memory used for the workspace must be *contiguous* . 64-bit versions of Dyalog APL have no such limitations; Dyalog has used workspaces of 96GiB on various platforms. -See also [Maximum workspace size](../configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). +See also [Maximum workspace size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/overstrikespopup.md b/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/overstrikespopup.md rename to dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md b/dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md rename to dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/pfkey-size.md b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md similarity index 68% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/pfkey-size.md rename to dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md index dceaef136d3..6bb6b56c0b0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/pfkey-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md @@ -4,4 +4,4 @@ This parameter specifies the size of the buffer that is used to store programmab For further details about defining a valid value for this parameter, see [Specifying Size-related Parameters](./configuration-parameters.md). -See also [PFKey buffer size](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [PFKey buffer size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/programfolder.md b/dyalog-configuration-guide/docs/configuration-parameters/programfolder.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/programfolder.md rename to dyalog-configuration-guide/docs/configuration-parameters/programfolder.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposeroot.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md similarity index 72% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposeroot.md rename to dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md index 5ce778576c0..db9d8d45ce0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposeroot.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md @@ -2,4 +2,4 @@ Each workspace contains a flag that specifies whether or not the names of Properties, Methods and Events of the Root object are exposed. If set, you may query/set the Properties of Root and invoke the Root Methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in your workspace. This parameter determines the default value of the flag in a `CLEAR WS`. -See also [Expose properties of Root](../configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). +See also [Expose properties of Root](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposese.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md similarity index 71% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposese.md rename to dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md index 0be291cb29e..1ecea1b20a5 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/propertyexposese.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md @@ -2,4 +2,4 @@ Each workspace contains a flag that specifies whether or the names of Properties, Methods and Events of the Session object are exposed. If set, you may query/set the Properties of `⎕SE` and invoke `⎕SE` Methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in the `⎕SE` namespace. This parameter determines the default value of the flag in a `CLEAR WS`. -See also [Expose properties of Session Namespace](../configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). +See also [Expose properties of Session Namespace](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/qcmd-timeout.md b/dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/qcmd-timeout.md rename to dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md b/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md rename to dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/ride-init.md b/dyalog-configuration-guide/docs/configuration-parameters/ride-init.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/ride-init.md rename to dyalog-configuration-guide/docs/configuration-parameters/ride-init.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/ride-spawned.md b/dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/ride-spawned.md rename to dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/runasservice.md b/dyalog-configuration-guide/docs/configuration-parameters/runasservice.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/runasservice.md rename to dyalog-configuration-guide/docs/configuration-parameters/runasservice.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/savecontinueonexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/savecontinueonexit.md rename to dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/savelogonexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/savelogonexit.md rename to dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/savesessiononexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/savesessiononexit.md rename to dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/serial.md b/dyalog-configuration-guide/docs/configuration-parameters/serial.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/serial.md rename to dyalog-configuration-guide/docs/configuration-parameters/serial.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/session-file.md b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md similarity index 73% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/session-file.md rename to dyalog-configuration-guide/docs/configuration-parameters/session-file.md index 3ea7ee7d121..4b9980afbd1 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/session-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md @@ -2,4 +2,4 @@ This parameter specifies the name of the file from which the APL session (`⎕SE` ) is to be loaded when APL starts. If not specified, a .dse extension is assumed. This session file contains the `⎕SE` object that was last saved in it. This object defines the appearance and behaviour of the Session menu bar, tool bar(s) and status bar, together with any functions and variables stored in the `⎕SE` namespace. -See also [Session file](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also [Session file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md similarity index 53% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md rename to dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md index 9b914013101..c996a14cc7d 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md @@ -3,4 +3,4 @@ Specifies whether or not the Session may appear on top of Edit and Trace Windows in Classic Dyalog mode. This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). -See also [Allow session above edit windows](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Allow session above edit windows](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/showstatusonerror.md b/dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/showstatusonerror.md rename to dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md similarity index 52% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md rename to dyalog-configuration-guide/docs/configuration-parameters/singletrace.md index a6cfc859a2b..2e091f5bbb3 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md @@ -3,4 +3,4 @@ Specifies whether there is a single Trace window, or one Trace window per function. This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). -See also [Single trace window](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Single trace window](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/skiplines.md b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md similarity index 61% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/skiplines.md rename to dyalog-configuration-guide/docs/configuration-parameters/skiplines.md index d72bbb2e8dc..9d23708fe73 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/skiplines.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md @@ -3,6 +3,6 @@ This parameter causes the Tracer to automatically skip lines that contain no executable statement, with the exception of the first line in the function, and in the case of a traditional function (not a dfn), the last line if it is a comment. SkipLines is an integer made up of the sum of the following values: |---|----------------------------------------------------------------------------------------------------------------------------------------------------| -|1 |Skip blank lines. See also [Skip blank lines when tracing](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | -|2 |Skip comment lines. See also [Skip comment lines when tracing](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) .| -|4 |Skip locals lines. See also [Skip locals lines when tracing](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | +|1 |Skip blank lines. See also [Skip blank lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | +|2 |Skip comment lines. See also [Skip comment lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) .| +|4 |Skip locals lines. See also [Skip locals lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/sm-cols.md b/dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/sm-cols.md rename to dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/sm-rows.md b/dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/sm-rows.md rename to dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md new file mode 100644 index 00000000000..9e95478cf37 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md @@ -0,0 +1,5 @@ +# StatusOnEdit + +Specifies whether or not a status bar is displayed at the bottom of an Edit window. + +See also [Show status bars](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md new file mode 100644 index 00000000000..7a825d8c0ff --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md @@ -0,0 +1,5 @@ +# TabStops + +This parameter specifies the number of spaces inserted by pressing the Tab key in the editor. Its default value is 4. + +See also [Tab stops every ](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md new file mode 100644 index 00000000000..8f6057e2e46 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md @@ -0,0 +1,5 @@ +# ToolBarsOnEdit + +Specifies whether or not tool bars are displayed along the top of individual Edit windows. + +See also [Show tool bars](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md similarity index 60% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md index f0dfa66c53a..efc4cae56d0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md @@ -2,4 +2,4 @@ This parameters specifies the initial horizontal position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. -See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md similarity index 59% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md index da0ecc3f7fc..873079c3c81 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md @@ -2,4 +2,4 @@ This parameters specifies the initial vertical position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. -See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md similarity index 78% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md index d1d9522400b..fa0e3fd8745 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md @@ -2,4 +2,4 @@ This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only if **ClassicMode** is 1 and **SingleTrace** is 0. -See also [Warn if trace stack bigger than](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Warn if trace stack bigger than](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md similarity index 57% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md index 48d75f6e954..2c43d4587b6 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md @@ -2,4 +2,4 @@ This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. -See also [X Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [X Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md similarity index 57% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md index 5ec33c4c196..880e5a2491d 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md @@ -2,4 +2,4 @@ This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. -See also [Y Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +See also [Y Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-on-error.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md similarity index 64% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/trace-on-error.md rename to dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md index e362f57574d..70019937a9b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-on-error.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md @@ -2,4 +2,4 @@ This parameter is either 0 (the default) or 1. If set to 1, **Trace_On_Error** specifies that the Tracer is automatically deployed when execution of a defined function halts with an error. A stack of Trace windows is immediately displayed, with the top Trace window receiving the input focus. -See also [Show trace stack on error](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also [Show trace stack on error](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/tracestopmonitor.md b/dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/tracestopmonitor.md rename to dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/ucmdcachefile.md b/dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/ucmdcachefile.md rename to dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md similarity index 74% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md rename to dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md index e4d6aca5213..8b051fc85f0 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md @@ -4,4 +4,4 @@ This parameter specifies whether or not text that is transferred to and from the Windows clipboard is treated as Unicode text. If **UnicodeToClipboard** is 0 (the default), the symbols in `⎕AV` are mapped to ASCII text (0-255). In particular, the APL symbols are mapped to ASCII symbols according to their positions in the Dyalog APL font. If **UnicodeToClipboard** is 1, the symbols in `⎕AV` are mapped to Unicode text and the APL symbols are mapped to their genuine Unicode equivalent values. -See also [Paste text as Unicode(Classic Edition only)](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) +See also [Paste text as Unicode(Classic Edition only)](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/urlhighlight.md b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md similarity index 79% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/urlhighlight.md rename to dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md index fd0c92c215a..8f5b09e7fd9 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/urlhighlight.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md @@ -13,4 +13,4 @@ Currently a URL string is defined to be a string starting with any of the follow - www. - mailto: -See also [Underline URLs and links](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +See also [Underline URLs and links](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md similarity index 68% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md rename to dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md index 083c57ebf03..de338982fd1 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md @@ -2,4 +2,4 @@ This parameter specifies whether or not Dyalog attempts to use the Microsoft Document Explorer and online help to display help for external objects, such as .Net Types. See [ ExternalHelpURL](externalhelpurl.md). -See also [Use Microsoft's documentation centre for non-Dyalog topics](../configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +See also [Use Microsoft's documentation centre for non-Dyalog topics](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md b/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md new file mode 100644 index 00000000000..0b0cf22133b --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md @@ -0,0 +1,3 @@ +# UserConfigFile + +This parameter specifies the name of the User Configuration file. See [Configuration Files](../../../windows-installation-and-configuration-guide/configuration-files.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/usexcv.md b/dyalog-configuration-guide/docs/configuration-parameters/usexcv.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/usexcv.md rename to dyalog-configuration-guide/docs/configuration-parameters/usexcv.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md new file mode 100644 index 00000000000..5721b506042 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md @@ -0,0 +1,5 @@ +# ValueTips/ColourScheme + +This parameter specifies the colour scheme used to display a Value Tip when the user hovers the mouse over a name. + +See also [Colour Scheme](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md new file mode 100644 index 00000000000..4c5a863cd9d --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md @@ -0,0 +1,5 @@ +# ValueTips/Delay + +This parameter specifies the delay before a Value Tip is displayed when the user hovers the mouse over a name. + +See also [Display Value Tips](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md similarity index 56% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/enabled.md rename to dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md index 00e49b8503f..30b3931c29a 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/enabled.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md @@ -2,4 +2,4 @@ This parameter specifies whether or not Value Tips are enabled. When enabled, Dyalog displays the value of a variable or the code for a function when the user hovers the mouse over its name. -See also [Display Value Tips](../../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +See also [Display Value Tips](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md rename to dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearch.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md similarity index 57% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearch.md rename to dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md index 0d7e168edae..41210511d32 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearch.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md @@ -2,4 +2,4 @@ This parameter specifies whether or not Search/Replace in the Editor stops at the bottom or top of the text (depending upon the direction of the search), or continues the search from the start or end as appropriate. -See also: [Allow search to wrap](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also: [Allow search to wrap](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md new file mode 100644 index 00000000000..710c82111e2 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md @@ -0,0 +1,5 @@ +# WrapSearchMsgBox + +Specifies whether or not a message box is displayed to inform the user when the search wraps. + +See also [Show message box if text wraps](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/wsext.md b/dyalog-configuration-guide/docs/configuration-parameters/wsext.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/wsext.md rename to dyalog-configuration-guide/docs/configuration-parameters/wsext.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/wspath.md b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md similarity index 79% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/wspath.md rename to dyalog-configuration-guide/docs/configuration-parameters/wspath.md index c44217d45a0..995ce7d81af 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/wspath.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md @@ -9,4 +9,4 @@ The following Windows example causes `)COPY` , `)LOAD` and `)LIB` to look first WSPath=.;D:\MYWS ``` -See also [Workspace search path](../configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). +See also [Workspace search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/xplookandfeel.md b/dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/xplookandfeel.md rename to dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/yy-window.md b/dyalog-configuration-guide/docs/configuration-parameters/yy-window.md similarity index 100% rename from windows-installation-and-configuration-guide/docs/configuration-parameters/yy-window.md rename to dyalog-configuration-guide/docs/configuration-parameters/yy-window.md diff --git a/dyalog-configuration-guide/docs/img/object_arraynotation.png b/dyalog-configuration-guide/docs/img/object_arraynotation.png new file mode 100644 index 0000000000000000000000000000000000000000..6ab90aed2a8cbfebde01c37577f812347999c923 GIT binary patch literal 16139 zcmeIZWmH_v7A@L9aCdi2aQEQu?u5o&8+Uhy;1=8h1lJH;g1fsr32wLZ9Ut%hIb*#0 z?=X6|RIN3u)~s1;S9LX!%8F9R2m}ZK003D=T3i+U>I1$4;9$Vd!-~kO0042Ym%27c z73fap=ltFtUV6Y;u*zL{X_LU!n&oboOQey+KoU>i-e z9hdI4{#G$9PLbQX4`Fxv_I$_s)}NQ8#=)AJsW<*vsIGsXUr7Dw`RMMG#m>v!>-%3f z*-x)6p5F((NDzEbCu%sq8@~Ci`s!~!%s;&M?VLQpT)lr4kFGgcAjS3aRi2Cz5UN@T zT|N>0A*9r@0R8Bq$JMOcwcfKhad*>|{P@iISc>CL>V9^!8oyye?nQsa`{RjNzxMe= z%m)YUH+RP51NnwOAv1{l(q*%JeBz-I1M<3^XNkFzO{m`a_@e&$Y9_wu5_sp-3$+oP zA=LGD>y+k4>f<8zyqDbje81}ue|NY)vEunAXrbXU?sxumP+t1iNy&P%v;THza6KwclcYs0Js%2Lm*P{U142`@{ zs%iaZh)X8!<7UjtlmL-sAkD9q0ZRCnLz2+NjV^wrW;ciM&5WRgrpbR&|1WFxz>Y8u8f+p8B)8^ZVk@ znqJ79^Xe{)jhV~V4qedQtc|O(mDP>w50m4m{1@jP`FC4Vcuqx$QuwY7Q?z^RJM!!k zY?T>yw|iRJn|&jdRc*`1D|WJ0gE?;NW(#X>LMhAew7H<`_ocaRk5cp5t#$`~504A= z`|CQtxYfLX4?_eFjC;QDv^+8+`1rr360g1>DNh>m*3b1H#;TTPFYO;i?dq7RI)7Fh z7&2NNFWvd*e3#Mc;K|PV`u%!;BZFOb&7ZM<=uj%VaImot+TH6PuR250k2dM^7U?drDH z@E%yvz1s$s(=vz?+fDSbaAvShtR*EA10@^i~? zJ**`?^J4W|!9jZb*%Rj*OU9bK%tUfidV16UBql;qfv838M(CgvCJ| zZpVYHmPBI8J^r>sK%~AU8=ZFFCXlq zm#VT4lm9rPYpsZr-MRI++NLGxlEHg!7A%egX|J&oFYTsAS^jfRiIFy>)neHXJ!qKV zgl9d~^jbE@`fTKhC`B#fWzu(6m3)CmUlx}VCZA&tLya@a~m ze8G>PqcwL410NrLQdSGclS@rn!2 zNun%KSa*xtXB$?Tu%|q>c^vwB=BmzV56X8uYQ(Xyt=cRHMkxr>AW??67RIZ@p<&vn z@hdvzm(J+NpoAtqk#GGHOot~-l(KmCJeXWr?6P9@*9k{J-_V`rXcs~{C&>;)pHB%M zVk%kg)YjNZylz#WTT9hG8Wq0=pt;BIpS~dn55< zWn9_Ho?KB9jiB`CgBuREXzyTfj4t|U=2M%r4~=S6NS5Bj=a@4~c&P7*eU4=sPH%Rk zgbs6sL(8E_E$ZUJZtz}T5_f%mE@2A@A#22_T({<`QSu_7zVhk>9FuVLH37Pr1m)2A z*7}Kz$}-}MYte8fe6jo7MCqLhixZ+I-Jmg!<{_>qJzHw(46hD&`1CEvI}0o5cG;q~1P-|NzUogP4q7AGlj-@44ipDU=Jz4cUq>TICH%++rnIn{ z>uD@vz<-X*#z~c6y{Sudh3pO>DM*Qa?;Xuf$l#81$ojRRKRB4pdqExGiuQ59PK6L3 zi_)J=HQRUQ80Bk_jycC69RVRPyD;=TB}?z2UB!*tQl`v%m{3WmR6YhkHKpY@?H1Ea z?HIJ5hI;9QhnSoN*_Mq)nfi;UIeYtX)wSBla95wfz*~GNm}34 zk}GQvdYvt@P}QAE?=)T7_a!{w*%21IQ3;TR$w>K|i9d@qRKS&4xsgnm{Y0G5dkoFe z(Ia+R%JOzo3YCzjAio+U=wXP3EPfs}eo3eZj3*k0Qc#~fahYtAj-u3l?JlVeIHOV# zli`25g1($pr3l2}IV0y5=l;Xm-C2BNa<0*2->DPsR+YE`BwSpB3@JsxLD)8n~W1MpDQb zXdu)b;}6L0j8Qc1$(B|Oe`)yeTNt*ryw+9_X$wC@OMWp|F^jyE_&R`Z-Gc=Um4}2n zB0wYg&>Tnfs#{%Z20bE@&^emHR!qyNW!kIX#liG~zrj)g9+{b5Y2qxvOX`Xl&< z6o{~zW;+IzVn4GU?OGBpf*87Ywe~jUS9fMmDsWS{x(S|0f^qI6fPF|pFkxz}>wtw$ zGQBd3-}g3M1=Z8Yw;Kl`J8WjG@RycS4@i@iOouoI&0H%(J`-i|XDvkd0O_g>ZE-}K~$5)~M}a~46&4#DEc^9iENsdE11_qe_yK_VB>jpyy2MvaYZ zhmnB@Efdqe7Y7rbf)B$5vjb|un3REg1#n>-k{h>7`72XH`%Tc)@}u2@5UVwn{tXP>h3EFdAu=-58rI8p(Qf%O5y}#ONvdl&Y5H9@N;P8hHo;DnZeLY zb)dV%7z9TQNEXJbiB=37N$;ibi8|W&oN&Bi>~3xcY6OrXOG4ZDd?bp~av^HbxEN|d zLZ0%F<4E;8%{(_>Dq@+FeMblMvh+@eu#3G1>>3E)sKMYR784hWIFK_B9g3RbE6~=Z z5@40}tBB$SHW6@&b5a_|4U9F8Dp7*SSDO<06x@jOg=1zDkIZNER?K~Z(?LZulf zk&5+(PkSRb353KEqVp{{9rCzA3iUhV6>(fa0c|M_W6>9r0fFsIkz9%DzUsIHgyBzn z?8l=l zDV!f?ba6AQ2`f*}Xv^+?( z9lPwD<&t90mr+Q5*yiD!6(?%8abszUC*cCrkCSQEO{Y{srlJAyLvS(bI*irLbXO!S zrf7)!($EK!f$(X0X>Jfrh^s9=)0QxD+UV|wQ%sAJq)?Bi9 zDd9exXlm-g;ZnC8humJaBYoRXY)yF+yUy58jYF7KGOd!?P+!w9gd1A)cH!0&P!_a2q*si9`ty6_j;2{Yis>P2{E3i-*N_6q{i>zd7Q5R#0;i!Wk^xbf74CRzv(kRaI z%du-A4X?{vWRUQeMV`JpKE^nu?~B}2Z()*f^~GG;T+gQav#A2~tAT5E>ad@!5ZAPy zoTuc!L}xhic3r@jx-+vJm{Cu(TQE{0%3!L+K)<|Cn6aIqY*%i^vT^IHw*Pr0fmp7t z4|i2VfV8DpVlQn^^ZWfbl&86ZtXawdOUlzwulIMkC{f64k*poF+Fg!;S9iW6`FoAs zF%oaN8ei>uD~W`yh1%TaWd|vvVHBeEPA?NM5uap|l?~-S$4Brj)RJaFw&Ow|zt@w$ zvHK+nn=}?+v3ONS!J|?XT%`nAeoRX!j1kyi1?Q?Vx#Xuj$_VfDzPiC?y zIk8ln36AqH<-DiO+;K)aQ|(x#Mf<%*iO{eUeEujQ#z$O5%wD+q7wBw8m z+jt|XnD@~ZnJ4A2MM>TraJo3mr9kafofURs*-qx!ZWYW9;pm_Z=^irdn3NI^3toc6 zWtH^`&Cz{H>aouK1%h!McRM@JlIu%h30C1qZRY!s+mIKhPC~kcmY!Xan`tBHhDoe7 zS(>UJmGu5Pzs~s*3RxF&EYt!Z?4nZ#;qPIIq2mVhJ^~gBt+tbxXE@eWcr5bUO+>VF zSmhwXYo}bHLOKn&7o=uZ&Au7_tdL0%Qu;lgB)e&p*-nM1E&S9xZ#ftvt;3 zqE0`F7B!0}H)#_a0DlZvknOAu=uggpJ?=bA1N;b3G7kokRMjL>tY^h1HX~>|;{=&7^Quv=#fX1m z^)>-D<~kfvnQ4mb@pKpsARb7u7(v972ua5SAFpf{ zpr5jBK2dp(6hPAxW3@M-`w&dW>lFFZX1s#V7W=>c;+^Gr7xX9+^^4rz6zc5EnHH-% zz^%@71@lyGi%k=FMP%-dXa*U`wPKLk{<>2Dr?<*rWW{5-z9sHPw%D>Y2Yd zZzZ0fppW+R!^ckca}s87G$^nIjYrmO9T-vRP@g!c&}#G+M|V0CwFw^Pgk&4jRN0fP zOSj_Ki82TzKIEr*iZxlX(rF{;s1Zy+niM|EdG42pxtO%E_irg+pRbO&E}Rbm8kafp z`T5!kqljc2J0;H*SfX0qbA6F?k~!pqOxY~6>(C3(KsHpoI1Y&mNg|nU8MmIq0U6tx z6Z`!T*|7-6%jSooZ!C@5LGnlpua;SB?nRTJ^?_5KSrYm|8^}}m{Su%nb~y93p^Gbd z6@kVkS(~!VnO1HnBqT|q0Yjv&T?L#d7 zYWV)>_(@srXZ!IV3NNnYYTknXDvck?w@14kwMIlVpBvC_n>YI~GyBM;v%P5J93h~A z_yePyG5j_TBpn}26V}6_6x{3?F|ak?aDs?B5aZo*Q9$0hlJ6_xTw?c7DwoKnu%cUF zDb$D*+cA0Pxf)0k+gvh1a0qd+>@W>KR+|r#(==mlouD@MPCpqbkFq}*n9f&;GLXGh zWH|xq-mZY?5}ukK_{fM!y;VP+Q5`?5H+fFD$;RG{Tki3;O3MbZr%v_x7b-%uq@dz- z$Lzw7$ROEGsIMb0L^$j-s>RK0RA+Fo)zjh@RZ3>AomI=A*l;Mh38YWy=SAAP z1!|7INEARn%rxb<#)e)}4!DZ?#Bp2FPNf}qdwk1k5X&_SU8r}B>Pg1N5Es9%v?4Q! z9mvvdi>ya24r3^d9H6hZHbPiq#8O(-$Y!iqFgMouj=~vRlKFN}Kr@i`xgB!chxPyp zMl(HmUowj%v90Ch+vDq?Ow7Z_sI8eAZr&6879aeAmh{X`Hy6dN&c<8!?sYbcu@# zD;m*fohERNXpl=yKFmi%N9cMD3?KfEO0a=vmE61GQeHLA&8LK_G=U0uA(OvZ{LSlX zX=H;qCQu3kGVPnPtDG%(iKq~J)?p9Ta*M1j(}VKf4PPrt5H8I`fCyt~`~i6=;(I3Q z^~G??z3k!8{6@qZ8(Dj!MhvOa_0)6TQEev6I|8C|bx#7LHh5_&Zqy;{;8XbFciUe+ zr`L`P`>4NNP84(#W*MylC#(y7d_E)6YW^ymKR5E(tAPUbfn+05uCeu}9}K(U{Tmx_ zqDAGBFi0Rmzb;(;=yplstcB&_p-U@p@ylPZhw6DN;q-1(ojJbzDab}I7-@*mtedyS zP!2?Ji+#LVcbF30aa8wpYwBRWa{2vmICfjWJ@%cFN9d;HWsg7TC6neF9Uwj_PN;3z zMltJsd~*mgz9`u9QKFT!>Nh2=LsNV}ZL2AyP^sncSAd z*oCH#Sr)n%4P}%xdc8=E_IUL|5~Y{V6+OL<^N3jc^U2-)a`1iR!yUBzv`A3lj(DEo z7N_98AI)#Ot<7SCIExskuWdS?M)sF`j2tg9TGmHN%Z(LEbwqa_e|74bywAg0sHz$0PD9oqVVR++mc4l#7If3#jhb$+B zdoFW?H^#T>7DiJt|2~G$ay3RL7VDV%bkWLo+%kX*Bhc)I>U>hI==sBq>@GTv*?_0$+*H{oUx>|IwdI~dh<>`v^0)g-wZQ+3#2}e@mYBKUk-(q zuOtJX3M1;C!q;v%G(+qQR(B_>8e_LbgzTu#JW<0&%9^9=_6laAzoGWoi@8|B&hV?t zPb`BfneBvnaP4Y{AcIjNBQMfR+nr)R1Qveg^T8#-LzYXcOO6sI*h^MWswdyPs-iPvKJ< zemm_uAg6EihllyicQ?w`a*Mc-y6BtLXdRS_rCL>{=y9%j@gRLnYej$^HjZ3qOs-=` za#_AeGnU;l(T=1BVHs+wCHMTk2@+?bYGU|l+!B5^F4>IFI zE#IFAQs*Tek4~x^k5yUpN8(ZKXpymz?h7+nW~kfEc0D63+A1)kbaLy6m6^g-R_?mh zeHr$bEI)=7gOB%Y#H&>3Qv;W=>3KirChPHwm7Y6)XJ|g=x7k;>RfIf@n>XZR9u%bq zlUy}^zVUpliP!uX6c>22s>}@wfASJajoI{NqL@t7BU{_hFlu*X3>3dHLw;`p;y9c) zk(O3wnzR#Z%(hLXe4oM>udimQigp8K-h{)x-ukf&Ei+CKQBNJs+a!>|>BP9b7amn~ zqqDWujkpc(wO`VV1Pi>NWhpln9p+2Fzx9gyplEe`{bCcd08g{{(+Wwf(M<5p47~ktXrqD#Y+YBD*58Pk98~X_;(}~` z{D|+b2#&7*3jWHL>>gs9iRXQrbmW^H0;912&-q}xcYM2hz+@TA+-W92eT+@@Dm{Iy zIx0}>cRs2}2rDJ4no)?D`_uhGc_+obrUZe6JApap^pdx z9(-T`J2McF%)`#s-i6OYkm4^~KJfcL#mp3Bf0=-61Szx?l*z;#oXyBMm^heN7$rQc z+}J2SB9I9M7wqR!E<>h5&VPj@vV+30; zx_H`yfF6wYE|h;D{)QoL=3?S(7Iv;G^DjJ*p8Xm4Wn2MP?%WCh0I z;o;&2vhc7mvU9StF>>&5b1(u;c!7*OT)bwytl$L6Zo>X=5K7KgU{wNb|Gig#piIF~ zY(P#fUJh{cyu92zj2x`2Y>dVnCLD}xKsI(>77ieg*UaQEC{q(YNe5>;Ab2>f?0^<# z%#QXJe^vY;oKHkqMv#JyiRE7<%C) ztnT1oD@gIDQ)GWU{}MQvz~6>N+R6oN;rU1Ne^>q{*SKz(e+<3@Lw7KPhJ0`>%U^)zcT)xy8eHo3*lee z9W#6I3dkM2nSm?OxCC#6V2tIY!~s_TL;xag!tW<=3B04UjtcU z7VJo3P})>vNAGYH;p)CvdC^O#u>bCu8+2|JQ0?w9*$hD=3UU{(n|MTm7_~Jt_PSZ*ne-O#2paY6-$)c@Y~Be7Kp3j2 z&4_(SC3&|waqRU-BH2$W>NPIGG{;b4#it`|YR=sG_3QZ9$jFB@wC&#g$EfxjysVV? zUuK;553;6#YnxAY#H+8`E0%X*}!yvG*J|YOJkRpGhNOBn!TN7n?}^P zv1Qp1gJ?+f?UgLKY!dq9;caMr8lver>l=WmG=$z_v-KRDf-O8DfPh0+{-p>Yq~9{u z&+C&1Ovi&ri)85N>hjB%EaZI`kg8)?S%jXM9zWWA-sBnE`IBIy8fm}?Rf_2|31jkb z3M3b$Zi{TOmto-)kqKgZm1t-JiV;*daS23CG0~6y?>4R4UXZ;k^zUpXA;($d$pU-; zinjK*TCE7=BR%h!dlZDo$|sKMw=f}Kct`~iK(OrW)T`Zx8qRm zxTxqF4wgeKR9bd4?bCfYIc~+0E3)z`2$&G=*7z{T6ZNGFlFS70DYdA#MP=-87ETNH zJ(aPd8YEUgyjA8aDMUf8B4IC!8XS3EeeBdk+MJQC>cx$5 zJP@^EXy2rSm+E$%AE1xX7iZwfGi-YsKfP8+YEJ{d_FjpF-ro+yg+e6g>cMl!1J|&y zCwrnAb?wk3RH}^f-dBr)&D1N;kJKOD3Avjx;i1^jCkpq3V4Ps2<+Z5C!Iw)pgQZ!T4WE- z?Y8(8UKeJdSrFuZ>VE$)Asd*&8qj?A+NCLD@|;Oorgj43?N*CB|MmnOLFabDS-j^8 zr?S6eYsJ}M)}O&{;dn4kTsRAKa6n~dW{$yUhe1I(&4ZOtfry9P zfY=bUqDMmwb>Vm zNmD*LKaUd`8F{$zUC3rLdwmOV`D6D-I`;2(l?dyIghTMROVidduVghEi`_3bH(F|O zj=5c&sZ9DUMr?}!Wi74nloTvW4uT!eBP{5uti5nBtNbCvLQ83`Vv3*2dlrkHQD~jM zYD|N9aM5*SO=U7@Gri`kG3<=$=@H%WI8ykAp|Z&5z+*@2V4s< zp>75t+<^Zt0=I^SR8nJ2a2p*O44Q({*7Di>=_>zvk2i}<(8=fhwTb{!HU3xt-&7izh-Z@F=6I(8 z0#KxCbsl_Kl{lv0b(63ayG2q(zovJOyRNSn;3WtY@(F)Y3A`$Ai^mE}DlMgzj3+_< zSZP2Td*b|_@QlweY6(Boa@G=gJtI-69q2GCXKr9m9YV&;j7qDND{f{+9g!Oi!R@dv zZeZ|auQ8D;n3$0|*%P%fAv8 zasx65gc5GHU(Q+8I`CIDiJD_~mZE=@%wtb^mn=~~?9 zsH(fMTBl}MxvDo>_5vI*L^fi7!+{~&e2-fXViP=|*#6GLJjsRaxcSO)np>83*-@IT z!KU^8=H3q=Pfho@KIkGd85|^^Sz~i-6aY)=WpLp$#lEQ>54Ur#KgOH zqpgyZc!x2it%pm&e$i(8=5Oz=Jr1FWWaeM=MU(&57pY+Fi)eoS$NrrS)=kpr?AyA~-yRRWvyVd#7Cnf=-HXVTc*wnF&}@rK!q3T?0}Jsb@uC|qX^?N6 z2fj*_j3I4p*+vIX{kQ}*f~nY%V%z?{TDu~ymzsNO7T=-4+}pc^V_*OiEEQ9GC@@lr z+az^Q$jKPtP71qQg(P`F@=Y_Rbt3K=c-5`9#-M3vIBw<7q1XAS|H+hzMbQiGQ#{E~ zEdJavk#MkNv{l}7fN$y7rt{sY1~Yy;S65eQ1%*&eoBOd~%;(j*Ek>dF;dhINORsVF zZk{aJw$$-23Wd}j-ZSv0LcYj%9MwYdVZel}ESn`oJrNOz>6w{Wwhkr4%f83vXCt`% zS15f)BMHY!R{xolliZ%~=cp%kM4$8N5Kb0q2AAqB7%@FCcUM>SeXfUTB?CY16w}t4 zFS~fHQG$iy(|BL3Y2wRBo}R3-XslA)m80Yi&RgI$N=j;~4vAw$#?jvXzVWa9F-faS z@O)0-*we`wi6fasT#}P)AlTXXB=Q8WBV_2==QPu>@+q^VK$%WiPtS%c!rU`lNcX7A z_o>!w6sHj62s~8N{`hL8XeR3WWVG;QUd;ysvLj1pwnECUCJ}TG_1*OZ2Ll6Ra&pp$ z7iT^5TYY_<$skJMDnFMG+B%|%yDs}PwEL+()}*z(5**sYgVLgN%gtpaC8C3>lM^eL z6Gj(lhp)u^Zbo!h{&`|KS(!B`CG2kn1ff z3Rz>mBhOdF{XGotC_gPVqG!Lgw-$V3rs|k-v*+2QIrZ`Y?jN2>L|--5MW zZ9$ijkvUwbAuaue?SA4^FS%x%6b2~sq-rK4f7keXhuw@5bi%vYLbX*{Rn^z#dV+>& zl3iovjBkJpv#Nb@`S|E%YHFI_)Pz&1SuN`9%%*Q(pp$lCMf>9^IhVELyO9Z0qI91Z zZ%b`08ZkPv(KKdmJ;fO*MxUM#`0SC>jqjf>r}>lG z+xe@iUfE#{4GrVc)A7``vhEP!L(qKQUhc9-knmXYPXOGXL)+WhD5$7*>+sy?Dl}m7 z8h5@73`nZ0tJij|4-dm9(9;1S8SA)2exVbWlUW-8IR*0*fPZu2L%)h*vLcTDkDapSY{5OVTD*zDv%{r&+V8nQ3&-Wm z(eZJVsi~>#up^VfxTB7Uf;sENq@*5CU+?t}&&#W;t-Psx%#oQHOmuYg>=9ElGje9; zcoze`X8ZnfwNjo`cw}T>hLlt1ZiP+(KIdKOkkC*kfpOfDAYn8~2>A+^eFEhQzzs5cBbdwFMnKWuL_?bnFR35M8X zp<;G;I4mtJ0~6ENHJxu26(6W*Xq=ZV>}_liLq&fa>E-XUG%3FIyS3`aEiP(bP--jb|*$Q4`(`)7{<$ZkSP8t^|;vVkrhjwyu$`-f->xq(= zx3wSLLKJTPt3mXJ|H0=>m)GY9kNpe_zR*BWhM*l-R1r~8+p}?MrHa6vfmqZx|AX-y zVn5}5mCmaHLOgbJ`2$a6H)uqMr0?H_N))mN%H_ql+0IP@&3!$*u?u3HLO0(^>3lu3H1m@xQ*~&sb zdA?`?%ZgTrCwBO+E3%-R9AYd4=u*7SLhW|{x7Uu7QXPiun(^q$O8V{XZL+k{n`1q7 zbu1WElAog=Gof2pog47kB(>;Ozr@z0P%fG`x|D6r5`3c|y} zjBihua?IbEJUvSw^~#5YzNe!rTeDLIE3h9NJKq`u!3w$WS85%PP_t~d1rmJo%)sIv;+gr3S#`2GXoLex9$tt`c}>faa>qf7=Ouq zDExMKXr-Nlda1SP})`dDG!n3*N#gSI)t- zDutu<8_z3d-T!cO)ZGXJpQ+ZhDHbT>?FP2BwgShqc`twc+95uSi9y;uIB;2puZ%xE zJJVr);2LWXSo;KqbWF8EVU~&(}p)uDKC?bnVDM-ftBfCN&-uwnp?d1@f2ZBO8*uqkv{*{r_duR=n+pYL57L*+{7g6)h!j*cvHQ6F$|an}LdT2Wt1^Zb^7 zcSCIU<9^z8wTNYG)kjfMQc9k;GBbnr_xJw=$YV1@D5c_mtZ>-qf8hj8Fc?X>I`;NJ$JS;SfX40MgwlO2^P$Ly2@rhcq~Ji%2(;A_9^E5`vU;Ny9sO zzxV#WcfG%V?pp8r-#u$hoafp5^X&cEah`Kdw5GZO0WJ+L001CRQk2z3{<{ADU}GY` z2Ubp1004?Ne!2#p+U9VetGkP}og)nB>FWvu!hGzk0RW%*>a161y;{qJ1$@6!J@5_s!&I3vEGc_b=`|^yu3)4sb(wD_V_e+%+vTaU{k4K ztSj&y`tV@+`fdBt>Y2vi=j(@gGQop~?Nyg&mrZN?x9DRso6oLX3!tVhvH8okM_zYV z+p=%*Fye+ztUA=EOdjFh`Sy0GkLTOXeY3w534fPAcqWu`bwhJo-oLn3)3J1Y3Z*D$ zBAvxqI#>x=e@k>kEjjK2Mx3xLcf}F468q5mOrIsqDq;^kb*p2Lhdr@bzse97YWj{JMw(B<%CeX!pMo%aH zJv1~i^15L}Yubf-<;}_1|T0asOE_WVo-JX7@ zuS8sI*wjXd$=x=uso0u_D>t%j6VRR=Sh}6J?wL5Z4u_|&r7XFD2Zh_e#+3YHbIqzyImym?>XKE<;D7oNS< zjYXEA@wTPTl zptSk=S^kX&)d&+w^Z;j3Nw|6qQ@8wWszEs-PdbL9I7hjnyf{xL92IajlG7acus*Z-}t+>OenBDFA z=E3`orMeB5lGC2!Ji*TA!wVcaD=Zu~RwD`u1Fyi6QvT~B`jmyj%DL{=*`-{`HmOP< zpQ%$bhq{U8$NP^hCXC#s3X`q9OclO=4Jn+u6$aa+wz`1N9hN$W=1CV+AC7!ZoY$0U z2>vC?3OBtZdUShRcv)(CaS~m?L&5vrInphM?mbIgbH)=X9y`Kp#hxrJB{+v>Ucl?< zjld9xfz1t_BmcLraVCC&(r14C%6#0vyJ^Ce9BCpvq#M9iP}Kc0(A;O*`Xn^o4Mbqz z#WEaAoJXtiIXWYu(PFt4&dJK|7W;zMluNhueeT?h6ZT66JRnM3lgf)Q?ZG)au(lJI?mV1>#;Nq6c~rMwRoMzK*s zw!taUvcHsdKaofZ36ohmd5me|Qrn8=q{*++O(iV5wNPwD%;KF)axD)Y#(f%nP`6qS zM}fi>Es5HWON>sI+O*zH9TB6qslRWsJEkLomf+uw;gFx8FgV1;H`cvZXlgTtHLeXr zMW1smuZ!4raZR{k6gbe(<;L%|&?jwTm&>vFZ;{FIz`|4BT@K{DGDb9sUNV*U&p{d{ z!|;7qjY|?g0EG4Foq z2AK`1Q2bc4G#4hMuY7#YTw`-bjP>gr=Y^S9#o5%e$bIFr6z%0FxUVcg{$6RuQl3AY zgut*}_H|ASW!7z{@Ue~$7mLiQn!ydV!HrXKxy+kOb`^b^(IKjU!Zn_o6d%`Xd3AFi)J)Q7R3O@+7=DquW>gVMCKU;G8f@vtXE{;cW=q}Vdee_?v0bK< zMmN$W7O*_Ve!A25DF?Z}$tnNnlK?f?ETVHXM-TOB7*3xT(`T+)Jd-5GhR6t_ru1`Y zf?v+zudCz+5KQH}%C9II}}pDqkWmL7`$`*Phgrznc~pW4k;O&DfwN1R>y7m3Fo zlTWD2*r2w}dp9}LT=APIBDT09ZHd$&1dynyd!76~2S^2hdos%RV|=R{Y>sHEvg9+r z0?zmy1nCdH-m)>X7wqw zze{%-D3ifL8q2+yVXEq(U}|<9Ba&(fIwLbXIqt879z}O!23#`7Xo-MCe&w36U7ge$ zrL9nbY^8Q*|88_MeiFCS@l0Fj8AL9{oU7Xuy3NetFm%gdOZoQ9f$hZl#^@rI1j{vkRlk_(8N(bt6qLYQe90LT?AEkj5fU3%0If$n*afehd)lP@)UDRp-Pip_pKUPp&;1 zzMa;D9}IKwE{*J|ntp%-jiD2i&Xr*l3DxYWB91&4|MaDxpklEjkvs8AUd1ZG0*vp; zVYC)vMTYl@w*nh1iBg)!%4!qk5&2GNs)|#0^@w-e^v$toWN&`VPf~$MD3>x7lnIbI zvFoPN_Q~iyUX`&!l8sjS?!%Tr%XC?ao+- z*_|){INs&W1l~reb+@u($n}Etkm-5I<>u!@FP;pSEJn35jP7{O+z>U}H`QBI_mY_> zUCAil`a*U9E)GU%qB0n`$tunl*1W!{wszE1g(xo-KiR^{y*=%TcQO2YlPldjGEB0= z$k;A@z{C!4`;3ea#)=M(Sf!<2xDl|`)H-zK4ip#q@2QxFQ8B?Kyn(2loQi~aO0$gE z)vV{^Vy0>^t7d$y?Bs7=GEMLtR1N<4uv6Z*dcuoD_n1wb%s>b_E~o5t5*q;VM#=7n zc8c1{!gG@n2FiXFp1s48PzU!7>*0?w=8AqLxSEq0;Ed4rS&>Ixre$xu(kb3`Jpa<` zq!)x^)=fDY(a#r_IH#7yk9hg9uhFZ325d3qkQU?Ib9d#*Iay0E!%?%g4m7Xs>3sPS$HRq})B$$I*1iSV8);M-<;clC zAy*PXLdEaxur$p4VTWMG*aA$AbNyknpQ*7qoCuN};R%-()T)OtLKaVgbPpTP`fx!! zG&$M&>btG=g&D#7*Mm=*YA!5!#*RoU z|3zOW%}%0NNke*k$_!ZDKQuRwj<3;4aWX2^{uF@4^vxZA#5)|qn<2!lW}|Qh^H8}} zc=U!3uHdQijY7tK)h+|Vu4~T^wz`NKlH2@oW{;5N;2M}iYfyYt)$)AJ<4p3%s0Bf( zhH6+&yIU6f{x$CkWf}Y@LavsFS)Yj^2(Uf;?D;X`Q%051>o8tWYW8aZQr;ivF0b_W zUkL9B8>}Y<21t&c>Ujy%@$L+0ci}1ObsY0ZxRD_UM0V&xk{fQEM3XBA_ul8Y2 zWxk07&b}O?VVNb`f6@As{(8D2XY&&xzY8l$hr<(D(~ z*I(1HJWPEx&cfEaB#=(=u;)Pz%2O4=&s(wX;dk|J_II9eEH&dvdQ4WXHX-N4_unF0 z=L2dNYfd6;o?c!he*lH{-7X|Dq%Q2?5M`amIFWh@HtMK1O1yH%=NTpRsHsT)IPK= z?twGnzq0i&PU<2rv%M19Mv}sElM~sMf-1Cx=PdV`>;-+X>(HNN6hS?BzdPI#wX|r` zGGFb~{F0yiu);x+NYC-Jy;D&b@;QTv|M?y%%R)oYK3WojhDiKfj904e5C_Voo!?%X zVjrrGvC!kow*53kv~hFoc}gM8KOPXutXPF9JhiEibxSSr79Q5gkr>;Zn-o8`_+JySfYu4g78(b*$ zU+B%wA^yb#T2kN|E6hjpMQcFZg9fV92x^f;;)U*QGmvmt(3ioR?vL|+c*mU(0;qyR zB49#?l@s^gyjSg5P&kRp=c&3Rqv8Ni0m&8o^~Aa;~K)Z)DvRU<^vt=yZs<%sC8 zem~25bL*}ut!P70R5M<8CXeyCuL_MrN^Fd6?ant(Y*M`EO2JeZyp}8d6jl)!T)if_ zJ9>CVOEO=hP@L)*LqV|w4d^X0H5eKrsJk0&zCjIzFT`vcDETl}7QW;WaZ?u)-D-M> zXxRN=7#2~6`M4GQn)Jt>T%mItmsC$Z&HV-4@l`8ywvRP3uC zQ^Ec61(*}0;Qp8sWVD4h@77%PBjE5|v@sU7Y~B!)SBlA0h!XKEcGgk<6s$Nz+l$V* zXK%{K4)mAEdhR66H~1sB2@A(=3iX@uS?&-ex?=fCBfN9R0~YL^ElWQ+F52qynPds> z4w){`Qje~5`{!|Zn>1ZApIE z)i^-VwcX1w#uXR7K9D|Tvwdq2_;E*`AmOpk4M;M(&nKrI)oQ}+EAg?)nC+}E%N~(V zQrX)qm1$#|sTFsTD1yb{x~b$Fq7c|c1X(P0QdJ5rpbV{g->b5LX^|LpP6vOV3M5Xt zR^){%`^+?eGCa;?_2$fv>uD2(^@?L<SKmAr@LmQ({%ffH;>cV>+8L43ZHW_OeHrm=$G?}P2-yB zR4#M~{iJV6UGkG1mYr4w#OqHIF93N>Ckten?O8jMf~|HJyM;^-%oxgko{N6V-|i21 zLR`-yY|ir&2Ss6!AmF(BI&}gN&aG3U*U+ci`Q!^cL4sud)o9>uX*}!+={)6* zB2lr{moquLBj^|EJTVjHPZk1Z$VV;xMH_hyMK*?aaWey=)rgZX4D6`MuHGmFCKC-| zw)B4fgBV$zKgbifzLZ8RqY_v$k6hN^L%v0KrQ2OgRd^+4ipqt`20?A3qb!O$K-wi( zRctm3#NBKj^oF(jbO0%QF}X#Brk8mpn2-82H9Yzz45))HTfTafZ%WVEWw#eRY$%Ku zn{z^HiI`R@ApO`9crB7<1rx;}d_M)2pb+0nXTh?~NH6OInoLlD>u2;b1`*TnoG8uO| z1)1KZ420`AJ#DRA>{9kC_Fa7u4)k@V)np*;GOTtXnQ}_(JA{+~M-{?4ShdD~6(w1+ zOthm$+uWS!y@YF>Xw+O8c?KW1;(c^-B|fMd-M}~&`L>t(+J&KzSm`laP<-f1in=TG z#8Bq)2CTBfzB7#*gU%k#61<8p~=E8a6B2^~$1)X!h!_dy4%dd!Oyu>d~mUrdO5SF4P$C zCtb7+?I?EP|H*Y~bTI*qf56Lfy0B#9D!HqhA2 z*8j$k0@p=ru*@cNey?FNkhgC&PW4kWsir_Gi68uD&DPwkXPiM{!Y`K4(<9SwR*IA9 zbhQMM&HI7|ZC5E&nmpB1po1+F<;T9waQzj!M+3Vx1^6H>5Cb!{XWa2xg^6gj!o#|j zg4etzt=Sw@xh=Ag5i+A9F)qJG&UbyS%2o)Y7v3&XtR;*&B>UPV%n)Vj9)afmB;L*S zSHgzlx4uk$B@fdFQk!Un@2UBp6&_2I_xH;S9|@~IVhYD$be+K_a)>Q$@Kktcg7W&K z66W%-lLWkIWg~Ycib)4tv|#rxWc0w$zF!nnq?5*8S%o3>QB1Wk2ln{gMGrsazb6VYP)40n zjW+@SP{QnFWHgmzWd8ZA8u^4e=S7mZVy`4^zo||G=L0O!D9<6y+{aNdBFYb5nIY;Q zJon;lImOEoVBz474{_+}N$9T#ef7SEuqFg}fwIai!qKW2eXoKGvJey5A8hkaXoClh zm+?;TW&w0RgSC$`GCo(w1V24}LnIZ($IPdrQAEjqNNak2cyz`+{Jwqc7J`}D{t=L` zC^qQX%d`Z{o2&O6z3yYwPbOdWSal2KR=gSVnp+nhm5ap4qXvV^eOHO!8SI+1gg*PI z8C@F998;myndtTGdwc)0>M4VryqoZz_QvE5=x5$l18G#Hs6;Ip>IVi<6BS7oOmf$J zME6l^8p$ebPpM;R@yevbe_Zt3ufUtE&Fv@Da0i0+DHrajFi_hh-#afX4>m4}q1=ph zr_KC&`mlTV(e_y*1q2ndDfrb+BijK=x@h-d3O98!^Q9ebIO<`b{BkN$-H|zPoTvS@|^;e9rE3Qfto7R(#46} z+{(oQ#_i+u`wasCASU7CYHsNO^8{MJZ0wxHnGV{zn1FUx;!IBk)p*rhWni{;ihk}e z9Y1wlOFsuoh!vB>6I?MLC=$R4=4lS}adLF_fcl6t{lSGI|NkE5VFLaU@pKSpGEmb5 z%DA}0fCAhC+`J$;A3JX_(-T~vn7frVR9ja5F9_tBIFqfXrz@0)2M&jG!}+;g+--RH zAP@)-FPH}m1|cOt9=^_=<~|^259Z$x|GRs&K`fUfaHV6$J~{NkDHgr$%*Ih8Xlf<-bj$Y4EkR+Jamz-V0g4)9xh() zmM}SQn6oGI-yy6l|E2Hhoex z$^JJb(9L5h4;1{$6L130vAYQP5g(aVbr3JsG$lo9|-0hHAY3}%U ztA0aSA)(AI1S~`#0#+cf2-qA6Weo;F_^lxzD{Em3At4K40kELOA1EtJsJx52lQ}Y+ zc24FtFdkQDn?Do335QB)Dv2|Jxq1I*MAOmS(;BIOtN}Y`D;K!O|4ixHIl**1&42UB zCoBLF5C((6{9ry|A@JYy^oys z%-qw(UDw6MQJm?wQNZ7te-a!h_K&bA+Ib))e1GTsUs|0|{bId1pAgv*LgP(X-J$O>d_Z7qb1xD_u5 zVr32n35h^p{JhruyaE=Ge@FLlvG#D&` zf*@WY5HCcRj~~j<3kCBt@%-g1&+nT4r?+A}{}&%(e+2&41dw|F7(+G}WUu1+SF`$y zuiq5@e?0z*!~e$>kkJ2K;rRy`lXKbgc`}AQTH@{=Ah@wL#JBpl>!+f9MF-MJU zc0CH^YH}hC7i&y^^9%{?T$ol5Mpa3@S;PF4yiSZHLW<1LQZn1ZwXzvAydbK(YB~1zb!6) zKR8H8cyfiEl#~=Q#X(-B&lOK68j?PUiEhIivzOd);doKwIN$@+% z!HKkk&#~;>-0~(SdA-obU@$2kA73)#;q^h6g1I@OH?Jw+(p^?o7TZ$(TN|7Ri;&jU zHZm(Bqqh#Qi6&O)e)b|~&1c8vs5U)krM)9g2!81NL7v0(lRU-D;9Hoow>gu;Z z&xUbbL%SC=~h?KNV{4;PB487Zb_!LGgXQD4Y;8^n0-t zi~O5D*R=tHEl(&_+<@?%iJl%tXb-S*eF|n|*U-?QsH7A;=eV!6e{*>()|bYuGRHasVXwlPc@1q1>qs;cgK&+QVzV6cnr()_QaoNP!bQZlk@ zS~GF?AJ~D{d%{9!{XzW}J&jHahX-Bv^ST-)CiI+~oK(T_Ci>n7OSj)f-#644w|Rg6 zIbAub^oHEn4vUDsuUw}Tz4C2gA)1|?U9N8=WW+O+(Y50 zPw1GKOpJ`*8w4&A6NzQz-g>7do&Gf%@+N*v9yr7r;s$|aHI_%78bIb_ph$}tgNh}NEK2S@dGXn85^A! zmDBEcU6#ZGZjJ`~j-{le4BlH4q-lG6|A4W((3HTzCyuDB#9L@`Da9o~!Vu=ayn~#* z|DEBNC!0EH93W7CG}$An;6?NMyW8e~OYpR6OhQ6rw&8MCm(P(!>_g%B3RQJ=!ivgD z>fpDlNH39{f$jDA$w}|V=WK*_xuZ6*CzKA8kXErc)7r{P6Du({s~cJ9yL0a&4VES+ z$)cm9eKvF9j)9HOt0PR_mO@E-Z3SXVrWE75YihWyY;4HdK8nQm4ySP)-CZBx%|xuM zm{mP*h^bKZ@)9Iucrt>0bGe!CcCw*naamTzuA2YE_|RK5TZq78bF`Q95c4kF?Y=KNoP5TB0w9_t6#w6r4$h}2^ z0|NuauRx~86~FctHWStDot%nCDe1)hJoBBj+Q@9*`Tz&rqT=J(UcarXl67{jS$q&t zRrR<6&8NMiW6zJbx+pCJNjTHv$FT;T_4VW!7#QBuQDb@HDtgv)b+A6JXq_w))4)sC zw28xBA_?p)?F)RH(VU(nW`(lhu!sn4$d_E@XkScZR!mnuB|Bgg8?!uE>S*@f%QAB+ zD=+UsR$y5pUbVi8(~amN=~V$~t?d^ki%Vq6J1(_9OO*YlkU-A}0>yErjU$8O*FkUJ zkmYNUXWkQnks;;_e%JodO4{DOLM^(P;uS__W~MHV&RD@!Zv=sdV%HEG)0i8r{#z5Z zwBEV#@gR_4)UuV-*|LN0n4w9zYT4H3C zmvZuZ?-~UBnzKn{Vo9N-Atnw&(yT*0u)e;2aWu#fy~<7l78HD-rl!Vod*2<5rYnp9bQj3I z+9eh9j%GcT(@=AF2TykpATx-AgTv?QlmoDmAaU1?yr7oliF*CieQeaMc`CI_KB#8j z@SKH}RjVIu=jYGF%*<%6r!{8C80wBagt)WJR2x2uhNs`+2SgxSpk(Q!R{0U~8b7{s zwza#mgUAsX2|sU?xX<18D@@7>bQ%vps16*`H`W^>DHIz z7f(x{OPl5h;^5%;oG-$iDju=1Ve(s#B<`9uT%sy+Ff<|S-i()u*K=$9Nm@coOu^`Y z_4Bgs!=oc9KR@WS%_M-Bo}PPdJaO_M`0a<;S<3D0?Q#1C*<*8abA!%+md8tKzc%|4 zExLnH6g4ykgHX`?Qt=1~8vJ9P7)oD9A-f|Z7gy!Nf<&o$ZVbUgA;l|By>ugK(>_C& zj_}x6{D8wAthW$=Cp350$VzBT5@OO(s9%|smlyx+y|q-eJ~I?b!=+!9xL&6;f3IxA zM11jb-`dgf@madOBaxMv3VSGC7KtM!SdmnH56=rj#7Q9Jvt(mfYXm8Cy2HFtZnram zFY*~}0d7`yw%g7OD4V8Im-F{_W4nk6nNtG;@)cI)!ieJHaK+Ky-d-V8CDHd~W!Q3Z zazgM#?eack?<1k3198k!j-7n%dMTl-tW4`SM7RC%L$a2|V+uUvrhx@sYya#SH7*_= zU7$3=k-)c{gk9g?D*L(1PDhZmOjY)0$3`?dwPwszC5tj)0YiotZJg$eRe_kC&J2?HWCXqoT d{`%k^5Rg-I97`{qirmNpl;qT9YoyIW{trQSZxsLl literal 0 HcmV?d00001 diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml index 7f4556de5e2..219bfe4aff5 100644 --- a/dyalog-configuration-guide/mkdocs.yml +++ b/dyalog-configuration-guide/mkdocs.yml @@ -64,3 +64,154 @@ nav: - Windows Registry: how-to-set/registry.md - Built-in Defaults: how-to-set/built-in-defaults.md - Configuration File Structure: how-to-set/configuration-file-structure.md + - Configuration Parameters: + - Introduction: configuration-parameters/configuration-parameters.md + - AddClassHeaders: configuration-parameters/addclassheaders.md + - APLAN_FOR_EDITOR: configuration-parameters/aplan-for-editor.md + - APLAN_FOR_OUTPUT: configuration-parameters/aplan-for-output.md + - AplCoreName: configuration-parameters/aplcorename.md + - aplk: configuration-parameters/aplk.md + - aplkeys: configuration-parameters/aplkeys.md + - aplnid: configuration-parameters/aplnid.md + - aplt: configuration-parameters/aplt.md + - apltrans: configuration-parameters/apltrans.md + - APL_CODE_E_MAGNITUDE: configuration-parameters/apl-code-e-magnitude.md + - APL_COMPLEX_AS_V12: configuration-parameters/apl-complex-as-v12.md + - APL_FCREATE_PROPS_C: configuration-parameters/apl-fcreate-props-c.md + - APL_FCREATE_PROPS_J: configuration-parameters/apl-fcreate-props-j.md + - APL_FAST_FCHK: configuration-parameters/apl-fast-fchk.md + - APL_MAX_THREADS: configuration-parameters/apl-max-threads.md + - APL_TextInAplCore: configuration-parameters/apl-textinaplcore.md + - AutoDPI: configuration-parameters/autodpi.md + - AutoComplete: + - CancelKey1: configuration-parameters/autocomplete/cancelkey1.md + - CancelKey2: configuration-parameters/autocomplete/cancelkey2.md + - Cols: configuration-parameters/autocomplete/cols.md + - CommonKey1: configuration-parameters/autocomplete/commonkey1.md + - CompleteKey1: configuration-parameters/autocomplete/completekey1.md + - CompleteKey2: configuration-parameters/autocomplete/completekey2.md + - Enabled: configuration-parameters/autocomplete/enabled.md + - History: configuration-parameters/autocomplete/history.md + - HistorySize: configuration-parameters/autocomplete/historysize.md + - PrefixSize: configuration-parameters/autocomplete/prefixsize.md + - Rows: configuration-parameters/autocomplete/rows.md + - ShowFiles: configuration-parameters/autocomplete/showfiles.md + - AutoFormat: configuration-parameters/autoformat.md + - AutoIndent: configuration-parameters/autoindent.md + - auto_pw: configuration-parameters/auto-pw.md + - CFEXT: configuration-parameters/cfext.md + - ClassicMode: configuration-parameters/classicmode.md + - ClassicModeSavePosition: configuration-parameters/classicmodesaveposition.md + - CMD_PREFIX and CMD_POSTFIX: configuration-parameters/cmd-prefix-and-cmd-postfix.md + - ConfigFile: configuration-parameters/configfile.md + - confirm_abort: configuration-parameters/confirm-abort.md + - confirm_close: configuration-parameters/confirm-close.md + - confirm_fix: configuration-parameters/confirm-fix.md + - confirm_session_delete: configuration-parameters/confirm-session-delete.md + - default_div: configuration-parameters/default-div.md + - default_io: configuration-parameters/default-io.md + - default_ml: configuration-parameters/default-ml.md + - default_pp: configuration-parameters/default-pp.md + - default_pw: configuration-parameters/default-pw.md + - default_rtl: configuration-parameters/default-rtl.md + - default_wx: configuration-parameters/default-wx.md + - DMXOUTPUTONERROR: configuration-parameters/dmxoutputonerror.md + - DockableEditWindows: configuration-parameters/dockableeditwindows.md + - DoubleClickEdit: configuration-parameters/doubleclickedit.md + - dyalog: configuration-parameters/dyalog.md + - DyalogEmailAddress: configuration-parameters/dyalogemailaddress.md + - DyalogHelpDir: configuration-parameters/dyaloghelpdir.md + - DyalogInstallDir: configuration-parameters/dyaloginstalldir.md + - DyalogLink: configuration-parameters/dyaloglink.md + - DyalogStartup: configuration-parameters/dyalogstartup.md + - DyalogStartupSE: configuration-parameters/dyalogstartupse.md + - DyalogStartup_X: configuration-parameters/dyalogstartup-x.md + - DyalogWebSite: configuration-parameters/dyalogwebsite.md + - DYALOG_DISCARD_FN_SOURCE: configuration-parameters/dyalog-discard-fn-source.md + - DYALOG_EVENTLOGGINGLEVEL: configuration-parameters/dyalog-eventlogginglevel.md + - DYALOG_EVENTLOGNAME: configuration-parameters/dyalog-eventlogname.md + - DYALOG_GUTTER_ENABLE: configuration-parameters/dyalog-gutter-enable.md + - Dyalog_LineEditor_Mode: configuration-parameters/dyalog-lineeditor-mode.md + - Dyalog_NETCore: configuration-parameters/dyalog-netcore.md + - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md + - DYALOG_PIXEL_TYPE: configuration-parameters/dyalog-pixel-type.md + - DYALOG_SERIAL: configuration-parameters/dyalog-serial.md + - EditorState: configuration-parameters/editorstate.md + - Edit_Cols: configuration-parameters/edit-cols.md + - Edit_First_X: configuration-parameters/edit-first-x.md + - Edit_First_Y: configuration-parameters/edit-first-y.md + - Edit_Offset_X: configuration-parameters/edit-offset-x.md + - Edit_Offset_Y: configuration-parameters/edit-offset-y.md + - Edit_Rows: configuration-parameters/edit-rows.md + - ENABLE_CEF: configuration-parameters/enable-cef.md + - ErrorOnExternalException: configuration-parameters/erroronexternalexception.md + - ExternalHelpURL: configuration-parameters/externalhelpurl.md + - File_Stack_Size: configuration-parameters/file-stack-size.md + - greet_bitmap: configuration-parameters/greet-bitmap.md + - history_size: configuration-parameters/history-size.md + - inifile: configuration-parameters/inifile.md + - InitFullScriptNormal: configuration-parameters/initfullscriptnormal.md + - InitFullScriptSusp: configuration-parameters/initfullscriptsusp.md + - InitialKeyboardLayout: configuration-parameters/initialkeyboardlayout.md + - InitialKeyboardLayoutInUse: configuration-parameters/initialkeyboardlayoutinuse.md + - InitialKeyboardLayoutShowAll: configuration-parameters/initialkeyboardlayoutshowall.md + - input_size: configuration-parameters/input-size.md + - KeyboardInputDelay: configuration-parameters/keyboardinputdelay.md + - Load: configuration-parameters/load.md + - localdyalogdir: configuration-parameters/localdyalogdir.md + - log_file: configuration-parameters/log-file.md + - log_file_inuse: configuration-parameters/log-file-inuse.md + - log_size: configuration-parameters/log-size.md + - LX: configuration-parameters/lx.md + - mapchars: configuration-parameters/mapchars.md + - MaxAplCores: configuration-parameters/maxaplcores.md + - maxws: configuration-parameters/maxws.md + - OverstrikesPopup: configuration-parameters/overstrikespopup.md + - PassExceptionsToOpSys: configuration-parameters/passexceptionstoopsys.md + - pfkey_size: configuration-parameters/pfkey-size.md + - ProgramFolder: configuration-parameters/programfolder.md + - PropertyExposeRoot: configuration-parameters/propertyexposeroot.md + - PropertyExposeSE: configuration-parameters/propertyexposese.md + - qcmd_timeout: configuration-parameters/qcmd-timeout.md + - ResolveOverstrikes: configuration-parameters/resolveoverstrikes.md + - RIDE_Init: configuration-parameters/ride-init.md + - RIDE_Spawned: configuration-parameters/ride-spawned.md + - RunAsService: configuration-parameters/runasservice.md + - SaveContinueOnExit: configuration-parameters/savecontinueonexit.md + - SaveLogOnExit: configuration-parameters/savelogonexit.md + - SaveSessionOnExit: configuration-parameters/savesessiononexit.md + - Serial: configuration-parameters/serial.md + - SessionOnTop: configuration-parameters/sessionontop.md + - session_file: configuration-parameters/session-file.md + - ShowStatusOnError: configuration-parameters/showstatusonerror.md + - SingleTrace: configuration-parameters/singletrace.md + - SkipLines: configuration-parameters/skiplines.md + - SM_Cols: configuration-parameters/sm-cols.md + - SM_Rows: configuration-parameters/sm-rows.md + - StatusOnEdit: configuration-parameters/statusonedit.md + - TabStops: configuration-parameters/tabstops.md + - ToolBarsOnEdit: configuration-parameters/toolbarsonedit.md + - TraceStopMonitor: configuration-parameters/tracestopmonitor.md + - Trace_First_X: configuration-parameters/trace-first-x.md + - Trace_First_Y: configuration-parameters/trace-first-y.md + - Trace_level_warn: configuration-parameters/trace-level-warn.md + - Trace_Offset_X: configuration-parameters/trace-offset-x.md + - Trace_Offset_Y: configuration-parameters/trace-offset-y.md + - Trace_On_Error: configuration-parameters/trace-on-error.md + - UCMDCacheFile: configuration-parameters/ucmdcachefile.md + - UnicodeToClipboard: configuration-parameters/unicodetoclipboard.md + - URLHighlight: configuration-parameters/urlhighlight.md + - UseExternalHelpURL: configuration-parameters/useexternalhelpurl.md + - UserConfigFile: configuration-parameters/userconfigfile.md + - UseXCV: configuration-parameters/usexcv.md + - ValueTips: + - ValueTips/ColourScheme: configuration-parameters/valuetips/colourscheme.md + - ValueTips/Delay: configuration-parameters/valuetips/delay.md + - ValueTips/Enabled: configuration-parameters/valuetips/enabled.md + - WantsSpecialKeys: configuration-parameters/wantsspecialkeys.md + - WrapSearch: configuration-parameters/wrapsearch.md + - WrapSearchMsgBox: configuration-parameters/wrapsearchmsgbox.md + - WSEXT: configuration-parameters/wsext.md + - WSPATH: configuration-parameters/wspath.md + - XPLookAndFeel: configuration-parameters/xplookandfeel.md + - yy_window: configuration-parameters/yy-window.md diff --git a/language-reference-guide/docs/primitive-operators/i-beam/aplcore-parameters.md b/language-reference-guide/docs/primitive-operators/i-beam/aplcore-parameters.md index 8afaeaace21..0e1a4c26b73 100644 --- a/language-reference-guide/docs/primitive-operators/i-beam/aplcore-parameters.md +++ b/language-reference-guide/docs/primitive-operators/i-beam/aplcore-parameters.md @@ -19,7 +19,7 @@ Sets the aplcore parameters **AplCoreName** and/or **MaxAplCores** for the curre If `Y` is empty, the function simply returns the values of these parameters without changing them. -See also: [AplCoreName](../../../../windows-installation-and-configuration-guide/configuration-parameters/aplcorename) and [MaxAplCores.](../../../../windows-installation-and-configuration-guide/configuration-parameters/maxaplcores) +See also: [AplCoreName](../../../../dyalog-configuration-guide/configuration-parameters/aplcorename) and [MaxAplCores.](../../../../dyalog-configuration-guide/configuration-parameters/maxaplcores)
diff --git a/language-reference-guide/docs/primitive-operators/i-beam/number-of-threads.md b/language-reference-guide/docs/primitive-operators/i-beam/number-of-threads.md index bd51597e4a4..f67bb240a7e 100644 --- a/language-reference-guide/docs/primitive-operators/i-beam/number-of-threads.md +++ b/language-reference-guide/docs/primitive-operators/i-beam/number-of-threads.md @@ -10,7 +10,7 @@ Specifies how many threads are to be used for parallel execution. If `Y` has the value `⍬`, `R` is the number of virtual processors in the machine. -Otherwise, `Y` is an integer that specifies the number of threads that are to be used henceforth for parallel execution. Prior to this call, the default number of threads is specified by the parameter `APL_MAX_THREADS`. See [ APL_MAX_THREADS](../../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +Otherwise, `Y` is an integer that specifies the number of threads that are to be used henceforth for parallel execution. Prior to this call, the default number of threads is specified by the parameter `APL_MAX_THREADS`. See [ APL_MAX_THREADS](../../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). Note that whatever the value of `Y`, Dyalog limits the number of threads to 64. So the effective number of threads is `Y⌊64`. diff --git a/language-reference-guide/docs/system-commands/continue.md b/language-reference-guide/docs/system-commands/continue.md index c7097f29cae..3d4d22bc3b9 100644 --- a/language-reference-guide/docs/system-commands/continue.md +++ b/language-reference-guide/docs/system-commands/continue.md @@ -2,7 +2,7 @@ # Save Continuation `)CONTINUE` -This command saves the active workspace in the current working directory and ends the Dyalog session. The name of the workspace file is CONTINUE in upper-case with the extension defined by the [`WSEXT` parameter](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +This command saves the active workspace in the current working directory and ends the Dyalog session. The name of the workspace file is CONTINUE in upper-case with the extension defined by the [`WSEXT` parameter](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). Note that the values of all system variables (including [`⎕SM`](../system-functions/sm.md)) and GUI objects are also saved in `CONTINUE`. diff --git a/language-reference-guide/docs/system-commands/load.md b/language-reference-guide/docs/system-commands/load.md index b6c67f860d8..939cda4768f 100644 --- a/language-reference-guide/docs/system-commands/load.md +++ b/language-reference-guide/docs/system-commands/load.md @@ -4,7 +4,7 @@ This command causes the named stored workspace to be loaded.  The current active workspace is lost. -`ws` specifies a file name. If no file extension is given, it is implied. See [WSEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/wsext). +`ws` specifies a file name. If no file extension is given, it is implied. See [WSEXT](../../../dyalog-configuration-guide/configuration-parameters/wsext). If `ws` is a full or relative pathname, only the specified directory is examined.  If not, the APL workspace path (`WSPATH`) is traversed in search of the named workspace.  A stored workspace is one which has previously been saved with the system command [`)SAVE`](save.md) or the system function [`⎕SAVE`](../system-functions/save.md).  Under Windows, if `ws` is omitted, the File Open dialog box is displayed. diff --git a/language-reference-guide/docs/system-commands/save.md b/language-reference-guide/docs/system-commands/save.md index 1d96ddf88a8..d14b8193e6b 100644 --- a/language-reference-guide/docs/system-commands/save.md +++ b/language-reference-guide/docs/system-commands/save.md @@ -10,7 +10,7 @@ If `ws` specifies a file name other than that implied by `⎕WSID`, the specif See [Programmer's Guide: "Workspaces"](../../../programming-reference-guide/introduction/workspaces) for the rules for specifying a workspace name. -If an extension is not specified, an extension is added according to the [**WSEXT** parameter](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters).. +If an extension is not specified, an extension is added according to the [**WSEXT** parameter](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters).. A workspace may not be saved if any threads (other than the root thread 0) are running or if there are any Edit or Trace windows open. Otherwise, the workspace is saved with its state of execution intact, however certain operations may be performed before it is saved. For further information, see [Set Workspace Save Options](../primitive-operators/i-beam/set-workspace-save-options.md). diff --git a/language-reference-guide/docs/system-functions/dt.md b/language-reference-guide/docs/system-functions/dt.md index f49af5a42cc..57a1d230c08 100644 --- a/language-reference-guide/docs/system-functions/dt.md +++ b/language-reference-guide/docs/system-functions/dt.md @@ -249,7 +249,7 @@ When XY is a pattern, the corresponding character vector ### Two-digit Years -Two digit years (that is, those corresponding to the formatting pattern elements `YY` and `WW`) are, by default, interpreted according to the same rules used for `⎕SM` and GUI edit fields, which are configurable using the [`YY_WINDOW`](../../windows-installation-and-configuration-guide/configuration-parameters/yy-window/) configuration parameter. +Two digit years (that is, those corresponding to the formatting pattern elements `YY` and `WW`) are, by default, interpreted according to the same rules used for `⎕SM` and GUI edit fields, which are configurable using the [`YY_WINDOW`](../../dyalog-configuration-guide/configuration-parameters/yy-window/) configuration parameter. ### Ambiguities and Precision diff --git a/language-reference-guide/docs/system-functions/fchk.md b/language-reference-guide/docs/system-functions/fchk.md index 247cfb28df9..309f9a0229e 100644 --- a/language-reference-guide/docs/system-functions/fchk.md +++ b/language-reference-guide/docs/system-functions/fchk.md @@ -7,7 +7,7 @@ search: `⎕FCHK` validates and repairs component files, and validates files associated with external variables, following an abnormal termination of the APL process or operating system. -`Y` must be a simple character scalar or vector which specifies the name of the file to be exclusively checked or repaired. For component files, the file must be named in accordance with the operating system's conventions, and may be a relative or absolute pathname. The file must exist and must not be tied. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +`Y` must be a simple character scalar or vector which specifies the name of the file to be exclusively checked or repaired. For component files, the file must be named in accordance with the operating system's conventions, and may be a relative or absolute pathname. The file must exist and must not be tied. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). For files associated with external variables, any filename extension must be specified even if `⎕XT` would not require it. The file must exist and must not currently be associated with an external variable. diff --git a/language-reference-guide/docs/system-functions/fcopy.md b/language-reference-guide/docs/system-functions/fcopy.md index 4200cadd3f7..299b5e79d64 100644 --- a/language-reference-guide/docs/system-functions/fcopy.md +++ b/language-reference-guide/docs/system-functions/fcopy.md @@ -9,7 +9,7 @@ search: `Y` must be a simple integer scalar or 1 or 2-element vector containing the file tie number and optional passnumber. The file need not be tied exclusively. -`X` is a character vector containing the name of a new file to be copied to. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +`X` is a character vector containing the name of a new file to be copied to. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). `⎕FCOPY` creates a copy of the tied file specified by `Y`, named `X`. diff --git a/language-reference-guide/docs/system-functions/fcreate.md b/language-reference-guide/docs/system-functions/fcreate.md index 0e3161cf661..1e5aedfeca1 100644 --- a/language-reference-guide/docs/system-functions/fcreate.md +++ b/language-reference-guide/docs/system-functions/fcreate.md @@ -15,7 +15,7 @@ search: `X` must be either: -1. a simple character scalar or vector which specifies the name of the file to be created. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +1. a simple character scalar or vector which specifies the name of the file to be created. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). 2. a vector of length 1 or 2 whose items are:- a simple character scalar or vector as above. - an integer scalar specifying the file size limit in bytes. diff --git a/language-reference-guide/docs/system-functions/frename.md b/language-reference-guide/docs/system-functions/frename.md index aefcac1f24c..f2516882d3f 100644 --- a/language-reference-guide/docs/system-functions/frename.md +++ b/language-reference-guide/docs/system-functions/frename.md @@ -9,7 +9,7 @@ search: `Y` must be a simple 1 or 2 element integer vector containing a file tie number and an optional passnumber.  If the passnumber is omitted it is assumed to be zero. -`X` must be a simple character scalar or vector containing the new name of the file.  This name must be in accordance with the operating system's conventions, and may be specified with a relative or absolute pathname. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +`X` must be a simple character scalar or vector containing the new name of the file.  This name must be in accordance with the operating system's conventions, and may be specified with a relative or absolute pathname. If no file extension is supplied, the first extension specified by the   **CFEXT** parameter will be added. See [ CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). The file being renamed must be tied exclusively. diff --git a/language-reference-guide/docs/system-functions/fstie.md b/language-reference-guide/docs/system-functions/fstie.md index 120f00cb3dc..2f480fa650f 100644 --- a/language-reference-guide/docs/system-functions/fstie.md +++ b/language-reference-guide/docs/system-functions/fstie.md @@ -7,7 +7,7 @@ search: `Y` must be 0 or a simple 1 or 2 element integer vector containing an available file tie number to be associated with the file for further file operations, and an optional passnumber.  If the passnumber is omitted it is assumed to be zero.  The tie number must not already be associated with a tied file. -`X` must be a simple character scalar or vector which specifies the name of the file to be tied.  The file must be named in accordance with the operating system's conventions, and may be specified with a relative or absolute pathname. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [ CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +`X` must be a simple character scalar or vector which specifies the name of the file to be tied.  The file must be named in accordance with the operating system's conventions, and may be specified with a relative or absolute pathname. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [ CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). The file must exist and be accessible by the user.  If it is already tied by another task, it must not be tied exclusively. diff --git a/language-reference-guide/docs/system-functions/ftie.md b/language-reference-guide/docs/system-functions/ftie.md index 929eff91bac..d4a833c96b8 100644 --- a/language-reference-guide/docs/system-functions/ftie.md +++ b/language-reference-guide/docs/system-functions/ftie.md @@ -9,7 +9,7 @@ search: `Y` must be 0 or a simple 1 or 2 element integer vector containing an available file tie number to be associated with the file for further file operations, and an optional passnumber.  If the passnumber is omitted it is assumed to be zero.  The tie number must not already be associated with a share tied or exclusively tied file. -`X` must be a simple character scalar or vector which specifies the name of the file to be exclusively tied.  The file must be named in accordance with the operating system's conventions, and may be a relative or absolute pathname. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [ CFEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +`X` must be a simple character scalar or vector which specifies the name of the file to be exclusively tied.  The file must be named in accordance with the operating system's conventions, and may be a relative or absolute pathname. If no file extension is supplied, the set of extensions specified by the  **CFEXT** parameter are tried one after another until the file is found or the set of extensions is exhausted. See [ CFEXT](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). The file must exist and the user must have write access to it.  It may not already be tied by another user. diff --git a/language-reference-guide/docs/system-functions/load.md b/language-reference-guide/docs/system-functions/load.md index 290851d8f04..90219cf7172 100644 --- a/language-reference-guide/docs/system-functions/load.md +++ b/language-reference-guide/docs/system-functions/load.md @@ -5,7 +5,7 @@ search: # Load Workspace `⎕LOAD Y`{{key}} -`Y` must be a simple character scalar or vector containing the name of a file that contains a saved workspace. . If no file extension is given it is implied. See [WSEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/wsext). +`Y` must be a simple character scalar or vector containing the name of a file that contains a saved workspace. . If no file extension is given it is implied. See [WSEXT](../../../dyalog-configuration-guide/configuration-parameters/wsext). If `Y` is ill-formed or does not identify a saved workspace or the user account does not have access permission to the workspace, a `DOMAIN ERROR` is reported. diff --git a/language-reference-guide/docs/system-functions/na.md b/language-reference-guide/docs/system-functions/na.md index 35c98ef9362..29f95ededc2 100644 --- a/language-reference-guide/docs/system-functions/na.md +++ b/language-reference-guide/docs/system-functions/na.md @@ -47,7 +47,7 @@ div 2.5 ``` -It is imperative that care be taken when coding type declarations. A DLL *cannot* check types of data passed from APL. A wrong type declaration will lead to erroneous results or may even cause the workspace to become corrupted and crash. During development, you may wish to prevent this happening. See [ErrorOnExternalException](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +It is imperative that care be taken when coding type declarations. A DLL *cannot* check types of data passed from APL. A wrong type declaration will lead to erroneous results or may even cause the workspace to become corrupted and crash. During development, you may wish to prevent this happening. See [ErrorOnExternalException](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). The full syntax for the right argument of `⎕NA` is: ``` diff --git a/language-reference-guide/docs/system-functions/system.md b/language-reference-guide/docs/system-functions/system.md index 75bce0d409f..bdd88cce6bc 100644 --- a/language-reference-guide/docs/system-functions/system.md +++ b/language-reference-guide/docs/system-functions/system.md @@ -251,7 +251,7 @@ This namespace provides information about the interpreter's operating system pro Non-negative integer [process identifier](https://en.wikipedia.org/wiki/Process_identifier) (PID) of the interpreter. #### Process.LaunchTarget -The fully qualified path of the file or directory loaded at startup. This is set by either a workspace name on the [APL command line](../../windows-installation-and-configuration-guide/apl-command-line) or using the [LOAD configuration parameter](../../windows-installation-and-configuration-guide/configuration-parameters/load/). +The fully qualified path of the file or directory loaded at startup. This is set by either a workspace name on the [APL command line](../../windows-installation-and-configuration-guide/apl-command-line) or using the [LOAD configuration parameter](../../dyalog-configuration-guide/configuration-parameters/load/). #### Process.ParentId Non-negative integer [process identifier](https://en.wikipedia.org/wiki/Process_identifier) of the process that launched the interpreter. Always `¯1` on Microsoft Windows. diff --git a/language-reference-guide/docs/system-functions/wx.md b/language-reference-guide/docs/system-functions/wx.md index 3f2748793d2..b18f00ce608 100644 --- a/language-reference-guide/docs/system-functions/wx.md +++ b/language-reference-guide/docs/system-functions/wx.md @@ -26,13 +26,13 @@ When you create an object, its `⎕WX` (like any other system variable) is initi If the value of `⎕WX` of a GUI object is initially 0, it will not expose its members. If you subsequently change it from 0 to 1, it will expose them. If you change its `⎕WX` back to 0, it will not expose any yet-unexposed members, although already-exposed members will continue to be exposed. -The value of `⎕WX` in a clear workspace is defined by the default_wx parameter (see [ default_wx](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters)) which itself defaults to 3. +The value of `⎕WX` in a clear workspace is defined by the default_wx parameter (see [ default_wx](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters)) which itself defaults to 3. `⎕WX` has namespace scope and may be localised in a function header. This allows you to create a utility namespace or utility function in which the exposure of objects is known and determined, regardless of its global value in the workspace. ## Notes -- The visibility of the properties and methods of the Root object are not controlled by `⎕WX` but by the **PropertyExposeRoot** parameter. For further information, see [ PropertyExposeRoot](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). +- The visibility of the properties and methods of the Root object are not controlled by `⎕WX` but by the **PropertyExposeRoot** parameter. For further information, see [ PropertyExposeRoot](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). - `⎕WX` is retained for backwards compatibility and should be considered as deprecated. Dyalog recommends `⎕WX` be set to 3 and never changed. diff --git a/object-reference/docs/objects/font.md b/object-reference/docs/objects/font.md index a9839a7fd5d..b79beb75a5d 100644 --- a/object-reference/docs/objects/font.md +++ b/object-reference/docs/objects/font.md @@ -20,7 +20,7 @@ The characteristics of the font are specified by its properties as follows : The [Coord](../properties/coord.md) property may be set to `'Pixel'`, `'ScaledPixel'` or `'RealPixel'` when the object is created, but [Coord](../properties/coord.md) may not subsequently be changed. -If Coord is `'Pixel'`, it is interpreted as either `'RealPixel'` or `'ScaledPixel'` according to the value of the **Dyalog_Pixel_Type** parameter, which is either ScaledPixel or RealPixel. See [Dyalog_Pixel_Type](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-pixel-type). +If Coord is `'Pixel'`, it is interpreted as either `'RealPixel'` or `'ScaledPixel'` according to the value of the **Dyalog_Pixel_Type** parameter, which is either ScaledPixel or RealPixel. See [Dyalog_Pixel_Type](../../../dyalog-configuration-guide/configuration-parameters/dyalog-pixel-type). **If this parameter is not specified, the default is RealPixel. So by default, when you set Coord to Pixel, it will be treated as RealPixel.** diff --git a/object-reference/docs/objects/root.md b/object-reference/docs/objects/root.md index cf4ca1cdcc5..d7c630a6ff2 100644 --- a/object-reference/docs/objects/root.md +++ b/object-reference/docs/objects/root.md @@ -47,7 +47,7 @@ There are a number of elements that control whether or not Root members are expo 2. This flag may be changed dynamically using the *Options/Object Syntax/Expose Root Properties* menu item on the Session or using `2401⌶`. If the workspace is subsequently saved, the current value of the flag is saved with it. 3. The value of the flag in a `CLEAR WS` is determined by the **PropertyExposeRoot** parameter. Under Windows, this parameter is associated with the *Expose properties of Root* checkbox on the *Object Syntax* Tab of the *Configuration* dialog box. When you change the value of this checkbox and close the *Configuration* dialog by clicking *OK*, the value of the **PropertyExposeRoot** parameter is immediately updated in the user's section of the Registry. However, the value of the flag *in the current workspace* is not changed. The **PropertyExposeRoot** parameter only defines the value of the flag in a `CLEAR WS`, so if you subsequently type `)CLEAR`, the current value of the parameter in the Registry determines whether or not Root members are exposed and sets the flag in the workspace accordingly. -For further information, see [The Options Menu](../../../windows-ui-guide/session-menubar), [ PropertyExposeRoot](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters), and [Expose Root Properties](../../../language-reference-guide/primitive-operators/i-beam/expose-root-properties). +For further information, see [The Options Menu](../../../windows-ui-guide/session-menubar), [ PropertyExposeRoot](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters), and [Expose Root Properties](../../../language-reference-guide/primitive-operators/i-beam/expose-root-properties). ## Notes diff --git a/object-reference/docs/properties/coord.md b/object-reference/docs/properties/coord.md index eff2f88e627..923898ebdfa 100644 --- a/object-reference/docs/properties/coord.md +++ b/object-reference/docs/properties/coord.md @@ -29,7 +29,7 @@ to (Size -1). If Coord is `'ScaledPixel'` the number of pixels specified for [Posn](posn.md), [Size](size.md), and other such properties will be automatically scaled by Dyalog APL according to the user's chosen display scaling factor. So if you specify an Edit object to be 80 pixels wide and 20 pixels high, and the user's scaling factor is 150%, Dyalog will automatically draw it 120 pixels wide and 30 pixels high. Dyalog will also de-scale coordinate values reported by `⎕WG` and event messages. -If Coord is `'Pixel'`, it is interpreted as either `'RealPixel'` or `'ScaledPixel'` according to the value of the **Dyalog_Pixel_Type** parameter, which is either ScaledPixel or RealPixel. See [Dyalog_Pixel_Type](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-pixel-type). +If Coord is `'Pixel'`, it is interpreted as either `'RealPixel'` or `'ScaledPixel'` according to the value of the **Dyalog_Pixel_Type** parameter, which is either ScaledPixel or RealPixel. See [Dyalog_Pixel_Type](../../../dyalog-configuration-guide/configuration-parameters/dyalog-pixel-type). **If this parameter is not specified, the default is RealPixel. So by default, when you set Coord to Pixel, it will be treated as RealPixel.** diff --git a/programming-reference-guide/docs/error-messages/system-errors.md b/programming-reference-guide/docs/error-messages/system-errors.md index 6c84720f0c9..1f8211c4fd9 100644 --- a/programming-reference-guide/docs/error-messages/system-errors.md +++ b/programming-reference-guide/docs/error-messages/system-errors.md @@ -11,13 +11,13 @@ On Windows, if the **DYALOG_NOPOPUPS** parameter is 0 (the default), it will di ## aplcore file -When a system error occurs, APL normally saves an *aplcore* file which may be sent to Dyalog for diagnosis. The name and location of the *aplcore* file may be specified by the [**AplCoreName**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) parameter. If this parameter is not specified, the *aplcore* file is named `aplcore` and is saved in the current working directory. +When a system error occurs, APL normally saves an *aplcore* file which may be sent to Dyalog for diagnosis. The name and location of the *aplcore* file may be specified by the [**AplCoreName**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) parameter. If this parameter is not specified, the *aplcore* file is named `aplcore` and is saved in the current working directory. -Normally a new *aplcore* will replace a file of the same name. However, if [**AplCoreName**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) contains an asterisk (*), the system will create a new file, replacing the asterisk with a number incremented from the largest numbered file present. +Normally a new *aplcore* will replace a file of the same name. However, if [**AplCoreName**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) contains an asterisk (*), the system will create a new file, replacing the asterisk with a number incremented from the largest numbered file present. -The number of *aplcore* files retained by the system is specified by the [**MaxAplCores**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) parameter. If [**MaxAplCores**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) is 0, the system will not save an *aplcore*. However, under Windows, if **DYALOG_NOPOPUPS** is 0, and the user checks the *Create an aplcore file* checkbox when the *System Error* dialog box is displayed, an *aplcore* will be saved regardless of the value of [**MaxAplCores**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters). See **System Error Dialog Box**. +The number of *aplcore* files retained by the system is specified by the [**MaxAplCores**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) parameter. If [**MaxAplCores**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) is 0, the system will not save an *aplcore*. However, under Windows, if **DYALOG_NOPOPUPS** is 0, and the user checks the *Create an aplcore file* checkbox when the *System Error* dialog box is displayed, an *aplcore* will be saved regardless of the value of [**MaxAplCores**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). See **System Error Dialog Box**. -Be aware that if your application contains any secure data, this data may be present in an *aplcore* file, and it may be appropriate to set both [**MaxAplCores**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) and **DYALOG_NOPOPUPS** to 0 to prevent such data being saved on disk. +Be aware that if your application contains any secure data, this data may be present in an *aplcore* file, and it may be appropriate to set both [**MaxAplCores**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) and **DYALOG_NOPOPUPS** to 0 to prevent such data being saved on disk. Information that may prove useful in debugging the problem, including (where possible) the SI stack at the point where the *aplcore* was generated, is by default written to the end of *aplcore* files; the section begins with the string @@ -27,7 +27,7 @@ Under UNIX, this interesting information section can be extracted from the *aplc `sed -n '/======== Interesting Information/,$p' aplcore` -To prevent this information from being written to the *aplcore* file, the [**APL_TextInAplCore**](../../../windows-installation-and-configuration-guide/configuration-parameters/apl-textinaplcore) parameter should be set to 0. +To prevent this information from being written to the *aplcore* file, the [**APL_TextInAplCore**](../../../dyalog-configuration-guide/configuration-parameters/apl-textinaplcore) parameter should be set to 0. ## Workspace Integrity @@ -120,7 +120,7 @@ After debugging, the System Exception dialog box appears again. Click on *Don't ## ErrorOnExternalException Parameter -This parameter allows you to prevent APL from taking the actions described above when an exception caused by an external DLL occurs. The following example illustrates what happens when the functions above are run, but with the [**ErrorOnExternalException**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) parameter set to 1. +This parameter allows you to prevent APL from taking the actions described above when an exception caused by an external DLL occurs. The following example illustrates what happens when the functions above are run, but with the [**ErrorOnExternalException**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) parameter set to 1. ```apl    ⎕←2 ⎕NQ'.' 'GetEnvironment' 'ErrorOnExternalException' 1 @@ -137,7 +137,7 @@ goo[1] foo[1] ``` -Note: Dyalog recommends that enabling [**ErrorOnExternalException**](../../../windows-installation-and-configuration-guide/configuration-parameters/configuration-parameters) should only be done while developing or debugging an application; ignoring such errors may result in corruption in the workspace which could result to unexpected errors later in the application. +Note: Dyalog recommends that enabling [**ErrorOnExternalException**](../../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) should only be done while developing or debugging an application; ignoring such errors may result in corruption in the workspace which could result to unexpected errors later in the application. ## What should I do if Dyalog hangs? diff --git a/programming-reference-guide/docs/introduction/arrays/display-of-arrays.md b/programming-reference-guide/docs/introduction/arrays/display-of-arrays.md index 9aa4928d019..b0db980c8e7 100644 --- a/programming-reference-guide/docs/introduction/arrays/display-of-arrays.md +++ b/programming-reference-guide/docs/introduction/arrays/display-of-arrays.md @@ -151,7 +151,7 @@ Arrays (including namespaces) can be displayed in the session using [array notat ``` In the [Microsoft Windows IDE](../../../../windows-ui-guide) it can also be toggled on and off using the ![](../../img/session_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon on the Session toolbar. -To enable the display of output using array notation when starting a Dyalog session, set the [APLAN_FOR_OUTPUT](../../../../windows-installation-and-configuration-guide/configuration-parameters/aplan-for-output) configuration parameter to `1`. +To enable the display of output using array notation when starting a Dyalog session, set the [APLAN_FOR_OUTPUT](../../../../dyalog-configuration-guide/configuration-parameters/aplan-for-output) configuration parameter to `1`. ## Obtaining Textual Representations diff --git a/programming-reference-guide/docs/introduction/workspaces.md b/programming-reference-guide/docs/introduction/workspaces.md index 5f2fffdd983..46f89162d1d 100644 --- a/programming-reference-guide/docs/introduction/workspaces.md +++ b/programming-reference-guide/docs/introduction/workspaces.md @@ -4,7 +4,7 @@ APL expressions are evaluated within a workspace. The workspace may contain obje Workspaces may be explicitly saved with an identifying name. The workspace may subsequently be loaded, or objects may be selectively copied from a saved workspace into the current workspace. -Workspaces are stored in files whose names must conform to operating system conventions. When a workspace name is specified without a file suffix, these are added or implied. For further information, see [WSEXT](../../../windows-installation-and-configuration-guide/configuration-parameters/wsext). +Workspaces are stored in files whose names must conform to operating system conventions. When a workspace name is specified without a file suffix, these are added or implied. For further information, see [WSEXT](../../../dyalog-configuration-guide/configuration-parameters/wsext). If the name of the file in which the workspace is saved contains spaces, the ws argument for the system functions `)SAVE`, `)COPY`, `)PCOPY`, `)LOAD`, `)XLOAD` and `)DROP` should be surrounded by two double-quote (") characters. To include a " character in the file name, you must specify two adjoining double-quotes (that is, """"). Note however that Windows does not allow double-quotes in file names, so this effectively applies only to non-Windows systems. diff --git a/windows-installation-and-configuration-guide/docs/apl-command-line.md b/windows-installation-and-configuration-guide/docs/apl-command-line.md index 7dce922b8f2..136901e3e72 100644 --- a/windows-installation-and-configuration-guide/docs/apl-command-line.md +++ b/windows-installation-and-configuration-guide/docs/apl-command-line.md @@ -17,7 +17,7 @@ Is the location of the Dyalog executable. Usually this is the full pathname, sur **[options]** |---|---| -|-x|Disables the execution of the `⎕LX` expression and the derived expression when code is loaded from a source code file or directory. This applies only at start-up and does not apply to workspaces or source files that are loaded subsequently. See [Latent Expression](../../language-reference-guide/system-functions/lx) and [Load](configuration-parameters/load.md)| +|-x|Disables the execution of the `⎕LX` expression and the derived expression when code is loaded from a source code file or directory. This applies only at start-up and does not apply to workspaces or source files that are loaded subsequently. See [Latent Expression](../../language-reference-guide/system-functions/lx) and [Load](../../dyalog-configuration-guide/configuration-parameters/load.md)| |-a|Start in USER mode.| |-b|Suppress the banner in the Session..| |-s|Disable the Session. This option is ignored in Windows versions.| @@ -41,10 +41,10 @@ The name of a Dyalog APL workspace to be loaded. Unless specified, on Windows th **[param]** -A parameter name followed by an equals sign (`=`) and a value. The parameter name may be one of the standard APL parameters (see [Configuration Parameters](configuration-parameters/configuration-parameters.md) ) or a name and value of your own choosing (see [GetEnvironment](../../object-reference/methodorevents/getenvironment) ) . If the parameter is in a registry sub-folder (see [Registry Sub-Folders](registry-subfolders.md) ), its name must be preceded by the name of the sub-folder, followed by a backslash (`\`) or underscore (`_`). +A parameter name followed by an equals sign (`=`) and a value. The parameter name may be one of the standard APL parameters (see [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters.md) ) or a name and value of your own choosing (see [GetEnvironment](../../object-reference/methodorevents/getenvironment) ) . If the parameter is in a registry sub-folder (see [Registry Sub-Folders](registry-subfolders.md) ), its name must be preceded by the name of the sub-folder, followed by a backslash (`\`) or underscore (`_`). !!! note - Instead of a loading a workspace specified by the **ws** option, APL can be instructed to load a program from a script file. For further information, see [Load](configuration-parameters/load.md). + Instead of a loading a workspace specified by the **ws** option, APL can be instructed to load a program from a script file. For further information, see [Load](../../dyalog-configuration-guide/configuration-parameters/load.md).

Examples

diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplt.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/aplt.md deleted file mode 100644 index 8f7654a4199..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/aplt.md +++ /dev/null @@ -1,5 +0,0 @@ -# APLT - -This parameter specifies the name of the Output Translate Table. On Windows the default is WIN.DOT and there is rarely a need to alter it. - -See also [Output table file](../configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md deleted file mode 100644 index a10932b3a60..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/CancelKey1 - -Specifies the first of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. - -See also [Cancel Key](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md deleted file mode 100644 index f5b40b87d13..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/CancelKey2 - -Specifies the second of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. - -See also [Cancel Key](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cols.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cols.md deleted file mode 100644 index 7fbc1054da8..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/cols.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/Cols - -This parameter specifies the maximum number of columns (width) in the Auto Complete pop-up suggestions box. - -See also [Show up to](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md deleted file mode 100644 index 5dd2b6572c2..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/CompleteKey1 - -Specifies the first of two possible keys that may be used to select the current option from the Auto Complete suggestion box. - -See also [OK Key](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md deleted file mode 100644 index fb4c8d2bb07..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/CompleteKey2 - -Specifies the second of two possible keys that may be used to select the current option from the Auto Complete suggestion box. - -See also [OK Key](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md deleted file mode 100644 index 28ed760d65c..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/Enabled - -This parameter specifies whether or not Auto Completion is enabled - -See also [Use Auto Complete](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/history.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/history.md deleted file mode 100644 index ebbfde9408b..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/history.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/History - -Specifies whether or not Auto Complete maintains a list of previous Auto Completions. - -See also [Keep History](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md deleted file mode 100644 index 124aef6d2dc..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/HistorySize - -Specifies the number of previous Auto Completions that are maintained when History is 1. See [History](history.md). - -See also [History Length](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md deleted file mode 100644 index d478b046f80..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/PrefixSize - -This parameter specifies the threshold (number of characters) before Auto Completeion displays suggestions. - -See also [Make suggestions after](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/rows.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/rows.md deleted file mode 100644 index 9406d47f845..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/rows.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/Rows - -This parameter specifies the maximum number of rows (height) in the Auto Complete pop-up suggestions box. - -See also [Suggest up to](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md deleted file mode 100644 index 29f36839856..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md +++ /dev/null @@ -1,5 +0,0 @@ -# AutoComplete/ShowFiles - -Specifies whether or not Auto Completion suggests directory and file names for `)LOAD`, `)COPY` and `)DROP` system commands. - -See also [Include filenames](../../configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/configfile.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/configfile.md deleted file mode 100644 index b744f192cee..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/configfile.md +++ /dev/null @@ -1,3 +0,0 @@ -# ConfigFile - -This parameter specifies the name of the Application Configuration file. See [Configuration Files](../configuration-files.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-div.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/default-div.md deleted file mode 100644 index 8cb87b10f51..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-div.md +++ /dev/null @@ -1,5 +0,0 @@ -# Default_DIV - -This parameter specifies the value of `⎕DIV` in a clear workspace. Its default value is 0. - -See also [⎕DIV](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-io.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/default-io.md deleted file mode 100644 index d41e1a01f8b..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-io.md +++ /dev/null @@ -1,5 +0,0 @@ -# Default_IO - -This parameter specifies the value of `⎕IO` in a clear workspace. Its default value is 1. - -See also [⎕IO](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-ml.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/default-ml.md deleted file mode 100644 index 89b4a7a4a17..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-ml.md +++ /dev/null @@ -1,5 +0,0 @@ -# Default_ML - -This parameter specifies the value of `⎕ML` in a clear workspace. Its default value is 1. - -See also [⎕ML](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-pp.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/default-pp.md deleted file mode 100644 index 9f8efe67e61..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-pp.md +++ /dev/null @@ -1,5 +0,0 @@ -# Default_PP - -This parameter specifies the value of `⎕PP` in a clear workspace. Its default value is 10. - -See also [⎕PP](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-rtl.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/default-rtl.md deleted file mode 100644 index 2e3331b2fb8..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/default-rtl.md +++ /dev/null @@ -1,5 +0,0 @@ -# Default_RTL - -This parameter specifies the value of `⎕RTL` in a clear workspace. Its default value is 0. - -See also [⎕RTL](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md deleted file mode 100644 index 98bb7ed47a6..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md +++ /dev/null @@ -1,5 +0,0 @@ -# Dyalog_LineEditor_Mode - -This Boolean parameter specifies whether or not multi-line input is enabled in the Session. - -See also [Multiline Input](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) and [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-cols.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-cols.md deleted file mode 100644 index 0111b3f2b5e..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-cols.md +++ /dev/null @@ -1,5 +0,0 @@ -# Edit_Cols - -This parameter specifies the initial width of an edit window in character units. - -See also [Width](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-x.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-x.md deleted file mode 100644 index 5a27e1a7c79..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-x.md +++ /dev/null @@ -1,5 +0,0 @@ -# Edit_Offset_X - -This parameter specify the number of characters by which an edit window is staggered horizontally from the previous one. - -See also [X Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-y.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-y.md deleted file mode 100644 index d49bbfcd45f..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-offset-y.md +++ /dev/null @@ -1,5 +0,0 @@ -# Edit_Offset_Y - -This parameter specify the number of characters by which an edit window is staggered vertically from the previous one. - -See also [Y Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-rows.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-rows.md deleted file mode 100644 index 221826629d7..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-rows.md +++ /dev/null @@ -1,5 +0,0 @@ -# Edit_Rows - -This parameter specifies the initial height of an edit window in character units. - -See also [Height](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/file-stack-size.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/file-stack-size.md deleted file mode 100644 index 6958238898a..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/file-stack-size.md +++ /dev/null @@ -1,3 +0,0 @@ -# File_Stack_Size - -This parameter specifies the number of the most recently used workspaces displayed in the Session File menu. See [Recently used file list size](../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/statusonedit.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/statusonedit.md deleted file mode 100644 index 377b1b2e831..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/statusonedit.md +++ /dev/null @@ -1,5 +0,0 @@ -# StatusOnEdit - -Specifies whether or not a status bar is displayed at the bottom of an Edit window. - -See also [Show status bars](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/tabstops.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/tabstops.md deleted file mode 100644 index a09b16bd3be..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/tabstops.md +++ /dev/null @@ -1,5 +0,0 @@ -# TabStops - -This parameter specifies the number of spaces inserted by pressing the Tab key in the editor. Its default value is 4. - -See also [Tab stops every ](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/toolbarsonedit.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/toolbarsonedit.md deleted file mode 100644 index 60a3f855305..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/toolbarsonedit.md +++ /dev/null @@ -1,5 +0,0 @@ -# ToolBarsOnEdit - -Specifies whether or not tool bars are displayed along the top of individual Edit windows. - -See also [Show tool bars](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/userconfigfile.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/userconfigfile.md deleted file mode 100644 index 8bf13ee1374..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/userconfigfile.md +++ /dev/null @@ -1,3 +0,0 @@ -# UserConfigFile - -This parameter specifies the name of the User Configuration file. See [Configuration Files](../configuration-files.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md deleted file mode 100644 index fe97a788762..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md +++ /dev/null @@ -1,5 +0,0 @@ -# ValueTips/ColourScheme - -This parameter specifies the colour scheme used to display a Value Tip when the user hovers the mouse over a name. - -See also [Colour Scheme](../../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/delay.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/delay.md deleted file mode 100644 index edc94f00dce..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/valuetips/delay.md +++ /dev/null @@ -1,5 +0,0 @@ -# ValueTips/Delay - -This parameter specifies the delay before a Value Tip is displayed when the user hovers the mouse over a name. - -See also [Display Value Tips](../../configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md deleted file mode 100644 index 36d26e1795c..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md +++ /dev/null @@ -1,5 +0,0 @@ -# WrapSearchMsgBox - -Specifies whether or not a message box is displayed to inform the user when the search wraps. - -See also [Show message box if text wraps](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md index cec62ca7bd5..1915b6371b6 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md @@ -8,14 +8,14 @@ Table: Configuration dialog: Auto Complete |Label|Parameter|Description| |---|---|---| -|Use Auto Complete|[Enabled](../../configuration-parameters/autocomplete/enabled.md)|Specifies whether or not Auto Completion is enabled.| -|Make suggestions after|[PrefixSize](../../configuration-parameters/autocomplete/prefixsize.md)|Specifies the number of characters you must enter before Auto Completion begins to make suggestions| -|Delay completion for|[KeyboardInputDelay](../../configuration-parameters/keyboardinputdelay.md)|Specifies the delay in milliseconds before Auto Completion begins to make suggestions| -|Suggest up to|[Rows](../../configuration-parameters/autocomplete/rows.md)|Specifies the maximum number of rows (height) in the AutoComplete pop-up suggestions box.| -|Show up to|[Cols](../../configuration-parameters/autocomplete/cols.md)|Specifies the maximum number of columns (width) in the AutoComplete pop-up suggestion box| -|Keep History|[History](../../configuration-parameters/autocomplete/history.md)|Specifies whether or not AutoComplete maintains a list of previous AutoCompletions.| -|History Length|[HistorySize](../../configuration-parameters/autocomplete/historysize.md)|Specifies the number of previous AutoCompletions that are maintained| -|Include filenames|[ShowFiles](../../configuration-parameters/autocomplete/showfiles.md)|Specifies whether or not AutoCompletion suggests directory and file names for `)LOAD` , `)COPY` and `)DROP` system commands.| -|OK Key|[CompleteKey1](../../configuration-parameters/autocomplete/completekey1.md) [CompleteKey2](../../configuration-parameters/autocomplete/completekey2.md)|Specifies two possible keys that may be used to select the current option from the Auto Complete suggestion box.| -|Cancel Key|[CancelKey1](../../configuration-parameters/autocomplete/cancelkey1.md) [CancelKey2](../../configuration-parameters/autocomplete/cancelkey2.md)|Specifies two possible keys that may be used to cancel (hide) the Auto Complete suggestion box.| -|Common Key|[CommonKey1](../../configuration-parameters/autocomplete/commonkey1.md)|Specifies the key that will auto-complete the *common prefix* .| +|Use Auto Complete|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/enabled.md)|Specifies whether or not Auto Completion is enabled.| +|Make suggestions after|[PrefixSize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/prefixsize.md)|Specifies the number of characters you must enter before Auto Completion begins to make suggestions| +|Delay completion for|[KeyboardInputDelay](../../../../dyalog-configuration-guide/configuration-parameters/keyboardinputdelay.md)|Specifies the delay in milliseconds before Auto Completion begins to make suggestions| +|Suggest up to|[Rows](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/rows.md)|Specifies the maximum number of rows (height) in the AutoComplete pop-up suggestions box.| +|Show up to|[Cols](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cols.md)|Specifies the maximum number of columns (width) in the AutoComplete pop-up suggestion box| +|Keep History|[History](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/history.md)|Specifies whether or not AutoComplete maintains a list of previous AutoCompletions.| +|History Length|[HistorySize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/historysize.md)|Specifies the number of previous AutoCompletions that are maintained| +|Include filenames|[ShowFiles](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/showfiles.md)|Specifies whether or not AutoCompletion suggests directory and file names for `)LOAD` , `)COPY` and `)DROP` system commands.| +|OK Key|[CompleteKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey1.md) [CompleteKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey2.md)|Specifies two possible keys that may be used to select the current option from the Auto Complete suggestion box.| +|Cancel Key|[CancelKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey1.md) [CancelKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey2.md)|Specifies two possible keys that may be used to cancel (hide) the Auto Complete suggestion box.| +|Common Key|[CommonKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/commonkey1.md)|Specifies the key that will auto-complete the *common prefix* .| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md index 228cdfee5f4..5d2894ea063 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md @@ -6,11 +6,11 @@ Table: Configuration dialog: General |Label|Parameter|Description| |---|---|---| -|Recently used file list size|[File_Stack_Size](../../configuration-parameters/file-stack-size.md)|Specifies the number of the most recently used workspaces displayed in the File menu.| -|Underline URLs and links|[URLHighlight](../../configuration-parameters/urlhighlight.md)|Specifies whether or not URLs and links are highlighted in Session and Edit windows.| -|Display Value Tips|[Enabled](../../configuration-parameters/valuetips/enabled.md)|Specifies whether or not Value Tips are enabled.| -|Display Value Tips after|[Delay](../../configuration-parameters/valuetips/delay.md)|Specifies the delay before APL displays a Value Tip.| -|Colour Scheme|[ColourScheme](../../configuration-parameters/valuetips/colourscheme.md)|Specifies the colour scheme used to display Value Tips.| -|Enable DPI Scaling of the interpreter and development environment|[AutoDPI](../../configuration-parameters/autodpi.md)|Enables or disables DPI scaling for the APL Session| -|Enable DPI scaling of GUI application|[Dyalog_Pixel_Type](../../configuration-parameters/dyalog-pixel-type.md)|Determines whether Coord `'Pixel'` is treated as ScaledPixel or RealPixel.| -|Configuration saved in|[IniFile](../../configuration-parameters/inifile.md)|Specifies the full pathname of the registry folder used by APL| +|Recently used file list size|[File_Stack_Size](../../../../dyalog-configuration-guide/configuration-parameters/file-stack-size.md)|Specifies the number of the most recently used workspaces displayed in the File menu.| +|Underline URLs and links|[URLHighlight](../../../../dyalog-configuration-guide/configuration-parameters/urlhighlight.md)|Specifies whether or not URLs and links are highlighted in Session and Edit windows.| +|Display Value Tips|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/enabled.md)|Specifies whether or not Value Tips are enabled.| +|Display Value Tips after|[Delay](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/delay.md)|Specifies the delay before APL displays a Value Tip.| +|Colour Scheme|[ColourScheme](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/colourscheme.md)|Specifies the colour scheme used to display Value Tips.| +|Enable DPI Scaling of the interpreter and development environment|[AutoDPI](../../../../dyalog-configuration-guide/configuration-parameters/autodpi.md)|Enables or disables DPI scaling for the APL Session| +|Enable DPI scaling of GUI application|[Dyalog_Pixel_Type](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-pixel-type.md)|Determines whether Coord `'Pixel'` is treated as ScaledPixel or RealPixel.| +|Configuration saved in|[IniFile](../../../../dyalog-configuration-guide/configuration-parameters/inifile.md)|Specifies the full pathname of the registry folder used by APL| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md index 53b8a67f84c..8af8d6a2340 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md @@ -6,6 +6,6 @@ Table: Configuration dialog: Help/DMX |Label|Parameter|Description| |---|---|---| -|DMX messages should go to|[DMXOutputOnError](../../configuration-parameters/dmxoutputonerror.md)|If checked, these boxes cause APL to display `⎕DMX` messages in the corresponding window(s).| -|Use Microsoft's documentation centre for non-Dyalog topics|[UseExternalHelpURL](../../configuration-parameters/useexternalhelpurl.md)|If this option is checked, APL will look for help for external objects at Microsoft's documentation center, which is identified by the specified URL.| -|URL|[ExternalHelpURL](../../configuration-parameters/externalhelpurl.md)|The URL for the documentation centre.| +|DMX messages should go to|[DMXOutputOnError](../../../../dyalog-configuration-guide/configuration-parameters/dmxoutputonerror.md)|If checked, these boxes cause APL to display `⎕DMX` messages in the corresponding window(s).| +|Use Microsoft's documentation centre for non-Dyalog topics|[UseExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/useexternalhelpurl.md)|If this option is checked, APL will look for help for external objects at Microsoft's documentation center, which is identified by the specified URL.| +|URL|[ExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/externalhelpurl.md)|The URL for the documentation centre.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md index ae8abe5970a..d4db20a610f 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Keyboard |Label |Parameter |Description | |-----------------------|----------------------------------------------------|------------------------------------------------------------------| -|Input table search path|[APLKeys](../../configuration-parameters/aplkeys.md)|A list of directories to be searched for the specified input table| -|Input table file |[APLK](../../configuration-parameters/aplk.md) |The name of the input table file (.DIN) | +|Input table search path|[APLKeys](../../../../dyalog-configuration-guide/configuration-parameters/aplkeys.md)|A list of directories to be searched for the specified input table| +|Input table file |[APLK](../../../../dyalog-configuration-guide/configuration-parameters/aplk.md) |The name of the input table file (.DIN) | diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md index 84ccb377213..8632dc387ed 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md @@ -8,6 +8,6 @@ Table: Configuration dialog: Object Syntax |Label|Parameter|Description| |---|---|---| -|Expose properties of GUI Namespaces|[Default_WX](../../configuration-parameters/default-wx.md)|Specifies the value of `⎕WX` in a clear workspace.| -|Expose properties of Root|[PropertyExposeRoot](../../configuration-parameters/propertyexposeroot.md)|Specifies whether or not the names of properties, methods and events of the Root object are exposed.| -|Expose properties of Session Namespace|[PropertyExposeSE](../../configuration-parameters/propertyexposese.md)|Specifies whether or not the names of properties, methods and events of the Session object are exposed.| +|Expose properties of GUI Namespaces|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx.md)|Specifies the value of `⎕WX` in a clear workspace.| +|Expose properties of Root|[PropertyExposeRoot](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposeroot.md)|Specifies whether or not the names of properties, methods and events of the Root object are exposed.| +|Expose properties of Session Namespace|[PropertyExposeSE](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposese.md)|Specifies whether or not the names of properties, methods and events of the Session object are exposed.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md index 815eec2d86f..8639dc9a368 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Output |Label |Parameter |Description | |------------------------|------------------------------------------------------|-------------------------------------------------------------------| -|Output table search path|[APLTrans](../../configuration-parameters/apltrans.md)|A list of directories to be searched for the specified output table| -|Output table file |[APLT](../../configuration-parameters/aplt.md) |The name of the output table file (.DOT) | +|Output table search path|[APLTrans](../../../../dyalog-configuration-guide/configuration-parameters/apltrans.md)|A list of directories to be searched for the specified output table| +|Output table file |[APLT](../../../../dyalog-configuration-guide/configuration-parameters/aplt.md) |The name of the output table file (.DOT) | diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md index 5646e33a725..53e6355e3b5 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md @@ -6,21 +6,21 @@ Table: Configuration dialog: Session |Label|Parameter|Description| |---|---|---| -|`⎕IO`|[Default_IO](../../configuration-parameters/default-io.md)|The default value of `⎕IO` in a `clear ws` .| -|`⎕ML`|[Default_ML](../../configuration-parameters/default-ml.md)|The default value of `⎕ML` in a `clear ws`| -|`⎕PP`|[Default_PP](../../configuration-parameters/default-pp.md)|The default value of `⎕PP` in a `clear ws` .| -|`⎕RTL`|[Default_RTL](../../configuration-parameters/default-rtl.md)|The default value of `⎕RTL` in a `clear ws` .| -|`⎕DIV`|[Default_DIV](../../configuration-parameters/default-div.md)|The default value of `⎕DIV` in a `clear ws` .| -|`⎕WX`|[Default_WX](../../configuration-parameters/default-wx.md)|The default value of `⎕WX` in a `clear ws` .| -|Auto PW|[Auto_PW](../../configuration-parameters/auto-pw.md)|If checked, the value of `⎕PW` is dynamic and depends on the width of the Session Window.| -|Input buffer size|[Input_Size](../../configuration-parameters/input-size.md)|The size of the buffer used to store marked lines (lines awaiting execution) in the Session.| -|History size|[History_Size](../../configuration-parameters/history-size.md)|The size of the buffer used to store previously entered (input) lines in the Session| -|PFKey buffer size|[PFKey_Size](../../configuration-parameters/pfkey-size.md)|The size of the buffer used to store PFKey definitions ( `⎕PFKEY` )| -|Confirm on Deletion from Session log|[Confirm_Session_Delete](../../configuration-parameters/confirm-session-delete.md)|Specifies whether or not you are prompted to confirm the deletion of a line from the Session (and Session log).| -|Session log size|[Log_Size](../../configuration-parameters/log-size.md)|The size of the Session log buffer.| -|Session file|[Session_File](../../configuration-parameters/session-file.md)|The name of the Session file in which the definition of your session ( `⎕SE` ) is stored.| -|Use log file|[Log_File_InUse](../../configuration-parameters/log-file-inuse.md)|Specifies whether or not the Session log is saved in a session log file| -|Use log file|[Log_File](../../configuration-parameters/log-file.md)|The full pathname of the Session log file| -|Multiline Input|[Dyalog_LineEditor_Mode](../../configuration-parameters/dyalog-lineeditor-mode.md)|Specifies whether or not multi-line input is enabled in the Session.| +|`⎕IO`|[Default_IO](../../../../dyalog-configuration-guide/configuration-parameters/default-io.md)|The default value of `⎕IO` in a `clear ws` .| +|`⎕ML`|[Default_ML](../../../../dyalog-configuration-guide/configuration-parameters/default-ml.md)|The default value of `⎕ML` in a `clear ws`| +|`⎕PP`|[Default_PP](../../../../dyalog-configuration-guide/configuration-parameters/default-pp.md)|The default value of `⎕PP` in a `clear ws` .| +|`⎕RTL`|[Default_RTL](../../../../dyalog-configuration-guide/configuration-parameters/default-rtl.md)|The default value of `⎕RTL` in a `clear ws` .| +|`⎕DIV`|[Default_DIV](../../../../dyalog-configuration-guide/configuration-parameters/default-div.md)|The default value of `⎕DIV` in a `clear ws` .| +|`⎕WX`|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx.md)|The default value of `⎕WX` in a `clear ws` .| +|Auto PW|[Auto_PW](../../../../dyalog-configuration-guide/configuration-parameters/auto-pw.md)|If checked, the value of `⎕PW` is dynamic and depends on the width of the Session Window.| +|Input buffer size|[Input_Size](../../../../dyalog-configuration-guide/configuration-parameters/input-size.md)|The size of the buffer used to store marked lines (lines awaiting execution) in the Session.| +|History size|[History_Size](../../../../dyalog-configuration-guide/configuration-parameters/history-size.md)|The size of the buffer used to store previously entered (input) lines in the Session| +|PFKey buffer size|[PFKey_Size](../../../../dyalog-configuration-guide/configuration-parameters/pfkey-size.md)|The size of the buffer used to store PFKey definitions ( `⎕PFKEY` )| +|Confirm on Deletion from Session log|[Confirm_Session_Delete](../../../../dyalog-configuration-guide/configuration-parameters/confirm-session-delete.md)|Specifies whether or not you are prompted to confirm the deletion of a line from the Session (and Session log).| +|Session log size|[Log_Size](../../../../dyalog-configuration-guide/configuration-parameters/log-size.md)|The size of the Session log buffer.| +|Session file|[Session_File](../../../../dyalog-configuration-guide/configuration-parameters/session-file.md)|The name of the Session file in which the definition of your session ( `⎕SE` ) is stored.| +|Use log file|[Log_File_InUse](../../../../dyalog-configuration-guide/configuration-parameters/log-file-inuse.md)|Specifies whether or not the Session log is saved in a session log file| +|Use log file|[Log_File](../../../../dyalog-configuration-guide/configuration-parameters/log-file.md)|The full pathname of the Session log file| +|Multiline Input|[Dyalog_LineEditor_Mode](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-lineeditor-mode.md)|Specifies whether or not multi-line input is enabled in the Session.| Note: The value of size-related values defined in the above table is specified as an integer value followed by one of K, M, G, T, P or E. The default, where no character is included, is K (Kilobytes). diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md index 578fa14a506..9248a34d5c3 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md @@ -6,31 +6,31 @@ Table: Configuration dialog: Trace/Edit |Label|Parameter|Description| |---|---|---| -|Classic Dyalog mode|[ClassicMode](../../configuration-parameters/classicmode.md)|Selects pre-Version 9 behaviour for Edit and Trace windows.| -|Allow session above edit windows|[SessionOnTop](../../configuration-parameters/sessionontop.md)|Specifies whether or not the Session may appear on top of Edit and Trace Windows| -|Single trace window|[ SingleTrace](../../configuration-parameters/singletrace.md)|Specifies whether or not there is a single Trace window| -|Remember previous window position|[ClassicModeSavePosition](../../configuration-parameters/classicmodesaveposition.md)|Specifies whether or not the current size and location of the first of the editor and tracer windows are remembered in the registry for next time.| -|Allow floating edit windows|[DockableEditWindows](../../configuration-parameters/dockableeditwindows.md)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| -|Show status bars|[ StatusOnEdit](../../configuration-parameters/statusonedit.md)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| -|Show tool bars|[ ToolBarsOnEdit](../../configuration-parameters/toolbarsonedit.md)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| -|Show trace stack on error|[Trace_On_Error](../../configuration-parameters/trace-on-error.md)|Specifies whether or not the Tracer is automatically invoked when an error or stop occurs in a defined function| -|Allow search to wrap|[ WrapSearch](../../configuration-parameters/wrapsearch.md)|Specifies whether or not Search/Replace in the Editor stops at the top or bottom of the text, or continues from the start or end as appropriate.| -|Show message box if text wraps|[ WrapSearchMsgBox](../../configuration-parameters/wrapsearchmsgbox.md)|Specifies whether or not a message box is displayed to inform the user when the search wraps.| -|Warn if trace stack bigger than|[Trace_Level_Warn](../../configuration-parameters/trace-level-warn.md)|Specifies the maximum stack size for automatic deployment of the Tracer.| -|Confirm edit window close on Close|[Confirm_Close](../../configuration-parameters/confirm-close.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then closes it without saving| -|Confirm edit window close on Edit (and Fix)|[Confirm_Fix](../../configuration-parameters/confirm-fix.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then saves it using *Fix* or *Exit*| -|Confirm edit window close on Abort|[Confirm_Abort](../../configuration-parameters/confirm-abort.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then aborts using| -|Autoformat functions|[ AutoFormat](../../configuration-parameters/autoformat.md)|Selects automatic indentation for Control Structures when function is opened for editing| -|Autoindent|[ AutoIndent](../../configuration-parameters/autoindent.md)|Selects semi-automatic indentation for Control Structures while editing| -|Double-click to Edit|[ DoubleClickEdit](../../configuration-parameters/doubleclickedit.md)|Specifies whether or not double-clicking  over a name invokes the editor| -|Skip blank lines when tracing|[ SkipLines](../../configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip blank lines.| -|Skip comment lines when tracing|[ SkipLines](../../configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip comment lines.| -|Skip locals lines when tracing|[ SkipLines](../../configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip locals lines.| -|Limit tracer display to current function in script|[AddClassHeaders](../../configuration-parameters/addclassheaders.md)|When Tracing the execution of a function in a script, the Tracer displays either just the first line of the script and the function in question (option enabled), or the entire script (option disabled).| -|Paste text as Unicode (Classic Edition only)|[ UnicodeToClipboard](../../configuration-parameters/unicodetoclipboard.md)|Specifies whether or not text transferred to and from the Windows clipboard is to be treated as Unicode| -|Tab stops every|[ TabStops](../../configuration-parameters/tabstops.md)|The number of spaces inserted by pressing Tab in an edit window| -|Exit and fix ...|[ InitFullScriptSusp](../../configuration-parameters/initfullscriptsusp.md)|See Fixing Scripts below| -|If not ...|[InitFullScriptNormal](../../configuration-parameters/initfullscriptnormal.md)|See Fixing Scripts below| +|Classic Dyalog mode|[ClassicMode](../../../../dyalog-configuration-guide/configuration-parameters/classicmode.md)|Selects pre-Version 9 behaviour for Edit and Trace windows.| +|Allow session above edit windows|[SessionOnTop](../../../../dyalog-configuration-guide/configuration-parameters/sessionontop.md)|Specifies whether or not the Session may appear on top of Edit and Trace Windows| +|Single trace window|[ SingleTrace](../../../../dyalog-configuration-guide/configuration-parameters/singletrace.md)|Specifies whether or not there is a single Trace window| +|Remember previous window position|[ClassicModeSavePosition](../../../../dyalog-configuration-guide/configuration-parameters/classicmodesaveposition.md)|Specifies whether or not the current size and location of the first of the editor and tracer windows are remembered in the registry for next time.| +|Allow floating edit windows|[DockableEditWindows](../../../../dyalog-configuration-guide/configuration-parameters/dockableeditwindows.md)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| +|Show status bars|[ StatusOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/statusonedit.md)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| +|Show tool bars|[ ToolBarsOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/toolbarsonedit.md)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| +|Show trace stack on error|[Trace_On_Error](../../../../dyalog-configuration-guide/configuration-parameters/trace-on-error.md)|Specifies whether or not the Tracer is automatically invoked when an error or stop occurs in a defined function| +|Allow search to wrap|[ WrapSearch](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearch.md)|Specifies whether or not Search/Replace in the Editor stops at the top or bottom of the text, or continues from the start or end as appropriate.| +|Show message box if text wraps|[ WrapSearchMsgBox](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearchmsgbox.md)|Specifies whether or not a message box is displayed to inform the user when the search wraps.| +|Warn if trace stack bigger than|[Trace_Level_Warn](../../../../dyalog-configuration-guide/configuration-parameters/trace-level-warn.md)|Specifies the maximum stack size for automatic deployment of the Tracer.| +|Confirm edit window close on Close|[Confirm_Close](../../../../dyalog-configuration-guide/configuration-parameters/confirm-close.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then closes it without saving| +|Confirm edit window close on Edit (and Fix)|[Confirm_Fix](../../../../dyalog-configuration-guide/configuration-parameters/confirm-fix.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then saves it using *Fix* or *Exit*| +|Confirm edit window close on Abort|[Confirm_Abort](../../../../dyalog-configuration-guide/configuration-parameters/confirm-abort.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then aborts using| +|Autoformat functions|[ AutoFormat](../../../../dyalog-configuration-guide/configuration-parameters/autoformat.md)|Selects automatic indentation for Control Structures when function is opened for editing| +|Autoindent|[ AutoIndent](../../../../dyalog-configuration-guide/configuration-parameters/autoindent.md)|Selects semi-automatic indentation for Control Structures while editing| +|Double-click to Edit|[ DoubleClickEdit](../../../../dyalog-configuration-guide/configuration-parameters/doubleclickedit.md)|Specifies whether or not double-clicking  over a name invokes the editor| +|Skip blank lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip blank lines.| +|Skip comment lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip comment lines.| +|Skip locals lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip locals lines.| +|Limit tracer display to current function in script|[AddClassHeaders](../../../../dyalog-configuration-guide/configuration-parameters/addclassheaders.md)|When Tracing the execution of a function in a script, the Tracer displays either just the first line of the script and the function in question (option enabled), or the entire script (option disabled).| +|Paste text as Unicode (Classic Edition only)|[ UnicodeToClipboard](../../../../dyalog-configuration-guide/configuration-parameters/unicodetoclipboard.md)|Specifies whether or not text transferred to and from the Windows clipboard is to be treated as Unicode| +|Tab stops every|[ TabStops](../../../../dyalog-configuration-guide/configuration-parameters/tabstops.md)|The number of spaces inserted by pressing Tab in an edit window| +|Exit and fix ...|[ InitFullScriptSusp](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptsusp.md)|See Fixing Scripts below| +|If not ...|[InitFullScriptNormal](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptnormal.md)|See Fixing Scripts below| ## Fixing Scripts diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md index 0a00c03d90a..16b9892cb1e 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md @@ -8,9 +8,9 @@ Table: Configuration dialog: Unicode Input |Label|Parameter|Description| |---|---|---| -|Activate selected keyboard|[InitialKeyboardLayoutInUse](../../configuration-parameters/initialkeyboardlayoutinuse.md)|If checked, the specified APL keyboard is activated on start-up.| -|Show keyboards for all Languages|[InitialKeyboardLayoutShowAll](../../configuration-parameters/initialkeyboardlayoutshowall.md)|If checked, all installed keyboards are displayed. Otherwise, only Dyalog keyboards are shown| -|Keyboard|[InitialKeyboardLayout](../../configuration-parameters/initialkeyboardlayout.md)|the APL keyboard to be selected.| +|Activate selected keyboard|[InitialKeyboardLayoutInUse](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutinuse.md)|If checked, the specified APL keyboard is activated on start-up.| +|Show keyboards for all Languages|[InitialKeyboardLayoutShowAll](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutshowall.md)|If checked, all installed keyboards are displayed. Otherwise, only Dyalog keyboards are shown| +|Keyboard|[InitialKeyboardLayout](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayout.md)|the APL keyboard to be selected.| |Configure Layout| |Displays thefollowng dialog box.| ## Input Method Editor Properties @@ -21,8 +21,8 @@ Table: Dyalog Input Method Editor Properties |Label|Parameter|Description| |---|---|---| -|Use Ctrl-X,C,V for clipboard|[UseXCV](../../configuration-parameters/usexcv.md)|specifies whether or not the commonly used keystrokes for copy, cut and paste are recognised as such.| +|Use Ctrl-X,C,V for clipboard|[UseXCV](../../../../dyalog-configuration-guide/configuration-parameters/usexcv.md)|specifies whether or not the commonly used keystrokes for copy, cut and paste are recognised as such.| |Enable Backtick Keyboard introducer| | | -|Enable Overstrikes|[ResolveOverstrikes](../../configuration-parameters/resolveoverstrikes.md)|1 = enable overstrikes. 0 = disable overstrikes| +|Enable Overstrikes|[ResolveOverstrikes](../../../../dyalog-configuration-guide/configuration-parameters/resolveoverstrikes.md)|1 = enable overstrikes. 0 = disable overstrikes| |Overstrikes do not require the OS introducer key| |1 = IME identifies overstrike operation automatically 0 = IME requires the key (default Ctrl+Bksp) to signal an overstrike operation| -|Use Overstrike popup|[OverstrikesPopup](../../configuration-parameters/overstrikespopup.md)|1 = enable the overstrike popup. 0 = disable the overstrike popup| +|Use Overstrike popup|[OverstrikesPopup](../../../../dyalog-configuration-guide/configuration-parameters/overstrikespopup.md)|1 = enable the overstrike popup. 0 = disable the overstrike popup| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md index 29fc429ed28..0fba6e3ccb2 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md @@ -6,25 +6,25 @@ Table: Configuration dialog: Windows (Edit Windows) |Label |Parameter |Description | |--------|----------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------| -|Width |[Edit_Cols](../../configuration-parameters/edit-cols.md) |The maximum number of rows displayed in a new edit window. | -|Height |[Edit_Rows](../../configuration-parameters/edit-rows.md) |The maximum number of columns displayed in a new edit window. | -|X Pos |[Edit_First_X](../../configuration-parameters/edit-first-x.md) |The initial horizontal position in characters of the first edit window. | -|Y Pos |[Edit_First_Y](../../configuration-parameters/edit-first-y.md) |The initial vertical position in characters of the first edit window. | -|X Offset|[Edit_Offset_X](../../configuration-parameters/edit-offset-x.md)|The initial horizontal position in characters of the second and subsequent edit windows relative to the previous one.| -|Y Offset|[Edit_Offset_Y](../../configuration-parameters/edit-offset-y.md)|The initial vertical position in characters of the second and subsequent edit windows relative to the previous one. | +|Width |[Edit_Cols](../../../../dyalog-configuration-guide/configuration-parameters/edit-cols.md) |The maximum number of rows displayed in a new edit window. | +|Height |[Edit_Rows](../../../../dyalog-configuration-guide/configuration-parameters/edit-rows.md) |The maximum number of columns displayed in a new edit window. | +|X Pos |[Edit_First_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-x.md) |The initial horizontal position in characters of the first edit window. | +|Y Pos |[Edit_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-y.md) |The initial vertical position in characters of the first edit window. | +|X Offset|[Edit_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-x.md)|The initial horizontal position in characters of the second and subsequent edit windows relative to the previous one.| +|Y Offset|[Edit_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-y.md)|The initial vertical position in characters of the second and subsequent edit windows relative to the previous one. | Table: Configuration dialog: Windows (Trace Windows) |Label |Parameter |Description | |--------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------| -|X Pos |[Trace_First_X](../../configuration-parameters/trace-first-x.md) |The initial horizontal position in characters of the first trace window. | -|Y Pos |[Trace_First_Y](../../configuration-parameters/trace-first-y.md) |The initial vertical position in characters of the first trace window. | -|X Offset|[Trace_Offset_X](../../configuration-parameters/trace-offset-x.md)|The initial horizontal position in characters of the second and subsequent trace windows relative to the previous one.| -|Y Offset|[Trace_Offset_Y](../../configuration-parameters/trace-offset-y.md)|The initial vertical position in characters of the second and subsequent trace windows relative to the previous one. | +|X Pos |[Trace_First_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-x.md) |The initial horizontal position in characters of the first trace window. | +|Y Pos |[Trace_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-y.md) |The initial vertical position in characters of the first trace window. | +|X Offset|[Trace_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-x.md)|The initial horizontal position in characters of the second and subsequent trace windows relative to the previous one.| +|Y Offset|[Trace_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-y.md)|The initial vertical position in characters of the second and subsequent trace windows relative to the previous one. | Table: Configuration dialog: Windows (QuadSM Window) |Label |Parameter |Description | |------|----------------------------------------------------|--------------------------------------------| -|Width |[SM_Cols](../../configuration-parameters/sm-cols.md)|The width of the `⎕SM` and prefect windows. | -|Height|[SM_Rows](../../configuration-parameters/sm-rows.md)|The height of the `⎕SM` and prefect windows.| +|Width |[SM_Cols](../../../../dyalog-configuration-guide/configuration-parameters/sm-cols.md)|The width of the `⎕SM` and prefect windows. | +|Height|[SM_Rows](../../../../dyalog-configuration-guide/configuration-parameters/sm-rows.md)|The height of the `⎕SM` and prefect windows.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md index 94303d2bee7..4115060b3c9 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Workspace |Label |Parameter |Description | |----------------------|--------------------------------------------------|-------------------------------------------------------------------------------------------------| -|Workspace search path |[WSPath](../../configuration-parameters/wspath.md)|A list of directories to be searched for the specified workspace when the user executes `)LOAD` .| -|Maximum workspace size|[MaxWS](../../configuration-parameters/maxws.md) |The maximum size of the workspace. | +|Workspace search path |[WSPath](../../../../dyalog-configuration-guide/configuration-parameters/wspath.md)|A list of directories to be searched for the specified workspace when the user executes `)LOAD` .| +|Maximum workspace size|[MaxWS](../../../../dyalog-configuration-guide/configuration-parameters/maxws.md) |The maximum size of the workspace. | diff --git a/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md b/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md index f26755c4cb3..c49403866af 100644 --- a/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md +++ b/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md @@ -18,7 +18,7 @@ All but the first of these are made using the *Export* dialog box accessed from ## Configuration Parameters -Configuration parameters for these run-time applications, both for the Dyalog engine and for your own application settings, may be specified in a number of ways. See [Configuration Parameters](configuration-parameters/configuration-parameters.md). +Configuration parameters for these run-time applications, both for the Dyalog engine and for your own application settings, may be specified in a number of ways. See [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters.md). Nevertheless, it is strongly recommended that you use Configuration files. In this section we will discuss only Application Configuration files, although User Configuration files may be used as well. @@ -54,7 +54,7 @@ The application starts by running `⎕LX` in `myapp.dws`. If a configuration fil dyalogrt.exe Load=myfn.aplf ``` -The application loads the file named `myfn.aplf` which contains the source code for a function, and executes the expression `(myfn 0⍴⊂'')` (see [Load](configuration-parameters/load.md)). If a configuration file named `myfn.dcfg` in the same directory, it is loaded and applied. +The application loads the file named `myfn.aplf` which contains the source code for a function, and executes the expression `(myfn 0⍴⊂'')` (see [Load](../../dyalog-configuration-guide/configuration-parameters/load.md)). If a configuration file named `myfn.dcfg` in the same directory, it is loaded and applied. If your application uses any component of the Microsoft .NET Framework, you must distribute the Bridge DLL and DyalogNet DLLs. These DLLs must be placed in the same directory as your EXE. diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml index 4d6292d38db..13e367d3e30 100644 --- a/windows-installation-and-configuration-guide/mkdocs.yml +++ b/windows-installation-and-configuration-guide/mkdocs.yml @@ -61,157 +61,6 @@ nav: - The APL Command Line: apl-command-line.md - APL Exit Codes: apl-exit-codes.md - Dyalog Serial Number: dyalog-serial-number.md - - Configuration Parameters: - - Introduction: configuration-parameters/configuration-parameters.md - - AddClassHeaders: configuration-parameters/addclassheaders.md - - APLAN_FOR_EDITOR: configuration-parameters/aplan-for-editor.md - - APLAN_FOR_OUTPUT: configuration-parameters/aplan-for-output.md - - AplCoreName: configuration-parameters/aplcorename.md - - aplk: configuration-parameters/aplk.md - - aplkeys: configuration-parameters/aplkeys.md - - aplnid: configuration-parameters/aplnid.md - - aplt: configuration-parameters/aplt.md - - apltrans: configuration-parameters/apltrans.md - - APL_CODE_E_MAGNITUDE: configuration-parameters/apl-code-e-magnitude.md - - APL_COMPLEX_AS_V12: configuration-parameters/apl-complex-as-v12.md - - APL_FCREATE_PROPS_C: configuration-parameters/apl-fcreate-props-c.md - - APL_FCREATE_PROPS_J: configuration-parameters/apl-fcreate-props-j.md - - APL_FAST_FCHK: configuration-parameters/apl-fast-fchk.md - - APL_MAX_THREADS: configuration-parameters/apl-max-threads.md - - APL_TextInAplCore: configuration-parameters/apl-textinaplcore.md - - AutoDPI: configuration-parameters/autodpi.md - - AutoComplete: - - CancelKey1: configuration-parameters/autocomplete/cancelkey1.md - - CancelKey2: configuration-parameters/autocomplete/cancelkey2.md - - Cols: configuration-parameters/autocomplete/cols.md - - CommonKey1: configuration-parameters/autocomplete/commonkey1.md - - CompleteKey1: configuration-parameters/autocomplete/completekey1.md - - CompleteKey2: configuration-parameters/autocomplete/completekey2.md - - Enabled: configuration-parameters/autocomplete/enabled.md - - History: configuration-parameters/autocomplete/history.md - - HistorySize: configuration-parameters/autocomplete/historysize.md - - PrefixSize: configuration-parameters/autocomplete/prefixsize.md - - Rows: configuration-parameters/autocomplete/rows.md - - ShowFiles: configuration-parameters/autocomplete/showfiles.md - - AutoFormat: configuration-parameters/autoformat.md - - AutoIndent: configuration-parameters/autoindent.md - - auto_pw: configuration-parameters/auto-pw.md - - CFEXT: configuration-parameters/cfext.md - - ClassicMode: configuration-parameters/classicmode.md - - ClassicModeSavePosition: configuration-parameters/classicmodesaveposition.md - - CMD_PREFIX and CMD_POSTFIX: configuration-parameters/cmd-prefix-and-cmd-postfix.md - - ConfigFile: configuration-parameters/configfile.md - - confirm_abort: configuration-parameters/confirm-abort.md - - confirm_close: configuration-parameters/confirm-close.md - - confirm_fix: configuration-parameters/confirm-fix.md - - confirm_session_delete: configuration-parameters/confirm-session-delete.md - - default_div: configuration-parameters/default-div.md - - default_io: configuration-parameters/default-io.md - - default_ml: configuration-parameters/default-ml.md - - default_pp: configuration-parameters/default-pp.md - - default_pw: configuration-parameters/default-pw.md - - default_rtl: configuration-parameters/default-rtl.md - - default_wx: configuration-parameters/default-wx.md - - DMXOUTPUTONERROR: configuration-parameters/dmxoutputonerror.md - - DockableEditWindows: configuration-parameters/dockableeditwindows.md - - DoubleClickEdit: configuration-parameters/doubleclickedit.md - - dyalog: configuration-parameters/dyalog.md - - DyalogEmailAddress: configuration-parameters/dyalogemailaddress.md - - DyalogHelpDir: configuration-parameters/dyaloghelpdir.md - - DyalogInstallDir: configuration-parameters/dyaloginstalldir.md - - DyalogLink: configuration-parameters/dyaloglink.md - - DyalogStartup: configuration-parameters/dyalogstartup.md - - DyalogStartupSE: configuration-parameters/dyalogstartupse.md - - DyalogStartup_X: configuration-parameters/dyalogstartup-x.md - - DyalogWebSite: configuration-parameters/dyalogwebsite.md - - DYALOG_DISCARD_FN_SOURCE: configuration-parameters/dyalog-discard-fn-source.md - - DYALOG_EVENTLOGGINGLEVEL: configuration-parameters/dyalog-eventlogginglevel.md - - DYALOG_EVENTLOGNAME: configuration-parameters/dyalog-eventlogname.md - - DYALOG_GUTTER_ENABLE: configuration-parameters/dyalog-gutter-enable.md - - Dyalog_LineEditor_Mode: configuration-parameters/dyalog-lineeditor-mode.md - - Dyalog_NETCore: configuration-parameters/dyalog-netcore.md - - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md - - DYALOG_PIXEL_TYPE: configuration-parameters/dyalog-pixel-type.md - - DYALOG_SERIAL: configuration-parameters/dyalog-serial.md - - EditorState: configuration-parameters/editorstate.md - - Edit_Cols: configuration-parameters/edit-cols.md - - Edit_First_X: configuration-parameters/edit-first-x.md - - Edit_First_Y: configuration-parameters/edit-first-y.md - - Edit_Offset_X: configuration-parameters/edit-offset-x.md - - Edit_Offset_Y: configuration-parameters/edit-offset-y.md - - Edit_Rows: configuration-parameters/edit-rows.md - - ENABLE_CEF: configuration-parameters/enable-cef.md - - ErrorOnExternalException: configuration-parameters/erroronexternalexception.md - - ExternalHelpURL: configuration-parameters/externalhelpurl.md - - File_Stack_Size: configuration-parameters/file-stack-size.md - - greet_bitmap: configuration-parameters/greet-bitmap.md - - history_size: configuration-parameters/history-size.md - - inifile: configuration-parameters/inifile.md - - InitFullScriptNormal: configuration-parameters/initfullscriptnormal.md - - InitFullScriptSusp: configuration-parameters/initfullscriptsusp.md - - InitialKeyboardLayout: configuration-parameters/initialkeyboardlayout.md - - InitialKeyboardLayoutInUse: configuration-parameters/initialkeyboardlayoutinuse.md - - InitialKeyboardLayoutShowAll: configuration-parameters/initialkeyboardlayoutshowall.md - - input_size: configuration-parameters/input-size.md - - KeyboardInputDelay: configuration-parameters/keyboardinputdelay.md - - Load: configuration-parameters/load.md - - localdyalogdir: configuration-parameters/localdyalogdir.md - - log_file: configuration-parameters/log-file.md - - log_file_inuse: configuration-parameters/log-file-inuse.md - - log_size: configuration-parameters/log-size.md - - LX: configuration-parameters/lx.md - - mapchars: configuration-parameters/mapchars.md - - MaxAplCores: configuration-parameters/maxaplcores.md - - maxws: configuration-parameters/maxws.md - - OverstrikesPopup: configuration-parameters/overstrikespopup.md - - PassExceptionsToOpSys: configuration-parameters/passexceptionstoopsys.md - - pfkey_size: configuration-parameters/pfkey-size.md - - ProgramFolder: configuration-parameters/programfolder.md - - PropertyExposeRoot: configuration-parameters/propertyexposeroot.md - - PropertyExposeSE: configuration-parameters/propertyexposese.md - - qcmd_timeout: configuration-parameters/qcmd-timeout.md - - ResolveOverstrikes: configuration-parameters/resolveoverstrikes.md - - RIDE_Init: configuration-parameters/ride-init.md - - RIDE_Spawned: configuration-parameters/ride-spawned.md - - RunAsService: configuration-parameters/runasservice.md - - SaveContinueOnExit: configuration-parameters/savecontinueonexit.md - - SaveLogOnExit: configuration-parameters/savelogonexit.md - - SaveSessionOnExit: configuration-parameters/savesessiononexit.md - - Serial: configuration-parameters/serial.md - - SessionOnTop: configuration-parameters/sessionontop.md - - session_file: configuration-parameters/session-file.md - - ShowStatusOnError: configuration-parameters/showstatusonerror.md - - SingleTrace: configuration-parameters/singletrace.md - - SkipLines: configuration-parameters/skiplines.md - - SM_Cols: configuration-parameters/sm-cols.md - - SM_Rows: configuration-parameters/sm-rows.md - - StatusOnEdit: configuration-parameters/statusonedit.md - - TabStops: configuration-parameters/tabstops.md - - ToolBarsOnEdit: configuration-parameters/toolbarsonedit.md - - TraceStopMonitor: configuration-parameters/tracestopmonitor.md - - Trace_First_X: configuration-parameters/trace-first-x.md - - Trace_First_Y: configuration-parameters/trace-first-y.md - - Trace_level_warn: configuration-parameters/trace-level-warn.md - - Trace_Offset_X: configuration-parameters/trace-offset-x.md - - Trace_Offset_Y: configuration-parameters/trace-offset-y.md - - Trace_On_Error: configuration-parameters/trace-on-error.md - - UCMDCacheFile: configuration-parameters/ucmdcachefile.md - - UnicodeToClipboard: configuration-parameters/unicodetoclipboard.md - - URLHighlight: configuration-parameters/urlhighlight.md - - UseExternalHelpURL: configuration-parameters/useexternalhelpurl.md - - UserConfigFile: configuration-parameters/userconfigfile.md - - UseXCV: configuration-parameters/usexcv.md - - ValueTips: - - ValueTips/ColourScheme: configuration-parameters/valuetips/colourscheme.md - - ValueTips/Delay: configuration-parameters/valuetips/delay.md - - ValueTips/Enabled: configuration-parameters/valuetips/enabled.md - - WantsSpecialKeys: configuration-parameters/wantsspecialkeys.md - - WrapSearch: configuration-parameters/wrapsearch.md - - WrapSearchMsgBox: configuration-parameters/wrapsearchmsgbox.md - - WSEXT: configuration-parameters/wsext.md - - WSPATH: configuration-parameters/wspath.md - - XPLookAndFeel: configuration-parameters/xplookandfeel.md - - yy_window: configuration-parameters/yy-window.md - Registry SubFolders: registry-subfolders.md - Configuration Files: configuration-files.md - Window Captions: window-captions.md diff --git a/windows-ui-guide/docs/file-explorer-integration.md b/windows-ui-guide/docs/file-explorer-integration.md index dc0c18b52ec..1cea0a7161f 100644 --- a/windows-ui-guide/docs/file-explorer-integration.md +++ b/windows-ui-guide/docs/file-explorer-integration.md @@ -14,7 +14,7 @@ During installation, Dyalog establishes the following file associations: When you double-click on a file with one of the above extensions, the file is opened with the corresponding application. -In addition, two items are added to the Windows Explorer context menu for directories, namely *Load with Dyalog* and *Run with Dyalog*. Both these items start Dyalog and attempt to import code from the corresponding directory using Link. The *Run with Dyalog* option also calls the function named `Run` if it exists. See [Load Parameter](../../windows-installation-and-configuration-guide/configuration-parameters/load). +In addition, two items are added to the Windows Explorer context menu for directories, namely *Load with Dyalog* and *Run with Dyalog*. Both these items start Dyalog and attempt to import code from the corresponding directory using Link. The *Run with Dyalog* option also calls the function named `Run` if it exists. See [Load Parameter](../../dyalog-configuration-guide/configuration-parameters/load). For more information about Link, see [https://dyalog.github.io/link/](https://dyalog.github.io/link/). diff --git a/windows-ui-guide/docs/multiline-session-input.md b/windows-ui-guide/docs/multiline-session-input.md index 173bdec14d5..18361a51fda 100644 --- a/windows-ui-guide/docs/multiline-session-input.md +++ b/windows-ui-guide/docs/multiline-session-input.md @@ -2,7 +2,7 @@ The Session allows multi-line input. This feature is optional, and is controlled by the value of the **Dyalog_LineEditor_Mode** configuration parameter (default is `1`, meaning that multi-line input is enabled). To disable multi-line input, set **Dyalog_LineEditor_Mode** to `0`. -See [Dyalog_LineEditor_Mode.](../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-lineeditor-mode) +See [Dyalog_LineEditor_Mode.](../../dyalog-configuration-guide/configuration-parameters/dyalog-lineeditor-mode) On Microsoft Windows, multi-line input can be enabled and disabled using the **Enable Multiline Input** checkbox on the **Session** tab of the **Configuration** dialog box. See [Dyalog_LineEditor_Mode](../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab). diff --git a/windows-ui-guide/docs/the-session-object/session-initialisation.md b/windows-ui-guide/docs/the-session-object/session-initialisation.md index a84b93bd8a7..897b7e39143 100644 --- a/windows-ui-guide/docs/the-session-object/session-initialisation.md +++ b/windows-ui-guide/docs/the-session-object/session-initialisation.md @@ -8,15 +8,15 @@ At the end of the initialisation, the function defined by the `.aplf` file (or t ## Implementation -Code to be installed in `⎕SE` is specified in APL source code files contained in *Session initialisation* directories identified by the **DyalogStartupSE** parameter. If this parameter is not specified, the default is a directory named `StartupSession` located in three standard locations as described below. See [DyalogStartupSE](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalogstartupse) for more details. +Code to be installed in `⎕SE` is specified in APL source code files contained in *Session initialisation* directories identified by the **DyalogStartupSE** parameter. If this parameter is not specified, the default is a directory named `StartupSession` located in three standard locations as described below. See [DyalogStartupSE](../../../dyalog-configuration-guide/configuration-parameters/dyalogstartupse) for more details. Only content stored in files matching the wildcard patterns `*.dyalog` and `*.apl?` will be loaded. All such files must be appropriate for `⎕FIX`. For each subdirectory in a Session initialisation directory, a corresponding namespace is created in `⎕SE`. Any source code files in these subdirectories will be fixed in their respective corresponding namespaces, and nested subdirectories become nested namespaces, recursively -Every top-level directory that is loaded as a namespace in `⎕SE` can have a `Run` function which (depending on the value of the **DyalogStartup_X** parameter, will be called after everything has been loaded. This does not apply to sub-namespaces. See [DyalogStartup_X](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalogstartup-x). +Every top-level directory that is loaded as a namespace in `⎕SE` can have a `Run` function which (depending on the value of the **DyalogStartup_X** parameter, will be called after everything has been loaded. This does not apply to sub-namespaces. See [DyalogStartup_X](../../../dyalog-configuration-guide/configuration-parameters/dyalogstartup-x). -This requires Link which is available by default. A custom version of Link can be used. See [DyalogLink](../../../windows-installation-and-configuration-guide/configuration-parameters/dyaloglink). +This requires Link which is available by default. A custom version of Link can be used. See [DyalogLink](../../../dyalog-configuration-guide/configuration-parameters/dyaloglink). The Session initialisation directories are processed in alphabetical order and code defined in each directory will replace code with the same name defined previously. In effect, this means that user-supplied content can replace content supplied by Dyalog Ltd. and version-specific content can replace version-agnostic content. diff --git a/windows-ui-guide/docs/the-session-object/session-object.md b/windows-ui-guide/docs/the-session-object/session-object.md index bbfcd0a5de2..3c2a3b60ac1 100644 --- a/windows-ui-guide/docs/the-session-object/session-object.md +++ b/windows-ui-guide/docs/the-session-object/session-object.md @@ -13,7 +13,7 @@ There is one (and only one) object of type Session and it is called `⎕SE`. You `⎕SE` is loaded from a session file when APL starts. The name of the session file is specified by the **session_file** parameter. If no session file is defined, `⎕SE` will have no children and the session will be devoid of menu bar, tool bar and status bar components. -An additional feature is provided to establish code in the Session; for more information, see the [DyalogStartupSE](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalogstartupse) configuration parameter. +An additional feature is provided to establish code in the Session; for more information, see the [DyalogStartupSE](../../../dyalog-configuration-guide/configuration-parameters/dyalogstartupse) configuration parameter. You may use all of the standard GUI system functions to build or configure the components of the Session to your own requirements. You may also control the Session by changing certain of its properties. From 18f58b5f5ed23bd85c4a2d12e7cd74188530f5f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:22:23 +0100 Subject: [PATCH 04/37] Apply configuration-parameter template to Session log and buffers First Session-category tranche: rework Log_File, Log_File_InUse, Log_Size, History_Size, Input_Size, PFKey_Size, and Session_File to the standard template (Description, Valid values, Default, Related parameters), folding in the Unix and macOS defaults where known. The per-OS Log_File default and the Session_File default are stated explicitly; defaults not present in the migrated source carry a grep-able "REVIEW(default)" marker for accuracy confirmation. Part of abrudz/documentation#27 and Dyalog/documentation#719 (Step Three, applied during migration). --- .../docs/configuration-parameters/history-size.md | 8 ++++++-- .../docs/configuration-parameters/input-size.md | 8 ++++++-- .../configuration-parameters/log-file-inuse.md | 13 +++++++++++-- .../docs/configuration-parameters/log-file.md | 15 +++++++++------ .../docs/configuration-parameters/log-size.md | 8 ++++++-- .../docs/configuration-parameters/pfkey-size.md | 6 +++--- .../docs/configuration-parameters/session-file.md | 8 ++++++-- 7 files changed, 47 insertions(+), 19 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/history-size.md b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md index 0cd49d404f2..4e5b06628c5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/history-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md @@ -1,5 +1,9 @@ # History_Size -This parameter specifies the size of the buffer used to store previously entered (input) lines in the Session. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. The maximum value is 2Gb. +The size of the buffer used to store previously entered (input) lines in the Session. See [Specifying Size-related Parameters](configuration-parameters.md) for how to give a valid size. The maximum is 2 GB. -See also [History size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). + + +Related parameters: [Input_Size](input-size.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/input-size.md b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md index 0bed354c726..a51abe5eeaf 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/input-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md @@ -1,5 +1,9 @@ # Input_Size -This parameter specifies the size of the buffer used to store marked lines (lines awaiting execution) in the Session. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. +The size of the buffer used to store marked lines (lines awaiting execution) in the Session. See [Specifying Size-related Parameters](configuration-parameters.md) for how to give a valid size. -See also [Input buffer size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). + + +Related parameters: [History_Size](history-size.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md index 34b1ade930b..a23e30e67f8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md @@ -1,5 +1,14 @@ # Log_File_InUse -This Boolean parameter specifies whether or not the Session log is saved. The default is 1 meaning that the Session log is saved in a Session log file and loaded the next time a Session is started. If set to 0, the Session log is not saved +Whether the Session log is saved to the [Session log file](log-file.md) and reloaded the next time a Session is started. -See also [Use log file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are: + +- `0` : the Session log is not saved +- `1` : the Session log is saved and reloaded the next time a Session is started + +Default is `1`. + +Related parameters: [Log_File](log-file.md), [Log_Size](log-size.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-file.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md index 88aa7e0ce2b..93c789f7d6e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md @@ -1,13 +1,16 @@ # Log_File -This parameter specifies the path (absolute or relative to the working directory) and name of the Session log file. +The path (absolute, or relative to the working directory) and name of the Session log file. -Session log files are not interchangeable between different versions/editions/widths of Dyalog. In addition, starting multiple instances of a Dyalog interpreter with the same log file name will only create a log file for the first instance started. +Session log files are not interchangeable between different versions, editions, or widths of Dyalog. Starting a second instance of the same interpreter with the same log file name would normally fail to create a log for that instance, so the default name includes a `*` character: at start-up Dyalog replaces the `*` with an increasing integer, beginning at `000`, and opens and locks the first name it can (for example `log*.dlfx` yields `log000.dlfx`, `log001.dlfx`, and so on). Closing an instance frees its number for reuse. The process fails, and no log is used, if the number would exceed `999`. -This is mitigated by including a __\*__ character in the default Session log’s filename, for example, __log.\*.dlfx__ or __log\*.dlfx__. In this situation, at start-up, Dyalog attempts to open, and then lock, a file in which the __\*__ is replaced with an increasing integer value starting from __000__, for example, __log\*.dlfx__ results in files called __log000.dlfx__, __log001.dlfx__, and so on. If a file cannot be opened and locked, the value is incremented. This means that starting multiple instances of the same interpreter simultaneously will create and open multiple log files with different values. If one or more instances are then closed, starting a new instance will re-open the closed log file for that interpreter that has the lowest value. The process fails, and no log will be created or used, if the value would exceed __999__. +The `LogFile` property of `⎕SE` reports the name of the log file in use. -NOTE: The LogFile property of `⎕SE` reports the name of the log file that is being used. +Default depends on operating system: -The default is __\Dyalog APL- Files\default_\*.dlfx__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 20.0 Unicode Files\default_\*.dlfx__ +- Microsoft Windows: `\Dyalog APL- Files\default_*.dlfx`, for example `C:\Users\Bob\Documents\Dyalog APL-64 21.0 Unicode Files\default_*.dlfx` +- UNIX and macOS: `$HOME/.dyalog/session_log__*.dlf`, for example `$HOME/.dyalog/session_log_210U64_*.dlf` -See also [Use log file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Related parameters: [Log_File_InUse](log-file-inuse.md), [Log_Size](log-size.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-size.md b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md index 85921db522c..ed9f67c6bf3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md @@ -1,5 +1,9 @@ # Log_Size -This parameter specifies the size of the Session log buffer. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. The maximum value is 2Gb. +The size of the Session log buffer. See [Specifying Size-related Parameters](configuration-parameters.md) for how to give a valid size. The maximum is 2 GB. -See also [Session log size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). + + +Related parameters: [Log_File](log-file.md), [Log_File_InUse](log-file-inuse.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md index 6bb6b56c0b0..417d0558c67 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md @@ -1,7 +1,7 @@ # PFKey_Size -This parameter specifies the size of the buffer that is used to store programmable function key definitions. See [Program Function Key ](../../../language-reference-guide/system-functions/pfkey). +The size of the buffer used to store programmable function key definitions (see [Program Function Key (`⎕PFKEY`)](../../../language-reference-guide/system-functions/pfkey)). If the buffer is too small, adding a new definition signals a `LIMIT ERROR`. See [Specifying Size-related Parameters](configuration-parameters.md) for how to give a valid size. -For further details about defining a valid value for this parameter, see [Specifying Size-related Parameters](./configuration-parameters.md). + -See also [PFKey buffer size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/session-file.md b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md index 4b9980afbd1..16be3c0aff3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/session-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md @@ -1,5 +1,9 @@ # Session_File -This parameter specifies the name of the file from which the APL session (`⎕SE` ) is to be loaded when APL starts. If not specified, a .dse extension is assumed. This session file contains the `⎕SE` object that was last saved in it. This object defines the appearance and behaviour of the Session menu bar, tool bar(s) and status bar, together with any functions and variables stored in the `⎕SE` namespace. +The name of the file from which the Session (`⎕SE`) is loaded when Dyalog starts. If no extension is given, `.dse` is assumed. The session file holds the `⎕SE` object last saved in it, which defines the appearance and behaviour of the Session menu bar, tool bars, and status bar, together with any functions and variables held in the `⎕SE` namespace. -See also [Session file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Default is `[DYALOG]/default.dse` (the `default.dse` file in the Dyalog installation directory). + + + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. From 41d265fc1bf6eea295b6dbc2e428c6cb920d53e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:28:21 +0100 Subject: [PATCH 05/37] Apply template to workspace-default configuration parameters MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rework Default_DIV, Default_IO, Default_ML, Default_PP, Default_RTL, Default_WX, Default_PW, and Auto_PW to the standard template. Each links its ⎕-system-variable page for the valid values, states the clear-workspace default where the migrated source gives it, and notes the per-OS behaviour of Auto_PW/Default_PW and the UNIX/macOS ⎕SE effect of Default_WX. Defaults absent from the source (⎕PW, ⎕WX) carry a grep-able REVIEW(default) marker. Part of abrudz/documentation#28 and Dyalog/documentation#719. --- .../docs/configuration-parameters/auto-pw.md | 16 ++++++++++++++-- .../docs/configuration-parameters/default-div.md | 8 ++++++-- .../docs/configuration-parameters/default-io.md | 8 ++++++-- .../docs/configuration-parameters/default-ml.md | 8 ++++++-- .../docs/configuration-parameters/default-pp.md | 8 ++++++-- .../docs/configuration-parameters/default-pw.md | 8 +++++++- .../docs/configuration-parameters/default-rtl.md | 8 ++++++-- .../docs/configuration-parameters/default-wx.md | 12 ++++++++++-- 8 files changed, 61 insertions(+), 15 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md index 6824c6d32f0..55fdcf48ada 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md @@ -1,5 +1,17 @@ # Auto_PW -This parameter specifies whether or not the value of `⎕PW` is derived automatically from the current width of the Session Window. If **Auto_PW** is 1, the value of `⎕PW` changes whenever the Session Window is resized and reflects the number of characters that can be displayed on a single line. If **Auto_PW** is 0 (the default under Windows) `⎕PW` is independent of the Session Window size. +Whether the value of [`⎕PW`](../../../language-reference-guide/system-functions/pw) is derived automatically from the current width of the Session (Windows) or terminal (UNIX and macOS) window. -See also [Auto PW](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are: + +- `0` : `⎕PW` is independent of the window width +- `1` : `⎕PW` changes whenever the window is resized, reflecting the number of characters that fit on one line + +Default depends on operating system: + +- Microsoft Windows: `0` +- UNIX and macOS: when unset, behaves as `1` (`⎕PW` tracks the terminal width, updated when the interpreter next checks for input) + +Related parameters: [Default_PW](default-pw.md). + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-div.md b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md index 948b231bfbe..a2159121b1a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-div.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md @@ -1,5 +1,9 @@ # Default_DIV -This parameter specifies the value of `⎕DIV` in a clear workspace. Its default value is 0. +The value of [`⎕DIV`](../../../language-reference-guide/system-functions/div) in a clear workspace. -See also [⎕DIV](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕DIV`: `0` or `1`. + +Default is `0`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-io.md b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md index 0eb06b403a3..a582040bd9d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-io.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md @@ -1,5 +1,9 @@ # Default_IO -This parameter specifies the value of `⎕IO` in a clear workspace. Its default value is 1. +The value of [`⎕IO`](../../../language-reference-guide/system-functions/io) in a clear workspace. -See also [⎕IO](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕IO`: `0` or `1`. + +Default is `1`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md index f2a38867059..2afa614e8f8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md @@ -1,5 +1,9 @@ # Default_ML -This parameter specifies the value of `⎕ML` in a clear workspace. Its default value is 1. +The value of [`⎕ML`](../../../language-reference-guide/system-functions/ml) (migration level) in a clear workspace. -See also [⎕ML](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕ML`: `0`, `1`, `2`, or `3`. + +Default is `1`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md index b3ce576bdf2..6fb84daefc0 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md @@ -1,5 +1,9 @@ # Default_PP -This parameter specifies the value of `⎕PP` in a clear workspace. Its default value is 10. +The value of [`⎕PP`](../../../language-reference-guide/system-functions/pp) (print precision) in a clear workspace. -See also [⎕PP](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕PP`: an integer from `1` to `34`. + +Default is `10`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-pw.md b/dyalog-configuration-guide/docs/configuration-parameters/default-pw.md index 645cc4b7840..b93d3a1a0ef 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-pw.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-pw.md @@ -1,3 +1,9 @@ # Default_PW -This parameter specifies the value of `⎕PW` in a clear workspace. Note that `⎕PW` is a property of the Session and the value of **Default_PW** is overridden when a Session file is loaded. +The value of [`⎕PW`](../../../language-reference-guide/system-functions/pw) in a clear workspace. `⎕PW` is a property of the Session, so this value is overridden when a Session file is loaded, and when [`Auto_PW`](auto-pw.md) causes `⎕PW` to track the width of the Session (Windows) or terminal (UNIX and macOS) window. + +Valid values are those of `⎕PW`: an integer from `42` to `32767`. + + + +Related parameters: [Auto_PW](auto-pw.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md index a32ef693645..74a4b9d3972 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md @@ -1,5 +1,9 @@ # Default_RTL -This parameter specifies the value of `⎕RTL` in a clear workspace. Its default value is 0. +The value of [`⎕RTL`](../../../language-reference-guide/system-functions/rtl) (response time limit) in a clear workspace. -See also [⎕RTL](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕RTL`: `0` or a positive integer. + +Default is `0`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md index a383ed381e3..914fbb30ef8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md @@ -1,5 +1,13 @@ # Default_WX -This parameter specifies the value of `⎕WX` in a clear workspace. This in turn determines whether or not the names of properties, methods and events of GUI objects are exposed. If set (`⎕WX` is 1), you may query/set properties and invoke methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in GUI objects. +The value of [`⎕WX`](../../../language-reference-guide/system-functions/wx) in a clear workspace. This determines whether the names of the properties, methods, and events of GUI objects are exposed: when they are (`⎕WX` is `1`), properties can be queried and set, and methods invoked, as if they were variables and functions, so those names cannot also be used for global variables in GUI objects. -See also [Expose properties of GUI Namespaces](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) and [⎕WX](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are those of `⎕WX`: `0`, `1`, or `3`. + +Default is `3`. + + +!!! Info "Information" + UNIX and macOS versions of Dyalog have no GUI objects, but `⎕SE` is present, so `⎕WX` still affects expressions such as `⎕SE.PropList`. + +See also [Expose properties of GUI Namespaces](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) in the Windows Configuration Dialog. From a68c8ae17cf44850a1a9a1b605b35899990ed31e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:34:48 +0100 Subject: [PATCH 06/37] Apply template to editor configuration parameters Rework the editor-behaviour parameters to the standard template: Confirm_Abort, Confirm_Close, Confirm_Fix, AutoFormat, AutoIndent, TabStops, DockableEditWindows, DoubleClickEdit, WrapSearch, WrapSearchMsgBox, DYALOG_DISCARD_FN_SOURCE, and APLAN_FOR_EDITOR. Each has Valid values and a Default (all present in the source except WrapSearch and WrapSearchMsgBox, which carry a REVIEW(default) marker), with related-parameter cross-links. Part of abrudz/documentation#29 and Dyalog/documentation#719. --- .../configuration-parameters/aplan-for-editor.md | 13 ++++++++----- .../docs/configuration-parameters/autoformat.md | 13 +++++++++++-- .../docs/configuration-parameters/autoindent.md | 13 +++++++++++-- .../docs/configuration-parameters/confirm-abort.md | 11 +++++++++-- .../docs/configuration-parameters/confirm-close.md | 11 +++++++++-- .../docs/configuration-parameters/confirm-fix.md | 11 +++++++++-- .../dockableeditwindows.md | 14 +++++++++++--- .../configuration-parameters/doubleclickedit.md | 11 +++++++++-- .../dyalog-discard-fn-source.md | 11 +++++++++-- .../docs/configuration-parameters/tabstops.md | 10 ++++++++-- .../docs/configuration-parameters/wrapsearch.md | 13 +++++++++++-- .../configuration-parameters/wrapsearchmsgbox.md | 13 +++++++++++-- 12 files changed, 116 insertions(+), 28 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md index 890cb4cb5d7..2efce9f27bc 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-editor.md @@ -1,11 +1,14 @@ # APLAN_FOR_EDITOR -This parameter specifies whether (`1`) or not (`0`, the default) new **Edit** windows containing arrays should open using [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) when possible. +Whether new **Edit** windows containing arrays open using [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) when possible. -When this parameter is `1`, [`⎕PP`](../../../language-reference-guide/system-functions/pp.md) does not apply to numbers shown in the Editor. +Valid values are: -The setting can be toggled with the `]APLAN.Editor` user command. +- `0` : arrays open in the usual display form +- `1` : arrays open using array notation; [`⎕PP`](../../../language-reference-guide/system-functions/pp) does not then apply to numbers shown in the editor -In Ride and the Microsoft Windows IDE, once an **Edit** window is open, its mode can be toggled by clicking the ![](../img/object_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the Editor's toolbar. +Default is `0`. -See also [APLAN_FOR_OUTPUT](aplan-for-output). +The setting can be toggled with the `]APLAN.Editor` user command. In Ride and the Microsoft Windows IDE, an open **Edit** window's mode can be toggled with the ![array notation](../img/object_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the editor's toolbar. + +Related parameters: [APLAN_FOR_OUTPUT](aplan-for-output.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md index 54b18dc38c3..4d9160820d4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md @@ -1,5 +1,14 @@ # AutoFormat -This parameter specifies whether or not you want automatic formatting of Control Structures in functions. The default value is 1 which means that formatting is done automatically for you when a function is opened for editing or converted to text by `⎕CR`, `⎕NR` and `⎕VR`. Automatic formatting first discards all leading spaces in the function body. It then prefixes all lines with a single space except those beginning with a label or a comment symbol (this has the effect of making labels and comments stand out). The third step is to indent Control Structures. The size of the indent depends upon the **TabStops** parameter. To turn off automatic formatting, set **AutoFormat** to 0. +Whether Control Structures are formatted automatically when a function is opened for editing or converted to text by `⎕CR`, `⎕NR`, or `⎕VR`. Automatic formatting discards leading spaces in the function body, prefixes each line with a single space except those beginning with a label or comment symbol (so that labels and comments stand out), and indents Control Structures by the width given in [`TabStops`](tabstops.md). -See also [Autoformat functions](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no automatic formatting +- `1` : Control Structures are formatted automatically + +Default is `1`. + +Related parameters: [TabStops](tabstops.md), [AutoIndent](autoindent.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md index 5527ef428aa..3a2f4e1b370 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md @@ -1,5 +1,14 @@ # AutoIndent -This parameter specifies whether or not you want semi-automatic indenting during editing. The default value is 1. This means that when you enter a new line in a function, it is automatically indented by the same amount as the previous line. This option simplifies the entry of indented Control Structures. +Whether semi-automatic indentation is applied during editing, so that a new line in a function is indented by the same amount as the previous line. This simplifies the entry of indented Control Structures. -See also [Autoindent](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no automatic indentation +- `1` : a new line is indented to match the previous line + +Default is `1`. + +Related parameters: [AutoFormat](autoformat.md), [TabStops](tabstops.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md index 46f6f3b2b16..83866554707 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md @@ -1,5 +1,12 @@ # Confirm_Abort -This parameter specifies whether or not you will be prompted for confirmation when you attempt to abort an edit session after making changes to the object being edited. Its value is either 1 (confirmation is required) or 0. The default is 0. +Whether you are prompted for confirmation when you abort an edit session after making changes to the object being edited. -See also [Confirm edit window close on Abort](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no confirmation +- `1` : confirmation is required + +Default is `0`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md index 5bb817ff660..0b94cf57303 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md @@ -1,5 +1,12 @@ # Confirm_Close -This parameter specifies whether or not you will be prompted for confirmation when you close an edit window after making changes to the object being edited. Its value is either 1 (confirmation is required) or 0. The default is 0. +Whether you are prompted for confirmation when you close an edit window after making changes to the object being edited. -See also [Confirm edit window close on Close](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no confirmation +- `1` : confirmation is required + +Default is `0`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md index 533371d9b23..48751624f90 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md @@ -1,5 +1,12 @@ # Confirm_Fix -This parameter specifies whether or not you will be prompted for confirmation when you attempt to fix an object in the workspace after making changes in the editor. Its value is either 1 (confirmation is required) or 0. The default is 0. +Whether you are prompted for confirmation when you fix an object in the workspace after making changes in the editor. -See also [Confirm edit window close on Edit (and Fix)](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no confirmation +- `1` : confirmation is required + +Default is `0`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md index bde03f528ee..5f79c77fd8d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md @@ -1,6 +1,14 @@ # DockableEditWindows -This parameter specifies whether or not individual edit windows can be undocked from (and docked back into) the (MDI) Editor window. Its default value is 0. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). +Whether individual edit windows can be undocked from (and docked back into) the MDI Editor window. This applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Allow floating edit windows](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : edit windows cannot be undocked +- `1` : edit windows can be undocked and re-docked + +Default is `0`. + +Related parameters: [ClassicMode](classicmode.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md index 7c68792e43b..7720cd0e16c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md @@ -1,5 +1,12 @@ # DoubleClickEdit -This parameter specifies whether or not double-clicking over a name invokes the editor. Its default is 1. If DoubleClickEdit is set to 0, double-clicking selects a word and triple-clicking selects the entire line. +Whether double-clicking over a name invokes the editor. -See also [Double-click to Edit](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : double-clicking selects a word, and triple-clicking selects the entire line +- `1` : double-clicking over a name invokes the editor + +Default is `1`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md index d473cbea0ba..8b37294ee95 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-discard-fn-source.md @@ -1,5 +1,12 @@ # DYALOG_DISCARD_FN_SOURCE -This Boolean parameter specifies whether (1) or not (0) source code is discarded from the workspace when an object is fixed. The default value is 0 which means that source code is retained in the workspace and will subsequently be presented for editing as it had been saved previously. +Whether source code is discarded when a function or operator is fixed by the editor or by `⎕FIX`. -For further information, see [Discard Source Information](../../../language-reference-guide/primitive-operators/i-beam/discard-source-information) and [Source as Typed](../../../earlier-release-notes/release-notes-v19-0/introduction/source-as-typed). +Valid values are: + +- `0` : source code is retained in the workspace, and is presented for editing as it was previously saved +- `1` : source code is discarded when an object is fixed (source code already retained in the workspace is not deleted) + +Default is `0`. + +For more information, see [Discard Source Information](../../../language-reference-guide/primitive-operators/i-beam/discard-source-information) and [Source as Typed](../../../earlier-release-notes/release-notes-v19-0/introduction/source-as-typed). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md index 7a825d8c0ff..e5163bb33d0 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md @@ -1,5 +1,11 @@ # TabStops -This parameter specifies the number of spaces inserted by pressing the Tab key in the editor. Its default value is 4. +The number of spaces inserted by pressing the Tab key in the editor. This width is also used to indent Control Structures when [`AutoFormat`](autoformat.md) is enabled. -See also [Tab stops every ](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) +Valid values are a positive integer number of spaces. + +Default is `4`. + +Related parameters: [AutoFormat](autoformat.md), [AutoIndent](autoindent.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md index 41210511d32..0279a806a42 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md @@ -1,5 +1,14 @@ # WrapSearch -This parameter specifies whether or not Search/Replace in the Editor stops at the bottom or top of the text (depending upon the direction of the search), or continues the search from the start or end as appropriate. +Whether Search/Replace in the editor stops at the top or bottom of the text (according to the direction of the search), or continues from the other end. -See also: [Allow search to wrap](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : the search stops at the top or bottom of the text +- `1` : the search continues from the start or end as appropriate + + + +Related parameters: [WrapSearchMsgBox](wrapsearchmsgbox.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md index 710c82111e2..d8f2cae5c11 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md @@ -1,5 +1,14 @@ # WrapSearchMsgBox -Specifies whether or not a message box is displayed to inform the user when the search wraps. +Whether a message box is displayed to inform you when a [wrapped search](wrapsearch.md) passes the start or end of the text. -See also [Show message box if text wraps](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no message box is displayed +- `1` : a message box is displayed when the search wraps + + + +Related parameters: [WrapSearch](wrapsearch.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. From d9e4e417c5f50006b3a826bcdcddfe85fc5bf867 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:40:02 +0100 Subject: [PATCH 07/37] Apply template to tracer configuration parameters Rework the tracer parameters to the standard template: Trace_On_Error, Trace_Level_Warn, SingleTrace, SkipLines, SessionOnTop, AddClassHeaders, and the Trace window geometry (Trace_First_X/Y, Trace_Offset_X/Y). Trace_On_Error carries a genuine per-OS default (Windows 0, UNIX/macOS 1); SkipLines documents its 1/2/4 bitmask; ClassicMode/SingleTrace conditions are noted with cross-links. Defaults absent from the source carry a REVIEW(default) marker. Part of abrudz/documentation#30 and Dyalog/documentation#719. --- .../configuration-parameters/addclassheaders.md | 11 +++++++++-- .../configuration-parameters/sessionontop.md | 14 +++++++++++--- .../docs/configuration-parameters/singletrace.md | 14 +++++++++++--- .../docs/configuration-parameters/skiplines.md | 15 ++++++++++----- .../configuration-parameters/trace-first-x.md | 10 ++++++++-- .../configuration-parameters/trace-first-y.md | 10 ++++++++-- .../configuration-parameters/trace-level-warn.md | 10 ++++++++-- .../configuration-parameters/trace-offset-x.md | 10 ++++++++-- .../configuration-parameters/trace-offset-y.md | 10 ++++++++-- .../configuration-parameters/trace-on-error.md | 16 ++++++++++++++-- 10 files changed, 95 insertions(+), 25 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md index 7c46f6126bc..d13cf673e8c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md @@ -1,5 +1,12 @@ # AddClassHeaders -This parameter specifies what the Tracer displays when tracing the execution of a function in a script. If set to 1, the Tracer displays just the first line of the script and the function in question. If set to 0, the entire script is shown in the Tracer window. +What the Tracer displays when tracing the execution of a function defined in a script. -See also [Limit tracer display to current function in script](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) +Valid values are: + +- `0` : the entire script is shown in the Trace window +- `1` : only the first line of the script and the function being traced are shown + + + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md index c996a14cc7d..8bf223a4346 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md @@ -1,6 +1,14 @@ # SessionOnTop -Specifies whether or not the Session may appear on top of Edit and Trace Windows in Classic Dyalog mode. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). +Whether the Session can appear on top of Edit and Trace windows in Classic Dyalog mode. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Allow session above edit windows](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : the Session cannot appear on top of Edit and Trace windows +- `1` : the Session can appear on top of Edit and Trace windows + + + +Related parameters: [ClassicMode](classicmode.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md index 2e091f5bbb3..5e1d24a305b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md @@ -1,6 +1,14 @@ # SingleTrace -Specifies whether there is a single Trace window, or one Trace window per function. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). +Whether there is a single Trace window or one Trace window per function. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Single trace window](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : one Trace window per function +- `1` : a single Trace window + + + +Related parameters: [ClassicMode](classicmode.md), [Trace_Level_Warn](trace-level-warn.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md index 9d23708fe73..8a9b7a9ac7c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md @@ -1,8 +1,13 @@ # SkipLines -This parameter causes the Tracer to automatically skip lines that contain no executable statement, with the exception of the first line in the function, and in the case of a traditional function (not a dfn), the last line if it is a comment. SkipLines is an integer made up of the sum of the following values: +Causes the Tracer to skip lines that contain no executable statement, with the exception of the first line of the function and, in a traditional function (not a dfn), the last line if it is a comment. -|---|----------------------------------------------------------------------------------------------------------------------------------------------------| -|1 |Skip blank lines. See also [Skip blank lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | -|2 |Skip comment lines. See also [Skip comment lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) .| -|4 |Skip locals lines. See also [Skip locals lines when tracing](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) . | +The value is the sum of the following: + +- `1` : skip blank lines +- `2` : skip comment lines +- `4` : skip locals lines + + + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md index efc4cae56d0..aa91cc8f67b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md @@ -1,5 +1,11 @@ # Trace_First_X -This parameters specifies the initial horizontal position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. +The initial horizontal position, in character units, of the first Trace window; subsequent Trace windows are staggered from it. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Trace_First_Y](trace-first-y.md), [Trace_Offset_X](trace-offset-x.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md index 873079c3c81..91b6853c505 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md @@ -1,5 +1,11 @@ # Trace_First_Y -This parameters specifies the initial vertical position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. +The initial vertical position, in character units, of the first Trace window; subsequent Trace windows are staggered from it. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Trace_First_X](trace-first-x.md), [Trace_Offset_Y](trace-offset-y.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md index fa0e3fd8745..8322d9a5e3e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md @@ -1,5 +1,11 @@ # Trace_Level_Warn -This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +The maximum number of Trace windows displayed when an error occurs and [`Trace_On_Error`](trace-on-error.md) is `1`. If the state indicator holds more functions than this, a warning message box is displayed instead of the stack of Trace windows, avoiding a lengthy delay. This parameter is ignored when the Tracer is invoked explicitly, and applies only when [`ClassicMode`](classicmode.md) is `1` and [`SingleTrace`](singletrace.md) is `0`. -See also [Warn if trace stack bigger than](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are a positive integer. + +Default is `16`. + +Related parameters: [Trace_On_Error](trace-on-error.md), [SingleTrace](singletrace.md), [ClassicMode](classicmode.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md index 2c43d4587b6..9fced440af8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md @@ -1,5 +1,11 @@ # Trace_Offset_X -This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +The number of characters by which a Trace window is staggered horizontally from the previous one. Applies only when [`ClassicMode`](classicmode.md) is `1` and [`SingleTrace`](singletrace.md) is `0`. -See also [X Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Trace_Offset_Y](trace-offset-y.md), [Trace_First_X](trace-first-x.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md index 880e5a2491d..2dab5106fb1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md @@ -1,5 +1,11 @@ # Trace_Offset_Y -This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +The number of characters by which a Trace window is staggered vertically from the previous one. Applies only when [`ClassicMode`](classicmode.md) is `1` and [`SingleTrace`](singletrace.md) is `0`. -See also [Y Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Trace_Offset_X](trace-offset-x.md), [Trace_First_Y](trace-first-y.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md index 70019937a9b..c3783f1d3bc 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md @@ -1,5 +1,17 @@ # Trace_On_Error -This parameter is either 0 (the default) or 1. If set to 1, **Trace_On_Error** specifies that the Tracer is automatically deployed when execution of a defined function halts with an error. A stack of Trace windows is immediately displayed, with the top Trace window receiving the input focus. +Whether the Tracer is deployed automatically when execution of a defined function halts with an untrapped error. When enabled, a stack of Trace windows is displayed immediately, with the top window receiving the input focus. -See also [Show trace stack on error](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : the Tracer is not deployed automatically +- `1` : the Tracer is deployed automatically on an untrapped error + +Default depends on operating system: + +- Microsoft Windows: `0` +- UNIX and macOS: `1` + +Related parameters: [Trace_Level_Warn](trace-level-warn.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. From 3061b33b0d4805a86c86d08c35da408d7d75803d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:52:01 +0100 Subject: [PATCH 08/37] Apply template to edit and SM window geometry parameters MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Rework the edit-window and stand-alone ⎕SM window geometry parameters to the standard template: Edit_Cols, Edit_Rows, Edit_First_X/Y, Edit_Offset_X/Y, SM_Cols, and SM_Rows. All take an integer number of character units; the ClassicMode condition on the edit-window positions is noted, and SM_Cols/SM_Rows link ⎕SM. Defaults are not in the source and carry a REVIEW(default) marker. Part of abrudz/documentation#29 and Dyalog/documentation#719. --- .../docs/configuration-parameters/edit-cols.md | 10 ++++++++-- .../docs/configuration-parameters/edit-first-x.md | 10 ++++++++-- .../docs/configuration-parameters/edit-first-y.md | 10 ++++++++-- .../docs/configuration-parameters/edit-offset-x.md | 10 ++++++++-- .../docs/configuration-parameters/edit-offset-y.md | 10 ++++++++-- .../docs/configuration-parameters/edit-rows.md | 10 ++++++++-- .../docs/configuration-parameters/sm-cols.md | 8 +++++++- .../docs/configuration-parameters/sm-rows.md | 8 +++++++- 8 files changed, 62 insertions(+), 14 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md index 8037a2f281e..cb8eac32d31 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md @@ -1,5 +1,11 @@ # Edit_Cols -This parameter specifies the initial width of an edit window in character units. +The initial width of an edit window, in character units. -See also [Width](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are a positive integer number of character units. + + + +Related parameters: [Edit_Rows](edit-rows.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md index f6ebe346142..43897e23139 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md @@ -1,5 +1,11 @@ # Edit_First_X -This parameters specify the initial x-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. +The initial horizontal position, in character units, of the first edit window; subsequent edit windows are staggered from it. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [X Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Edit_First_Y](edit-first-y.md), [Edit_Offset_X](edit-offset-x.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md index cd70cd89c7c..8afa8d8392b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md @@ -1,5 +1,11 @@ # Edit_First_Y -This parameters specify the initial y-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. +The initial vertical position, in character units, of the first edit window; subsequent edit windows are staggered from it. Applies only when [`ClassicMode`](classicmode.md) is `1`. -See also [Y Pos](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Edit_First_X](edit-first-x.md), [Edit_Offset_Y](edit-offset-y.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md index 4a4f8f30c6c..6fb0358cd73 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md @@ -1,5 +1,11 @@ # Edit_Offset_X -This parameter specify the number of characters by which an edit window is staggered horizontally from the previous one. +The number of characters by which an edit window is staggered horizontally from the previous one. -See also [X Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Edit_Offset_Y](edit-offset-y.md), [Edit_First_X](edit-first-x.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md index 4f2f1888f47..f6a7f9db5f6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md @@ -1,5 +1,11 @@ # Edit_Offset_Y -This parameter specify the number of characters by which an edit window is staggered vertically from the previous one. +The number of characters by which an edit window is staggered vertically from the previous one. -See also [Y Offset](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are an integer number of character units. + + + +Related parameters: [Edit_Offset_X](edit-offset-x.md), [Edit_First_Y](edit-first-y.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md index d170dff910e..87d9668a05e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md @@ -1,5 +1,11 @@ # Edit_Rows -This parameter specifies the initial height of an edit window in character units. +The initial height of an edit window, in character units. -See also [Height](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). +Valid values are a positive integer number of character units. + + + +Related parameters: [Edit_Cols](edit-cols.md). + +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md b/dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md index c0f5b424209..928fd671889 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/sm-cols.md @@ -1,3 +1,9 @@ # SM_Cols -This parameter specifies the width in characters of the window used to display `⎕SM` when it is used *stand-alone* . It is **not** used if the window is specified using the SM object. +The width, in characters, of the window used to display [`⎕SM`](../../../language-reference-guide/system-functions/sm) when it is used stand-alone. It is not used when the window is specified through the SM object. + +Valid values are a positive integer number of characters. + + + +Related parameters: [SM_Rows](sm-rows.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md b/dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md index 65e6a99f39a..b12f12bfc69 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/sm-rows.md @@ -1,3 +1,9 @@ # SM_Rows -This parameter specifies the height in characters of the window used to display `⎕SM` when it is used *stand-alone* . It is **not** used if the window is specified using the SM object. +The height, in characters, of the window used to display [`⎕SM`](../../../language-reference-guide/system-functions/sm) when it is used stand-alone. It is not used when the window is specified through the SM object. + +Valid values are a positive integer number of characters. + + + +Related parameters: [SM_Cols](sm-cols.md). From 01e4c48533ee20b6bc9ba8aede5626c642f40590 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:56:06 +0100 Subject: [PATCH 09/37] Apply template to session-appearance configuration parameters Rework APLAN_FOR_OUTPUT, DYALOG_GUTTER_ENABLE, Confirm_Session_Delete, URLHighlight, StatusOnEdit, ToolBarsOnEdit, AutoDPI, Dyalog_Pixel_Type, ClassicMode, and ClassicModeSavePosition to the standard template. AutoDPI and Dyalog_Pixel_Type carry a Microsoft Windows-only restriction admonition; DYALOG_GUTTER_ENABLE notes its interface- dependent default (0 for TTY, 1 otherwise). Defaults absent from the source carry a REVIEW(default) marker. Part of abrudz/documentation#27 and Dyalog/documentation#719. --- .../configuration-parameters/aplan-for-output.md | 13 ++++++++----- .../docs/configuration-parameters/autodpi.md | 14 +++++++++++++- .../docs/configuration-parameters/classicmode.md | 11 ++++++++--- .../classicmodesaveposition.md | 14 ++++++++++---- .../confirm-session-delete.md | 11 +++++++++-- .../dyalog-gutter-enable.md | 13 +++++++++---- .../dyalog-pixel-type.md | 14 ++++++++++++-- .../configuration-parameters/statusonedit.md | 13 +++++++++++-- .../configuration-parameters/toolbarsonedit.md | 13 +++++++++++-- .../configuration-parameters/urlhighlight.md | 16 ++++++---------- 10 files changed, 97 insertions(+), 35 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md index 9e61b9d9cd2..ab40aeed87c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplan-for-output.md @@ -1,11 +1,14 @@ # APLAN_FOR_OUTPUT -This parameter specifies whether (`1`) or not (`0`, the default) to use [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) for session output when possible. +Whether Session output uses [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) when possible. -When this parameter is `1`, [`⎕PP`](../../../language-reference-guide/system-functions/pp.md) does not apply to numeric session output. +Valid values are: -The setting can be toggled with the `]APLAN.Output` user command +- `0` : Session output uses the usual display form +- `1` : Session output uses array notation; [`⎕PP`](../../../language-reference-guide/system-functions/pp) does not then apply to numeric Session output -In the Microsoft Windows IDE, the setting can also be toggled by clicking the ![](../img/session_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the session toolbar. +Default is `0`. -See also [APLAN_FOR_EDITOR](aplan-for-editor). +The setting can be toggled with the `]APLAN.Output` user command. In the Microsoft Windows IDE it can also be toggled with the ![array notation](../img/session_arraynotation.png){width=20 height=20 vertical-align:text-bottom} icon in the Session toolbar. + +Related parameters: [APLAN_FOR_EDITOR](aplan-for-editor.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md index 3c6a2622161..da8a2637e5d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md @@ -1,3 +1,15 @@ # AutoDPI -This parameter determines whether or not the Dyalog program registers the application as DPI-Aware when it initialises. If 1, (the default), Dyalog performs the auto-scaling; if 0, scaling is the responsibility of the programmer or operating system. See also [Enable DPI Scaling of the interpreter and development environment](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +Whether Dyalog registers the application as DPI-aware when it initialises, and so performs auto-scaling itself. + +Valid values are: + +- `0` : scaling is the responsibility of the programmer or the operating system +- `1` : Dyalog performs the auto-scaling + +Default is `1`. + +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md index 63c2b16cf76..2b5fa2cab05 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md @@ -1,7 +1,12 @@ # ClassicMode -This parameter specifies whether or not the Session operates in *Dyalog Classic mode* . The default is 0. If this parameter is set to 1, the Editor and Tracer behave in a manner that is consistent with earlier versions of Dyalog APL. +Whether the Session operates in *Dyalog Classic mode*, in which the Editor and Tracer behave as they did in earlier versions of Dyalog. In this mode a maximum of 50 Trace windows can be displayed. -Note that in this mode, a maximum of 50 Trace windows may be displayed. +Valid values are: -See also [Classic Dyalog mode](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +- `0` : the Session uses the modern Editor and Tracer +- `1` : the Session operates in Classic mode + +Default is `0`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md index 40b9cad5431..81fcd42df92 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md @@ -1,8 +1,14 @@ # ClassicModeSavePosition -This parameter specifies whether or not the current size and location of the first of the editor and tracer windows are remembered for next time. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). +Whether the current size and location of the first editor and tracer windows are remembered for next time (saved in the Registry sub-folders `WindowRects/EditWindow` and `WindowRects/TraceWindow`). Applies only when [`ClassicMode`](classicmode.md) is `1`. -The size and location of the windows are saved in the registry in the subfolder WindowRects/EditWindow and TraceWindow. +Valid values are: -See also [Remember previous window position](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +- `0` : window size and position are not remembered +- `1` : window size and position are remembered + + + +Related parameters: [ClassicMode](classicmode.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md index 75b6b85d1e3..a2e560bca86 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md @@ -1,5 +1,12 @@ # Confirm_Session_Delete -This parameter specifies whether or not you will be prompted for confirmation when you attempt to delete lines from the Session Log. Its value is either 1 (confirmation is required) or 0. The default is 1. +Whether you are prompted for confirmation when you delete lines from the Session log. -See also [Confirm on Deletion from Session log](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). +Valid values are: + +- `0` : no confirmation +- `1` : confirmation is required + +Default is `1`. + +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md index a262b85f90b..46d6ae874f6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-gutter-enable.md @@ -1,8 +1,13 @@ # DYALOG_GUTTER_ENABLE -This Boolean parameter specifies whether (1) or not (0) a Gutter is displayed in the left-most column of the Session window. This gutter is used to display: +Whether a gutter is displayed in the left-most column of the Session window. The gutter shows: -- A small red circle. This indicator is used on every line that is modified in the session, including old ones (for example, if you move up the session and modify them, without pressing ``) . The indicators show which session lines will be re-executed when you subsequently press ``. -- A left bracket `[` to identify groups of [implicit output](../../../programming-reference-guide/introduction/output). Note that other forms of output are not identified in this way. +- a small red circle on every line that has been modified in the Session (including older lines moved to and edited without pressing ``), indicating which lines will be re-executed when `` is next pressed; +- a left bracket `[` identifying groups of [implicit output](../../../programming-reference-guide/introduction/output). Other forms of output are not marked in this way. -The default value is 0 for the TTY interface, and 1 otherwise. +Valid values are: + +- `0` : no gutter is displayed +- `1` : the gutter is displayed + +Default depends on the interface: `0` for the TTY interface, `1` otherwise. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md index f6e1fff6eab..96609621267 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md @@ -1,5 +1,15 @@ # Dyalog_Pixel_Type -When the Coord property is set to `'Pixel'` , this parameter specifies how it is interpreted. If the value of **Dyalog_Pixel_Type** is RealPixel or if Dyalog_Pixel_Type is undefined, the object behaves as if Coord was `'RealPixel'` . If the value of **Dyalog_Pixel_Type** is ScaledPixel, the object behaves as if Coord were `'ScaledPixel'`. See [Coord](../../../object-reference/properties/coord). +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. -See also [Enable DPI scaling of GUI application](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +How the value `'Pixel'` of the [`Coord`](../../../object-reference/properties/coord) property is interpreted. + +Valid values are: + +- `RealPixel` : the object behaves as if `Coord` were `'RealPixel'` (also the behaviour when the parameter is undefined) +- `ScaledPixel` : the object behaves as if `Coord` were `'ScaledPixel'` + +Default is `RealPixel`. + +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md index 9e95478cf37..de6db9ec021 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md @@ -1,5 +1,14 @@ # StatusOnEdit -Specifies whether or not a status bar is displayed at the bottom of an Edit window. +Whether a status bar is displayed along the bottom of individual Edit windows. -See also [Show status bars](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no status bar is displayed +- `1` : a status bar is displayed + + + +Related parameters: [ToolBarsOnEdit](toolbarsonedit.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md index 8f6057e2e46..c20fe0097f7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md @@ -1,5 +1,14 @@ # ToolBarsOnEdit -Specifies whether or not tool bars are displayed along the top of individual Edit windows. +Whether tool bars are displayed along the top of individual Edit windows. -See also [Show tool bars](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +Valid values are: + +- `0` : no tool bars are displayed +- `1` : tool bars are displayed + + + +Related parameters: [StatusOnEdit](statusonedit.md). + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md index 8f5b09e7fd9..e40b45675c2 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md @@ -1,16 +1,12 @@ # URLHighlight -Specifies whether or not URLs and links are highlighted in Session and Edit windows. Its value is either 1 (highlight) or 0. The default is 0. +Whether URLs and links are highlighted in Session and Edit windows. When enabled, a valid URL under the mouse pointer is underscored, the relevant Session pop-up menu items (open the link, copy it to the clipboard) are activated, and the link can be opened with Ctrl+Click. A URL is recognised as a string beginning with `http://`, `https://`, `www.`, or `mailto:`. -If this option is selected, valid URLs are identified when the cursor is in the Session or in an Edit or Trace window. When the mouse pointer is over a URL, the URL is underscored and the appropriate items in the Session Popup menu are activated. These allow you to open the link or copy it to the clipboard. +Valid values are: -You may also open a URL using Ctrl+Click (Left Mouse button). +- `0` : URLs and links are not highlighted +- `1` : URLs and links are highlighted -Currently a URL string is defined to be a string starting with any of the following strings: +Default is `0`. -- http:// -- https:// -- www. -- mailto: - -See also [Underline URLs and links](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. From 17c444f8f83f6211546373ec93205b265023e1d9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 03:18:40 +0100 Subject: [PATCH 10/37] Apply template to keyboard and input configuration parameters Rework the keyboard/input parameters to the standard template: APLK, APLKeys, APLT, APLTrans, InitialKeyboardLayout(+InUse/ShowAll), OverstrikesPopup, ResolveOverstrikes, UseXCV, UnicodeToClipboard, KeyboardInputDelay, WantsSpecialKeys, and mapchars. Each carries the relevant restriction admonition (Classic edition, Unicode edition, or Microsoft Windows). Defaults are stated where the source gives them (APLKeys/APLTrans install sub-directories, APLT WIN.DOT on Windows, UnicodeToClipboard 0) and flagged otherwise. Part of abrudz/documentation#719. --- .../docs/configuration-parameters/aplk.md | 13 ++++++++--- .../docs/configuration-parameters/aplkeys.md | 13 ++++++++--- .../docs/configuration-parameters/aplt.md | 14 ++++++++++-- .../docs/configuration-parameters/apltrans.md | 13 +++++++++-- .../initialkeyboardlayout.md | 13 ++++++++--- .../initialkeyboardlayoutinuse.md | 16 +++++++++++--- .../initialkeyboardlayoutshowall.md | 16 +++++++++++--- .../keyboardinputdelay.md | 7 +++--- .../docs/configuration-parameters/mapchars.md | 22 ++++++++++--------- .../overstrikespopup.md | 16 ++++++++++++-- .../resolveoverstrikes.md | 16 ++++++++++++-- .../unicodetoclipboard.md | 14 +++++++++--- .../docs/configuration-parameters/usexcv.md | 14 +++++++----- .../wantsspecialkeys.md | 9 ++++++-- 14 files changed, 149 insertions(+), 47 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplk.md b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md index fc980994c47..0ffafe9ff9f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplk.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md @@ -1,7 +1,14 @@ # APLK -**Classic Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -This parameter specifies the name of your Input Translate Table, which defines your keyboard layout. The keyboard combo in the *Configure* dialog box displays all the files with the .DIN extension in the directory specified by the **APLKEYS** parameter. You may choose any one of the supplied tables, and you may add your own to the directory. Note that the FILE.DIN table is intended for input from **file** , and should not normally be chosen as a keyboard table. +The name of the Input Translate Table, which defines the keyboard layout. The keyboard list in the Configuration dialog shows every `.DIN` file in the directory given by [`APLKeys`](aplkeys.md); any of the supplied tables can be chosen, and you can add your own. The `FILE.DIN` table is intended for input from file and should not normally be chosen as a keyboard table. -See also [Input table file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). +Valid values are the name of a `.DIN` input translate table. + + + +Related parameters: [APLKeys](aplkeys.md). + +See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md index ed666a2084a..5b052d0207f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md @@ -1,7 +1,14 @@ # APLKeys -**Classic Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -This parameter specifies a search path for the Input Translate Table and is useful for configuring a run-time application. The directory paths are specified using Operating System specific conventions and separated by ";" (Windows) or ":" (UNIX). Its default value is the `aplkeys` sub-directory of the directory in which Dyalog APL/W is installed (defined by **Dyalog** ). +A search path for the Input Translate Table, useful when configuring a run-time application. Directory paths use the operating system's conventions and are separated by `;` (Windows) or `:` (UNIX and macOS). -See also [Input table search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md). +Valid values are a list of directory paths. + +Default is the `aplkeys` sub-directory of the Dyalog installation directory (given by [`Dyalog`](dyalog.md)). + +Related parameters: [APLK](aplk.md), [Dyalog](dyalog.md). + +See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplt.md b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md index b5ca426d66e..5e351b7c9b0 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplt.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md @@ -1,5 +1,15 @@ # APLT -This parameter specifies the name of the Output Translate Table. On Windows the default is WIN.DOT and there is rarely a need to alter it. +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -See also [Output table file](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). +The name of the Output Translate Table. + +Valid values are the name of an output translate table. + +Default is `WIN.DOT` on Microsoft Windows, where there is rarely a need to alter it. + + +Related parameters: [APLTrans](apltrans.md). + +See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md index a9243e26d46..1862dcbaebd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md @@ -1,5 +1,14 @@ # APLTrans -This parameter specifies a search path for the Output Translate Table and is useful for configuring a run-time application. The directory paths are specified using Operating System specific conventions and separated by ";" (Windows) or ":" (UNIX). Its default value is the sub-directory `apltrans` in the directory in which Dyalog APL/W is installed. +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -See also [Output table search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md). +A search path for the Output Translate Table, useful when configuring a run-time application. Directory paths use the operating system's conventions and are separated by `;` (Windows) or `:` (UNIX and macOS). + +Valid values are a list of directory paths. + +Default is the `apltrans` sub-directory of the Dyalog installation directory (given by [`Dyalog`](dyalog.md)). + +Related parameters: [APLT](aplt.md), [Dyalog](dyalog.md). + +See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md index 4bcd10a3a4f..4e479c8f33c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md @@ -1,7 +1,14 @@ # InitialKeyboardLayout -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -This parameter specifies the name of the keyboard to be selected on startup. When you start an APL session, this layout will automatically be selected as the current keyboard layout if the value of **InitialKeyboardLayoutInUse** is 1. +The name of the keyboard to be selected on start-up. When an APL Session starts, this layout becomes the current keyboard layout if [`InitialKeyboardLayoutInUse`](initialkeyboardlayoutinuse.md) is `1`. -See also [Keyboard](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +Valid values are the name of an installed keyboard layout. + + + +Related parameters: [InitialKeyboardLayoutInUse](initialkeyboardlayoutinuse.md), [InitialKeyboardLayoutShowAll](initialkeyboardlayoutshowall.md). + +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md index fe3aba6c4c0..603886558b1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md @@ -1,7 +1,17 @@ # InitialKeyboardLayoutInUse -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -This Boolean parameter specifies whether or not the keyboard specified by **InitialKeyboardLayout** is selected as the current keyboard layout when you start an APL session. +Whether the keyboard given by [`InitialKeyboardLayout`](initialkeyboardlayout.md) is selected as the current keyboard layout when an APL Session starts. -See also [Activate selected keyboard](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +Valid values are: + +- `0` : the initial keyboard layout is not selected automatically +- `1` : the initial keyboard layout is selected on start-up + + + +Related parameters: [InitialKeyboardLayout](initialkeyboardlayout.md). + +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md index 3d0b475cf3b..4d321e92c93 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md @@ -1,7 +1,17 @@ # InitialKeyboardLayoutShowAll -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -This Boolean parameter specifies whether or not all installed keyboards are listed in the choice of keyboards in the Configuration dialog box (Unicode Input tab). +Whether all installed keyboards are listed in the choice of keyboards on the Unicode Input tab of the Configuration dialog. -See also [Show keyboards for all Languages](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md). +Valid values are: + +- `0` : only Dyalog keyboards are listed +- `1` : all installed keyboards are listed + + + +Related parameters: [InitialKeyboardLayout](initialkeyboardlayout.md). + +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md index 5052974a9cf..90bab6f6809 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md @@ -1,6 +1,7 @@ # KeyboardInputDelay -This parameter specifies the delay (in milliseconds) before the system reacts to a user keystroke by: +The delay, in milliseconds, before the system reacts to a keystroke by updating the name of the Current Object in the Session status bar (see [The Current Object](../../../windows-ui-guide/session-manager)) and offering a list of names for auto-completion (see the [Auto Complete tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md)). -- updating the name of the Current Object in the Session statusbar. See [The Current Object](../../../windows-ui-guide/session-manager). -- offering a list of names for auto-completion. See [ Auto Complete Tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) +Valid values are a number of milliseconds. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/mapchars.md b/dyalog-configuration-guide/docs/configuration-parameters/mapchars.md index 734ba80d3e6..f73c8bbc5dd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/mapchars.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/mapchars.md @@ -1,17 +1,19 @@ # mapchars -**Classic Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -In previous versions of Dyalog APL, certain pairs of characters in `⎕AV` were mapped to a single font glyph through the output translate table. For example, the ASCII pipe ¦ and the APL style `|` were both mapped to the APL style `|` . From Version 7.0 onwards, it has been a requirement that the mapping between `⎕AV` and the font is strictly one-to-one (this is a consequence of the new native file system). Originally, the mapping of the ASCII pipe and the APL style, the APL and ASCII quotes, and the ASCII ^ and the APL ^ were hard-coded. The mapping is defined by the **mapchars** parameter. +The mapping between `⎕AV` and the font must be strictly one-to-one. Historically a few pairs of `⎕AV` characters were mapped to a single font glyph (for example the ASCII pipe `¦` and the APL style `|`); **mapchars** defines any such mappings. -**mapchars** is a string containing pairs of hexadecimal values which refer to 0-origin indices in `⎕AV` . The first character in each pair is mapped to the second on output. The default value of **mapchars** is `DB0DEBA7EEC00BE0` which defines the following mappings. +**mapchars** is a string of pairs of hexadecimal values, each an origin-`0` index into `⎕AV`. The first character of each pair is mapped to the second on output. -|From|||To||| +The default is `DB0DEBA7EEC00BE0`, which defines the following mappings: + +| From (hex) | From (decimal) | From | To (hex) | To (decimal) | To | |---|---|---|---|---|---| -|Hex|Decimal|Symbol|Hex|Decimal|Symbol| -|DB|219|`‘`|0D|13|`'`| -|EB|235|`^`|A7|167|`^`| -|EE|238|`⌷`|C0|192|`|`| -|0B|11|`.`|E0|224|`.`| +| DB | 219 | `‘` | 0D | 13 | `'` | +| EB | 235 | `^` | A7 | 167 | `^` | +| EE | 238 | `⌷` | C0 | 192 | `\|` | +| 0B | 11 | `.` | E0 | 224 | `.` | -To clear all mappings, set `MAPCHARS=0000` . +To clear all mappings, set `mapchars=0000`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md b/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md index 0a961df732e..ac1d127922f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md @@ -1,5 +1,17 @@ # OverstrikesPopup -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -This is a Boolean parameter that specifies whether or not the Overstrikes popup is enabled. +Whether the Overstrikes popup is enabled. + +Valid values are: + +- `0` : the Overstrikes popup is disabled +- `1` : the Overstrikes popup is enabled + + + +Related parameters: [ResolveOverstrikes](resolveoverstrikes.md). + +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md b/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md index 35701094537..2e11dac35ce 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md @@ -1,5 +1,17 @@ # ResolveOverstrikes -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -Specifies whether or not the user may enter an APL composite symbol using overstrikes. +Whether an APL composite symbol can be entered using overstrikes. + +Valid values are: + +- `0` : overstrikes are disabled +- `1` : overstrikes are enabled + + + +Related parameters: [OverstrikesPopup](overstrikespopup.md). + +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md index 8b051fc85f0..3873f0ae96d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md @@ -1,7 +1,15 @@ # UnicodeToClipboard -**Classic Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog. -This parameter specifies whether or not text that is transferred to and from the Windows clipboard is treated as Unicode text. If **UnicodeToClipboard** is 0 (the default), the symbols in `⎕AV` are mapped to ASCII text (0-255). In particular, the APL symbols are mapped to ASCII symbols according to their positions in the Dyalog APL font. If **UnicodeToClipboard** is 1, the symbols in `⎕AV` are mapped to Unicode text and the APL symbols are mapped to their genuine Unicode equivalent values. +Whether text transferred to and from the Windows clipboard is treated as Unicode text. -See also [Paste text as Unicode(Classic Edition only)](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) +Valid values are: + +- `0` : the symbols in `⎕AV` are mapped to ASCII text (0-255); APL symbols are mapped to ASCII symbols by their position in the Dyalog APL font +- `1` : the symbols in `⎕AV` are mapped to Unicode text; APL symbols are mapped to their genuine Unicode equivalents + +Default is `0`. + +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/usexcv.md b/dyalog-configuration-guide/docs/configuration-parameters/usexcv.md index ce3811cdcff..1de8812c686 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/usexcv.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/usexcv.md @@ -1,13 +1,15 @@ # UseXCV -This Boolean parameter specifies how the commonly used keystrokes for copy (ctrl+c), cut Ctrl+x) and paste (ctrl+v) are processed. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. It is defined for the Unicode IME in the Registry section `HKEY_CURRENT_USER\Software\Dyalog\UnicodeIME\`. -0 = process normally (via the appropriate .DIN file)1 = pass untranslated to the host application +How the common copy (Ctrl+C), cut (Ctrl+X), and paste (Ctrl+V) keystrokes are processed. -The **UseXCV** parameter is defined for the IME in the Registry section `HKEY_CURRENT_USER\Software\Dyalog\UnicodeIME\` +Valid values are: -When **UseXCV** is 1, the keystrokes Ctrl+X, Ctrl+C and Ctrl+V are passed untranslated to `dyalog.exe` which treats them as CT, CP and PT respectively. This is likely to be true for other host applications using the Dyalog keyboard. +- `0` : processed normally, through the appropriate `.DIN` file +- `1` : passed untranslated to the host application (`dyalog.exe` treats Ctrl+X, Ctrl+C, and Ctrl+V as CT, CP, and PT respectively) -The standard Dyalog keyboard (*.din) files map Shift+Del to CT, Ctrl+Ins to CP, and Shift+Ins to PT. These will therefore work independently of the **UseXCV** option. + -The standard Dyalog keyboard (*.din) files map BOTH Ctrl+X and Ctrl+Shift+Xto `⊃` So if **UseXCV** is set to 1, you must use Ctrl+Shift+X to obtain `⊃`. Likewise for C and V. +The standard Dyalog keyboard (`*.din`) files map Shift+Del to CT, Ctrl+Ins to CP, and Shift+Ins to PT, so these work regardless of this setting. Those files also map both Ctrl+X and Ctrl+Shift+X to `⊃`, so when this parameter is `1` you must use Ctrl+Shift+X to obtain `⊃` (and likewise for C and V). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md index f44c0f933b5..493f27d3606 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wantsspecialkeys.md @@ -1,5 +1,10 @@ # WantsSpecialKeys -**Unicode Edition only.** +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog. -This parameter specifies a list of applications (for example, *putty.exe* ) that use the command strings in the Input Translate Tables. +A list of applications (for example, `putty.exe`) that use the command strings in the Input Translate Tables. + +Valid values are a list of application names. + + From 0bc29379e39d8eaf2a0521536c2cc4fea8c74f6b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 03:28:46 +0100 Subject: [PATCH 11/37] Apply template to startup and workspace-loading parameters Rework Load, LX, MaxWS, WSPath, WSEXT, CFEXT, ConfigFile, UserConfigFile, DyalogStartup, DyalogStartupSE, and DyalogStartup_X to the standard template. Records the per-OS WSEXT/CFEXT defaults, the Raspberry Pi MaxWS default, and the LX Unicode/development restriction; repoints ConfigFile/UserConfigFile to the guide's own How to Set pages. Part of abrudz/documentation#719. --- .../docs/configuration-parameters/cfext.md | 13 +++-- .../configuration-parameters/configfile.md | 6 ++- .../dyalogstartup-x.md | 11 +++-- .../configuration-parameters/dyalogstartup.md | 8 +++- .../dyalogstartupse.md | 37 ++++----------- .../docs/configuration-parameters/load.md | 47 ++++++------------- .../docs/configuration-parameters/lx.md | 9 ++-- .../docs/configuration-parameters/maxws.md | 20 +++----- .../userconfigfile.md | 6 ++- .../docs/configuration-parameters/wsext.md | 13 ++--- .../docs/configuration-parameters/wspath.md | 13 +++-- 11 files changed, 79 insertions(+), 104 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/cfext.md b/dyalog-configuration-guide/docs/configuration-parameters/cfext.md index e702abcbf86..7e2ca6bc04b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/cfext.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/cfext.md @@ -1,11 +1,14 @@ # CFEXT -This parameter specifies component file filename extensions. +Component file filename extensions, determining the file search order when a component file is tied. -CFEXT is a string that specifies a colon-separated list of one or more extensions, including any period (".") which separates the extension from its basename. +Valid values are a colon-separated list of one or more extensions, each including the leading period (`.`) that separates it from the basename. -If undefined, CFEXT defaults to `.dcf:` on Windows and macOS, and `.dcf:.DCF:` on all other platforms. +Default depends on operating system: -In the Windows case, this means that `'myfile'⎕FTIE 0` will search first for a file named `myfile.dcf` , and then for a file named `myfile` (with no extension). As file names are not case-sensitive under Windows, this will find `myfile.DCF` or `MyFile.Dcf` and so forth. If none are found with this extension, it will load `myfile` , `MyFile` , `MYFILE` etc. +- Microsoft Windows and macOS: `.dcf:` +- other platforms: `.dcf:.DCF:` -In the second (non-Windows) case note that `'myfile'⎕FTIE 0` will search first for a file named `myfile` , then `myfile.dcf` , then `myfile.DCF` . +For example, on Windows `'myfile'⎕FTIE 0` searches first for `myfile.dcf`, then for `myfile` with no extension (and, as Windows file names are not case-sensitive, finds `myfile.DCF`, `MyFile.Dcf`, and so on). On other platforms it searches for `myfile`, then `myfile.dcf`, then `myfile.DCF`. + +Related parameters: [WSEXT](wsext.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configfile.md b/dyalog-configuration-guide/docs/configuration-parameters/configfile.md index a4a2666a474..4dae9501acc 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/configfile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/configfile.md @@ -1,3 +1,7 @@ # ConfigFile -This parameter specifies the name of the Application Configuration file. See [Configuration Files](../../../windows-installation-and-configuration-guide/configuration-files.md). +The name of the [application configuration file](../how-to-set/application-configuration-files.md). + +Valid values are a file name. + +Related parameters: [UserConfigFile](userconfigfile.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md index ad7e5ad74b5..bebbd9da1f5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup-x.md @@ -1,11 +1,14 @@ # DyalogStartup_X -During Session initialisation, code is loaded from the directories specified by the **DyalogStartupSE** parameter into a corresponding namespace tree in the Session namespace `⎕SE`. Optionally, the code is then executed. +During Session initialisation, code is loaded from the directories given by [`DyalogStartupSE`](dyalogstartupse.md) into a corresponding namespace tree in `⎕SE`, and is then optionally executed. This parameter controls that execution. -If **DyalogStartup_X** is 0 (the default if not defined), the `Run` function (if it exists) in each *top-level* namespace loaded during Session start-up is executed. The namespaces are processed in alphabetical order. +Valid values are: -If **DyalogStartup_X** is 1, the `Run` function is not executed. +- `0` : the `Run` function (if it exists) in each top-level namespace loaded during Session start-up is executed, in alphabetical order of namespace +- `1` : the `Run` function is not executed Other values are reserved for future extension. -See also: [DyalogStartupSE](dyalogstartupse.md). +Default is `0`. + +Related parameters: [DyalogStartupSE](dyalogstartupse.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md index 80152a20a3c..074a25a338e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartup.md @@ -1,5 +1,9 @@ # DyalogStartup -This parameter specifies the name of a file that contains APL code to be run each time Dyalog starts. If this is undefined, the default file is named `SessionStartup` with the file extension `.aplf`, .`apln` or `.aplc`, in the `Dyalog` directory. +The name of a file containing APL code to be run each time Dyalog starts. -See also [Introduction](../../../windows-ui-guide/the-session-object/session-initialisation). +Valid values are a file name. + +Default is a file named `SessionStartup`, with the extension `.aplf`, `.apln`, or `.aplc`, in the Dyalog directory. + +For more information, see [Session Initialisation](../../../windows-ui-guide/the-session-object/session-initialisation). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md index 3e9ab3dec7c..77c2c5bbd5c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalogstartupse.md @@ -1,36 +1,19 @@ # DyalogStartupSE -This parameter specifies one or more *Session initialisation* directories that contain APL code to be installed in `⎕SE`. If this parameter is not specified, the default is a directory named `StartupSession` located in three standard locations. +One or more *Session initialisation* directories containing APL code to be installed in `⎕SE`. -Under Windows these might be: +Valid values are a list of directory names, separated by `;` (Windows) or `:` (UNIX and macOS). If the value begins with the separator, the default list is *extended* rather than *replaced*. -1. `C:\Program Files\Dyalog\Dyalog APL-64 19.0 Unicode` +Default is a directory named `StartupSession` in the standard locations. On Windows these might be: -2. `C:\Users\Pete\Documents\Dyalog APL Files` +1. `C:\Program Files\Dyalog\Dyalog APL-64 21.0 Unicode` +2. `C:\Users\Bob\Documents\Dyalog APL Files` +3. `C:\Users\Bob\Documents\Dyalog APL-64 21.0 Unicode Files` -3. `C:\Users\Pete\Documents\Dyalog APL-64 19.0 Unicode Files` +where the version-specific name has the form `Dyalog APL{bit} {version} {edition}` (`{bit}` is `-64` for a 64-bit version, otherwise nothing; `{version}` is the major and secondary version numbers separated by a period; `{edition}` is `Unicode` for the Unicode edition, otherwise nothing). -The version-specific name is : -```apl - Dyalog APL{bit} {version} {edition} -``` +The effective sequence of directories is stored as a vector of character vectors in `⎕SE.Dyalog.StartupSession.AllPaths`. When the parameter is unset or extended, the `StartupSession` directory in the installation directory, the version-agnostic directory, and the version-specific directory are available as `⎕SE.Dyalog.StartupSession.Dyalog`, `.VerAgno`, and `.VerSpec` respectively. -where: +Related parameters: [DyalogStartup_X](dyalogstartup-x.md). -- {bit} is "`-64`" if 64-bit version, otherwise nothing -- {version} is the main and secondary version numbers of dyalog.exe separated by ".". -- {edition} is "`Unicode`" for the Unicode Edition, otherwise nothing - -The parameter is a string containing the list of directory names separated by ";" on Windows, ":" elsewhere. - -If DyalogStartupSE begins with the specified separator, the default list is *extended* rather than *replaced*. - -Note that the effective sequence of directories specified by this parameter is converted to a vector of character vectors and stored in `⎕SE.Dyalog.StartupSession.AllPaths`. - -If unset or extended (that is, starts with a : separator): - -- the effective StartupSession directory in [DYALOG] is available as `⎕SE.Dyalog.StartupSession.Dyalog`. -- the StartupSession directory in the version-agnostic directory is available as `⎕SE.Dyalog.StartupSession.VerAgno`. -- the StartupSession directory in the version-specific directory is available as `⎕SE.Dyalog.StartupSession.VerSpec`. - -See also [Implementation](../../../windows-ui-guide/the-session-object/session-initialisation). +For more information, see [Session Initialisation](../../../windows-ui-guide/the-session-object/session-initialisation). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/load.md b/dyalog-configuration-guide/docs/configuration-parameters/load.md index 39d90e11971..8d8a2e655e5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/load.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/load.md @@ -1,41 +1,22 @@ # Load -This parameter is a character string that specifies the name of a workspace, or a directory or text file containing APL source code, to be loaded when Dyalog starts. +The name of a workspace, or of a directory or text file containing APL source code, to be loaded when Dyalog starts. It is normally given on the command line or in a configuration file, and overrides a workspace name given as the last item on the command line. -If Load specifies a text file, `2 ⎕FIX` is used to import the file contents and associate that file with each of the objects that have been fixed in the workspace. +- If **Load** names a text file, `2 ⎕FIX` imports its contents and associates the file with each fixed object. +- If **Load** names a directory, Link associates the directory with the active workspace and imports the code (see [Link](https://dyalog.github.io/link)). -If Load specifies a directory, Link is used to associate the directory with the active workspace and to import the code. - For more information about Link, see [https://dyalog.github.io/link](https://dyalog.github.io/link). +Having loaded the workspace or fixed the code, Dyalog executes the expression given by [`LX`](lx.md) if it is set. If `LX` is not set and the `-x` command-line option was given, no further action is taken. Otherwise Dyalog derives an expression to execute: -The **Load** parameter will normally be specified on the command line or in a Configuration file. +- if **Load** is a directory, `Run ,⊂`; +- if **Load** is a workspace (determined by its internal signature), the expression given by its [`⎕LX`](../../../language-reference-guide/system-functions/lx); +- otherwise, for a source file, according to its extension: -Having loaded the workspace, or fixed the code from the named file or directory, Dyalog executes the expression specified by the `LX` parameter if it is set. See [LX](lx.md). +|File Extension|Type|Expression| +|---|---|---| +|`.aplf`|Function source code|`filename 0⍴⊂''`| +|`.aplc`|Class source code|`filename.Run 0⍴⊂''`| +|`.apln`|Namespace source code|`filename.Run 0⍴⊂''`| -If `LX` is not set, Dyalog checks whether or not the **-x** command line option was specified. If so, no further action is taken. See [-x](../../../windows-installation-and-configuration-guide/apl-command-line.md#command-line). +where `filename` is the **Load** value without its extension. Nothing is executed for operator (`.aplo`) or interface (`.apli`) source files. (The argument `0⍴⊂''` may change in a future version.) -Otherwise, Dyalog executes an expression which is derived as follows. - -If the value of Load is a directory, Dyalog will execute the expression: -```apl - Run ,⊂ -``` - -where `` is the value of the **Load** parameter. - -If the value of Load is the name of a file, Dyalog determines whether or not the file is a workspace by its internal signature. - -If the file is a workspace the expression to be executed is specified by its `⎕LX`. See [Latent Expression](../../../language-reference-guide/system-functions/lx). - -Otherwise, if the file extension is `.aplf` `.aplc` or `.apln` the expression is shown in the table below, where `filename` is the file name specified by the **Load** parameter without its extension. - -|File Extension|Type |Expression | -|--------------|---------------------|--------------------| -|`.aplf` |Function source code |`filename 0⍴⊂''` | -|`.aplc` |Class source code |`filename.Run 0⍴⊂''`| -|`.apln` |Namespace source code|`filename.Run 0⍴⊂''`| - -## Notes - -- The **Load** parameter overrides a workspace name specified as the last item on the command line. -- The argument `0⍴⊂''` may change in a future version of Dyalog. -- Nothing is executed when code is loaded from source files that define operators (`.aplo`) or Interfaces (`.apli`). +Related parameters: [LX](lx.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/lx.md b/dyalog-configuration-guide/docs/configuration-parameters/lx.md index fc822255124..fb6855f783a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/lx.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/lx.md @@ -1,9 +1,10 @@ # LX -This parameter specifies an expression to be executed after Dyalog has started and loaded a workspace or a text file containing APL source code. Also see [ Load](load.md). This expression is run only on Dyalog start-up and overrides the workspace latent expression `⎕LX`. +!!! Info "Information" + This configuration parameter is only relevant when using the Unicode edition of Dyalog, and only in the development interpreter (it is ignored in run-time applications). -The LX parameter applies only to the development version of Dyalog and is ignored in run-time applications. +An expression to be executed after Dyalog has started and loaded a workspace or a text file of APL source code (see [`Load`](load.md)). It is run only at start-up and overrides the workspace latent expression `⎕LX`; it is ignored when a workspace is loaded other than at start-up. -The LX parameter is ignored when a workspace is loaded other than at start-up of the Dyalog program. +Valid values are an APL expression. -The LX parameter applies only to the Unicode edition of Dyalog and is ignored in Classic edition. +Related parameters: [Load](load.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/maxws.md b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md index 0d37d1d41bf..3ff495e2e03 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/maxws.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md @@ -1,20 +1,12 @@ # MaxWS -This parameter determines your workspace size and is the amount of memory allocated to the workspace at APL start-up. See [Specifying Size-related Parameters](./configuration-parameters.md) for further details about defining a valid value for this parameter. +The amount of memory allocated to the workspace at start-up. See [Specifying Size-related Parameters](configuration-parameters.md) for how to give a valid size; for example `MAXWS=4G` requests a 4 GiB workspace. Values less than `4M` are ignored, and the maximum is `15E`. -The default value is 256M (256MiB), with the exception of the Raspberry Pi where the default is 64M. Values less than 4M are ignored, and the maximum value is 15E. +Default depends on platform: -For example, to get a 4GiB workspace, set: -```apl - MAXWS=4G -``` +- Raspberry Pi: `64M` +- all other platforms: `256M` -Dyalog APL places no implicit restriction on workspace size, and the virtual memory capability of the underlying operating system allows you to access more memory than you have physically installed. However if you use a workspace that **greatly** exceeds your physical memory you will encounter excessive *paging* and your APL programs will run slowly. You may also cause the system to crash. +The memory used for the workspace must be contiguous. Dyalog places no implicit restriction on workspace size, and virtual memory allows more than the physically installed memory to be addressed; however, a workspace that greatly exceeds physical memory causes excessive paging. 32-bit versions are typically limited to 1.3-1.9 GiB (a limitation of the operating system on 32-bit processes, not of Dyalog); 64-bit versions have no such limit. -Note that the memory used for the workspace must be *contiguous* . - -32-bit versions of Dyalog APL are typically limited to between 1.3GiB to 1.9GiB under Windows, and 1.9GiB under UNIX. These are operating system limitations imposed on 32-bit processes rather than ones imposed by Dyalog APL, and are affected by the number and size of DLLs/shared libraries that are loaded into the process space. - -64-bit versions of Dyalog APL have no such limitations; Dyalog has used workspaces of 96GiB on various platforms. - -See also [Maximum workspace size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). +See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md b/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md index 0b0cf22133b..2a68bef37cc 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/userconfigfile.md @@ -1,3 +1,7 @@ # UserConfigFile -This parameter specifies the name of the User Configuration file. See [Configuration Files](../../../windows-installation-and-configuration-guide/configuration-files.md). +The name of the [user configuration file](../how-to-set/user-configuration-files.md). On Microsoft Windows this parameter is not set by default, but can be defined by the user. + +Valid values are a file name. + +Related parameters: [ConfigFile](configfile.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wsext.md b/dyalog-configuration-guide/docs/configuration-parameters/wsext.md index 3d9e53eba0f..276f8317e38 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wsext.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wsext.md @@ -1,13 +1,14 @@ # WSEXT -This parameter specifies workspace filename extensions. It complements the **WSPATH** parameter in that together they determine the file search order to satisfy `)LOAD` or `)COPY`; it also specifies the filename extension to add on `)SAVE` or `)CONTINUE` if none is explicitly provided. +Workspace filename extensions. Together with [`WSPath`](wspath.md) this determines the file search order for `)LOAD` and `)COPY`, and it specifies the extension added by `)SAVE` or `)CONTINUE` when none is given. -WSEXT is a string that specifies a colon-separated list of one or more extensions, including any period (".") which separates the extension from its basename. +Valid values are a colon-separated list of one or more extensions, each including the leading period (`.`) that separates it from the basename. When `)SAVE` or `⎕SAVE` is used without an extension, the first extension in the list is applied. -If undefined, WSEXT defaults to `.dws:` on Windows and macOS, and `:.dws:.DWS` on all other platforms. +Default depends on operating system: -In the Windows case, this means that `)LOAD myws` will search first for a file named `myws.dws` , and then for a file named `myws` (with no extension). As file names are not case-sensitive under Windows, this will find `myws.DWS` or `MyWs.Dws` and so forth. If none are found with this extension, it will load `myws` , `MyWs` , `MYWS` etc. +- Microsoft Windows and macOS: `.dws:` +- other platforms: `:.dws:.DWS` -In the second (non-Windows) case note that `)LOAD myws` will search first for a file named `myws` , then `myws.dws` , then `myws.DWS`. +For example, on Windows `)LOAD myws` searches first for `myws.dws`, then for `myws` with no extension (and, as Windows file names are not case-sensitive, finds `myws.DWS`, `MyWs.Dws`, and so on). On other platforms `)LOAD myws` searches for `myws`, then `myws.dws`, then `myws.DWS`. -When `)SAVE` and `⎕SAVE` is used without specifying a file extension, the first extension defined by WSEXT is applied to complete the file name. The default is therefore `.dws` in all cases. +Related parameters: [WSPath](wspath.md), [CFEXT](cfext.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wspath.md b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md index 995ce7d81af..e800d78f1b2 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wspath.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md @@ -1,12 +1,11 @@ # WSPath -This parameter defines the workspace path. This is a list of directories that are searched in the order specified when you `)LOAD` or `)COPY` a workspace and when you start an Auxiliary Processor without explicitly specifying a path in the name. The directory paths are specified using Operating System specific conventions and separated by ";" (Windows) or ":" (UNIX). +The workspace search path: a list of directories searched, in order, when you `)LOAD` or `)COPY` a workspace, or start an Auxiliary Processor, without giving an explicit path. To load workspaces from the current directory, include `.` in the list. -Note that to load workspaces from the current directory, "." must be included in the list defined by **WSPath**.. +Valid values are a list of directory paths, separated by `;` (Windows) or `:` (UNIX and macOS). -The following Windows example causes `)COPY` , `)LOAD` and `)LIB` to look first in the current directory, then in `D:\MYWS` . -```apl -WSPath=.;D:\MYWS -``` +For example, on Windows `WSPath=.;D:\MYWS` causes `)COPY`, `)LOAD`, and `)LIB` to look first in the current directory, then in `D:\MYWS`. -See also [Workspace search path](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md). +Related parameters: [WSEXT](wsext.md). + +See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md) of the Windows Configuration Dialog. From eeb689256e2c489ddbbde1ffffdba7893b0b9e7a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 08:20:49 +0100 Subject: [PATCH 12/37] Apply template to interpreter runtime configuration parameters Rework MaxAplCores, qcmd_timeout, SaveContinueOnExit, SaveSessionOnExit, SaveLogOnExit, RunAsService, Dyalog_NETCore, Enable_CEF, APL_MAX_THREADS, CMD_PREFIX/CMD_POSTFIX, Serial, and DYALOG_SERIAL to the standard template. Windows-only restrictions on qcmd_timeout, RunAsService and CMD_PREFIX/POSTFIX; a .NET restriction and per-OS default on Dyalog_NETCore; a Legacy admonition on Serial; Enable_CEF documents its desktop-dependent default and the registry/config caveat. Part of abrudz/documentation#719. --- .../configuration-parameters/apl-max-threads.md | 6 +++++- .../cmd-prefix-and-cmd-postfix.md | 9 +++++++-- .../configuration-parameters/dyalog-netcore.md | 15 +++++++++++++-- .../configuration-parameters/dyalog-serial.md | 4 +++- .../docs/configuration-parameters/enable-cef.md | 15 +++++++++------ .../docs/configuration-parameters/maxaplcores.md | 10 +++++----- .../docs/configuration-parameters/qcmd-timeout.md | 9 ++++++++- .../docs/configuration-parameters/runasservice.md | 13 ++++++++++++- .../savecontinueonexit.md | 11 ++++++++++- .../configuration-parameters/savelogonexit.md | 11 ++++++++++- .../configuration-parameters/savesessiononexit.md | 11 ++++++++++- .../docs/configuration-parameters/serial.md | 9 ++++++++- 12 files changed, 100 insertions(+), 23 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md index 6c9aa4a018a..717cc52a0af 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-max-threads.md @@ -1,3 +1,7 @@ # APL_MAX_THREADS -Specifies the maximum number of system threads that are to be used for parallel execution. The default is 1 and the maximum value is 64. +The maximum number of system threads used for parallel execution. + +Valid values are an integer from `1` to `64`. + +Default is `1`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md b/dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md index 4fb67a58c0c..67b378fec1b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/cmd-prefix-and-cmd-postfix.md @@ -1,5 +1,10 @@ # CMD_PREFIX and CMD_POSTFIX -These parameters defines strings within which operating system commands specified as the arguments to `⎕CMD` and `⎕SH` , and `)CMD` and `)SH` , are wrapped. Its purpose is to run the command arguments under a non-standard command shell. This applies to Windows only. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. -See [Windows Command](../../../language-reference-guide/system-functions/cmd) for implementation details. +Strings within which operating-system commands given as the arguments to `⎕CMD`, `⎕SH`, `)CMD`, and `)SH` are wrapped, so that the command arguments run under a non-standard command shell. + +Valid values are a string. + +For implementation details, see [Windows Command (`⎕CMD`)](../../../language-reference-guide/system-functions/cmd). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md index e00a2f1e7e6..d25ac1539d7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-netcore.md @@ -1,5 +1,16 @@ # Dyalog_NETCore -This Boolean parameter specifies whether the .NET interface is enabled. On Windows the default is 0 which disables the .NET interface in favour of the .NET Framework interface. If it is set to 1, Dyalog uses .NET instead of the .NET Framework. +!!! Info "Information" + This configuration parameter is only relevant when using .NET or .NET Framework. -On other platforms which support .NET, the default is 1. +Whether the .NET interface is used in preference to the .NET Framework interface. + +Valid values are: + +- `0` : the .NET Framework interface is used +- `1` : the .NET interface is used + +Default depends on operating system: + +- Microsoft Windows: `0` +- other platforms that support .NET: `1` diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md index 19ec7e5cca7..7127a5921de 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md @@ -1,5 +1,7 @@ # 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. +Your Dyalog serial number. This must be set to the serial number issued to you; if it is not set, the software is unregistered. + +Valid values are your issued serial number. 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). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md b/dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md index c106006741b..78fb002c3dd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/enable-cef.md @@ -1,10 +1,13 @@ # 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-reference/objects/htmlrenderer) object will fail with an error message. +Whether the [Chromium Embedded Framework (CEF)](https://en.wikipedia.org/wiki/Chromium_Embedded_Framework) is enabled. When disabled, an attempt to create an [HTMLRenderer](../../../object-reference/objects/htmlrenderer) object fails with an error message. -## Note +Valid values are: -Currently the value of the **Enable_CEF** parameter defined in the Windows Registry or in a -Configuration file is ignored. Only the value set in the command line or as an -environment variable is honoured. If not defined in this way, the default value -is used. +- `0` : CEF is disabled +- `1` : CEF is enabled + +Default is `1`, except when Dyalog is not running under a desktop (for example, in a PuTTY session), where the default is `0`. + +!!! Info "Information" + The value of **Enable_CEF** in the Windows Registry or a configuration file is currently ignored; only a value set on the command line or as an environment variable is honoured, otherwise the default is used. Under UNIX and macOS, Auxiliary Processors cannot be used while CEF is enabled. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md b/dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md index 8333c486937..c25d18d37cb 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/maxaplcores.md @@ -1,11 +1,11 @@ # MaxAplCores -This parameter is used in conjunction with the **AplCoreName** parameter to control the maximum number of*aplcore* files that are saved. It applies when the string specified by **AplCoreName** ends with an asterisk (*). If so, when saving an *aplcore* file, Dyalog performs the following steps: +The maximum number of *aplcore* files retained. It applies, in conjunction with [`AplCoreName`](aplcorename.md), when the string given by `AplCoreName` ends with an asterisk (`*`). When saving an aplcore, Dyalog finds the highest-numbered matching file (or `0` if none), increments it, saves the new aplcore with that number, and deletes lower-numbered files so that at most this many are kept. -1. Identifies the highest number ending of those files that match the directory/name pattern specified by **AplCoreName** . If none, assume 0. -2. Increments that number, then saves the *aplcore* in a new file ending with the new number. -3. If necessary, deletes lower-numbered files to retain only the maximum number of files specified by **MaxAplCores** . +Valid values are a positive integer. -See also: [AplCoreName](aplcorename.md). + + +Related parameters: [AplCoreName](aplcorename.md). See also [aplcore Parameters](../../../language-reference-guide/primitive-operators/i-beam/aplcore-parameters). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md b/dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md index 230784417e4..b9fc06387e0 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/qcmd-timeout.md @@ -1,3 +1,10 @@ # qcmd_timeout -This parameter specifies the length of time in milliseconds that APL will wait for the execution of a Windows command to start. Its default value is 5000 milliseconds. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +The length of time, in milliseconds, that Dyalog waits for the execution of a Windows command to start. + +Valid values are a number of milliseconds. + +Default is `5000`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/runasservice.md b/dyalog-configuration-guide/docs/configuration-parameters/runasservice.md index 01c33fcb51e..660e2da0242 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/runasservice.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/runasservice.md @@ -1,3 +1,14 @@ # RunAsService -When RunAsService is set to 1 or 2 (the default is 0) Dyalog APL will not prompt for confirmation when the user logs off, and the interpreter will continue to run across the logoff /logon process. The value 2 reduces the resources used by a Dyalog service by disabling the graphical user-interface features. In this mode, `⎕WC object` will fail with a `LIMIT ERROR` unles the object is Timer, which is the only one that remains enabled. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +Whether Dyalog runs as a service: it does not prompt for confirmation when the user logs off, and the interpreter continues to run across the logoff/logon process. + +Valid values are: + +- `0` : Dyalog does not run as a service +- `1` : Dyalog runs as a service +- `2` : as `1`, but graphical user-interface features are disabled to reduce resource use; `⎕WC` then fails with a `LIMIT ERROR` for every object except Timer + +Default is `0`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md index 4c7279c3249..a9482ace828 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/savecontinueonexit.md @@ -1,3 +1,12 @@ # SaveContinueOnExit -Specifies whether or not your current workspace is saved as `CONTINUE.DWS` before APL terminates. +Whether the current workspace is saved as `CONTINUE.DWS` before Dyalog terminates. + +Valid values are: + +- `0` : the workspace is not saved on exit +- `1` : the workspace is saved as `CONTINUE.DWS` on exit + + + +Related parameters: [SaveSessionOnExit](savesessiononexit.md), [SaveLogOnExit](savelogonexit.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md index b9263f65286..104752b72a6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/savelogonexit.md @@ -1,3 +1,12 @@ # SaveLogOnExit -Specifies whether or not your Session log is saved before APL terminates. +Whether the Session log is saved before Dyalog terminates. + +Valid values are: + +- `0` : the Session log is not saved on exit +- `1` : the Session log is saved on exit + + + +Related parameters: [SaveSessionOnExit](savesessiononexit.md), [SaveContinueOnExit](savecontinueonexit.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md b/dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md index 8aeaaa475cb..3a48e35df7e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/savesessiononexit.md @@ -1,3 +1,12 @@ # SaveSessionOnExit -Specifies whether or not your current Session is saved in your Session file before APL terminates. +Whether the current Session is saved in the Session file before Dyalog terminates. + +Valid values are: + +- `0` : the Session is not saved on exit +- `1` : the Session is saved on exit + + + +Related parameters: [SaveContinueOnExit](savecontinueonexit.md), [SaveLogOnExit](savelogonexit.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/serial.md b/dyalog-configuration-guide/docs/configuration-parameters/serial.md index 92870c67072..f9bbd7ddef5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/serial.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/serial.md @@ -1,3 +1,10 @@ # Serial -Legacy: Specifies your Dyalog APL/W Serial Number. See[ DYALOG_SERIAL](dyalog-serial.md) which supercedes it.. +!!! Legacy "Legacy" + This configuration parameter is superseded by [`DYALOG_SERIAL`](dyalog-serial.md). + +Your Dyalog serial number. + +Valid values are your issued serial number. + +Related parameters: [DYALOG_SERIAL](dyalog-serial.md). From e472eeb3f9c7091d750bfd1bb944a37539e61068 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 08:22:12 +0100 Subject: [PATCH 13/37] Apply template to location, help, and URL configuration parameters Rework Dyalog, localdyalogdir, DyalogInstallDir, ProgramFolder, DyalogLink, DyalogHelpDir, DyalogWebSite, DyalogEmailAddress, ExternalHelpURL, and UseExternalHelpURL to the standard template. ProgramFolder, ExternalHelpURL, and UseExternalHelpURL carry a Microsoft Windows-only restriction; Dyalog and DyalogLink state their defaults. Remaining defaults flagged for confirmation. Part of abrudz/documentation#719. --- .../docs/configuration-parameters/dyalog.md | 8 +++++++- .../dyalogemailaddress.md | 6 +++++- .../configuration-parameters/dyaloghelpdir.md | 10 +++++++--- .../configuration-parameters/dyaloginstalldir.md | 8 +++++++- .../docs/configuration-parameters/dyaloglink.md | 8 +++++--- .../configuration-parameters/dyalogwebsite.md | 6 +++++- .../configuration-parameters/externalhelpurl.md | 13 +++++++++++-- .../configuration-parameters/localdyalogdir.md | 8 +++++++- .../configuration-parameters/programfolder.md | 9 ++++++++- .../useexternalhelpurl.md | 16 ++++++++++++++-- 10 files changed, 76 insertions(+), 16 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md index 8604c3532c1..512ac846691 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md @@ -1,3 +1,9 @@ # Dyalog -This parameter specifies the name of the directory in which Dyalog APL is installed. If undefined, the name of the directory from which the Dyalog APL program was loaded is assumed. +The directory in which Dyalog is installed. It is used to form the default values of parameters such as [`APLKeys`](aplkeys.md), [`APLTrans`](apltrans.md), and [`WSPath`](wspath.md). + +Valid values are a directory path. + +Default is the directory from which the Dyalog program was loaded. + +Related parameters: [DyalogInstallDir](dyaloginstalldir.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md index 87fed966141..a3dbb49f238 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalogemailaddress.md @@ -1,3 +1,7 @@ # DyalogEmailAddress -This parameter specifies the contact email address for Dyalog Limited. +The contact email address for Dyalog Ltd. + +Valid values are an email address. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md index da64d42fbdc..a892a0eaee1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyaloghelpdir.md @@ -1,6 +1,10 @@ # DyalogHelpDir -This parameter specifies identifies the location of the HTML-based help that is used for a request for help (from the Help menu or pressing `F1`) from the Session. It may be: +The location of the HTML-based help used when help is requested from the Session (from the Help menu or by pressing `F1`). -- The full pathname of the directory that contains the Dyalog APL help file (`dyalog.chm`). This is the default. -- The index page of the on-line HTML-based help located on `help.dyalog.com` for example, `https://help.dyalog.com/18.0`. +Valid values are: + +- the full pathname of the directory that contains the Dyalog help file (`dyalog.chm`) +- the index page of the online HTML-based help on `help.dyalog.com`, for example `https://help.dyalog.com/21.0` + +Default is the full pathname of the directory containing `dyalog.chm`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md index 1e06c346606..42dfcfe208b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyaloginstalldir.md @@ -1,3 +1,9 @@ # DyalogInstallDir -This parameter specifies the full pathname of the directory in which Dyalog APL is installed. +The full pathname of the directory in which Dyalog is installed. + +Valid values are a directory path. + + + +Related parameters: [Dyalog](dyalog.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md b/dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md index c1849bf312c..9de5195a02f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyaloglink.md @@ -1,7 +1,9 @@ # DyalogLink -This parameter specifies the name of the directory containing the code for Link. The default is `[DYALOG]/StartupSession/Link`. +The directory containing the code for Link. Link is required for Session initialisation. -Note that Link is required for Session initialisation. +Valid values are a directory path. -For further information, see [https://dyalog.github.io/link/4.0/Usage/Installation](https://dyalog.github.io/link/4.0/Usage/Installation). +Default is `[DYALOG]/StartupSession/Link`. + +For more information, see the [Link installation instructions](https://dyalog.github.io/link/4.0/Usage/Installation). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md index d9abbc1b856..fe74e51e78e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalogwebsite.md @@ -1,3 +1,7 @@ # DyalogWebSite -This parameter specifies the URL for the Dyalog web site. +The URL of the Dyalog web site. + +Valid values are a URL. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md index c7c690ca0e0..599c51103b5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md @@ -1,5 +1,14 @@ # ExternalHelpURL -If **UseExternalHelpURL** is 1, Dyalog attempts to use the Microsoft Document Explorer and online help, for example from Visual Studio (if installed), to display help for external objects, such as .Net Types. This parameter specifies the URL to be used. In most cases the default setting will be sufficient. On some configurations it may be necessary to change this. See [ UseExternalHelpURL](useexternalhelpurl.md). +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. -See also [URL](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +The URL used when [`UseExternalHelpURL`](useexternalhelpurl.md) is `1` and Dyalog displays help for external objects (such as .NET types) through the Microsoft Document Explorer and online help (for example from Visual Studio). The default is usually sufficient, but some configurations require it to be changed. + +Valid values are a URL. + + + +Related parameters: [UseExternalHelpURL](useexternalhelpurl.md). + +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md b/dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md index ed465a4325f..2baed60d964 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/localdyalogdir.md @@ -1,3 +1,9 @@ # localdyalogdir -This parameter specifies the name of the directory in which Dyalog APL/W is installed on the client, in a client/server installation +The directory in which Dyalog is installed on the client, in a client/server installation. + +Valid values are a directory path. + + + +Related parameters: [Dyalog](dyalog.md), [DyalogInstallDir](dyaloginstalldir.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/programfolder.md b/dyalog-configuration-guide/docs/configuration-parameters/programfolder.md index e3b393a007d..d1db2f8fc23 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/programfolder.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/programfolder.md @@ -1,3 +1,10 @@ # ProgramFolder -This parameter specifies the name of the folder in which the Dyalog APL program icons are installed. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +The folder in which the Dyalog program icons are installed. + +Valid values are a folder name. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md index de338982fd1..110223926e9 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md @@ -1,5 +1,17 @@ # UseExternalHelpURL -This parameter specifies whether or not Dyalog attempts to use the Microsoft Document Explorer and online help to display help for external objects, such as .Net Types. See [ ExternalHelpURL](externalhelpurl.md). +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. -See also [Use Microsoft's documentation centre for non-Dyalog topics](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +Whether Dyalog uses the Microsoft Document Explorer and online help to display help for external objects, such as .NET types. + +Valid values are: + +- `0` : the Microsoft Document Explorer is not used +- `1` : the Microsoft Document Explorer and online help are used, at the URL given by [`ExternalHelpURL`](externalhelpurl.md) + + + +Related parameters: [ExternalHelpURL](externalhelpurl.md). + +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. From 9ef9d1f62c21ebdde56201cc7f59aa1c08ecdbdc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 08:24:00 +0100 Subject: [PATCH 14/37] Apply template to file, interop, and diagnostic parameters Rework APL_FCREATE_PROPS_C/J, APL_FAST_FCHK, APL_CODE_E_MAGNITUDE, APL_COMPLEX_AS_V12, File_Stack_Size, AplCoreName, APL_TextInAplCore, DMXOutputOnError, PassExceptionsToOpSys, ErrorOnExternalException, and ShowStatusOnError to the standard template. APL_COMPLEX_AS_V12 carries a Legacy admonition; PassExceptionsToOpSys a Windows-only restriction; confirmed defaults recorded (checksum/journaling 1, APL_FAST_FCHK 0, APL_CODE_E_MAGNITUDE 0, APL_TextInAplCore 1) and the rest flagged. Part of abrudz/documentation#719. --- .../apl-code-e-magnitude.md | 18 ++++++------------ .../apl-complex-as-v12.md | 14 +++++++------- .../configuration-parameters/apl-fast-fchk.md | 15 +++++---------- .../apl-fcreate-props-c.md | 8 +++++++- .../apl-fcreate-props-j.md | 8 +++++++- .../apl-textinaplcore.md | 11 ++++++++++- .../configuration-parameters/aplcorename.md | 8 ++++++-- .../dmxoutputonerror.md | 11 +++++++++-- .../erroronexternalexception.md | 9 ++++++++- .../file-stack-size.md | 8 +++++++- .../passexceptionstoopsys.md | 15 +++++++++++++-- .../showstatusonerror.md | 9 ++++++++- 12 files changed, 93 insertions(+), 41 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md index 6387c045c41..0bd1f01a1d7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-code-e-magnitude.md @@ -1,17 +1,11 @@ # APL_CODE_E_MAGNITUDE -The introduction of decimal floating point numbers lead to the maximum allowable print precision being increased from 17 to 34, which resulted in a change in the way numbers in the range `(10*17) to (10*34)` in function bodies are descanned[^1]. For example, the number one sextillion (1021) in a function is descanned by Version 12.1 as `1E21` and by Version 13.0 as `1000000000000000000000`. +The magnitude at or above which numbers in function bodies are descanned (written out as their character representation, for example by `⎕CR`) in exponential format. This controls whether large integers appear as, for example, `1E21` or `1000000000000000000000`, which affects the readability of code and the stability of its character representation across versions. -Whilst this change has no other deleterious effect, it means that code that contains such numbers is harder to read, and the result of `⎕CR` (and other character representations) of the same function may have changed between Version 12.1 and later versions of Dyalog causing undesired affects in code management systems. +Valid values are: -The **APL_CODE_E_MAGNITUDE** parameter allows the user to choose between the behaviour seen in Version 12.1 and earlier and in more recent behaviour. It also allows the user to specify the size of numbers above which those numbers are display in exponential format. +- `0` : numbers are descanned and displayed normally (the default) +- `¯1` : numbers greater than or equal to 1017 use exponential format, as in Version 12.1 +- an integer from `2` to `34` : numbers greater than or equal to 10value use exponential format -If the **APL_CODE_E_MAGNITUDE** parameter is undefined or set to 0 (the default), numbers are descanned and displayed as normal. - -If **APL_CODE_E_MAGNITUDE** has the value -1, numbers greater than or equal to 1017 will be displayed using exponential format, as in Version 12.1. - -If **APL_CODE_E_MAGNITUDE** has a value between 2 and 34, numbers greater than or equal to 10value will be displayed using exponential format. - -The effect of setting this parameter to any other value is undefined. - -[^1]: Descanning refers to the internal process used to convert the internal representation of APL code into a character array. For numbers in function statements, this process uses the maximum value of Print Precision. +Default is `0`. The effect of any other value is undefined. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md index 3b0b46a77c4..2260fcfde9b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-complex-as-v12.md @@ -1,13 +1,13 @@ # APL_COMPLEX_AS_V12 -Support for Complex Numbers means that some functions produce different results from older Versions of Dyalog APL. If **APL_COMPLEX_AS_V12** is set to 1 the behaviour of code developed using Version 12.1 or earlier will be unchanged; in particular: +!!! Legacy "Legacy" + This configuration parameter eases the transition of older code to currently supported versions of Dyalog. It is intended to be removed in a future release. -- Power (`*` ) and logarithm (`⍟` ) do not produce Complex Numbers as results from non-complex arguments. -- `⎕VFI` will not honour "J" or "j" as part of a number. -- `¯4○Y` will be evaluated as `(¯1+Y*2)*0.5` , which is positive for negative real arguments. +Whether code developed with Version 12.1 or earlier keeps its original behaviour with respect to complex numbers. -If **APL_COMPLEX_AS_V12** is set to any other value or is not set at all then code developed using version 12.1 or earlier may now generate Complex Numbers. +Valid values are: -In addition, if **APL_COMPLEX_AS_V12** is set to 1, objects containing complex numbers cannot be transferred to or from component files, TCP/IP (CONGA), or auxiliary processors and may not be used as an argument to Serialise/Deserialise Array (`220⌶` ). Instead, a `DOMAIN ERROR` will be issued. +- `1` : Version 12.1 behaviour is retained. Power (`*`) and logarithm (`⍟`) do not produce complex results from non-complex arguments; `⎕VFI` does not honour `J`/`j`; and `¯4○Y` is evaluated as `(¯1+Y*2)*0.5`. In addition, objects containing complex numbers cannot be transferred to or from component files, TCP/IP (Conga), or auxiliary processors, nor used as an argument to Serialise/Deserialise Array (`220⌶`); a `DOMAIN ERROR` is issued instead. +- any other value, or unset : code developed with Version 12.1 or earlier may now generate complex numbers -Note that this feature is provided to simplify the transition of older code to currently supported Versions of Dyalog APL. It does not prevent the generation and use of Complex Numbers using newer features (such as explicitly specifying a Complex Number literal), and the intention is that it will be removed in a future release of Dyalog APL. +This does not prevent the generation and use of complex numbers through newer features, such as complex-number literals. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md index 8a75219994c..01003d61794 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-fast-fchk.md @@ -1,15 +1,10 @@ # APL_FAST_FCHK -This parameter specifies whether Dyalog APL should optimise `⎕FCHK` by allowing it to reliably determine whether a component file had been properly untied and therefore does not need to be checked (this is overridable using the `⎕FCHK` option force). +Whether `⎕FCHK` is optimised so that it can reliably determine that a component file was properly untied and so need not be checked (this can be overridden with the `⎕FCHK` `force` option). The optimisation has a performance cost on `⎕FUNTIE`, so it is best switched off in applications that frequently tie and untie files. It affects only component files with journaling enabled. -Optimising `⎕FCHK` in this way has a performance impact on `⎕FUNTIE` and it is recommended this optimisation is switched off if your application frequently ties and unties files. +Valid values are: -Note: this only affects component files with journaling enabled. +- `0` : do not optimise `⎕FCHK` (optimise `⎕FUNTIE` instead) +- `1` : optimise `⎕FCHK` -The values of the parameter are: - -|---|----------------------------------------------------| -|0 |Do not optimise `⎕FCHK` (optimise `⎕FUNTIE` instead)| -|1 |Optimise `⎕FCHK` | - -The default value of the parameter is 0 on all platforms. On Windows, setting the value 1 has no effect. +Default is `0` on all platforms. On Microsoft Windows, setting the value `1` has no effect. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md index d9d3882d21e..6916af2f6b7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md @@ -1,3 +1,9 @@ # APL_FCREATE_PROPS_C -This parameter specifies the default checksum level for newly-created component files. If unspecified, the default checksum level is 1. +The default checksum level for newly-created component files. + +Valid values are a checksum level. + +Default is `1`. + +Related parameters: [APL_FCREATE_PROPS_J](apl-fcreate-props-j.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md index 9e5fba6ae35..a477d5a6dd3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md @@ -1,3 +1,9 @@ # APL_FCREATE_PROPS_J -This parameter specifies the default journaling level for newly-created component files. If unspecified, the default journaling level is 1. +The default journaling level for newly-created component files. + +Valid values are a journaling level. + +Default is `1`. + +Related parameters: [APL_FCREATE_PROPS_C](apl-fcreate-props-c.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md index f42ffa6d104..9d15f5ba2f7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md @@ -1,3 +1,12 @@ # APL_TextInAplCore -This Boolean parameter specifies whether or not certain information is written to an *aplcore* file when a [system error](../../../programming-reference-guide/error-messages/system-errors) occurs. The default is 1. +Whether certain information is written to an *aplcore* file when a [system error](../../../programming-reference-guide/error-messages/system-errors) occurs. + +Valid values are: + +- `0` : the information is omitted +- `1` : the information is included + +Default is `1`. + +Related parameters: [AplCoreName](aplcorename.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md b/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md index 4757b359a31..3a0691d5932 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md @@ -1,7 +1,11 @@ # AplCoreName -This parameter specifies the directory and name of the file in which *aplcore* should be saved. The optional wild-card character (`*`) is replaced by a number when the file is written. If there is more than one `*` in **AplCoreName**, the string is used as is; no substitution is made. For more details, including how to prevent aplcore files from being generated, see [MaxAplCores](maxaplcores.md). +The directory and name of the file in which an *aplcore* is saved. An optional wild-card character (`*`) is replaced by a number when the file is written; if there is more than one `*`, the string is used as is, with no substitution. Dyalog terminates with an exit code of `3` when an aplcore is generated. -Note that APL terminates with an exit code of 3 when an aplcore file is generated. +Valid values are a file path, optionally containing a single `*`. + + + +Related parameters: [MaxAplCores](maxaplcores.md) (including how to prevent aplcore files being generated). See also [aplcore Parameters](../../../language-reference-guide/primitive-operators/i-beam/aplcore-parameters). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md index ff9b9d4b0fa..b15a1055089 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md @@ -1,5 +1,12 @@ # DMXOutputOnError -This parameter specifies in which windows DMX error messages are displayed. It is an integer whose value is the sum of the specified windows where 1 = Status Window and 2 = Session Window. +Which windows `⎕DMX` error messages are displayed in. The value is the sum of the codes for the chosen windows. -See also [DMX messages should go to](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md). +The value is the sum of the following: + +- `1` : Status window +- `2` : Session window + + + +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md b/dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md index be5081ddf83..d9e0c69c515 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/erroronexternalexception.md @@ -1,3 +1,10 @@ # ErrorOnExternalException -This parameter specifies the behaviour when a System Exception occurs in an external DLL. If this parameter is set to 1, and an exception occurs in a call on an external DLL. APL generates an `EXTERNAL DLL EXCEPTION` error (91), instead of terminating with a System Error. This error may be trapped. +The behaviour when a system exception occurs in a call on an external DLL or shared library. + +Valid values are: + +- `0` : Dyalog terminates with a system error +- `1` : Dyalog generates a trappable `EXTERNAL DLL EXCEPTION` error (91) instead of terminating + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md index 09e435549d0..063113dc342 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md @@ -1,3 +1,9 @@ # File_Stack_Size -This parameter specifies the number of the most recently used workspaces displayed in the Session File menu. See [Recently used file list size](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +The number of most-recently-used workspaces displayed in the Session File menu. + +Valid values are a non-negative integer. + + + +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md b/dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md index 12c0703db98..c7660bad875 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/passexceptionstoopsys.md @@ -1,4 +1,15 @@ # PassExceptionsToOpSys -This is a Boolean parameter that specifies the default state of the *Pass Exception* check box in the *System Error* dialog box.See - [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors) for more information. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +The default state of the *Pass Exception* check box in the System Error dialog box. + +Valid values are: + +- `0` : *Pass Exception* is cleared by default +- `1` : *Pass Exception* is checked by default + + + +For more information, see [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md b/dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md index de9644dce54..60123f8a0f9 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/showstatusonerror.md @@ -1,3 +1,10 @@ # ShowStatusOnError -Specifies whether or not the Status window is automatically displayed (if required) when APL attempts to write output to it. +Whether the Status window is displayed automatically, when required, when Dyalog attempts to write output to it. + +Valid values are: + +- `0` : the Status window is not displayed automatically +- `1` : the Status window is displayed automatically when output is written to it + + From 220df8d250d9211ca57307ae445b2617d30827c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 10:10:04 +0100 Subject: [PATCH 15/37] Apply template to AutoComplete configuration parameters Rework the twelve AutoComplete parameters (CancelKey1/2, Cols, CommonKey1, CompleteKey1/2, Enabled, History, HistorySize, PrefixSize, Rows, ShowFiles) to the standard template, with key/size/boolean values and related-parameter cross-links. Defaults are not in the source and carry a REVIEW(default) marker. Also corrected the source "Auto Cancel" and "Completeion" typos. Part of abrudz/documentation#719. --- .../autocomplete/cancelkey1.md | 10 ++++++++-- .../autocomplete/cancelkey2.md | 10 ++++++++-- .../configuration-parameters/autocomplete/cols.md | 10 ++++++++-- .../autocomplete/commonkey1.md | 8 ++++++-- .../autocomplete/completekey1.md | 10 ++++++++-- .../autocomplete/completekey2.md | 10 ++++++++-- .../autocomplete/enabled.md | 11 +++++++++-- .../autocomplete/history.md | 13 +++++++++++-- .../autocomplete/historysize.md | 10 ++++++++-- .../autocomplete/prefixsize.md | 8 ++++++-- .../configuration-parameters/autocomplete/rows.md | 10 ++++++++-- .../autocomplete/showfiles.md | 11 +++++++++-- 12 files changed, 97 insertions(+), 24 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md index c2d7c419949..8ebab13110e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md @@ -1,5 +1,11 @@ # AutoComplete/CancelKey1 -Specifies the first of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. +The first of two possible keys that cancel (hide) the AutoComplete suggestion box. -See also [Cancel Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a key code. + + + +Related parameters: [AutoComplete/CancelKey2](cancelkey2.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md index faac97c7b7c..4e15f1bcec8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md @@ -1,5 +1,11 @@ # AutoComplete/CancelKey2 -Specifies the second of two possible keys that may be used to cancel (hide) the Auto Cancel suggestion box. +The second of two possible keys that cancel (hide) the AutoComplete suggestion box. -See also [Cancel Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a key code. + + + +Related parameters: [AutoComplete/CancelKey1](cancelkey1.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md index 2399d5c68aa..56f54328073 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md @@ -1,5 +1,11 @@ # AutoComplete/Cols -This parameter specifies the maximum number of columns (width) in the Auto Complete pop-up suggestions box. +The maximum number of columns (width) in the AutoComplete pop-up suggestion box. -See also [Show up to](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a positive integer. + + + +Related parameters: [AutoComplete/Rows](rows.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md index fcfb54b7ad5..a39453363ea 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md @@ -1,5 +1,9 @@ # AutoComplete/CommonKey1 -Specifies the key that will auto-complete the *common prefix*. This is defined to be the longest string of leading characters in the currently selected name that is shared by at least one other name in the Auto Complete suggestion box. +The key that auto-completes the *common prefix*: the longest string of leading characters of the currently selected name that is shared by at least one other name in the AutoComplete suggestion box. -See also [Common Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a key code. + + + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md index c8b32685db9..476aa1a210d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md @@ -1,5 +1,11 @@ # AutoComplete/CompleteKey1 -Specifies the first of two possible keys that may be used to select the current option from the Auto Complete suggestion box. +The first of two possible keys that select the current option from the AutoComplete suggestion box. -See also [OK Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a key code. + + + +Related parameters: [AutoComplete/CompleteKey2](completekey2.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md index 2c39003ec68..f0765a02522 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md @@ -1,5 +1,11 @@ # AutoComplete/CompleteKey2 -Specifies the second of two possible keys that may be used to select the current option from the Auto Complete suggestion box. +The second of two possible keys that select the current option from the AutoComplete suggestion box. -See also [OK Key](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a key code. + + + +Related parameters: [AutoComplete/CompleteKey1](completekey1.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md index 3a6d4971475..25165ccb8e8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md @@ -1,5 +1,12 @@ # AutoComplete/Enabled -This parameter specifies whether or not Auto Completion is enabled +Whether AutoComplete is enabled. -See also [Use Auto Complete](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are: + +- `0` : AutoComplete is disabled +- `1` : AutoComplete is enabled + + + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md index 427cf520aba..0c4ef3678f6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md @@ -1,5 +1,14 @@ # AutoComplete/History -Specifies whether or not Auto Complete maintains a list of previous Auto Completions. +Whether AutoComplete maintains a list of previous auto-completions. -See also [Keep History](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are: + +- `0` : no history is kept +- `1` : a history of previous auto-completions is kept + + + +Related parameters: [AutoComplete/HistorySize](historysize.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md index 6712b8ddd2f..13e9d788eb1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md @@ -1,5 +1,11 @@ # AutoComplete/HistorySize -Specifies the number of previous Auto Completions that are maintained when History is 1. See [History](history.md). +The number of previous auto-completions kept when [`AutoComplete/History`](history.md) is `1`. -See also [History Length](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a positive integer. + + + +Related parameters: [AutoComplete/History](history.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md index 6adb08bd9e7..66b806ff484 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md @@ -1,5 +1,9 @@ # AutoComplete/PrefixSize -This parameter specifies the threshold (number of characters) before Auto Completeion displays suggestions. +The threshold, in number of characters entered, before AutoComplete begins to display suggestions. -See also [Make suggestions after](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a non-negative integer. + + + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md index c603c81d538..fc76daf484c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md @@ -1,5 +1,11 @@ # AutoComplete/Rows -This parameter specifies the maximum number of rows (height) in the Auto Complete pop-up suggestions box. +The maximum number of rows (height) in the AutoComplete pop-up suggestion box. -See also [Suggest up to](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are a positive integer. + + + +Related parameters: [AutoComplete/Cols](cols.md). + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md index 853bf7717f9..3923f946928 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md @@ -1,5 +1,12 @@ # AutoComplete/ShowFiles -Specifies whether or not Auto Completion suggests directory and file names for `)LOAD`, `)COPY` and `)DROP` system commands. +Whether AutoComplete suggests directory and file names for the `)LOAD`, `)COPY`, and `)DROP` system commands. -See also [Include filenames](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md). +Valid values are: + +- `0` : file and directory names are not suggested +- `1` : file and directory names are suggested + + + +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. From 78fb2c566ed43486b57e54b75bda9c60c5d0cff6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 10:12:08 +0100 Subject: [PATCH 16/37] Apply template to ValueTips, event-log, and miscellaneous parameters Rework ValueTips/ColourScheme/Delay/Enabled, DYALOG_EVENTLOGGINGLEVEL, DYALOG_EVENTLOGNAME, TraceStopMonitor, Ride_Spawned, UCMDCacheFile, IniFile, and Greet_Bitmap to the standard template. Windows-only restrictions on the event-log pair and IniFile; a Ride restriction on Ride_Spawned. UCMDCacheFile and IniFile record their (macro-derived) defaults; the rest are flagged, and DYALOG_EVENTLOGGINGLEVEL flags its values pending confirmation of Boolean vs multi-level. Part of abrudz/documentation#719. --- .../dyalog-eventlogginglevel.md | 17 ++++++++-- .../dyalog-eventlogname.md | 14 ++++++-- .../configuration-parameters/greet-bitmap.md | 9 ++--- .../docs/configuration-parameters/inifile.md | 33 ++++++++++--------- .../configuration-parameters/ride-spawned.md | 14 +++++++- .../tracestopmonitor.md | 10 +++++- .../configuration-parameters/ucmdcachefile.md | 9 ++--- .../valuetips/colourscheme.md | 10 ++++-- .../valuetips/delay.md | 10 ++++-- .../valuetips/enabled.md | 13 ++++++-- 10 files changed, 101 insertions(+), 38 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md index ce4a8a9c020..5a9cfc80ba3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogginglevel.md @@ -1,4 +1,17 @@ # DYALOG_EVENTLOGGINGLEVEL -This parameter applies under Windows only, and specifies whether a log entry is written to the Windows Event Log or not when Dyalog APL would pop up a message box due to an unexpected termination of Dyalog APL. See - [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors) for more information. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +Whether a log entry is written to the Windows Event Log when Dyalog would otherwise pop up a message box because of an unexpected termination. + +Valid values are: + +- `0` : no entry is written to the Windows Event Log +- `1` : an entry is written to the Windows Event Log + + + +Related parameters: [DYALOG_EVENTLOGNAME](dyalog-eventlogname.md). + +For more information, see [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md index 3c6c854e606..774a193aa9e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-eventlogname.md @@ -1,4 +1,14 @@ # DYALOG_EVENTLOGNAME -This parameter applies under Windows only, and is either the name of the event log to which an event message will be written, or the source of the event message (depending on the registry entries which may or may not have been defined) when Dyalog APL would pop up a message box due to an unexpected termination of Dyalog APL.See - [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors) for more information. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +The name of the Windows Event Log to which an event message is written (or the source of the event message, depending on the Registry entries defined) when Dyalog would otherwise pop up a message box because of an unexpected termination. + +Valid values are an event log name or event source name. + + + +Related parameters: [DYALOG_EVENTLOGGINGLEVEL](dyalog-eventlogginglevel.md). + +For more information, see [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md b/dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md index 47fb933f034..e43ddaf3a9c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/greet-bitmap.md @@ -1,6 +1,7 @@ # Greet_Bitmap -This parameter specifies the filename of a bitmap to be displayed during initialisation of the Dyalog APL application. It is used typically to display a product logo from a runtime application. The bitmap will remain until either an error occurs, or it is removed using the [GreetBitmap](../../../object-reference/methodorevents/greetbitmap) method of the Root object. -```apl -Greet_Bitmap=c:\myapp\logo.bmp -``` +The filename of a bitmap displayed during initialisation of the Dyalog application, typically to show a product logo from a run-time application. The bitmap remains until an error occurs or it is removed using the [GreetBitmap](../../../object-reference/methodorevents/greetbitmap) method of the Root object. For example, `Greet_Bitmap=c:\myapp\logo.bmp`. + +Valid values are a file path. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/inifile.md b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md index 565a249a9fb..e366801f4ec 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/inifile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md @@ -1,22 +1,23 @@ # IniFile -This parameter specifies the name of the Windows Registry folder that contains the configuration parameters described in this section. For example, -```apl -INIFILE=Software\Dyalog\mysettings -``` +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. -The default values for **IniFile**, for the 64-bit and 32-bit versions respectively, are: +The name of the Windows Registry folder that holds the configuration parameters. For example, `INIFILE=Software\Dyalog\mysettings`. -## Unicode Edition -```apl - Software\Dyalog\Dyalog APL/W-64 {{ version_majmin }} Unicode - Software\Dyalog\Dyalog APL/W {{ version_majmin }} Unicode -``` +Valid values are a Registry folder path. -## Classic Edition -```apl - Software\Dyalog\Dyalog APL/W-64 {{ version_majmin }} - Software\Dyalog\Dyalog APL/W {{ version_majmin }} -``` +Default depends on edition (64-bit and 32-bit versions respectively): -See also [Configuration saved in](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +- Unicode edition: + ``` + Software\Dyalog\Dyalog APL/W-64 {{ version_majmin }} Unicode + Software\Dyalog\Dyalog APL/W {{ version_majmin }} Unicode + ``` +- Classic edition: + ``` + Software\Dyalog\Dyalog APL/W-64 {{ version_majmin }} + Software\Dyalog\Dyalog APL/W {{ version_majmin }} + ``` + +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md b/dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md index 09037975249..0d0f3930c04 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/ride-spawned.md @@ -1,3 +1,15 @@ # Ride_Spawned -If non-zero, this parameter disables `⎕SR` and `)SH` which instead generate `DOMAIN ERROR`. This parameter is used to prevent certain user-interfaces from being executed from a Ride session which does not support them, and which would otherwise cause the Ride session to become unresponsive. See [Ride User Guide](https://dyalog.github.io/ride). +!!! Info "Information" + This configuration parameter is only relevant when using Ride. + +Whether `⎕SR` and `)SH` are disabled. It is used to prevent user interfaces that a Ride session does not support (and which would otherwise make the session unresponsive) from being executed. + +Valid values are: + +- `0` : `⎕SR` and `)SH` behave normally +- non-zero : `⎕SR` and `)SH` are disabled and instead generate a `DOMAIN ERROR` + + + +For more information, see the [Ride User Guide](https://dyalog.github.io/ride). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md b/dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md index e822249cf80..0660e03f97a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/tracestopmonitor.md @@ -1,3 +1,11 @@ # TraceStopMonitor -This parameter specifies which of the `⎕TRACE` (1), `⎕STOP` (2) and `⎕MONITOR` (4) columns are displayed in Trace and Edit windows. Its value is the sum of the corresponding values. +Which of the `⎕TRACE`, `⎕STOP`, and `⎕MONITOR` columns are displayed in Trace and Edit windows. The value is the sum of the codes for the chosen columns. + +The value is the sum of the following: + +- `1` : the `⎕TRACE` column +- `2` : the `⎕STOP` column +- `4` : the `⎕MONITOR` column + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md b/dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md index 846b5033b39..53270edeaad 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/ucmdcachefile.md @@ -1,10 +1,7 @@ # UCMDCacheFile -This parameter specifies the name of the User Command cache file. +The name of the User Command cache file. -The default value is: -```apl -UserCommand{UcmdMajor}{UcmdMinor}.{DyalogMajor}{DyalogMinor}{U|C}{bits}.cache -``` +Valid values are a file name. -For example, `UserCommand25.182U64.cache` +Default is `UserCommand{UcmdMajor}{UcmdMinor}.{DyalogMajor}{DyalogMinor}{U|C}{bits}.cache`, for example `UserCommand25.182U64.cache`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md index 5721b506042..71ec8cfc7c5 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md @@ -1,5 +1,11 @@ # ValueTips/ColourScheme -This parameter specifies the colour scheme used to display a Value Tip when the user hovers the mouse over a name. +The colour scheme used to display a Value Tip when the mouse hovers over a name. -See also [Colour Scheme](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +Valid values are the name of a colour scheme. + + + +Related parameters: [ValueTips/Enabled](enabled.md), [ValueTips/Delay](delay.md). + +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md index 4c5a863cd9d..1aa30089352 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md @@ -1,5 +1,11 @@ # ValueTips/Delay -This parameter specifies the delay before a Value Tip is displayed when the user hovers the mouse over a name. +The delay, in milliseconds, before a Value Tip is displayed when the mouse hovers over a name. -See also [Display Value Tips](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +Valid values are a number of milliseconds. + + + +Related parameters: [ValueTips/Enabled](enabled.md), [ValueTips/ColourScheme](colourscheme.md). + +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md index 30b3931c29a..0ca9793d6f4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md @@ -1,5 +1,14 @@ # ValueTips/Enabled -This parameter specifies whether or not Value Tips are enabled. When enabled, Dyalog displays the value of a variable or the code for a function when the user hovers the mouse over its name. +Whether Value Tips are enabled. When enabled, Dyalog displays the value of a variable, or the code of a function, when the mouse hovers over its name. -See also [Display Value Tips](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md). +Valid values are: + +- `0` : Value Tips are disabled +- `1` : Value Tips are enabled + + + +Related parameters: [ValueTips/Delay](delay.md), [ValueTips/ColourScheme](colourscheme.md). + +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. From e1913c95d4b6a12265316235ce62542ca91ec1bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 10:14:04 +0100 Subject: [PATCH 17/37] Apply template to remaining configuration parameters Rework the final parameters to the standard template: aplnid (with its per-OS split), Dyalog_LineEditor_Mode, DYALOG_NOPOPUPS, EditorState, InitFullScriptNormal/Susp, PropertyExposeRoot/SE, XPLookAndFeel, and yy_window; and add the Ride restriction to RIDE_Init. Windows-only restrictions on DYALOG_NOPOPUPS and XPLookAndFeel. This completes the per-parameter template pass across all 147 parameters. Part of abrudz/documentation#719. --- .../docs/configuration-parameters/aplnid.md | 9 ++- .../dyalog-lineeditor-mode.md | 11 ++- .../dyalog-nopopups.md | 15 +++- .../configuration-parameters/editorstate.md | 4 +- .../initfullscriptnormal.md | 14 ++-- .../initfullscriptsusp.md | 14 ++-- .../propertyexposeroot.md | 13 +++- .../propertyexposese.md | 13 +++- .../configuration-parameters/ride-init.md | 5 +- .../configuration-parameters/xplookandfeel.md | 12 +++- .../configuration-parameters/yy-window.md | 70 ++----------------- 11 files changed, 89 insertions(+), 91 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplnid.md b/dyalog-configuration-guide/docs/configuration-parameters/aplnid.md index 5dae14b6e55..fcce58d8430 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplnid.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplnid.md @@ -1,7 +1,10 @@ # aplnid -Under Windows, this parameter specifies the *user number* that is used by the component file system to control file sharing and security. If you wish to share component files and/or external variables in a network it is essential that each user has a unique **aplnid** parameter. It may be any integer in the range 0 to 65535. Note that an **aplnid** value of 0 causes the user to bypass APL's access control matrix mechanism. +The *user number* used by the component file system to control file sharing and security. When a user creates a component file, their user number is recorded in the file to identify them as its owner. -Under UNIX, the *user number* is obtained from the Operating System (UID) and **aplnid** is not used. If the user is "root", APL's access control mechanism is ignored. +Valid values, and how the user number is obtained, depend on the operating system: -When a user creates a component file, his *user number* is recorded in the file to identify him as its owner. +- Microsoft Windows: **aplnid** is an integer from `0` to `65535`. To share component files or external variables across a network, each user must have a unique **aplnid**. A value of `0` causes the user to bypass APL's access-control-matrix mechanism. +- UNIX and macOS: the user number is obtained from the operating system (UID) and **aplnid** is not used. If the user is `root`, APL's access-control mechanism is ignored. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md index e52f6bf158f..2028d813238 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md @@ -1,5 +1,12 @@ # Dyalog_LineEditor_Mode -This Boolean parameter specifies whether or not multi-line input is enabled in the Session. +Whether multi-line input is enabled in the Session. -See also [Multiline Input](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) and [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input). +Valid values are: + +- `0` : multi-line input is disabled +- `1` : multi-line input is enabled + + + +See also [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input) and the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md index d1255543d96..227d5c8b487 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-nopopups.md @@ -1,4 +1,15 @@ # DYALOG_NOPOPUPS -This parameter specifies whether a MsgBox will appear (0, the default) or will not (1) when Dyalog APL terminates unexpectedly. This applies to APL on Windows only. See - [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors) for more information. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +Whether a message box appears when Dyalog terminates unexpectedly. + +Valid values are: + +- `0` : a message box appears +- `1` : no message box appears + +Default is `0`. + +For more information, see [Handling Unexpected Application Errors in Windows](../../../programming-reference-guide/error-trapping/handling-unexpected-errors). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/editorstate.md b/dyalog-configuration-guide/docs/configuration-parameters/editorstate.md index 910b4521f78..668aca7e93e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/editorstate.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/editorstate.md @@ -1,3 +1,5 @@ # EditorState -This is an internal parameter that remembers the state of the last edit window (normal or maximised). This is used to create the next edit window in the appropriate state. +An internal parameter that records the state (normal or maximised) of the last edit window, so that the next edit window is created in the same state. It is not intended to be set by the user. + + diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md index e010c4e978e..78d325f0150 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md @@ -1,14 +1,14 @@ # InitFullScriptNormal -When using the Editor to edit a script such as a Class or Namespace you can specify whether, when you Fix the script and Exit the Editor, just the functions in the script are re-fixed, or whether the whole script is re-executed, thereby re-initialising any Fields or variables defined within. +When the Editor is used to edit a script (such as a Class or Namespace) that is **not suspended**, this controls whether fixing the script and exiting the Editor re-fixes just the functions in the script, or re-executes the whole script (re-initialising any fields or variables defined within it). It determines the action associated with the `` (Esc) key; the other action remains available on the Editor File menu (and can be assigned to `` in the Keyboard Shortcuts tab). -These two actions always appear in the Editor File menu, but you can specify which is associated with the (Esc) key by selecting the appropriate option in the drop-downs labelled: +Valid values are: -- Exit and save changes (EP) in a suspended class or namespace should fix: -- If not suspended fix: +- `Only Functions` : only the functions in the script are re-fixed +- `Everything` : the whole script is re-executed -In both cases, you may select either *Only Functions* or *Everything*. + -The label for the corresponding items on the Editor File menu (see Editor (The File Menu, editing a script)) will change according to which behaviour applies. Note that if you specify a keystroke for in the *Keyboard Shortcuts* tab, this will be associated with the unselected action. +Related parameters: [InitFullScriptSusp](initfullscriptsusp.md). -See also [If not ...](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md index 83eee5c8cb8..f7f45ad956e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md @@ -1,14 +1,14 @@ # InitFullScriptSusp -When using the Editor to edit a script such as a Class or Namespace you can specify whether, when you Fix the script and Exit the Editor, just the functions in the script are re-fixed, or whether the whole script is re-executed, thereby re-initialising any Fields or variables defined within. +When the Editor is used to edit a script (such as a Class or Namespace) that is **suspended**, this controls whether fixing the script and exiting the Editor re-fixes just the functions in the script, or re-executes the whole script (re-initialising any fields or variables defined within it). It determines the action associated with the `` (Esc) key; the other action remains available on the Editor File menu (and can be assigned to `` in the Keyboard Shortcuts tab). -These two actions always appear in the Editor File menu, but you can specify which is associated with the (Esc) key by selecting the appropriate option in the drop-downs labelled: +Valid values are: -- Exit and save changes (EP) in a suspended class or namespace should fix: -- If not suspended fix: +- `Only Functions` : only the functions in the script are re-fixed +- `Everything` : the whole script is re-executed -In both cases, you may select either *Only Functions* or *Everything*. + -The label for the corresponding items on the Editor File menu (see Editor (The File Menu, editing a script)) will change according to which behaviour applies. Note that if you specify a keystroke for in the *Keyboard Shortcuts* tab, this will be associated with the unselected action. +Related parameters: [InitFullScriptNormal](initfullscriptnormal.md). -See also [Exit and fix ...](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md index db9d8d45ce0..b2324e703de 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md @@ -1,5 +1,14 @@ # PropertyExposeRoot -Each workspace contains a flag that specifies whether or not the names of Properties, Methods and Events of the Root object are exposed. If set, you may query/set the Properties of Root and invoke the Root Methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in your workspace. This parameter determines the default value of the flag in a `CLEAR WS`. +The default value, in a clear workspace, of the flag that specifies whether the names of the properties, methods, and events of the Root object are exposed. When set, the properties of Root can be queried and set, and its methods invoked, as if they were variables and functions, so those names cannot also be used for global variables in the workspace. -See also [Expose properties of Root](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). +Valid values are: + +- `0` : the names are not exposed +- `1` : the names are exposed + + + +Related parameters: [PropertyExposeSE](propertyexposese.md), [Default_WX](default-wx.md). + +See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md index 1ecea1b20a5..183be9b35a8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md @@ -1,5 +1,14 @@ # PropertyExposeSE -Each workspace contains a flag that specifies whether or the names of Properties, Methods and Events of the Session object are exposed. If set, you may query/set the Properties of `⎕SE` and invoke `⎕SE` Methods directly as if they were variables and functions respectively. As a consequence, these names may not be used for global variables in the `⎕SE` namespace. This parameter determines the default value of the flag in a `CLEAR WS`. +The default value, in a clear workspace, of the flag that specifies whether the names of the properties, methods, and events of the Session object (`⎕SE`) are exposed. When set, the properties of `⎕SE` can be queried and set, and its methods invoked, as if they were variables and functions, so those names cannot also be used for global variables in the `⎕SE` namespace. -See also [Expose properties of Session Namespace](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md). +Valid values are: + +- `0` : the names are not exposed +- `1` : the names are exposed + + + +Related parameters: [PropertyExposeRoot](propertyexposeroot.md). + +See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/ride-init.md b/dyalog-configuration-guide/docs/configuration-parameters/ride-init.md index 3cd3eab473f..eb5f17a796f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/ride-init.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/ride-init.md @@ -2,7 +2,10 @@ This parameter determines how the interpreter should behave with respect to the Ride protocol. Setting this configuration parameter on the machine that hosts the interpreter enables the interpreter-Ride connection. -RIDE_Init can only be used to specify a limited number of Ride configuration options; the rest must be specified in a Ride ini file. Full details describing how to configure Ride, including using certificates to authenticate connections can be found in the [Ride User Guide](https://dyalog.github.io/ride). +RIDE_Init can only be used to specify a limited number of Ride configuration options; the rest must be specified in a Ride ini file. + +!!! Info "Information" + This configuration parameter is only relevant when using Ride. Full details describing how to configure Ride, including using certificates to authenticate connections can be found in the [Ride User Guide](https://dyalog.github.io/ride). The format of the value is: ``` diff --git a/dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md b/dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md index 370dba90585..f9b50380d3c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/xplookandfeel.md @@ -1,3 +1,13 @@ # XPLookAndFeel -This Boolean parameter specifies whether or not *Native Look and Feel* is used. This affects the appearance of user-interface controls such as Buttons. The default is 1. +!!! Info "Information" + This configuration parameter is only relevant on the Microsoft Windows operating system. + +Whether *Native Look and Feel* is used, affecting the appearance of user-interface controls such as buttons. + +Valid values are: + +- `0` : Native Look and Feel is not used +- `1` : Native Look and Feel is used + +Default is `1`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/yy-window.md b/dyalog-configuration-guide/docs/configuration-parameters/yy-window.md index ad771b11832..6f310e47d23 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/yy-window.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/yy-window.md @@ -1,69 +1,13 @@ # yy_window -This parameter defines how Dyalog APL is to interpret a 2-digit year number. If **yy_window** is not set (the default) then under Windows, Version 13.2 onwards will adhere to the rules specified in the Windows Region and Language 2-digit year settings. +How Dyalog interprets a 2-digit year number (for `⎕SM` and GUI edit fields that use a 2-digit year format such as `MM/DD/YY`). It has no effect on applications that use a 4-digit year format. The value defines a *date window*, either fixed or sliding. -Dyalog allows a choice of input date formats for `⎕SM` and GUI edit fields. If you have chosen a 2-digit year format such as MM/DD/YY, then an input of 02/01/00 will by default be interpreted as 1stFebruary 1900 - not 1stFebruary 2000. +Valid values are: -If your application uses a 4-digit year format such as YYYY-MM-DD, the problem will not arise. +- a 4-digit year : a **fixed** window whose earliest acceptable year is that value (for example `1970` maps 2-digit input to `1970`-`2069`) +- a 1- or 2-digit year, typically negative : a **sliding** window whose oldest acceptable year is that many years before the current year (for example `-30` in 1999 maps input to `1969`-`2068`) +- two values separated by a comma : the lower and upper limits of the window (each independently fixed (4-digit) or sliding (1- or 2-digit)); a 2-digit year that does not convert into the range signals a `DOMAIN ERROR`. If only the first is given, the second defaults to the first plus 99. -You can use the **yy_window** parameter to cause your application to interpret 2-digit dates in as required without changing any APL code. +Default is unset: on Microsoft Windows, Dyalog then follows the Region and Language 2-digit year settings. -## Sliding versus Fixed Window - -Two schemes are in common use within the industry: Sliding or Fixed date windows. - -Use a Fixed window if there is a *specific year* , for example 1970, before which, dates are meaningless to your application. Note that with a fixed window, this date (say 1970) will still be the limit if your application is running in a hundred years' time. - -Use a Sliding window if there is a *time period* , for example 30 years, before which dates are considered too old for your application. With a sliding window, you will always be able to enter dates up to (say) 30 years old, but after a while, specific years in the past (for example 1970) will become inaccessible. - -## Setting a Fixed Window - -To make a fixed window, set parameter **yy_window** to the 4-DIGIT year which is the earliest acceptable date. For example: - -YY_WINDOW=1970 - -This will cause the interpreter to convert any 2-digit input date into a year in the range 1970, 1971 ... 2069 - -## Setting a Sliding Window - -To make a sliding window, set parameter **yy_window** to the 1- or 2-DIGIT year which determines the oldest acceptable date. This will typically be negative. - -YY_WINDOW=-30 - -Conversion of dates now depends on the current year: - -If the current year is 1999, the earliest accepted date is 1999-30 = 1969. - -This will cause the interpreter to convert any 2-digit input date into a year in the range 1969, 1970 ... 2068. - -However if your application is still running in the year 2010, the earliest accepted date then will be 2010-30 = 1980. So in the year 2010, a 2-digit year will be interpreted in the range 1980, 1981 ... 2079. - -## Advanced Settings - -You can further restrict date windows by setting an upper as well as lower year limit. - -YY_WINDOW=1970,1999 - -This causes 2-digit years to be converted only into the range 1970, 1971 ... 1999. Any 2-digit year (for example, 54) not convertible to a year in this range will cause a `DOMAIN ERROR` . - -The sliding window equivalent is: - -YY_WINDOW=-10,10 - -This would establish a valid date window, ten years either side of the current year. For example, if the current year is 1998, the valid range would be (1998-10) – (1998+10), in other words: 1988, 1989, `→` 2008. - -One way of looking at the **yy_window** variable is that it specifies a 2-element vector. If you supply only the first element, the second one defaults to the first element + 99. - -Note that the system uses only the number of digits in the year specification to determine whether it refers to a fixed (4-digits) or sliding (1-, or 2-digits) window. In fact you can have a fixed lower limit and a sliding upper limit, or vice versa. - -YY_WINDOW=1990,10 - -Allows dates as early as 1990, but not more than 10 years hence. - -YY_WINDOW=0,1999 - -Allows dates from the current year to the end of the century. - -If the second date is before, or more than 99 years after the first date, then any date conversion will result in a `DOMAIN ERROR` . This might be useful in an application where the end-user has control over the input date format and you want to disallow any 2-digit date input. - -YY_WINDOW=1,0 +The number of digits in each value determines whether it is a fixed (4-digit) or sliding (1- or 2-digit) limit, so a window can mix the two, for example `YY_WINDOW=1990,10` allows dates from `1990` to at most 10 years hence. From f47c9148f80833e8c819ac9fcebf4ef64b0cf26d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 11:03:19 +0100 Subject: [PATCH 18/37] Rewrite Configuration Parameters landing page cross-platform Replace the Windows-specific intro (precedence list and Registry-editing instructions, now covered by Introduction and How to Set Configuration Parameters) with a concise section overview: what a parameter page contains, a pointer to the by-category listing and to How to Set, and the size-unit syntax as a table. Refs Dyalog/documentation#719 --- .../configuration-parameters.md | 47 +++++++------------ 1 file changed, 16 insertions(+), 31 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md index 89f7f73d330..11cdc28a476 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters.md @@ -1,41 +1,26 @@ # Configuration Parameters -## Introduction +This section documents each Dyalog configuration parameter on its own page. A parameter page states what the parameter does, its valid values, its default (noting any difference between operating systems), and related parameters. -Dyalog APL is customised using a set of **configuration parameters**. These may be defined in a number of ways, which take precedence as follows: +The parameters are listed alphabetically in the navigation pane. For a subject-based overview, see [Configuration Parameters by Category](configuration-parameters-by-category.md). -- Command-line settings -- Application configuration file settings -- Environment variable settings -- User configuration file settings -- Settings in the registry section defined by the **IniFile** parameter (Windows only) -- Built-in defaults +For how to give a parameter a value – on the command line, in a configuration file, as an environment variable, or in the Windows Registry – and for the order of precedence when a parameter is set in more than one place, see [How to Set Configuration Parameters](../how-to-set/overview.md). -This scheme provides a great deal of flexibility, and a system whereby you can override one setting with another. For example, you can define your normal workspace size (*maxws*) in the Registry, but override it with a new value specified on the APL command line. The way this is done is described in the following section. +You are not limited to the parameters used by Dyalog itself; you can also define parameters of your own. -Furthermore, you are not limited to the set of parameters employed by APL itself as you may add parameters of your own choosing. +## Specifying size-related parameters -Although for clarity parameter names are given here in mixed case, they are case-independent under Windows. Under UNIX and Linux, if Dyalog parameters are specified as environment variables they must be named entirely in upper-case. +Several configuration parameters define a size, such as [maxws](maxws.md) or [log_size](log-size.md). -Note that the value of a parameter obtained by the GetEnvironment method (see [GetEnvironment](../../../object-reference/methodorevents/getenvironment)) uses exactly the same set of rules. +The value of such a parameter is an integer, optionally followed immediately by a single character that denotes the units: -The following section details those parameters that are implemented by Registry Values in the top-level folder identified by **IniFile**. Values that are implemented in sub-folders are *mainly* internal and are not described in detail here. However, any Value that is maintained via a configuration dialog box will be named and described in the documentation for that dialog box in The APL Environment. +| Character | Units | +|-----------|-------| +| `K` | KiB | +| `M` | MiB | +| `G` | GiB | +| `T` | TiB | +| `P` | PiB | +| `E` | EiB | -## Specifying Size-related Parameters - -Several of the configuration parameters define sizes. - -The value of the parameter must consist of an integer value, optionally followed immediately by a single character which denotes the units to be used. If the value contains no character the units are assumed to be KiB. - -Valid values for units are: - -K(KiB), M(MiB), G(GiB), T(TiB), P(PiB) and E(EiB). - -Specifying an invalid value will prevent Dyalog APL from starting. - -## Changing parameter values in the Registry - -You can change parameters in the Registry in one of two ways: - -- Using the Configuration dialog box that is obtained by selecting *Configure* from the *Options* menu on the Dyalog APL/W session. See ["The Configuration Dialog Box"](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) for details. -- By directly editing the Windows Registry using `REGEDIT.EXE` or `REGEDIT32.EXE`. This is necessary for parameters that are not editable via the Configuration dialog box. +If no character is given, the units are assumed to be KiB. Specifying an invalid value prevents Dyalog from starting. From a9794b696c074a7e740b3f8c035a430de3b4b4b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 11:03:20 +0100 Subject: [PATCH 19/37] Add Configuration Parameters by Category listing Add a by-category page modelled on system-functions-by-category, grouping all 147 configuration parameters into 18 subject categories with a one-line description and a link to each parameter's page, and register it in the guide navigation after the Introduction. Refs Dyalog/documentation#719 --- .../configuration-parameters-by-category.md | 278 ++++++++++++++++++ dyalog-configuration-guide/mkdocs.yml | 1 + 2 files changed, 279 insertions(+) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md new file mode 100644 index 00000000000..1c4e3c9b224 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md @@ -0,0 +1,278 @@ +--- +search: + exclude: true +--- +# Configuration Parameters (by Category) + +The following tables list the configuration parameters grouped by subject. Each parameter is described in full on its own page; the parameters are also listed alphabetically in the navigation pane. + +## Session log and input buffers + +These control the Session log and the buffers that hold input and function-key definitions. + +|Name|Description| +|----|-----------| +|[`Log_File`](log-file.md)|The path (absolute, or relative to the working directory) and name of the Session log file| +|[`Log_File_InUse`](log-file-inuse.md)|Whether the Session log is saved to the Session log file and reloaded the next time a Session is started| +|[`Log_Size`](log-size.md)|The size of the Session log buffer| +|[`Session_File`](session-file.md)|The name of the file from which the Session (`⎕SE`) is loaded when Dyalog starts| +|[`History_Size`](history-size.md)|The size of the buffer used to store previously entered (input) lines in the Session| +|[`Input_Size`](input-size.md)|The size of the buffer used to store marked lines (lines awaiting execution) in the Session| +|[`PFKey_Size`](pfkey-size.md)|The size of the buffer used to store programmable function key definitions (see Program Function Key (`⎕PFKEY`))| +|[`Confirm_Session_Delete`](confirm-session-delete.md)|Whether you are prompted for confirmation when you delete lines from the Session log| + +## Session appearance and behaviour + +These control how the Session window looks and behaves. + +|Name|Description| +|----|-----------| +|[`APLAN_FOR_OUTPUT`](aplan-for-output.md)|Whether Session output uses array notation when possible| +|[`DYALOG_GUTTER_ENABLE`](dyalog-gutter-enable.md)|Whether a gutter is displayed in the left-most column of the Session window| +|[`URLHighlight`](urlhighlight.md)|Whether URLs and links are highlighted in Session and Edit windows| +|[`StatusOnEdit`](statusonedit.md)|Whether a status bar is displayed along the bottom of individual Edit windows| +|[`ToolBarsOnEdit`](toolbarsonedit.md)|Whether tool bars are displayed along the top of individual Edit windows| +|[`AutoDPI`](autodpi.md)|Whether Dyalog registers the application as DPI-aware when it initialises, and so performs auto-scaling itself| +|[`Dyalog_Pixel_Type`](dyalog-pixel-type.md)|How the value `'Pixel'` of the `Coord` property is interpreted| +|[`ClassicMode`](classicmode.md)|Whether the Session operates in *Dyalog Classic mode*, in which the Editor and Tracer behave as they did in earlier versions of Dyalog| +|[`ClassicModeSavePosition`](classicmodesaveposition.md)|Whether the current size and location of the first editor and tracer windows are remembered for next time (saved in the Registry sub-folders `WindowRects/EditWindow` and `WindowRects/TraceWindow`)| +|[`SessionOnTop`](sessionontop.md)|Whether the Session can appear on top of Edit and Trace windows in Classic Dyalog mode| +|[`Dyalog_LineEditor_Mode`](dyalog-lineeditor-mode.md)|Whether multi-line input is enabled in the Session| +|[`DYALOG_NOPOPUPS`](dyalog-nopopups.md)|Whether a message box appears when Dyalog terminates unexpectedly| +|[`XPLookAndFeel`](xplookandfeel.md)|Whether *Native Look and Feel* is used, affecting the appearance of user-interface controls such as buttons| +|[`ShowStatusOnError`](showstatusonerror.md)|Whether the Status window is displayed automatically, when required, when Dyalog attempts to write output to it| + +## Workspace defaults + +These set the values that system variables and related flags take in a clear workspace. + +|Name|Description| +|----|-----------| +|[`Default_DIV`](default-div.md)|The value of `⎕DIV` in a clear workspace| +|[`Default_IO`](default-io.md)|The value of `⎕IO` in a clear workspace| +|[`Default_ML`](default-ml.md)|The value of `⎕ML` (migration level) in a clear workspace| +|[`Default_PP`](default-pp.md)|The value of `⎕PP` (print precision) in a clear workspace| +|[`Default_PW`](default-pw.md)|The value of `⎕PW` in a clear workspace| +|[`Default_RTL`](default-rtl.md)|The value of `⎕RTL` (response time limit) in a clear workspace| +|[`Default_WX`](default-wx.md)|The value of `⎕WX` in a clear workspace| +|[`Auto_PW`](auto-pw.md)|Whether the value of `⎕PW` is derived automatically from the current width of the Session (Windows) or terminal (UNIX and macOS) window| +|[`PropertyExposeRoot`](propertyexposeroot.md)|The default value, in a clear workspace, of the flag that specifies whether the names of the properties, methods, and events of the Root object are exposed| +|[`PropertyExposeSE`](propertyexposese.md)|The default value, in a clear workspace, of the flag that specifies whether the names of the properties, methods, and events of the Session object (`⎕SE`) are exposed| + +## Editor + +These control the behaviour of the Editor. + +|Name|Description| +|----|-----------| +|[`Confirm_Abort`](confirm-abort.md)|Whether you are prompted for confirmation when you abort an edit session after making changes to the object being edited| +|[`Confirm_Close`](confirm-close.md)|Whether you are prompted for confirmation when you close an edit window after making changes to the object being edited| +|[`Confirm_Fix`](confirm-fix.md)|Whether you are prompted for confirmation when you fix an object in the workspace after making changes in the editor| +|[`AutoFormat`](autoformat.md)|Whether Control Structures are formatted automatically when a function is opened for editing or converted to text by `⎕CR`, `⎕NR`, or `⎕VR`| +|[`AutoIndent`](autoindent.md)|Whether semi-automatic indentation is applied during editing, so that a new line in a function is indented by the same amount as the previous line| +|[`TabStops`](tabstops.md)|The number of spaces inserted by pressing the Tab key in the editor| +|[`DockableEditWindows`](dockableeditwindows.md)|Whether individual edit windows can be undocked from (and docked back into) the MDI Editor window| +|[`DoubleClickEdit`](doubleclickedit.md)|Whether double-clicking over a name invokes the editor| +|[`WrapSearch`](wrapsearch.md)|Whether Search/Replace in the editor stops at the top or bottom of the text (according to the direction of the search), or continues from the other end| +|[`WrapSearchMsgBox`](wrapsearchmsgbox.md)|Whether a message box is displayed to inform you when a wrapped search passes the start or end of the text| +|[`DYALOG_DISCARD_FN_SOURCE`](dyalog-discard-fn-source.md)|Whether source code is discarded when a function or operator is fixed by the editor or by `⎕FIX`| +|[`APLAN_FOR_EDITOR`](aplan-for-editor.md)|Whether new **Edit** windows containing arrays open using array notation when possible| +|[`InitFullScriptNormal`](initfullscriptnormal.md)|When the Editor is used to edit a script (such as a Class or Namespace) that is **not suspended**, this controls whether fixing the script and exiting the Editor re-fixes just the functions in the script, or re-executes the whole script (re-initialising any fields or variables defined within it)| +|[`InitFullScriptSusp`](initfullscriptsusp.md)|When the Editor is used to edit a script (such as a Class or Namespace) that is **suspended**, this controls whether fixing the script and exiting the Editor re-fixes just the functions in the script, or re-executes the whole script (re-initialising any fields or variables defined within it)| +|[`EditorState`](editorstate.md)|An internal parameter that records the state (normal or maximised) of the last edit window, so that the next edit window is created in the same state| + +## Tracer + +These control the behaviour of the Tracer. + +|Name|Description| +|----|-----------| +|[`AddClassHeaders`](addclassheaders.md)|What the Tracer displays when tracing the execution of a function defined in a script| +|[`Trace_On_Error`](trace-on-error.md)|Whether the Tracer is deployed automatically when execution of a defined function halts with an untrapped error| +|[`Trace_Level_Warn`](trace-level-warn.md)|The maximum number of Trace windows displayed when an error occurs and `Trace_On_Error` is `1`| +|[`SingleTrace`](singletrace.md)|Whether there is a single Trace window or one Trace window per function| +|[`SkipLines`](skiplines.md)|Causes the Tracer to skip lines that contain no executable statement, with the exception of the first line of the function and, in a traditional function (not a dfn), the last line if it is a comment| +|[`TraceStopMonitor`](tracestopmonitor.md)|Which of the `⎕TRACE`, `⎕STOP`, and `⎕MONITOR` columns are displayed in Trace and Edit windows| + +## Edit, Trace, and SM window geometry + +These set the initial size, position, and staggering of Edit, Trace, and stand-alone `⎕SM` windows in Dyalog Classic mode. + +|Name|Description| +|----|-----------| +|[`Edit_Cols`](edit-cols.md)|The initial width of an edit window, in character units| +|[`Edit_Rows`](edit-rows.md)|The initial height of an edit window, in character units| +|[`Edit_First_X`](edit-first-x.md)|The initial horizontal position, in character units, of the first edit window; subsequent edit windows are staggered from it| +|[`Edit_First_Y`](edit-first-y.md)|The initial vertical position, in character units, of the first edit window; subsequent edit windows are staggered from it| +|[`Edit_Offset_X`](edit-offset-x.md)|The number of characters by which an edit window is staggered horizontally from the previous one| +|[`Edit_Offset_Y`](edit-offset-y.md)|The number of characters by which an edit window is staggered vertically from the previous one| +|[`Trace_First_X`](trace-first-x.md)|The initial horizontal position, in character units, of the first Trace window; subsequent Trace windows are staggered from it| +|[`Trace_First_Y`](trace-first-y.md)|The initial vertical position, in character units, of the first Trace window; subsequent Trace windows are staggered from it| +|[`Trace_Offset_X`](trace-offset-x.md)|The number of characters by which a Trace window is staggered horizontally from the previous one| +|[`Trace_Offset_Y`](trace-offset-y.md)|The number of characters by which a Trace window is staggered vertically from the previous one| +|[`SM_Cols`](sm-cols.md)|The width, in characters, of the window used to display `⎕SM` when it is used stand-alone| +|[`SM_Rows`](sm-rows.md)|The height, in characters, of the window used to display `⎕SM` when it is used stand-alone| + +## AutoComplete + +These control the AutoComplete suggestion box. + +|Name|Description| +|----|-----------| +|[`AutoComplete/Enabled`](autocomplete/enabled.md)|Whether AutoComplete is enabled| +|[`AutoComplete/PrefixSize`](autocomplete/prefixsize.md)|The threshold, in number of characters entered, before AutoComplete begins to display suggestions| +|[`AutoComplete/History`](autocomplete/history.md)|Whether AutoComplete maintains a list of previous auto-completions| +|[`AutoComplete/HistorySize`](autocomplete/historysize.md)|The number of previous auto-completions kept when `AutoComplete/History` is `1`| +|[`AutoComplete/ShowFiles`](autocomplete/showfiles.md)|Whether AutoComplete suggests directory and file names for the `)LOAD`, `)COPY`, and `)DROP` system commands| +|[`AutoComplete/Cols`](autocomplete/cols.md)|The maximum number of columns (width) in the AutoComplete pop-up suggestion box| +|[`AutoComplete/Rows`](autocomplete/rows.md)|The maximum number of rows (height) in the AutoComplete pop-up suggestion box| +|[`AutoComplete/CancelKey1`](autocomplete/cancelkey1.md)|The first of two possible keys that cancel (hide) the AutoComplete suggestion box| +|[`AutoComplete/CancelKey2`](autocomplete/cancelkey2.md)|The second of two possible keys that cancel (hide) the AutoComplete suggestion box| +|[`AutoComplete/CommonKey1`](autocomplete/commonkey1.md)|The key that auto-completes the *common prefix*: the longest string of leading characters of the currently selected name that is shared by at least one other name in the AutoComplete suggestion box| +|[`AutoComplete/CompleteKey1`](autocomplete/completekey1.md)|The first of two possible keys that select the current option from the AutoComplete suggestion box| +|[`AutoComplete/CompleteKey2`](autocomplete/completekey2.md)|The second of two possible keys that select the current option from the AutoComplete suggestion box| + +## Value Tips + +These control the Value Tips shown when the mouse hovers over a name. + +|Name|Description| +|----|-----------| +|[`ValueTips/Enabled`](valuetips/enabled.md)|Whether Value Tips are enabled| +|[`ValueTips/Delay`](valuetips/delay.md)|The delay, in milliseconds, before a Value Tip is displayed when the mouse hovers over a name| +|[`ValueTips/ColourScheme`](valuetips/colourscheme.md)|The colour scheme used to display a Value Tip when the mouse hovers over a name| + +## Keyboard and input + +These control keyboard layouts, translate tables, and how keystrokes are interpreted. + +|Name|Description| +|----|-----------| +|[`APLK`](aplk.md)|The name of the Input Translate Table, which defines the keyboard layout| +|[`APLKeys`](aplkeys.md)|A search path for the Input Translate Table, useful when configuring a run-time application| +|[`APLT`](aplt.md)|The name of the Output Translate Table| +|[`APLTrans`](apltrans.md)|A search path for the Output Translate Table, useful when configuring a run-time application| +|[`InitialKeyboardLayout`](initialkeyboardlayout.md)|The name of the keyboard to be selected on start-up| +|[`InitialKeyboardLayoutInUse`](initialkeyboardlayoutinuse.md)|Whether the keyboard given by `InitialKeyboardLayout` is selected as the current keyboard layout when an APL Session starts| +|[`InitialKeyboardLayoutShowAll`](initialkeyboardlayoutshowall.md)|Whether all installed keyboards are listed in the choice of keyboards on the Unicode Input tab of the Configuration dialog| +|[`OverstrikesPopup`](overstrikespopup.md)|Whether the Overstrikes popup is enabled| +|[`ResolveOverstrikes`](resolveoverstrikes.md)|Whether an APL composite symbol can be entered using overstrikes| +|[`UseXCV`](usexcv.md)|How the common copy (Ctrl+C), cut (Ctrl+X), and paste (Ctrl+V) keystrokes are processed| +|[`UnicodeToClipboard`](unicodetoclipboard.md)|Whether text transferred to and from the Windows clipboard is treated as Unicode text| +|[`KeyboardInputDelay`](keyboardinputdelay.md)|The delay, in milliseconds, before the system reacts to a keystroke by updating the name of the Current Object in the Session status bar (see The Current Object) and offering a list of names for auto-completion (see the Auto Complete tab)| +|[`WantsSpecialKeys`](wantsspecialkeys.md)|A list of applications (for example, `putty.exe`) that use the command strings in the Input Translate Tables| +|[`mapchars`](mapchars.md)|The mapping between `⎕AV` and the font must be strictly one-to-one| + +## Start-up and workspace loading + +These control what is loaded and run when Dyalog starts, and where workspaces are found. + +|Name|Description| +|----|-----------| +|[`Load`](load.md)|The name of a workspace, or of a directory or text file containing APL source code, to be loaded when Dyalog starts| +|[`LX`](lx.md)|An expression to be executed after Dyalog has started and loaded a workspace or a text file of APL source code (see `Load`)| +|[`MaxWS`](maxws.md)|The amount of memory allocated to the workspace at start-up| +|[`WSPath`](wspath.md)|The workspace search path: a list of directories searched, in order, when you `)LOAD` or `)COPY` a workspace, or start an Auxiliary Processor, without giving an explicit path| +|[`WSEXT`](wsext.md)|Workspace filename extensions| +|[`ConfigFile`](configfile.md)|The name of the application configuration file| +|[`UserConfigFile`](userconfigfile.md)|The name of the user configuration file| +|[`IniFile`](inifile.md)|The name of the Windows Registry folder that holds the configuration parameters| +|[`DyalogStartup`](dyalogstartup.md)|The name of a file containing APL code to be run each time Dyalog starts| +|[`DyalogStartupSE`](dyalogstartupse.md)|One or more *Session initialisation* directories containing APL code to be installed in `⎕SE`| +|[`DyalogStartup_X`](dyalogstartup-x.md)|During Session initialisation, code is loaded from the directories given by `DyalogStartupSE` into a corresponding namespace tree in `⎕SE`, and is then optionally executed| + +## Interpreter and runtime + +These control aspects of the running interpreter. + +|Name|Description| +|----|-----------| +|[`qcmd_timeout`](qcmd-timeout.md)|The length of time, in milliseconds, that Dyalog waits for the execution of a Windows command to start| +|[`Dyalog_NETCore`](dyalog-netcore.md)|Whether the .NET interface is used in preference to the .NET Framework interface| +|[`Enable_CEF`](enable-cef.md)|Whether the Chromium Embedded Framework (CEF) is enabled| +|[`APL_MAX_THREADS`](apl-max-threads.md)|The maximum number of system threads used for parallel execution| +|[`CMD_PREFIX and CMD_POSTFIX`](cmd-prefix-and-cmd-postfix.md)|Strings within which operating-system commands given as the arguments to `⎕CMD`, `⎕SH`, `)CMD`, and `)SH` are wrapped, so that the command arguments run under a non-standard command shell| +|[`Serial`](serial.md)|Your Dyalog serial number| +|[`DYALOG_SERIAL`](dyalog-serial.md)|Your Dyalog serial number| + +## Shutting down + +These control what is saved when Dyalog terminates, and running as a service. + +|Name|Description| +|----|-----------| +|[`SaveContinueOnExit`](savecontinueonexit.md)|Whether the current workspace is saved as `CONTINUE.DWS` before Dyalog terminates| +|[`SaveSessionOnExit`](savesessiononexit.md)|Whether the current Session is saved in the Session file before Dyalog terminates| +|[`SaveLogOnExit`](savelogonexit.md)|Whether the Session log is saved before Dyalog terminates| +|[`RunAsService`](runasservice.md)|Whether Dyalog runs as a service: it does not prompt for confirmation when the user logs off, and the interpreter continues to run across the logoff/logon process| + +## Installation locations, help, and URLs + +These give the locations of Dyalog components and of help and web resources. + +|Name|Description| +|----|-----------| +|[`Dyalog`](dyalog.md)|The directory in which Dyalog is installed| +|[`localdyalogdir`](localdyalogdir.md)|The directory in which Dyalog is installed on the client, in a client/server installation| +|[`DyalogInstallDir`](dyaloginstalldir.md)|The full pathname of the directory in which Dyalog is installed| +|[`ProgramFolder`](programfolder.md)|The folder in which the Dyalog program icons are installed| +|[`DyalogLink`](dyaloglink.md)|The directory containing the code for Link| +|[`DyalogHelpDir`](dyaloghelpdir.md)|The location of the HTML-based help used when help is requested from the Session (from the Help menu or by pressing `F1`)| +|[`DyalogWebSite`](dyalogwebsite.md)|The URL of the Dyalog web site| +|[`DyalogEmailAddress`](dyalogemailaddress.md)|The contact email address for Dyalog Ltd| +|[`ExternalHelpURL`](externalhelpurl.md)|The URL used when `UseExternalHelpURL` is `1` and Dyalog displays help for external objects (such as .NET types) through the Microsoft Document Explorer and online help (for example from Visual Studio)| +|[`UseExternalHelpURL`](useexternalhelpurl.md)|Whether Dyalog uses the Microsoft Document Explorer and online help to display help for external objects, such as .NET types| + +## Component files and interoperability + +These control component-file defaults and the interoperability of code and data across versions. + +|Name|Description| +|----|-----------| +|[`APL_FCREATE_PROPS_C`](apl-fcreate-props-c.md)|The default checksum level for newly-created component files| +|[`APL_FCREATE_PROPS_J`](apl-fcreate-props-j.md)|The default journaling level for newly-created component files| +|[`APL_FAST_FCHK`](apl-fast-fchk.md)|Whether `⎕FCHK` is optimised so that it can reliably determine that a component file was properly untied and so need not be checked (this can be overridden with the `⎕FCHK` `force` option)| +|[`CFEXT`](cfext.md)|Component file filename extensions, determining the file search order when a component file is tied| +|[`APL_CODE_E_MAGNITUDE`](apl-code-e-magnitude.md)|The magnitude at or above which numbers in function bodies are descanned (written out as their character representation, for example by `⎕CR`) in exponential format| +|[`APL_COMPLEX_AS_V12`](apl-complex-as-v12.md)|Whether code developed with Version 12.1 or earlier keeps its original behaviour with respect to complex numbers| +|[`File_Stack_Size`](file-stack-size.md)|The number of most-recently-used workspaces displayed in the Session File menu| +|[`aplnid`](aplnid.md)|The *user number* used by the component file system to control file sharing and security| + +## Errors and diagnostics + +These control aplcore files, error reporting, and event logging. + +|Name|Description| +|----|-----------| +|[`AplCoreName`](aplcorename.md)|The directory and name of the file in which an *aplcore* is saved| +|[`MaxAplCores`](maxaplcores.md)|The maximum number of *aplcore* files retained| +|[`APL_TextInAplCore`](apl-textinaplcore.md)|Whether certain information is written to an *aplcore* file when a system error occurs| +|[`DMXOutputOnError`](dmxoutputonerror.md)|Which windows `⎕DMX` error messages are displayed in| +|[`PassExceptionsToOpSys`](passexceptionstoopsys.md)|The default state of the *Pass Exception* check box in the System Error dialog box| +|[`ErrorOnExternalException`](erroronexternalexception.md)|The behaviour when a system exception occurs in a call on an external DLL or shared library| +|[`DYALOG_EVENTLOGGINGLEVEL`](dyalog-eventlogginglevel.md)|Whether a log entry is written to the Windows Event Log when Dyalog would otherwise pop up a message box because of an unexpected termination| +|[`DYALOG_EVENTLOGNAME`](dyalog-eventlogname.md)|The name of the Windows Event Log to which an event message is written (or the source of the event message, depending on the Registry entries defined) when Dyalog would otherwise pop up a message box because of an unexpected termination| + +## Ride + +These control the interpreter's use of the Ride protocol. + +|Name|Description| +|----|-----------| +|[`RIDE_Init`](ride-init.md)|This parameter determines how the interpreter should behave with respect to the Ride protocol| +|[`Ride_Spawned`](ride-spawned.md)|Whether `⎕SR` and `)SH` are disabled| + +## User commands + +These control the user-command framework. + +|Name|Description| +|----|-----------| +|[`UCMDCacheFile`](ucmdcachefile.md)|The name of the User Command cache file| + +## Miscellaneous + +|Name|Description| +|----|-----------| +|[`Greet_Bitmap`](greet-bitmap.md)|The filename of a bitmap displayed during initialisation of the Dyalog application, typically to show a product logo from a run-time application| +|[`yy_window`](yy-window.md)|How Dyalog interprets a 2-digit year number (for `⎕SM` and GUI edit fields that use a 2-digit year format such as `MM/DD/YY`)| diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml index 219bfe4aff5..9c56f7c031b 100644 --- a/dyalog-configuration-guide/mkdocs.yml +++ b/dyalog-configuration-guide/mkdocs.yml @@ -66,6 +66,7 @@ nav: - Configuration File Structure: how-to-set/configuration-file-structure.md - Configuration Parameters: - Introduction: configuration-parameters/configuration-parameters.md + - By Category: configuration-parameters/configuration-parameters-by-category.md - AddClassHeaders: configuration-parameters/addclassheaders.md - APLAN_FOR_EDITOR: configuration-parameters/aplan-for-editor.md - APLAN_FOR_OUTPUT: configuration-parameters/aplan-for-output.md From f805961e454463f8e56b35d9fe50714b90139996 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 12:08:39 +0100 Subject: [PATCH 20/37] Clean up the How to Set parameter lists Do not run the source lists on as a single sentence: drop the trailing semicolons and full stop in the Overview list, and drop the "settings, which override" connectives and final full stop in the Order of Precedence list. The lead-in line already states that each source overrides those below it. Refs Dyalog/documentation#719 --- .../docs/how-to-set/order-of-precedence.md | 12 ++++++------ .../docs/how-to-set/overview.md | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md b/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md index 3c5d233e7c2..a9e35fac0cf 100644 --- a/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md +++ b/dyalog-configuration-guide/docs/how-to-set/order-of-precedence.md @@ -2,12 +2,12 @@ When a configuration parameter is set in more than one place, Dyalog applies the following order of precedence. Each source overrides those below it: -1. [Command line](command-line.md) settings, which override -2. [Application configuration file](application-configuration-files.md) settings, which override -3. [Environment variable](environment-variables.md) settings, which override -4. [User configuration file](user-configuration-files.md) settings, which override -5. [Windows Registry](registry.md) settings (Microsoft Windows only), which override -6. [Built-in defaults](built-in-defaults.md). +1. [Command line](command-line.md) +2. [Application configuration file](application-configuration-files.md) +3. [Environment variable](environment-variables.md) +4. [User configuration file](user-configuration-files.md) +5. [Windows Registry](registry.md) (Microsoft Windows only) +6. [Built-in defaults](built-in-defaults.md) !!! Info "Information" The Registry step applies to Microsoft Windows only. On UNIX and macOS there is no Registry, so a user configuration file setting is overridden only by the sources above it. diff --git a/dyalog-configuration-guide/docs/how-to-set/overview.md b/dyalog-configuration-guide/docs/how-to-set/overview.md index 4136fe76122..f8aaf1d4e11 100644 --- a/dyalog-configuration-guide/docs/how-to-set/overview.md +++ b/dyalog-configuration-guide/docs/how-to-set/overview.md @@ -2,12 +2,12 @@ A configuration parameter can be set from any of the following sources: -- the [command line](command-line.md) used to start Dyalog; -- an [application configuration file](application-configuration-files.md); -- an [environment variable](environment-variables.md); -- a [user configuration file](user-configuration-files.md); -- the [Windows Registry](registry.md) (Microsoft Windows only); -- the interpreter's [built-in defaults](built-in-defaults.md). +- the [command line](command-line.md) used to start Dyalog +- an [application configuration file](application-configuration-files.md) +- an [environment variable](environment-variables.md) +- a [user configuration file](user-configuration-files.md) +- the [Windows Registry](registry.md) (Microsoft Windows only) +- the interpreter's [built-in defaults](built-in-defaults.md) When the same parameter is set in more than one source, the [order of precedence](order-of-precedence.md) determines which value is used. This gives a great deal of flexibility: a usual value can be defined in a configuration file and then temporarily overridden from the command line. From 99c913a78473495c972f41d321f579029d463d08 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 13:12:54 +0100 Subject: [PATCH 21/37] Fix cross-guide links left broken by the parameter migration The migration repointed links to and from the moved configuration-parameter pages but kept the .md extension on the cross-guide forms, which the site-urls plugin does not rewrite, so they resolved to nonexistent .md URLs. Drop the .md on those cross-guide links (183 links across 101 pages: the moved pages' links to the Windows Configuration Dialog and other Windows pages, and the Windows guide's repointed references into the Configuration Guide). Also correct two language-reference links (system, dt) that were one ../ short of the Configuration Guide. Verified with a local mkdocs build: every affected link now resolves, and no link into or out of the Configuration Guide is broken. Refs Dyalog/documentation#719 --- .../addclassheaders.md | 2 +- .../docs/configuration-parameters/aplk.md | 2 +- .../docs/configuration-parameters/aplkeys.md | 2 +- .../docs/configuration-parameters/aplt.md | 2 +- .../docs/configuration-parameters/apltrans.md | 2 +- .../docs/configuration-parameters/auto-pw.md | 2 +- .../autocomplete/cancelkey1.md | 2 +- .../autocomplete/cancelkey2.md | 2 +- .../autocomplete/cols.md | 2 +- .../autocomplete/commonkey1.md | 2 +- .../autocomplete/completekey1.md | 2 +- .../autocomplete/completekey2.md | 2 +- .../autocomplete/enabled.md | 2 +- .../autocomplete/history.md | 2 +- .../autocomplete/historysize.md | 2 +- .../autocomplete/prefixsize.md | 2 +- .../autocomplete/rows.md | 2 +- .../autocomplete/showfiles.md | 2 +- .../docs/configuration-parameters/autodpi.md | 2 +- .../configuration-parameters/autoformat.md | 2 +- .../configuration-parameters/autoindent.md | 2 +- .../configuration-parameters/classicmode.md | 2 +- .../classicmodesaveposition.md | 2 +- .../configuration-parameters/confirm-abort.md | 2 +- .../configuration-parameters/confirm-close.md | 2 +- .../configuration-parameters/confirm-fix.md | 2 +- .../confirm-session-delete.md | 2 +- .../configuration-parameters/default-div.md | 2 +- .../configuration-parameters/default-io.md | 2 +- .../configuration-parameters/default-ml.md | 2 +- .../configuration-parameters/default-pp.md | 2 +- .../configuration-parameters/default-rtl.md | 2 +- .../configuration-parameters/default-wx.md | 2 +- .../dmxoutputonerror.md | 2 +- .../dockableeditwindows.md | 2 +- .../doubleclickedit.md | 2 +- .../dyalog-lineeditor-mode.md | 2 +- .../dyalog-pixel-type.md | 2 +- .../configuration-parameters/edit-cols.md | 2 +- .../configuration-parameters/edit-first-x.md | 2 +- .../configuration-parameters/edit-first-y.md | 2 +- .../configuration-parameters/edit-offset-x.md | 2 +- .../configuration-parameters/edit-offset-y.md | 2 +- .../configuration-parameters/edit-rows.md | 2 +- .../externalhelpurl.md | 2 +- .../file-stack-size.md | 2 +- .../configuration-parameters/history-size.md | 2 +- .../docs/configuration-parameters/inifile.md | 2 +- .../initfullscriptnormal.md | 2 +- .../initfullscriptsusp.md | 2 +- .../initialkeyboardlayout.md | 2 +- .../initialkeyboardlayoutinuse.md | 2 +- .../initialkeyboardlayoutshowall.md | 2 +- .../configuration-parameters/input-size.md | 2 +- .../keyboardinputdelay.md | 2 +- .../log-file-inuse.md | 2 +- .../docs/configuration-parameters/log-file.md | 2 +- .../docs/configuration-parameters/log-size.md | 2 +- .../docs/configuration-parameters/maxws.md | 2 +- .../overstrikespopup.md | 2 +- .../configuration-parameters/pfkey-size.md | 2 +- .../propertyexposeroot.md | 2 +- .../propertyexposese.md | 2 +- .../resolveoverstrikes.md | 2 +- .../configuration-parameters/session-file.md | 2 +- .../configuration-parameters/sessionontop.md | 2 +- .../configuration-parameters/singletrace.md | 2 +- .../configuration-parameters/skiplines.md | 2 +- .../configuration-parameters/statusonedit.md | 2 +- .../docs/configuration-parameters/tabstops.md | 2 +- .../toolbarsonedit.md | 2 +- .../configuration-parameters/trace-first-x.md | 2 +- .../configuration-parameters/trace-first-y.md | 2 +- .../trace-level-warn.md | 2 +- .../trace-offset-x.md | 2 +- .../trace-offset-y.md | 2 +- .../trace-on-error.md | 2 +- .../unicodetoclipboard.md | 2 +- .../configuration-parameters/urlhighlight.md | 2 +- .../useexternalhelpurl.md | 2 +- .../valuetips/colourscheme.md | 2 +- .../valuetips/delay.md | 2 +- .../valuetips/enabled.md | 2 +- .../configuration-parameters/wrapsearch.md | 2 +- .../wrapsearchmsgbox.md | 2 +- .../docs/configuration-parameters/wspath.md | 2 +- .../docs/system-functions/dt.md | 2 +- .../docs/system-functions/system.md | 2 +- .../docs/apl-command-line.md | 6 +-- .../configuration-dialog-auto-complete-tab.md | 22 ++++---- .../configuration-dialog-general-tab.md | 16 +++--- .../configuration-dialog-help-dmx-tab.md | 6 +-- ...n-dialog-input-tab-classic-edition-only.md | 4 +- .../configuration-dialog-object-syntax-tab.md | 6 +-- ...-dialog-output-tab-classic-edition-only.md | 4 +- .../configuration-dialog-session-tab.md | 32 ++++++------ .../configuration-dialog-trace-edit-tab.md | 50 +++++++++---------- ...-unicode-input-tab-unicode-edition-only.md | 12 ++--- .../configuration-dialog-windows-tab.md | 24 ++++----- .../configuration-dialog-workspace-tab.md | 4 +- .../runtime-applications-and-components.md | 4 +- 101 files changed, 183 insertions(+), 183 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md index d13cf673e8c..32ff5662b2a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/addclassheaders.md @@ -9,4 +9,4 @@ Valid values are: -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplk.md b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md index 0ffafe9ff9f..06d86ed939a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplk.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplk.md @@ -11,4 +11,4 @@ Valid values are the name of a `.DIN` input translate table. Related parameters: [APLKeys](aplkeys.md). -See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md) of the Windows Configuration Dialog. +See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md index 5b052d0207f..459110c3102 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md @@ -11,4 +11,4 @@ Default is the `aplkeys` sub-directory of the Dyalog installation directory (giv Related parameters: [APLK](aplk.md), [Dyalog](dyalog.md). -See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md) of the Windows Configuration Dialog. +See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplt.md b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md index 5e351b7c9b0..0be147e6c7e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplt.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplt.md @@ -12,4 +12,4 @@ Default is `WIN.DOT` on Microsoft Windows, where there is rarely a need to alter Related parameters: [APLTrans](apltrans.md). -See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md) of the Windows Configuration Dialog. +See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md index 1862dcbaebd..f97f5d0ed36 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md @@ -11,4 +11,4 @@ Default is the `apltrans` sub-directory of the Dyalog installation directory (gi Related parameters: [APLT](aplt.md), [Dyalog](dyalog.md). -See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md) of the Windows Configuration Dialog. +See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md index 55fdcf48ada..c7879410f54 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/auto-pw.md @@ -14,4 +14,4 @@ Default depends on operating system: Related parameters: [Default_PW](default-pw.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md index 8ebab13110e..0cab4980f03 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey1.md @@ -8,4 +8,4 @@ Valid values are a key code. Related parameters: [AutoComplete/CancelKey2](cancelkey2.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md index 4e15f1bcec8..3a02bcb58d7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cancelkey2.md @@ -8,4 +8,4 @@ Valid values are a key code. Related parameters: [AutoComplete/CancelKey1](cancelkey1.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md index 56f54328073..0b6152899b2 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/cols.md @@ -8,4 +8,4 @@ Valid values are a positive integer. Related parameters: [AutoComplete/Rows](rows.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md index a39453363ea..8f457c359b3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/commonkey1.md @@ -6,4 +6,4 @@ Valid values are a key code. -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md index 476aa1a210d..15e05d38592 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey1.md @@ -8,4 +8,4 @@ Valid values are a key code. Related parameters: [AutoComplete/CompleteKey2](completekey2.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md index f0765a02522..543859cb56c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/completekey2.md @@ -8,4 +8,4 @@ Valid values are a key code. Related parameters: [AutoComplete/CompleteKey1](completekey1.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md index 25165ccb8e8..494abc819f4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/enabled.md @@ -9,4 +9,4 @@ Valid values are: -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md index 0c4ef3678f6..84cc08ea2fe 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/history.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [AutoComplete/HistorySize](historysize.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md index 13e9d788eb1..13a98777de4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/historysize.md @@ -8,4 +8,4 @@ Valid values are a positive integer. Related parameters: [AutoComplete/History](history.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md index 66b806ff484..99ebd55e9a9 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/prefixsize.md @@ -6,4 +6,4 @@ Valid values are a non-negative integer. -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md index fc76daf484c..fc309a12d26 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/rows.md @@ -8,4 +8,4 @@ Valid values are a positive integer. Related parameters: [AutoComplete/Cols](cols.md). -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md index 3923f946928..ff69af763ff 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autocomplete/showfiles.md @@ -9,4 +9,4 @@ Valid values are: -See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md) of the Windows Configuration Dialog. +See also the [Auto Complete tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md index da8a2637e5d..994ce165d02 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autodpi.md @@ -12,4 +12,4 @@ Valid values are: Default is `1`. -See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md index 4d9160820d4..5656d3e0deb 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoformat.md @@ -11,4 +11,4 @@ Default is `1`. Related parameters: [TabStops](tabstops.md), [AutoIndent](autoindent.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md index 3a2f4e1b370..687efa65870 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/autoindent.md @@ -11,4 +11,4 @@ Default is `1`. Related parameters: [AutoFormat](autoformat.md), [TabStops](tabstops.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md index 2b5fa2cab05..e69e32c4520 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmode.md @@ -9,4 +9,4 @@ Valid values are: Default is `0`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md index 81fcd42df92..15c135d33c4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [ClassicMode](classicmode.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md index 83866554707..5b51fa3abc6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-abort.md @@ -9,4 +9,4 @@ Valid values are: Default is `0`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md index 0b94cf57303..311b42ddb87 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-close.md @@ -9,4 +9,4 @@ Valid values are: Default is `0`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md index 48751624f90..233c6119e1f 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-fix.md @@ -9,4 +9,4 @@ Valid values are: Default is `0`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md index a2e560bca86..45e4aa68d51 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/confirm-session-delete.md @@ -9,4 +9,4 @@ Valid values are: Default is `1`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-div.md b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md index a2159121b1a..909b4914ba4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-div.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-div.md @@ -6,4 +6,4 @@ Valid values are those of `⎕DIV`: `0` or `1`. Default is `0`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-io.md b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md index a582040bd9d..461e686c8db 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-io.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-io.md @@ -6,4 +6,4 @@ Valid values are those of `⎕IO`: `0` or `1`. Default is `1`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md index 2afa614e8f8..7b7ca1b50b3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-ml.md @@ -6,4 +6,4 @@ Valid values are those of `⎕ML`: `0`, `1`, `2`, or `3`. Default is `1`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md index 6fb84daefc0..96b4ffc465a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-pp.md @@ -6,4 +6,4 @@ Valid values are those of `⎕PP`: an integer from `1` to `34`. Default is `10`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md index 74a4b9d3972..f9566b77673 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-rtl.md @@ -6,4 +6,4 @@ Valid values are those of `⎕RTL`: `0` or a positive integer. Default is `0`. -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md index 914fbb30ef8..080e03fd483 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/default-wx.md @@ -10,4 +10,4 @@ Default is `3`. !!! Info "Information" UNIX and macOS versions of Dyalog have no GUI objects, but `⎕SE` is present, so `⎕WX` still affects expressions such as `⎕SE.PropList`. -See also [Expose properties of GUI Namespaces](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) in the Windows Configuration Dialog. +See also [Expose properties of GUI Namespaces](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab) in the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md index b15a1055089..7b94633f9a2 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dmxoutputonerror.md @@ -9,4 +9,4 @@ The value is the sum of the following: -See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md index 5f79c77fd8d..36b39b5f1c7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dockableeditwindows.md @@ -11,4 +11,4 @@ Default is `0`. Related parameters: [ClassicMode](classicmode.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md index 7720cd0e16c..ed6fd6e52dd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/doubleclickedit.md @@ -9,4 +9,4 @@ Valid values are: Default is `1`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md index 2028d813238..a673af46590 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-lineeditor-mode.md @@ -9,4 +9,4 @@ Valid values are: -See also [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input) and the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also [Multi-line Session Input](../../../windows-ui-guide/multiline-session-input) and the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md index 96609621267..4f58dfaf343 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-pixel-type.md @@ -12,4 +12,4 @@ Valid values are: Default is `RealPixel`. -See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md index cb8eac32d31..d7ad9853d02 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-cols.md @@ -8,4 +8,4 @@ Valid values are a positive integer number of character units. Related parameters: [Edit_Rows](edit-rows.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md index 43897e23139..4cba7aeab7e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-x.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Edit_First_Y](edit-first-y.md), [Edit_Offset_X](edit-offset-x.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md index 8afa8d8392b..c225b406a94 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-first-y.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Edit_First_X](edit-first-x.md), [Edit_Offset_Y](edit-offset-y.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md index 6fb0358cd73..d5fe278781d 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-x.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Edit_Offset_Y](edit-offset-y.md), [Edit_First_X](edit-first-x.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md index f6a7f9db5f6..68164eb81e4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-offset-y.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Edit_Offset_X](edit-offset-x.md), [Edit_First_Y](edit-first-y.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md index 87d9668a05e..7697e1e05d7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/edit-rows.md @@ -8,4 +8,4 @@ Valid values are a positive integer number of character units. Related parameters: [Edit_Cols](edit-cols.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md index 599c51103b5..94d1984c8b6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/externalhelpurl.md @@ -11,4 +11,4 @@ Valid values are a URL. Related parameters: [UseExternalHelpURL](useexternalhelpurl.md). -See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md index 063113dc342..a79927a1fe7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/file-stack-size.md @@ -6,4 +6,4 @@ Valid values are a non-negative integer. -See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/history-size.md b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md index 4e5b06628c5..fcb20f8f280 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/history-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/history-size.md @@ -6,4 +6,4 @@ The size of the buffer used to store previously entered (input) lines in the Ses Related parameters: [Input_Size](input-size.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/inifile.md b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md index e366801f4ec..7b8e45400d3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/inifile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/inifile.md @@ -20,4 +20,4 @@ Default depends on edition (64-bit and 32-bit versions respectively): Software\Dyalog\Dyalog APL/W {{ version_majmin }} ``` -See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md index 78d325f0150..e4f9cc0f9b8 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptnormal.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [InitFullScriptSusp](initfullscriptsusp.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md index f7f45ad956e..3933b7f98fd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initfullscriptsusp.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [InitFullScriptNormal](initfullscriptnormal.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md index 4e479c8f33c..b58d322d9d3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayout.md @@ -11,4 +11,4 @@ Valid values are the name of an installed keyboard layout. Related parameters: [InitialKeyboardLayoutInUse](initialkeyboardlayoutinuse.md), [InitialKeyboardLayoutShowAll](initialkeyboardlayoutshowall.md). -See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md index 603886558b1..940cda54120 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutinuse.md @@ -14,4 +14,4 @@ Valid values are: Related parameters: [InitialKeyboardLayout](initialkeyboardlayout.md). -See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md index 4d321e92c93..f1d041a21fd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/initialkeyboardlayoutshowall.md @@ -14,4 +14,4 @@ Valid values are: Related parameters: [InitialKeyboardLayout](initialkeyboardlayout.md). -See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/input-size.md b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md index a51abe5eeaf..2876f02c189 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/input-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/input-size.md @@ -6,4 +6,4 @@ The size of the buffer used to store marked lines (lines awaiting execution) in Related parameters: [History_Size](history-size.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md index 90bab6f6809..c92037e6aaf 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/keyboardinputdelay.md @@ -1,6 +1,6 @@ # KeyboardInputDelay -The delay, in milliseconds, before the system reacts to a keystroke by updating the name of the Current Object in the Session status bar (see [The Current Object](../../../windows-ui-guide/session-manager)) and offering a list of names for auto-completion (see the [Auto Complete tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md)). +The delay, in milliseconds, before the system reacts to a keystroke by updating the name of the Current Object in the Session status bar (see [The Current Object](../../../windows-ui-guide/session-manager)) and offering a list of names for auto-completion (see the [Auto Complete tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab)). Valid values are a number of milliseconds. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md index a23e30e67f8..10f1d6a79c1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file-inuse.md @@ -11,4 +11,4 @@ Default is `1`. Related parameters: [Log_File](log-file.md), [Log_Size](log-size.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-file.md b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md index 93c789f7d6e..06d789a9e2e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-file.md @@ -13,4 +13,4 @@ Default depends on operating system: Related parameters: [Log_File_InUse](log-file-inuse.md), [Log_Size](log-size.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/log-size.md b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md index ed9f67c6bf3..ef350558177 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/log-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/log-size.md @@ -6,4 +6,4 @@ The size of the Session log buffer. See [Specifying Size-related Parameters](con Related parameters: [Log_File](log-file.md), [Log_File_InUse](log-file-inuse.md). -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/maxws.md b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md index 3ff495e2e03..0e09b320c5b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/maxws.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/maxws.md @@ -9,4 +9,4 @@ Default depends on platform: The memory used for the workspace must be contiguous. Dyalog places no implicit restriction on workspace size, and virtual memory allows more than the physically installed memory to be addressed; however, a workspace that greatly exceeds physical memory causes excessive paging. 32-bit versions are typically limited to 1.3-1.9 GiB (a limitation of the operating system on 32-bit processes, not of Dyalog); 64-bit versions have no such limit. -See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md) of the Windows Configuration Dialog. +See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md b/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md index ac1d127922f..4708c0618cd 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/overstrikespopup.md @@ -14,4 +14,4 @@ Valid values are: Related parameters: [ResolveOverstrikes](resolveoverstrikes.md). -See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md index 417d0558c67..35847d356fc 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/pfkey-size.md @@ -4,4 +4,4 @@ The size of the buffer used to store programmable function key definitions (see -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md index b2324e703de..600f11d0d00 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposeroot.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [PropertyExposeSE](propertyexposese.md), [Default_WX](default-wx.md). -See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) of the Windows Configuration Dialog. +See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md index 183be9b35a8..660abb8c138 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/propertyexposese.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [PropertyExposeRoot](propertyexposeroot.md). -See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md) of the Windows Configuration Dialog. +See also the [Object Syntax tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md b/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md index 2e11dac35ce..9c8dd390b0a 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/resolveoverstrikes.md @@ -14,4 +14,4 @@ Valid values are: Related parameters: [OverstrikesPopup](overstrikespopup.md). -See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md) of the Windows Configuration Dialog. +See also the [Unicode Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/session-file.md b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md index 16be3c0aff3..808881ac5f1 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/session-file.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/session-file.md @@ -6,4 +6,4 @@ Default is `[DYALOG]/default.dse` (the `default.dse` file in the Dyalog installa -See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md) of the Windows Configuration Dialog. +See also the [Session tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md index 8bf223a4346..abf1efa5deb 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/sessionontop.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [ClassicMode](classicmode.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md index 5e1d24a305b..72d1ee9f462 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/singletrace.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [ClassicMode](classicmode.md), [Trace_Level_Warn](trace-level-warn.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md index 8a9b7a9ac7c..bb30ecc16f6 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/skiplines.md @@ -10,4 +10,4 @@ The value is the sum of the following: -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md index de6db9ec021..fd1856266f0 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/statusonedit.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [ToolBarsOnEdit](toolbarsonedit.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md index e5163bb33d0..220e7f2bd06 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/tabstops.md @@ -8,4 +8,4 @@ Default is `4`. Related parameters: [AutoFormat](autoformat.md), [AutoIndent](autoindent.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md index c20fe0097f7..fd78d235263 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/toolbarsonedit.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [StatusOnEdit](statusonedit.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md index aa91cc8f67b..767f2fc3d28 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-x.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Trace_First_Y](trace-first-y.md), [Trace_Offset_X](trace-offset-x.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md index 91b6853c505..1814838d9db 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-first-y.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Trace_First_X](trace-first-x.md), [Trace_Offset_Y](trace-offset-y.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md index 8322d9a5e3e..bb8d69e3627 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-level-warn.md @@ -8,4 +8,4 @@ Default is `16`. Related parameters: [Trace_On_Error](trace-on-error.md), [SingleTrace](singletrace.md), [ClassicMode](classicmode.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md index 9fced440af8..cca41d1e0c7 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-x.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Trace_Offset_Y](trace-offset-y.md), [Trace_First_X](trace-first-x.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md index 2dab5106fb1..d960925c6c3 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-offset-y.md @@ -8,4 +8,4 @@ Valid values are an integer number of character units. Related parameters: [Trace_Offset_X](trace-offset-x.md), [Trace_First_Y](trace-first-y.md). -See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md) of the Windows Configuration Dialog. +See also the [Windows tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md index c3783f1d3bc..dc3090f5e90 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/trace-on-error.md @@ -14,4 +14,4 @@ Default depends on operating system: Related parameters: [Trace_Level_Warn](trace-level-warn.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md index 3873f0ae96d..71474209231 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/unicodetoclipboard.md @@ -12,4 +12,4 @@ Valid values are: Default is `0`. -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md index e40b45675c2..616ebe1892c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/urlhighlight.md @@ -9,4 +9,4 @@ Valid values are: Default is `0`. -See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md index 110223926e9..2e104a5c450 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/useexternalhelpurl.md @@ -14,4 +14,4 @@ Valid values are: Related parameters: [ExternalHelpURL](externalhelpurl.md). -See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md) of the Windows Configuration Dialog. +See also the [Help/DMX tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md index 71ec8cfc7c5..52048f84580 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/colourscheme.md @@ -8,4 +8,4 @@ Valid values are the name of a colour scheme. Related parameters: [ValueTips/Enabled](enabled.md), [ValueTips/Delay](delay.md). -See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md index 1aa30089352..f81fad03aed 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/delay.md @@ -8,4 +8,4 @@ Valid values are a number of milliseconds. Related parameters: [ValueTips/Enabled](enabled.md), [ValueTips/ColourScheme](colourscheme.md). -See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md index 0ca9793d6f4..0bc2f76168c 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/valuetips/enabled.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [ValueTips/Delay](delay.md), [ValueTips/ColourScheme](colourscheme.md). -See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md) of the Windows Configuration Dialog. +See also the [General tab](../../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md index 0279a806a42..1d88be60ece 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearch.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [WrapSearchMsgBox](wrapsearchmsgbox.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md index d8f2cae5c11..1f6c0f547ad 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wrapsearchmsgbox.md @@ -11,4 +11,4 @@ Valid values are: Related parameters: [WrapSearch](wrapsearch.md). -See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md) of the Windows Configuration Dialog. +See also the [Trace/Edit tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/wspath.md b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md index e800d78f1b2..6a731208011 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/wspath.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/wspath.md @@ -8,4 +8,4 @@ For example, on Windows `WSPath=.;D:\MYWS` causes `)COPY`, `)LOAD`, and `)LIB` t Related parameters: [WSEXT](wsext.md). -See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md) of the Windows Configuration Dialog. +See also the [Workspace tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab) of the Windows Configuration Dialog. diff --git a/language-reference-guide/docs/system-functions/dt.md b/language-reference-guide/docs/system-functions/dt.md index 57a1d230c08..cb26e6138e7 100644 --- a/language-reference-guide/docs/system-functions/dt.md +++ b/language-reference-guide/docs/system-functions/dt.md @@ -249,7 +249,7 @@ When XY is a pattern, the corresponding character vector ### Two-digit Years -Two digit years (that is, those corresponding to the formatting pattern elements `YY` and `WW`) are, by default, interpreted according to the same rules used for `⎕SM` and GUI edit fields, which are configurable using the [`YY_WINDOW`](../../dyalog-configuration-guide/configuration-parameters/yy-window/) configuration parameter. +Two digit years (that is, those corresponding to the formatting pattern elements `YY` and `WW`) are, by default, interpreted according to the same rules used for `⎕SM` and GUI edit fields, which are configurable using the [`YY_WINDOW`](../../../dyalog-configuration-guide/configuration-parameters/yy-window/) configuration parameter. ### Ambiguities and Precision diff --git a/language-reference-guide/docs/system-functions/system.md b/language-reference-guide/docs/system-functions/system.md index bdd88cce6bc..d2426f041e1 100644 --- a/language-reference-guide/docs/system-functions/system.md +++ b/language-reference-guide/docs/system-functions/system.md @@ -251,7 +251,7 @@ This namespace provides information about the interpreter's operating system pro Non-negative integer [process identifier](https://en.wikipedia.org/wiki/Process_identifier) (PID) of the interpreter. #### Process.LaunchTarget -The fully qualified path of the file or directory loaded at startup. This is set by either a workspace name on the [APL command line](../../windows-installation-and-configuration-guide/apl-command-line) or using the [LOAD configuration parameter](../../dyalog-configuration-guide/configuration-parameters/load/). +The fully qualified path of the file or directory loaded at startup. This is set by either a workspace name on the [APL command line](../../windows-installation-and-configuration-guide/apl-command-line) or using the [LOAD configuration parameter](../../../dyalog-configuration-guide/configuration-parameters/load/). #### Process.ParentId Non-negative integer [process identifier](https://en.wikipedia.org/wiki/Process_identifier) of the process that launched the interpreter. Always `¯1` on Microsoft Windows. diff --git a/windows-installation-and-configuration-guide/docs/apl-command-line.md b/windows-installation-and-configuration-guide/docs/apl-command-line.md index 136901e3e72..ef5150b847e 100644 --- a/windows-installation-and-configuration-guide/docs/apl-command-line.md +++ b/windows-installation-and-configuration-guide/docs/apl-command-line.md @@ -17,7 +17,7 @@ Is the location of the Dyalog executable. Usually this is the full pathname, sur **[options]** |---|---| -|-x|Disables the execution of the `⎕LX` expression and the derived expression when code is loaded from a source code file or directory. This applies only at start-up and does not apply to workspaces or source files that are loaded subsequently. See [Latent Expression](../../language-reference-guide/system-functions/lx) and [Load](../../dyalog-configuration-guide/configuration-parameters/load.md)| +|-x|Disables the execution of the `⎕LX` expression and the derived expression when code is loaded from a source code file or directory. This applies only at start-up and does not apply to workspaces or source files that are loaded subsequently. See [Latent Expression](../../language-reference-guide/system-functions/lx) and [Load](../../dyalog-configuration-guide/configuration-parameters/load)| |-a|Start in USER mode.| |-b|Suppress the banner in the Session..| |-s|Disable the Session. This option is ignored in Windows versions.| @@ -41,10 +41,10 @@ The name of a Dyalog APL workspace to be loaded. Unless specified, on Windows th **[param]** -A parameter name followed by an equals sign (`=`) and a value. The parameter name may be one of the standard APL parameters (see [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters.md) ) or a name and value of your own choosing (see [GetEnvironment](../../object-reference/methodorevents/getenvironment) ) . If the parameter is in a registry sub-folder (see [Registry Sub-Folders](registry-subfolders.md) ), its name must be preceded by the name of the sub-folder, followed by a backslash (`\`) or underscore (`_`). +A parameter name followed by an equals sign (`=`) and a value. The parameter name may be one of the standard APL parameters (see [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters) ) or a name and value of your own choosing (see [GetEnvironment](../../object-reference/methodorevents/getenvironment) ) . If the parameter is in a registry sub-folder (see [Registry Sub-Folders](registry-subfolders.md) ), its name must be preceded by the name of the sub-folder, followed by a backslash (`\`) or underscore (`_`). !!! note - Instead of a loading a workspace specified by the **ws** option, APL can be instructed to load a program from a script file. For further information, see [Load](../../dyalog-configuration-guide/configuration-parameters/load.md). + Instead of a loading a workspace specified by the **ws** option, APL can be instructed to load a program from a script file. For further information, see [Load](../../dyalog-configuration-guide/configuration-parameters/load).

Examples

diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md index 1915b6371b6..04d45ae7c7a 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-auto-complete-tab.md @@ -8,14 +8,14 @@ Table: Configuration dialog: Auto Complete |Label|Parameter|Description| |---|---|---| -|Use Auto Complete|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/enabled.md)|Specifies whether or not Auto Completion is enabled.| -|Make suggestions after|[PrefixSize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/prefixsize.md)|Specifies the number of characters you must enter before Auto Completion begins to make suggestions| -|Delay completion for|[KeyboardInputDelay](../../../../dyalog-configuration-guide/configuration-parameters/keyboardinputdelay.md)|Specifies the delay in milliseconds before Auto Completion begins to make suggestions| -|Suggest up to|[Rows](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/rows.md)|Specifies the maximum number of rows (height) in the AutoComplete pop-up suggestions box.| -|Show up to|[Cols](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cols.md)|Specifies the maximum number of columns (width) in the AutoComplete pop-up suggestion box| -|Keep History|[History](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/history.md)|Specifies whether or not AutoComplete maintains a list of previous AutoCompletions.| -|History Length|[HistorySize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/historysize.md)|Specifies the number of previous AutoCompletions that are maintained| -|Include filenames|[ShowFiles](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/showfiles.md)|Specifies whether or not AutoCompletion suggests directory and file names for `)LOAD` , `)COPY` and `)DROP` system commands.| -|OK Key|[CompleteKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey1.md) [CompleteKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey2.md)|Specifies two possible keys that may be used to select the current option from the Auto Complete suggestion box.| -|Cancel Key|[CancelKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey1.md) [CancelKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey2.md)|Specifies two possible keys that may be used to cancel (hide) the Auto Complete suggestion box.| -|Common Key|[CommonKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/commonkey1.md)|Specifies the key that will auto-complete the *common prefix* .| +|Use Auto Complete|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/enabled)|Specifies whether or not Auto Completion is enabled.| +|Make suggestions after|[PrefixSize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/prefixsize)|Specifies the number of characters you must enter before Auto Completion begins to make suggestions| +|Delay completion for|[KeyboardInputDelay](../../../../dyalog-configuration-guide/configuration-parameters/keyboardinputdelay)|Specifies the delay in milliseconds before Auto Completion begins to make suggestions| +|Suggest up to|[Rows](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/rows)|Specifies the maximum number of rows (height) in the AutoComplete pop-up suggestions box.| +|Show up to|[Cols](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cols)|Specifies the maximum number of columns (width) in the AutoComplete pop-up suggestion box| +|Keep History|[History](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/history)|Specifies whether or not AutoComplete maintains a list of previous AutoCompletions.| +|History Length|[HistorySize](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/historysize)|Specifies the number of previous AutoCompletions that are maintained| +|Include filenames|[ShowFiles](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/showfiles)|Specifies whether or not AutoCompletion suggests directory and file names for `)LOAD` , `)COPY` and `)DROP` system commands.| +|OK Key|[CompleteKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey1) [CompleteKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/completekey2)|Specifies two possible keys that may be used to select the current option from the Auto Complete suggestion box.| +|Cancel Key|[CancelKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey1) [CancelKey2](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/cancelkey2)|Specifies two possible keys that may be used to cancel (hide) the Auto Complete suggestion box.| +|Common Key|[CommonKey1](../../../../dyalog-configuration-guide/configuration-parameters/autocomplete/commonkey1)|Specifies the key that will auto-complete the *common prefix* .| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md index 5d2894ea063..70cc844ea1e 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-general-tab.md @@ -6,11 +6,11 @@ Table: Configuration dialog: General |Label|Parameter|Description| |---|---|---| -|Recently used file list size|[File_Stack_Size](../../../../dyalog-configuration-guide/configuration-parameters/file-stack-size.md)|Specifies the number of the most recently used workspaces displayed in the File menu.| -|Underline URLs and links|[URLHighlight](../../../../dyalog-configuration-guide/configuration-parameters/urlhighlight.md)|Specifies whether or not URLs and links are highlighted in Session and Edit windows.| -|Display Value Tips|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/enabled.md)|Specifies whether or not Value Tips are enabled.| -|Display Value Tips after|[Delay](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/delay.md)|Specifies the delay before APL displays a Value Tip.| -|Colour Scheme|[ColourScheme](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/colourscheme.md)|Specifies the colour scheme used to display Value Tips.| -|Enable DPI Scaling of the interpreter and development environment|[AutoDPI](../../../../dyalog-configuration-guide/configuration-parameters/autodpi.md)|Enables or disables DPI scaling for the APL Session| -|Enable DPI scaling of GUI application|[Dyalog_Pixel_Type](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-pixel-type.md)|Determines whether Coord `'Pixel'` is treated as ScaledPixel or RealPixel.| -|Configuration saved in|[IniFile](../../../../dyalog-configuration-guide/configuration-parameters/inifile.md)|Specifies the full pathname of the registry folder used by APL| +|Recently used file list size|[File_Stack_Size](../../../../dyalog-configuration-guide/configuration-parameters/file-stack-size)|Specifies the number of the most recently used workspaces displayed in the File menu.| +|Underline URLs and links|[URLHighlight](../../../../dyalog-configuration-guide/configuration-parameters/urlhighlight)|Specifies whether or not URLs and links are highlighted in Session and Edit windows.| +|Display Value Tips|[Enabled](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/enabled)|Specifies whether or not Value Tips are enabled.| +|Display Value Tips after|[Delay](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/delay)|Specifies the delay before APL displays a Value Tip.| +|Colour Scheme|[ColourScheme](../../../../dyalog-configuration-guide/configuration-parameters/valuetips/colourscheme)|Specifies the colour scheme used to display Value Tips.| +|Enable DPI Scaling of the interpreter and development environment|[AutoDPI](../../../../dyalog-configuration-guide/configuration-parameters/autodpi)|Enables or disables DPI scaling for the APL Session| +|Enable DPI scaling of GUI application|[Dyalog_Pixel_Type](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-pixel-type)|Determines whether Coord `'Pixel'` is treated as ScaledPixel or RealPixel.| +|Configuration saved in|[IniFile](../../../../dyalog-configuration-guide/configuration-parameters/inifile)|Specifies the full pathname of the registry folder used by APL| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md index 8af8d6a2340..8daed77aefe 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-help-dmx-tab.md @@ -6,6 +6,6 @@ Table: Configuration dialog: Help/DMX |Label|Parameter|Description| |---|---|---| -|DMX messages should go to|[DMXOutputOnError](../../../../dyalog-configuration-guide/configuration-parameters/dmxoutputonerror.md)|If checked, these boxes cause APL to display `⎕DMX` messages in the corresponding window(s).| -|Use Microsoft's documentation centre for non-Dyalog topics|[UseExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/useexternalhelpurl.md)|If this option is checked, APL will look for help for external objects at Microsoft's documentation center, which is identified by the specified URL.| -|URL|[ExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/externalhelpurl.md)|The URL for the documentation centre.| +|DMX messages should go to|[DMXOutputOnError](../../../../dyalog-configuration-guide/configuration-parameters/dmxoutputonerror)|If checked, these boxes cause APL to display `⎕DMX` messages in the corresponding window(s).| +|Use Microsoft's documentation centre for non-Dyalog topics|[UseExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/useexternalhelpurl)|If this option is checked, APL will look for help for external objects at Microsoft's documentation center, which is identified by the specified URL.| +|URL|[ExternalHelpURL](../../../../dyalog-configuration-guide/configuration-parameters/externalhelpurl)|The URL for the documentation centre.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md index d4db20a610f..f3c18305ffb 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Keyboard |Label |Parameter |Description | |-----------------------|----------------------------------------------------|------------------------------------------------------------------| -|Input table search path|[APLKeys](../../../../dyalog-configuration-guide/configuration-parameters/aplkeys.md)|A list of directories to be searched for the specified input table| -|Input table file |[APLK](../../../../dyalog-configuration-guide/configuration-parameters/aplk.md) |The name of the input table file (.DIN) | +|Input table search path|[APLKeys](../../../../dyalog-configuration-guide/configuration-parameters/aplkeys)|A list of directories to be searched for the specified input table| +|Input table file |[APLK](../../../../dyalog-configuration-guide/configuration-parameters/aplk) |The name of the input table file (.DIN) | diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md index 8632dc387ed..77aa995b696 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-object-syntax-tab.md @@ -8,6 +8,6 @@ Table: Configuration dialog: Object Syntax |Label|Parameter|Description| |---|---|---| -|Expose properties of GUI Namespaces|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx.md)|Specifies the value of `⎕WX` in a clear workspace.| -|Expose properties of Root|[PropertyExposeRoot](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposeroot.md)|Specifies whether or not the names of properties, methods and events of the Root object are exposed.| -|Expose properties of Session Namespace|[PropertyExposeSE](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposese.md)|Specifies whether or not the names of properties, methods and events of the Session object are exposed.| +|Expose properties of GUI Namespaces|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx)|Specifies the value of `⎕WX` in a clear workspace.| +|Expose properties of Root|[PropertyExposeRoot](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposeroot)|Specifies whether or not the names of properties, methods and events of the Root object are exposed.| +|Expose properties of Session Namespace|[PropertyExposeSE](../../../../dyalog-configuration-guide/configuration-parameters/propertyexposese)|Specifies whether or not the names of properties, methods and events of the Session object are exposed.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md index 8639dc9a368..2cf70f8bd51 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Output |Label |Parameter |Description | |------------------------|------------------------------------------------------|-------------------------------------------------------------------| -|Output table search path|[APLTrans](../../../../dyalog-configuration-guide/configuration-parameters/apltrans.md)|A list of directories to be searched for the specified output table| -|Output table file |[APLT](../../../../dyalog-configuration-guide/configuration-parameters/aplt.md) |The name of the output table file (.DOT) | +|Output table search path|[APLTrans](../../../../dyalog-configuration-guide/configuration-parameters/apltrans)|A list of directories to be searched for the specified output table| +|Output table file |[APLT](../../../../dyalog-configuration-guide/configuration-parameters/aplt) |The name of the output table file (.DOT) | diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md index 53e6355e3b5..b32808a25a6 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md @@ -6,21 +6,21 @@ Table: Configuration dialog: Session |Label|Parameter|Description| |---|---|---| -|`⎕IO`|[Default_IO](../../../../dyalog-configuration-guide/configuration-parameters/default-io.md)|The default value of `⎕IO` in a `clear ws` .| -|`⎕ML`|[Default_ML](../../../../dyalog-configuration-guide/configuration-parameters/default-ml.md)|The default value of `⎕ML` in a `clear ws`| -|`⎕PP`|[Default_PP](../../../../dyalog-configuration-guide/configuration-parameters/default-pp.md)|The default value of `⎕PP` in a `clear ws` .| -|`⎕RTL`|[Default_RTL](../../../../dyalog-configuration-guide/configuration-parameters/default-rtl.md)|The default value of `⎕RTL` in a `clear ws` .| -|`⎕DIV`|[Default_DIV](../../../../dyalog-configuration-guide/configuration-parameters/default-div.md)|The default value of `⎕DIV` in a `clear ws` .| -|`⎕WX`|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx.md)|The default value of `⎕WX` in a `clear ws` .| -|Auto PW|[Auto_PW](../../../../dyalog-configuration-guide/configuration-parameters/auto-pw.md)|If checked, the value of `⎕PW` is dynamic and depends on the width of the Session Window.| -|Input buffer size|[Input_Size](../../../../dyalog-configuration-guide/configuration-parameters/input-size.md)|The size of the buffer used to store marked lines (lines awaiting execution) in the Session.| -|History size|[History_Size](../../../../dyalog-configuration-guide/configuration-parameters/history-size.md)|The size of the buffer used to store previously entered (input) lines in the Session| -|PFKey buffer size|[PFKey_Size](../../../../dyalog-configuration-guide/configuration-parameters/pfkey-size.md)|The size of the buffer used to store PFKey definitions ( `⎕PFKEY` )| -|Confirm on Deletion from Session log|[Confirm_Session_Delete](../../../../dyalog-configuration-guide/configuration-parameters/confirm-session-delete.md)|Specifies whether or not you are prompted to confirm the deletion of a line from the Session (and Session log).| -|Session log size|[Log_Size](../../../../dyalog-configuration-guide/configuration-parameters/log-size.md)|The size of the Session log buffer.| -|Session file|[Session_File](../../../../dyalog-configuration-guide/configuration-parameters/session-file.md)|The name of the Session file in which the definition of your session ( `⎕SE` ) is stored.| -|Use log file|[Log_File_InUse](../../../../dyalog-configuration-guide/configuration-parameters/log-file-inuse.md)|Specifies whether or not the Session log is saved in a session log file| -|Use log file|[Log_File](../../../../dyalog-configuration-guide/configuration-parameters/log-file.md)|The full pathname of the Session log file| -|Multiline Input|[Dyalog_LineEditor_Mode](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-lineeditor-mode.md)|Specifies whether or not multi-line input is enabled in the Session.| +|`⎕IO`|[Default_IO](../../../../dyalog-configuration-guide/configuration-parameters/default-io)|The default value of `⎕IO` in a `clear ws` .| +|`⎕ML`|[Default_ML](../../../../dyalog-configuration-guide/configuration-parameters/default-ml)|The default value of `⎕ML` in a `clear ws`| +|`⎕PP`|[Default_PP](../../../../dyalog-configuration-guide/configuration-parameters/default-pp)|The default value of `⎕PP` in a `clear ws` .| +|`⎕RTL`|[Default_RTL](../../../../dyalog-configuration-guide/configuration-parameters/default-rtl)|The default value of `⎕RTL` in a `clear ws` .| +|`⎕DIV`|[Default_DIV](../../../../dyalog-configuration-guide/configuration-parameters/default-div)|The default value of `⎕DIV` in a `clear ws` .| +|`⎕WX`|[Default_WX](../../../../dyalog-configuration-guide/configuration-parameters/default-wx)|The default value of `⎕WX` in a `clear ws` .| +|Auto PW|[Auto_PW](../../../../dyalog-configuration-guide/configuration-parameters/auto-pw)|If checked, the value of `⎕PW` is dynamic and depends on the width of the Session Window.| +|Input buffer size|[Input_Size](../../../../dyalog-configuration-guide/configuration-parameters/input-size)|The size of the buffer used to store marked lines (lines awaiting execution) in the Session.| +|History size|[History_Size](../../../../dyalog-configuration-guide/configuration-parameters/history-size)|The size of the buffer used to store previously entered (input) lines in the Session| +|PFKey buffer size|[PFKey_Size](../../../../dyalog-configuration-guide/configuration-parameters/pfkey-size)|The size of the buffer used to store PFKey definitions ( `⎕PFKEY` )| +|Confirm on Deletion from Session log|[Confirm_Session_Delete](../../../../dyalog-configuration-guide/configuration-parameters/confirm-session-delete)|Specifies whether or not you are prompted to confirm the deletion of a line from the Session (and Session log).| +|Session log size|[Log_Size](../../../../dyalog-configuration-guide/configuration-parameters/log-size)|The size of the Session log buffer.| +|Session file|[Session_File](../../../../dyalog-configuration-guide/configuration-parameters/session-file)|The name of the Session file in which the definition of your session ( `⎕SE` ) is stored.| +|Use log file|[Log_File_InUse](../../../../dyalog-configuration-guide/configuration-parameters/log-file-inuse)|Specifies whether or not the Session log is saved in a session log file| +|Use log file|[Log_File](../../../../dyalog-configuration-guide/configuration-parameters/log-file)|The full pathname of the Session log file| +|Multiline Input|[Dyalog_LineEditor_Mode](../../../../dyalog-configuration-guide/configuration-parameters/dyalog-lineeditor-mode)|Specifies whether or not multi-line input is enabled in the Session.| Note: The value of size-related values defined in the above table is specified as an integer value followed by one of K, M, G, T, P or E. The default, where no character is included, is K (Kilobytes). diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md index 9248a34d5c3..5c57c190539 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md @@ -6,31 +6,31 @@ Table: Configuration dialog: Trace/Edit |Label|Parameter|Description| |---|---|---| -|Classic Dyalog mode|[ClassicMode](../../../../dyalog-configuration-guide/configuration-parameters/classicmode.md)|Selects pre-Version 9 behaviour for Edit and Trace windows.| -|Allow session above edit windows|[SessionOnTop](../../../../dyalog-configuration-guide/configuration-parameters/sessionontop.md)|Specifies whether or not the Session may appear on top of Edit and Trace Windows| -|Single trace window|[ SingleTrace](../../../../dyalog-configuration-guide/configuration-parameters/singletrace.md)|Specifies whether or not there is a single Trace window| -|Remember previous window position|[ClassicModeSavePosition](../../../../dyalog-configuration-guide/configuration-parameters/classicmodesaveposition.md)|Specifies whether or not the current size and location of the first of the editor and tracer windows are remembered in the registry for next time.| -|Allow floating edit windows|[DockableEditWindows](../../../../dyalog-configuration-guide/configuration-parameters/dockableeditwindows.md)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| -|Show status bars|[ StatusOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/statusonedit.md)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| -|Show tool bars|[ ToolBarsOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/toolbarsonedit.md)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| -|Show trace stack on error|[Trace_On_Error](../../../../dyalog-configuration-guide/configuration-parameters/trace-on-error.md)|Specifies whether or not the Tracer is automatically invoked when an error or stop occurs in a defined function| -|Allow search to wrap|[ WrapSearch](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearch.md)|Specifies whether or not Search/Replace in the Editor stops at the top or bottom of the text, or continues from the start or end as appropriate.| -|Show message box if text wraps|[ WrapSearchMsgBox](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearchmsgbox.md)|Specifies whether or not a message box is displayed to inform the user when the search wraps.| -|Warn if trace stack bigger than|[Trace_Level_Warn](../../../../dyalog-configuration-guide/configuration-parameters/trace-level-warn.md)|Specifies the maximum stack size for automatic deployment of the Tracer.| -|Confirm edit window close on Close|[Confirm_Close](../../../../dyalog-configuration-guide/configuration-parameters/confirm-close.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then closes it without saving| -|Confirm edit window close on Edit (and Fix)|[Confirm_Fix](../../../../dyalog-configuration-guide/configuration-parameters/confirm-fix.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then saves it using *Fix* or *Exit*| -|Confirm edit window close on Abort|[Confirm_Abort](../../../../dyalog-configuration-guide/configuration-parameters/confirm-abort.md)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then aborts using| -|Autoformat functions|[ AutoFormat](../../../../dyalog-configuration-guide/configuration-parameters/autoformat.md)|Selects automatic indentation for Control Structures when function is opened for editing| -|Autoindent|[ AutoIndent](../../../../dyalog-configuration-guide/configuration-parameters/autoindent.md)|Selects semi-automatic indentation for Control Structures while editing| -|Double-click to Edit|[ DoubleClickEdit](../../../../dyalog-configuration-guide/configuration-parameters/doubleclickedit.md)|Specifies whether or not double-clicking  over a name invokes the editor| -|Skip blank lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip blank lines.| -|Skip comment lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip comment lines.| -|Skip locals lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines.md)|If enabled, this causes the Tracer to automatically skip locals lines.| -|Limit tracer display to current function in script|[AddClassHeaders](../../../../dyalog-configuration-guide/configuration-parameters/addclassheaders.md)|When Tracing the execution of a function in a script, the Tracer displays either just the first line of the script and the function in question (option enabled), or the entire script (option disabled).| -|Paste text as Unicode (Classic Edition only)|[ UnicodeToClipboard](../../../../dyalog-configuration-guide/configuration-parameters/unicodetoclipboard.md)|Specifies whether or not text transferred to and from the Windows clipboard is to be treated as Unicode| -|Tab stops every|[ TabStops](../../../../dyalog-configuration-guide/configuration-parameters/tabstops.md)|The number of spaces inserted by pressing Tab in an edit window| -|Exit and fix ...|[ InitFullScriptSusp](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptsusp.md)|See Fixing Scripts below| -|If not ...|[InitFullScriptNormal](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptnormal.md)|See Fixing Scripts below| +|Classic Dyalog mode|[ClassicMode](../../../../dyalog-configuration-guide/configuration-parameters/classicmode)|Selects pre-Version 9 behaviour for Edit and Trace windows.| +|Allow session above edit windows|[SessionOnTop](../../../../dyalog-configuration-guide/configuration-parameters/sessionontop)|Specifies whether or not the Session may appear on top of Edit and Trace Windows| +|Single trace window|[ SingleTrace](../../../../dyalog-configuration-guide/configuration-parameters/singletrace)|Specifies whether or not there is a single Trace window| +|Remember previous window position|[ClassicModeSavePosition](../../../../dyalog-configuration-guide/configuration-parameters/classicmodesaveposition)|Specifies whether or not the current size and location of the first of the editor and tracer windows are remembered in the registry for next time.| +|Allow floating edit windows|[DockableEditWindows](../../../../dyalog-configuration-guide/configuration-parameters/dockableeditwindows)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| +|Show status bars|[ StatusOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/statusonedit)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| +|Show tool bars|[ ToolBarsOnEdit](../../../../dyalog-configuration-guide/configuration-parameters/toolbarsonedit)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| +|Show trace stack on error|[Trace_On_Error](../../../../dyalog-configuration-guide/configuration-parameters/trace-on-error)|Specifies whether or not the Tracer is automatically invoked when an error or stop occurs in a defined function| +|Allow search to wrap|[ WrapSearch](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearch)|Specifies whether or not Search/Replace in the Editor stops at the top or bottom of the text, or continues from the start or end as appropriate.| +|Show message box if text wraps|[ WrapSearchMsgBox](../../../../dyalog-configuration-guide/configuration-parameters/wrapsearchmsgbox)|Specifies whether or not a message box is displayed to inform the user when the search wraps.| +|Warn if trace stack bigger than|[Trace_Level_Warn](../../../../dyalog-configuration-guide/configuration-parameters/trace-level-warn)|Specifies the maximum stack size for automatic deployment of the Tracer.| +|Confirm edit window close on Close|[Confirm_Close](../../../../dyalog-configuration-guide/configuration-parameters/confirm-close)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then closes it without saving| +|Confirm edit window close on Edit (and Fix)|[Confirm_Fix](../../../../dyalog-configuration-guide/configuration-parameters/confirm-fix)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then saves it using *Fix* or *Exit*| +|Confirm edit window close on Abort|[Confirm_Abort](../../../../dyalog-configuration-guide/configuration-parameters/confirm-abort)|Specifies whether or not a confirmation dialog is displayed if the user alters the contents of an edit window, then aborts using| +|Autoformat functions|[ AutoFormat](../../../../dyalog-configuration-guide/configuration-parameters/autoformat)|Selects automatic indentation for Control Structures when function is opened for editing| +|Autoindent|[ AutoIndent](../../../../dyalog-configuration-guide/configuration-parameters/autoindent)|Selects semi-automatic indentation for Control Structures while editing| +|Double-click to Edit|[ DoubleClickEdit](../../../../dyalog-configuration-guide/configuration-parameters/doubleclickedit)|Specifies whether or not double-clicking  over a name invokes the editor| +|Skip blank lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines)|If enabled, this causes the Tracer to automatically skip blank lines.| +|Skip comment lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines)|If enabled, this causes the Tracer to automatically skip comment lines.| +|Skip locals lines when tracing|[ SkipLines](../../../../dyalog-configuration-guide/configuration-parameters/skiplines)|If enabled, this causes the Tracer to automatically skip locals lines.| +|Limit tracer display to current function in script|[AddClassHeaders](../../../../dyalog-configuration-guide/configuration-parameters/addclassheaders)|When Tracing the execution of a function in a script, the Tracer displays either just the first line of the script and the function in question (option enabled), or the entire script (option disabled).| +|Paste text as Unicode (Classic Edition only)|[ UnicodeToClipboard](../../../../dyalog-configuration-guide/configuration-parameters/unicodetoclipboard)|Specifies whether or not text transferred to and from the Windows clipboard is to be treated as Unicode| +|Tab stops every|[ TabStops](../../../../dyalog-configuration-guide/configuration-parameters/tabstops)|The number of spaces inserted by pressing Tab in an edit window| +|Exit and fix ...|[ InitFullScriptSusp](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptsusp)|See Fixing Scripts below| +|If not ...|[InitFullScriptNormal](../../../../dyalog-configuration-guide/configuration-parameters/initfullscriptnormal)|See Fixing Scripts below| ## Fixing Scripts diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md index 16b9892cb1e..325e67a79d9 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-unicode-input-tab-unicode-edition-only.md @@ -8,9 +8,9 @@ Table: Configuration dialog: Unicode Input |Label|Parameter|Description| |---|---|---| -|Activate selected keyboard|[InitialKeyboardLayoutInUse](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutinuse.md)|If checked, the specified APL keyboard is activated on start-up.| -|Show keyboards for all Languages|[InitialKeyboardLayoutShowAll](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutshowall.md)|If checked, all installed keyboards are displayed. Otherwise, only Dyalog keyboards are shown| -|Keyboard|[InitialKeyboardLayout](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayout.md)|the APL keyboard to be selected.| +|Activate selected keyboard|[InitialKeyboardLayoutInUse](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutinuse)|If checked, the specified APL keyboard is activated on start-up.| +|Show keyboards for all Languages|[InitialKeyboardLayoutShowAll](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayoutshowall)|If checked, all installed keyboards are displayed. Otherwise, only Dyalog keyboards are shown| +|Keyboard|[InitialKeyboardLayout](../../../../dyalog-configuration-guide/configuration-parameters/initialkeyboardlayout)|the APL keyboard to be selected.| |Configure Layout| |Displays thefollowng dialog box.| ## Input Method Editor Properties @@ -21,8 +21,8 @@ Table: Dyalog Input Method Editor Properties |Label|Parameter|Description| |---|---|---| -|Use Ctrl-X,C,V for clipboard|[UseXCV](../../../../dyalog-configuration-guide/configuration-parameters/usexcv.md)|specifies whether or not the commonly used keystrokes for copy, cut and paste are recognised as such.| +|Use Ctrl-X,C,V for clipboard|[UseXCV](../../../../dyalog-configuration-guide/configuration-parameters/usexcv)|specifies whether or not the commonly used keystrokes for copy, cut and paste are recognised as such.| |Enable Backtick Keyboard introducer| | | -|Enable Overstrikes|[ResolveOverstrikes](../../../../dyalog-configuration-guide/configuration-parameters/resolveoverstrikes.md)|1 = enable overstrikes. 0 = disable overstrikes| +|Enable Overstrikes|[ResolveOverstrikes](../../../../dyalog-configuration-guide/configuration-parameters/resolveoverstrikes)|1 = enable overstrikes. 0 = disable overstrikes| |Overstrikes do not require the OS introducer key| |1 = IME identifies overstrike operation automatically 0 = IME requires the key (default Ctrl+Bksp) to signal an overstrike operation| -|Use Overstrike popup|[OverstrikesPopup](../../../../dyalog-configuration-guide/configuration-parameters/overstrikespopup.md)|1 = enable the overstrike popup. 0 = disable the overstrike popup| +|Use Overstrike popup|[OverstrikesPopup](../../../../dyalog-configuration-guide/configuration-parameters/overstrikespopup)|1 = enable the overstrike popup. 0 = disable the overstrike popup| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md index 0fba6e3ccb2..786a09fc290 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md @@ -6,25 +6,25 @@ Table: Configuration dialog: Windows (Edit Windows) |Label |Parameter |Description | |--------|----------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------| -|Width |[Edit_Cols](../../../../dyalog-configuration-guide/configuration-parameters/edit-cols.md) |The maximum number of rows displayed in a new edit window. | -|Height |[Edit_Rows](../../../../dyalog-configuration-guide/configuration-parameters/edit-rows.md) |The maximum number of columns displayed in a new edit window. | -|X Pos |[Edit_First_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-x.md) |The initial horizontal position in characters of the first edit window. | -|Y Pos |[Edit_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-y.md) |The initial vertical position in characters of the first edit window. | -|X Offset|[Edit_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-x.md)|The initial horizontal position in characters of the second and subsequent edit windows relative to the previous one.| -|Y Offset|[Edit_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-y.md)|The initial vertical position in characters of the second and subsequent edit windows relative to the previous one. | +|Width |[Edit_Cols](../../../../dyalog-configuration-guide/configuration-parameters/edit-cols) |The maximum number of rows displayed in a new edit window. | +|Height |[Edit_Rows](../../../../dyalog-configuration-guide/configuration-parameters/edit-rows) |The maximum number of columns displayed in a new edit window. | +|X Pos |[Edit_First_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-x) |The initial horizontal position in characters of the first edit window. | +|Y Pos |[Edit_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-first-y) |The initial vertical position in characters of the first edit window. | +|X Offset|[Edit_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-x)|The initial horizontal position in characters of the second and subsequent edit windows relative to the previous one.| +|Y Offset|[Edit_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/edit-offset-y)|The initial vertical position in characters of the second and subsequent edit windows relative to the previous one. | Table: Configuration dialog: Windows (Trace Windows) |Label |Parameter |Description | |--------|------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------| -|X Pos |[Trace_First_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-x.md) |The initial horizontal position in characters of the first trace window. | -|Y Pos |[Trace_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-y.md) |The initial vertical position in characters of the first trace window. | -|X Offset|[Trace_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-x.md)|The initial horizontal position in characters of the second and subsequent trace windows relative to the previous one.| -|Y Offset|[Trace_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-y.md)|The initial vertical position in characters of the second and subsequent trace windows relative to the previous one. | +|X Pos |[Trace_First_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-x) |The initial horizontal position in characters of the first trace window. | +|Y Pos |[Trace_First_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-first-y) |The initial vertical position in characters of the first trace window. | +|X Offset|[Trace_Offset_X](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-x)|The initial horizontal position in characters of the second and subsequent trace windows relative to the previous one.| +|Y Offset|[Trace_Offset_Y](../../../../dyalog-configuration-guide/configuration-parameters/trace-offset-y)|The initial vertical position in characters of the second and subsequent trace windows relative to the previous one. | Table: Configuration dialog: Windows (QuadSM Window) |Label |Parameter |Description | |------|----------------------------------------------------|--------------------------------------------| -|Width |[SM_Cols](../../../../dyalog-configuration-guide/configuration-parameters/sm-cols.md)|The width of the `⎕SM` and prefect windows. | -|Height|[SM_Rows](../../../../dyalog-configuration-guide/configuration-parameters/sm-rows.md)|The height of the `⎕SM` and prefect windows.| +|Width |[SM_Cols](../../../../dyalog-configuration-guide/configuration-parameters/sm-cols)|The width of the `⎕SM` and prefect windows. | +|Height|[SM_Rows](../../../../dyalog-configuration-guide/configuration-parameters/sm-rows)|The height of the `⎕SM` and prefect windows.| diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md index 4115060b3c9..bf44fe7b78e 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-workspace-tab.md @@ -6,5 +6,5 @@ Table: Configuration dialog: Workspace |Label |Parameter |Description | |----------------------|--------------------------------------------------|-------------------------------------------------------------------------------------------------| -|Workspace search path |[WSPath](../../../../dyalog-configuration-guide/configuration-parameters/wspath.md)|A list of directories to be searched for the specified workspace when the user executes `)LOAD` .| -|Maximum workspace size|[MaxWS](../../../../dyalog-configuration-guide/configuration-parameters/maxws.md) |The maximum size of the workspace. | +|Workspace search path |[WSPath](../../../../dyalog-configuration-guide/configuration-parameters/wspath)|A list of directories to be searched for the specified workspace when the user executes `)LOAD` .| +|Maximum workspace size|[MaxWS](../../../../dyalog-configuration-guide/configuration-parameters/maxws) |The maximum size of the workspace. | diff --git a/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md b/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md index c49403866af..c5d8f7229d8 100644 --- a/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md +++ b/windows-installation-and-configuration-guide/docs/runtime-applications-and-components.md @@ -18,7 +18,7 @@ All but the first of these are made using the *Export* dialog box accessed from ## Configuration Parameters -Configuration parameters for these run-time applications, both for the Dyalog engine and for your own application settings, may be specified in a number of ways. See [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters.md). +Configuration parameters for these run-time applications, both for the Dyalog engine and for your own application settings, may be specified in a number of ways. See [Configuration Parameters](../../dyalog-configuration-guide/configuration-parameters/configuration-parameters). Nevertheless, it is strongly recommended that you use Configuration files. In this section we will discuss only Application Configuration files, although User Configuration files may be used as well. @@ -54,7 +54,7 @@ The application starts by running `⎕LX` in `myapp.dws`. If a configuration fil dyalogrt.exe Load=myfn.aplf ``` -The application loads the file named `myfn.aplf` which contains the source code for a function, and executes the expression `(myfn 0⍴⊂'')` (see [Load](../../dyalog-configuration-guide/configuration-parameters/load.md)). If a configuration file named `myfn.dcfg` in the same directory, it is loaded and applied. +The application loads the file named `myfn.aplf` which contains the source code for a function, and executes the expression `(myfn 0⍴⊂'')` (see [Load](../../dyalog-configuration-guide/configuration-parameters/load)). If a configuration file named `myfn.dcfg` in the same directory, it is loaded and applied. If your application uses any component of the Microsoft .NET Framework, you must distribute the Bridge DLL and DyalogNet DLLs. These DLLs must be placed in the same directory as your EXE. From d50a75e650c271d27d859033fcab5ee8a8e112b7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 14:50:54 +0100 Subject: [PATCH 22/37] Add UNIX-only configuration parameters to the guide Migrate the parameters that exist only on UNIX and macOS from the UNIX guide's environment-variables page into the Configuration Guide, each on its own page with an availability admonition: APLSTATUSFD, DYALOG_SERIALFILE, DYALOG_SHELL_SUBPROCESS (AIX), EDITOR_COLUMNS, and the Classic-edition translate-table overrides APLK0 and APLTn. Add them to the navigation and a new "UNIX and macOS specific" section of the by-category listing, and repoint language-reference-guide/shell.md at the new DYALOG_SHELL_SUBPROCESS page. TERM and LIBPATH are deliberately not migrated: they are standard operating- system environment variables (whose names vary by platform) that Dyalog merely respects, not Dyalog configuration parameters. Defaults that were not recorded in the migrated source are flagged with REVIEW comments. Refs Dyalog/documentation#719 --- .../docs/configuration-parameters/aplk0.md | 11 +++++++++++ .../docs/configuration-parameters/aplstatusfd.md | 10 ++++++++++ .../docs/configuration-parameters/apltn.md | 11 +++++++++++ .../configuration-parameters-by-category.md | 13 +++++++++++++ .../dyalog-serialfile.md | 12 ++++++++++++ .../dyalog-shell-subprocess.md | 13 +++++++++++++ .../configuration-parameters/editor-columns.md | 16 ++++++++++++++++ dyalog-configuration-guide/mkdocs.yml | 6 ++++++ .../docs/system-functions/shell.md | 2 +- 9 files changed, 93 insertions(+), 1 deletion(-) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/aplk0.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/aplstatusfd.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/apltn.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/dyalog-shell-subprocess.md create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/editor-columns.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplk0.md b/dyalog-configuration-guide/docs/configuration-parameters/aplk0.md new file mode 100644 index 00000000000..be60e8e1256 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplk0.md @@ -0,0 +1,11 @@ +# APLK0 + +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog on the UNIX and macOS operating systems. + +An input translate table that overrides [`APLK`](aplk.md), if set. It takes precedence over the table implied by the terminal type. + +Valid values are the name of a `.din` input translate table. + + +Related parameters: [APLK](aplk.md), [APLKeys](aplkeys.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplstatusfd.md b/dyalog-configuration-guide/docs/configuration-parameters/aplstatusfd.md new file mode 100644 index 00000000000..7bb90462ce5 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplstatusfd.md @@ -0,0 +1,10 @@ +# APLSTATUSFD + +!!! Info "Information" + This configuration parameter is only relevant on the UNIX and macOS operating systems. + +The number of the output stream (file descriptor) on which messages for the Status window are written. Setting it allows this output to be redirected when Dyalog is started. + +Valid values are a file descriptor number. + +Default is unset, in which case the output appears in the same terminal window as the Session (although it is not part of the Session, and can be cleared with the Screen Redraw command key, often `Ctrl+L`). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apltn.md b/dyalog-configuration-guide/docs/configuration-parameters/apltn.md new file mode 100644 index 00000000000..d325f737e21 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/apltn.md @@ -0,0 +1,11 @@ +# APLTn + +!!! Info "Information" + This configuration parameter is only relevant when using the Classic edition of Dyalog on the UNIX and macOS operating systems. + +An output translate table that overrides [`APLT`](aplt.md), if set. The name ends with a digit (for example `APLT0`), so that more than one can be defined. It takes precedence over the table implied by the terminal type. + +Valid values are the name of an output translate table. + + +Related parameters: [APLT](aplt.md), [APLTrans](apltrans.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md index 1c4e3c9b224..b9c01c76a62 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md @@ -270,6 +270,19 @@ These control the user-command framework. |----|-----------| |[`UCMDCacheFile`](ucmdcachefile.md)|The name of the User Command cache file| +## UNIX and macOS specific + +These parameters are only relevant on the UNIX and macOS operating systems. + +|Name|Description| +|----|-----------| +|[`APLSTATUSFD`](aplstatusfd.md)|The output stream on which Status window messages are written| +|[`APLK0`](aplk0.md)|An input translate table that overrides `APLK` (Classic edition)| +|[`APLTn`](apltn.md)|An output translate table that overrides `APLT` (Classic edition)| +|[`DYALOG_SERIALFILE`](dyalog-serialfile.md)|The path to the file containing your Dyalog serial number| +|[`DYALOG_SHELL_SUBPROCESS`](dyalog-shell-subprocess.md)|Whether a child process handles `⎕SHELL` calls (AIX)| +|[`EDITOR_COLUMNS`](editor-columns.md)|The columns shown in the Editor for each type of object| + ## Miscellaneous |Name|Description| diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md new file mode 100644 index 00000000000..337588ec4c5 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md @@ -0,0 +1,12 @@ +# DYALOG_SERIALFILE + +!!! Info "Information" + This configuration parameter is only relevant on the UNIX and macOS operating systems. + +The full path to the text file that contains your Dyalog serial number. + +Valid values are a file path. + +Default is unset. + +Related parameters: [DYALOG_SERIAL](dyalog-serial.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-shell-subprocess.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-shell-subprocess.md new file mode 100644 index 00000000000..96e1f5b6336 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-shell-subprocess.md @@ -0,0 +1,13 @@ +# DYALOG_SHELL_SUBPROCESS + +!!! Info "Information" + This configuration parameter is only relevant on the AIX operating system. + +Whether the interpreter starts a small child process to handle calls to [`⎕SHELL`](../../../language-reference-guide/system-functions/shell). This improves the performance of `⎕SHELL` on AIX. + +Valid values are: + +- `0` : calls to `⎕SHELL` are handled without a child process +- `1` : the interpreter starts a child process to handle calls to `⎕SHELL` + +Default is `1`. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/editor-columns.md b/dyalog-configuration-guide/docs/configuration-parameters/editor-columns.md new file mode 100644 index 00000000000..bba28878d7d --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/editor-columns.md @@ -0,0 +1,16 @@ +# EDITOR_COLUMNS + +!!! Info "Information" + This configuration parameter is only relevant on the UNIX and macOS operating systems. + +The columns shown in the Editor, set separately for each type of object. There is one parameter per object type: + +- `EDITOR_COLUMNS_CHARACTER_ARRAY` +- `EDITOR_COLUMNS_CLASS` +- `EDITOR_COLUMNS_FUNCTION` +- `EDITOR_COLUMNS_NAMESPACE` +- `EDITOR_COLUMNS_NUMERIC_ARRAY` + +Valid values are a list of column names. + +See also [Configuring the Editor](../../../unix-installation-and-configuration-guide/configuring-the-editor). diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml index 9c56f7c031b..d53bcd664ef 100644 --- a/dyalog-configuration-guide/mkdocs.yml +++ b/dyalog-configuration-guide/mkdocs.yml @@ -72,9 +72,12 @@ nav: - APLAN_FOR_OUTPUT: configuration-parameters/aplan-for-output.md - AplCoreName: configuration-parameters/aplcorename.md - aplk: configuration-parameters/aplk.md + - APLK0: configuration-parameters/aplk0.md - aplkeys: configuration-parameters/aplkeys.md - aplnid: configuration-parameters/aplnid.md + - APLSTATUSFD: configuration-parameters/aplstatusfd.md - aplt: configuration-parameters/aplt.md + - APLTn: configuration-parameters/apltn.md - apltrans: configuration-parameters/apltrans.md - APL_CODE_E_MAGNITUDE: configuration-parameters/apl-code-e-magnitude.md - APL_COMPLEX_AS_V12: configuration-parameters/apl-complex-as-v12.md @@ -137,6 +140,9 @@ nav: - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md - DYALOG_PIXEL_TYPE: configuration-parameters/dyalog-pixel-type.md - DYALOG_SERIAL: configuration-parameters/dyalog-serial.md + - DYALOG_SERIALFILE: configuration-parameters/dyalog-serialfile.md + - DYALOG_SHELL_SUBPROCESS: configuration-parameters/dyalog-shell-subprocess.md + - EDITOR_COLUMNS: configuration-parameters/editor-columns.md - EditorState: configuration-parameters/editorstate.md - Edit_Cols: configuration-parameters/edit-cols.md - Edit_First_X: configuration-parameters/edit-first-x.md diff --git a/language-reference-guide/docs/system-functions/shell.md b/language-reference-guide/docs/system-functions/shell.md index aa7390af6a3..2b955b327e8 100644 --- a/language-reference-guide/docs/system-functions/shell.md +++ b/language-reference-guide/docs/system-functions/shell.md @@ -306,7 +306,7 @@ The default for the input stream is - `(0 'Null')`: Provide no data on standard input. !!! unix "Dyalog on AIX" - The performance of `⎕SHELL` on AIX can be improved using the [`DYALOG_SHELL_SUBPROCESS`](../../../unix-installation-and-configuration-guide/configuration-parameters/environment-variables/#_table-4) configuration parameter; this configuration parameter is active by default. + The performance of `⎕SHELL` on AIX can be improved using the [`DYALOG_SHELL_SUBPROCESS`](../../../dyalog-configuration-guide/configuration-parameters/dyalog-shell-subprocess) configuration parameter; this configuration parameter is active by default.
From 2d61e4fa6a0d469aa8519c307138e21746a59a3e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 17:16:33 +0100 Subject: [PATCH 23/37] Add remaining per-OS notes for shared parameters Most per-OS behaviour was already captured when the parameters were templated (aplnid, Dyalog_NETCore, Enable_CEF, MaxWS, Default_WX, Log_File, Auto_PW, Session_File). Fill the last gaps from the UNIX guide: the Dyalog parameter is set by the mapl startup script on UNIX and macOS (with the reliable way to locate the executable); APL_TextInAplCore is 0 in the interpreter but set to 1 by the startup script; and APLKeys and APLTrans fall back to the Dyalog directory, then /usr/dyalog, on UNIX and macOS. The APLKeys/APLTrans per-OS defaults are flagged for reconciliation. Refs Dyalog/documentation#719 --- .../docs/configuration-parameters/apl-textinaplcore.md | 2 +- .../docs/configuration-parameters/aplkeys.md | 3 +++ .../docs/configuration-parameters/apltrans.md | 3 +++ .../docs/configuration-parameters/dyalog.md | 3 +++ 4 files changed, 10 insertions(+), 1 deletion(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md b/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md index 9d15f5ba2f7..b4e9fbb3987 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apl-textinaplcore.md @@ -7,6 +7,6 @@ Valid values are: - `0` : the information is omitted - `1` : the information is included -Default is `1`. +Default is `1` (the interpreter's own default is `0`, but on UNIX and macOS the supplied startup script sets it to `1`). Related parameters: [AplCoreName](aplcorename.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md index 459110c3102..f0014a23b34 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplkeys.md @@ -9,6 +9,9 @@ Valid values are a list of directory paths. Default is the `aplkeys` sub-directory of the Dyalog installation directory (given by [`Dyalog`](dyalog.md)). +On UNIX and macOS, if this parameter is unset the search path defaults to the directory given by [`Dyalog`](dyalog.md); if that is also unset, it defaults to `/usr/dyalog`. + + Related parameters: [APLK](aplk.md), [Dyalog](dyalog.md). See also the [Input tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-input-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md index f97f5d0ed36..08d2c36657b 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/apltrans.md @@ -9,6 +9,9 @@ Valid values are a list of directory paths. Default is the `apltrans` sub-directory of the Dyalog installation directory (given by [`Dyalog`](dyalog.md)). +On UNIX and macOS, if this parameter is unset the search path defaults to the directory given by [`Dyalog`](dyalog.md); if that is also unset, it defaults to `/usr/dyalog`. + + Related parameters: [APLT](aplt.md), [Dyalog](dyalog.md). See also the [Output tab](../../../windows-installation-and-configuration-guide/configuring-the-ide/configuration-dialog/configuration-dialog-output-tab-classic-edition-only) of the Windows Configuration Dialog. diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md index 512ac846691..d31ff36ebeb 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog.md @@ -6,4 +6,7 @@ Valid values are a directory path. Default is the directory from which the Dyalog program was loaded. +!!! Info "Information" + On UNIX and macOS this parameter is set by the supplied startup script (`mapl`). To find the location of the Dyalog executable itself, read it from the process information (for example `/proc//` on Linux, or the output of `ps`) rather than from this parameter. + Related parameters: [DyalogInstallDir](dyaloginstalldir.md). From f1243b3ce63970e8f7a2d473d1330a93f9d681a1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 17:49:24 +0100 Subject: [PATCH 24/37] Trim the OS guides to reference the Configuration Guide The Windows and UNIX guides restated the configuration-file syntax, precedence order, and environment-variable list that the Configuration Guide now documents cross-platform. Replace that duplicated material with a short summary and links into the Configuration Guide: the Windows configuration-files page, and the UNIX configuration-parameters, configuration-files, and environment-variables pages. Everything removed has an equivalent in the Configuration Guide, including the Windows credentials warning and the Configuration Dialog/Registry interaction. The one exception was the rule that a back-slash in a parameter name becomes an underscore in the equivalent environment variable, which is added to the Configuration Guide's environment-variables page. Verified with a local mkdocs build: the pointer links resolve and the repository's broken-link count is unchanged. Refs Dyalog/documentation#719 --- .../docs/how-to-set/environment-variables.md | 2 + .../configuration-files.md | 80 +-------- .../configuration-parameters.md | 12 +- .../environment-variables.md | 128 +-------------- .../docs/configuration-files.md | 153 +----------------- 5 files changed, 19 insertions(+), 356 deletions(-) diff --git a/dyalog-configuration-guide/docs/how-to-set/environment-variables.md b/dyalog-configuration-guide/docs/how-to-set/environment-variables.md index 909f334efd7..373ccddd081 100644 --- a/dyalog-configuration-guide/docs/how-to-set/environment-variables.md +++ b/dyalog-configuration-guide/docs/how-to-set/environment-variables.md @@ -4,5 +4,7 @@ A configuration parameter can be set as an environment variable in the environme On UNIX and macOS, environment variable names are given in upper case, for example `MAXWS`. On Microsoft Windows, parameter names are not case-sensitive. +If a parameter's name contains a back-slash (that is, the parameter lives in a sub-key, such as `SALT\CommandFolder`), replace the back-slash with an underscore when setting it as an environment variable, for example `SALT_CommandFolder`. + !!! Hint "Hints and Recommendations" Dyalog Ltd recommends that [configuration files](application-configuration-files.md) are used for all run-time applications, and that the use of environment variables for this purpose is eliminated. Configuration files are text-based, portable across platforms, and easily managed alongside application source code. diff --git a/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-files.md b/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-files.md index bf67263ef94..e02349557c3 100644 --- a/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-files.md +++ b/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-files.md @@ -1,79 +1,11 @@ # Configuration Files -A configuration file is a text file containing configuration parameters and values. It can cascade, that is, it can extend (inherit) configuration values from other configuration files, and supplement and/or override them. Configuration files use JSON5 (a superset of standard JSON) syntax and are portable across all systems supported by Dyalog. +A configuration file is a text file, in JSON5 syntax, that holds configuration parameters and their values, and is portable across all platforms that Dyalog supports. -The key benefits of defining configuration parameters using configuration files include: +Configuration files and their structure are documented, for all platforms, in the Dyalog Configuration Guide: -- Configuration files are text-based. They are, therefore, easily managed along with the source code for an application, using industry standard tools for source code management and continuous integration. -- Application configuration files can be placed in application folders and define the configuration settings for a specific application. -- User configuration files provide settings that are the same for all applications. Typically, these files are used to configure the development environment. -- Interpreter configuration can be performed in the same way across all supported platforms. -- Dyalog can be launched from a text file that defines a function, namespace or class. If a configuration file exists with the same name as this file (but with a *.dcfg* extension), then Dyalog will detect this on launching and use the configuration parameter settings it defines. -- Configuration files are easy to read, and can be written directly or by using `⎕JSON` (which supports JSON5). -- Both application and user configuration files can cascade, overriding settings defined in a more generic configuration file; this simplifies the configuration of components which share some configuration. +- [Application Configuration Files](../../../dyalog-configuration-guide/how-to-set/application-configuration-files) +- [User Configuration Files](../../../dyalog-configuration-guide/how-to-set/user-configuration-files) +- [Configuration File Structure](../../../dyalog-configuration-guide/how-to-set/configuration-file-structure) -Dyalog Ltd recommends that configuration files are used for all run-time applications, and that the use of environment variables for this purpose is eliminated. - -There are two different types of configuration file: - -- A user configuration file – this defines configuration values for the current (possibly only) user of the system. The first time a new version of Dyalog is launched it creates and initialises a user configuration file called *\$HOME/.dyalog/dyalog.<version-specific>.dcfg*, where the version-specific information comprises the version number, edition and width. For example, a 64‑bit Unicode edition of Dyalog version 18.0 will be identified as *180U64*. The name of this file should not be changed. -- An application configuration file – this contains configuration values associated with a specific application. This is created by the user and should be saved at the same level as the application. It can either be given the same name as the workspace/script that is loaded when the application starts (but with the extension *.dcfg*) or the name should be stored in the CONFIGFILE parameter. - -An additional configuration file called *\$HOME/.dyalog/dyalog.dcfg* is also created the first time any version of Dyalog is run. This can be edited to include configuration parameter values that should always be applied irrespective of Dyalog version so that they do not have to be redefined in multiple version-specific user configuration files. - -Prior to Dyalog version 18.0, configuration parameters could be specified as environment variables and set in the *\$HOME/.dyalog/dyalog.config* script. This is no longer referenced, and any settings that should be retained must be re-entered in the appropriate *\$HOME/.dyalog/dyalog.<version-specific>.dcfg* configuration file. - -## Configuration File Structure - -Configuration files define configuration parameters using JSON5. A JSON object contains data in the form of key/value pairs and other JSON objects. The keys are strings and the values are the JSON types. A key and its value are seperated by a colon (`:`) character. Entries (key/value pairs) are separated by comma (`,`) characters. - -The top-level object defines an optional key called `Extend` and an optional object called `Settings`: - -- `Extend` is a string value containing the name of a configuration file to import. The extended (imported) file can extend another configuration file. Configuration values from the imported file(s) can be overridden by redefining them. The file name is implicitly relative to the name of the file that imports it (any file name extension must be explicitly specified). -- `Settings` is an object containing the names of configuration parameters and their values. The values can be a string, a number or an array of strings. - -The names and values correspond to configuration parameters, and names are not case sensitive. Any named values can be defined; an APL application could query the values using `+2⎕NQ'.' 'GetEnvironment' ` or using the `]Config` user command. - -If the same name is defined multiple times within a configuration file then the first definition will be used and a warning will be generated. - -## Arrays - -An array can be used to define file paths, for example, `WSPATH: ["/dir1", "/dir2"]`. The only parameters which can be defined as arrays are **WSPATH**, **WSEXT** and **CFEXT**. - -## References to other Configuration Parameters - -Configuration parameters that are string values can include references to other configuration parameters (irrespective of where they are defined) using square bracket delimiters. For example, `MySetting: "[DYALOG]/MyFile"` will replace `[DYALOG]` with the value of the **DYALOG** configuration parameter. - -If the referenced configuration parameter is not defined then no substitution will take place; the reference, including the square bracket delimiters, will remain in place. - -To include literal square brackets in a string, prefix them with a `\` character. - -## Nested Structures - -Configuration files support nested parameter structures by defining an object that corresponds to the structure. For example: -``` -Captions: { - Session: "My Dyalog Session" - Status: "My Status window" -} -``` -```apl - +2 ⎕NQ '.' 'GetEnvironment' 'Captions\Session' -My Dyalog Session -``` - -## Example Configuration File Content -``` -{ - Extend: "my_default_configuration.dcfg", - Settings: { - // maximum workspace - MAXWS: "2GB", - WSPATH: ["/dir1", "/dir2", ""], - UserOption: 123, - ROOTDIR: "/my/root/directory", - // references to other configuration parameters - FNAME: "[rootdir]/filename", - } -} -``` +On UNIX and macOS, user configuration files are held in `$HOME/.dyalog/`. diff --git a/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md b/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md index 155b53a9e62..59981fb657f 100644 --- a/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md +++ b/unix-installation-and-configuration-guide/docs/configuration-parameters/configuration-parameters.md @@ -1,13 +1,5 @@ # Configuration Parameters -Dyalog can be customised using configuration parameters. These can be set in various ways; if a configuration parameter is set in multiple places the following descending order of precedence applies: +Dyalog is customised using configuration parameters. The parameters, the ways to set them (the command line, application and user configuration files, environment variables, and built-in defaults), and the order of precedence when a parameter is set in more than one place are documented, for all platforms, in the [Dyalog Configuration Guide](../../../dyalog-configuration-guide/introduction). -1. command line settings -2. application configuration file settings -3. environment variable settings -4. user configuration file settings -5. built-in defaults - -This provides a great deal of flexibility, enabling a user to override one setting with another. For example, a "usual" workspace size (**MAXWS**) can be defined in the user configuration file, but be temporarily superseded by entering a different value when starting a Dyalog Session from the command line. - -For more information on configuration files, see [Configuration Files](configuration-files.md). For more information on environment variables, see [Environment Variables](environment-variables.md). +The parameters that apply only to UNIX and macOS, and the platform-specific defaults and behaviour of the shared parameters, are noted on the individual parameter pages there. 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 4dedf4b26f9..4d3fcb7ccd6 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 @@ -1,129 +1,5 @@ # Environment Variables -Environment variables are used to configure various aspects of Dyalog APL. The complete list appears in the *Dyalog for Microsoft Windows Installation and Configuration Guide: Configuration Parameters*; this section discusses those variables which are of particular importance to the Non-GUI versions of Dyalog APL, and lists those that have meaning to the UNIX versions. Additionally there some non-GUI-specific variables which are described below and some which either do not apply, or may not work as the user might at first expect. +A configuration parameter can be set as an environment variable. This mechanism, the order of precedence, and the full list of parameters (including those specific to UNIX and macOS) are documented in the [Dyalog Configuration Guide](../../../dyalog-configuration-guide/how-to-set/environment-variables). -Under UNIX, all environment variables should appear in UPPER CASE. For example, to set the default value of `⎕ML` to 3, then -``` -$ export DEFAULT_ML=3 -``` - -If a configuration parameter described in the *Dyalog for Microsoft Windows Installation and Configuration Guide* has a backslash "\" in its name (strictly speaking, appears in a subkey of the Dyalog key in the Windows Registry), this should be replaced with an underscore in the equivalent environment variable. This applies for example to SALT\CommandFolder. - -Many of these environment variables are set in the mapl script; their values are either appropriate for the installation location of Dyalog APL, or are set to define reasonable default values. - -The environment variables are broken down into several tables: - -- [Table 1](#_table-1): The most commonly defined and used for non-GUI versions of Dyalog APL under UNIX. Most of these variables are essential for a usable APL session -- [Table 2](#_table-2): Variables used to control default values in the workspace -- [Table 3](#_table-3): Variables used to configure the Session -- [Table 4](#_table-4): Miscellaneous Variables used by non-GUI Dyalog APL -- [Table 5](#_table-5): Editor-related environment variables -- [Table 6](#_table-6): Tracer-related environment variables -- [Table 7](#_table-7): Ride-related environment variables -- [Table 8](#_table-8): SALT and User Command-related environment variables - -Table: Commonly used Variables - -|Variable|Notes| -|---|---| -|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).| -|`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).| -|`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.| -|`WSPATH`|Defines the search path for both workspaces and Auxiliary processors.

If unset, there is no default value. Workspaces and APs that are not on the `WSPATH` can be accessed using absolute or relative pathnames.| - -## Note - -Currently the value of the **Enable_CEF** parameter defined in the Windows Registry or in a -Configuration file is ignored. Only the value set in the command line or as an -environment variable is honoured. If not defined in this way, the default value -is used. - -Under macOS and Linux, if the configuration parameter **ENABLE_CEF** is 1, Auxiliary Processors cannot be used (they hang on error). The default value is 1 unless you are not running under a desktop (for example, you are running Dyalog in a PuTTY session when the default is 0). - -Table: Default workspace values - -|Variable|Notes| -|---|---| -|`DEFAULT_DIV`|Default value for `⎕DIV` in a clear workspace.| -|`DEFAULT_IO`|Default value for `⎕IO` in a clear workspace.| -|`DEFAULT_ML`|Default value for `⎕ML` in a clear workspace.| -|`DEFAULT_PP`|Default value for `⎕PP` in a clear workspace.| -|`AUTO_PW` `DEFAULT_PW`|`⎕PW` is set by the interpreter when it starts, or when the session window is resized. Under UNIX if the terminal window is resized, the session will be resized when the interpreter next checks for input.| -|`DEFAULT_RTL`|Default value for `⎕RTL` in a clear workspace.| -|`DEFAULT_WX`|Default value for `⎕WX` in a clear workspace. Note that although the UNIX versions of Dyalog APL do not have GUI objects, `⎕SE` is present, and the value of `⎕WX` will affect the programmer's ability to run expressions such as `⎕SE.PropList`.| - -For numeric values, the interpreter takes the value of the environment variable, and prepends a "0" to that string. It then parses the string, accepting characters until the first non-digit character is reached. - -This string, now of digits only, is converted into an integer. If the resulting value is valid, then that is the value that will be used in the workspace. If the resulting value is invalid, then the default value will be used instead. - -Table: Variables used to configure the Session - -|Variable|Notes| -|---|---| -|`APLAN_FOR_OUTPUT`|Enable or disable use of [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) for session output| -|`DYALOGLINK`|Specifies the directory for Link| -|`DYALOGSTARTUPSE`|Specifies one or more *Session initialisation* directories that contain APL code to be installed in `⎕SE`| -|`DYALOGSTART_X`|Specifies whether the `Run` function is executed during Session startup| -|`DYALOG_GUTTER_ENABLE`|Enable or disable Session Gutter| -|`HISTORY_SIZE`|The size of the prior line buffer| -|`INPUT_SIZE`|The size of the buffer used to store lines marked for execution| -|`LOG_FILE` `LOG_FILE_INUSE` `LOG_SIZE`|These three variables determine the name of the session log file (default `~/.dyalog/session_log__*.dlf`, for example, `~/.dyalog/session_log_190U64_*.dlf`), whether a log file is created or not, and the size of the log file in KB. Be aware: the session log file is not interchangeable between the different editions and widths of APL; in a mixed environment it is strongly recommended to use a different log file for each version.| -|`PFKEY_SIZE`|The size of the buffer used to hold `PFKEY` definitions: if this is too small, an attempt to add a new definition will result in a `LIMIT ERROR`.| -|`SESSION_FILE`|Defines the location of your session file; session file support was added in Dyalog 13.1. The default value is `$DYALOG/default.dse`| - -To set values, use K to indicate KB. Note that the buffers will contain other information, so the buffer size will not be exact. Note also that multibyte Unicode characters will take up more space than single byte characters, and that 32 and 64 bit versions of Dyalog APL can require different amounts of space for holding the same information. - -Example: -``` -HISTORY_SIZE=4K my_apl_startup_script -``` - -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.| -|`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`.| -|`DYALOG_SHELL_SUBPROCESS`|On AIX, if `DYALOG_SHELL_SUBPROCESS` is `1` (the default on AIX), the interpreter starts a (small) child process that handles calls to `⎕SHELL`.| - -These are the remaining variables listed in the *Dyalog for Microsoft Windows Installation and Configuration Guide* which are effective in the non-GUI UNIX versions of Dyalog APL - -Table: Editor-related environment variables - -|---|---| -|Variable|Notes| -|`APLAN_FOR_EDITOR`|Enable or disable use of [array notation](../../../programming-reference-guide/introduction/arrays/array-notation/) for editing arrays| -|`EDITOR_COLUMNS_*`|See [Configuring the Editor](../configuring-the-editor.md). Can be one of `EDITOR_COLUMNS_CHARACTER_ARRAY EDITOR_COLUMNS_CLASS EDITOR_COLUMNS_FUNCTION EDITOR_COLUMNS_NAMESPACE EDITOR_COLUMNS_NUMERIC_ARRAY`| -|`DYALOG_DISCARD_FN_SOURCE`|Specifies whether source code is retained in the workspace| - -Table: Tracer-related environment variables - -|--------------|--------------------------------------------------------------------------------------| -|Variable |Notes | -|`TRACE_ON_ERROR`|With this is set to 1 (the default) the tracer is opened if an untrapped error occurs.| - -Table: Ride-related environment variables - -|---------|----------------------------------------------------------------------------| -|Variable |Notes | -|`RIDE_INIT`|Enables and configures Ride; see the [Ride User Guide](https://dyalog.github.io/ride) for more information.| - -Table: SALT and user commands related environment variables - -|---|---| -|Variable|Notes| -|`SESSION_FILE`|Specifies the location of the file containing `⎕SE` . The default value is `$DYALOG/default.dse`| -|`UCMDCACHEFILE`|Specifies the location of the user command cache file. Defaults to `"UserCommand{UcmdMajor}{UcmdMinor}.{DyalogMajor}{DyalogMinor}{U|C}{bits}.cache"` , for example, `UserCommand25.182U64.cache` in the `dyalog` directory.| - -Further information about SALT and user commands appear in the *User Commands User Guide* and the *SALT User Guide*. +On UNIX and macOS, environment variable names are given in upper case, for example `MAXWS`. diff --git a/windows-installation-and-configuration-guide/docs/configuration-files.md b/windows-installation-and-configuration-guide/docs/configuration-files.md index 2c0103246ba..051d23d5dea 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-files.md +++ b/windows-installation-and-configuration-guide/docs/configuration-files.md @@ -1,151 +1,12 @@ # Configuration Files -## Introduction +A configuration file is an optional text file, in JSON5 syntax, that holds configuration parameters and their values. Configuration files are portable across all platforms that Dyalog supports. -A configuration file is an optional text file containing configuration parameters and their values. It may cascade, that is, it can extend (inherit) configuration values from other configuration files, and supplement and/or override them. +Configuration files, their structure, and how they combine with the other ways of setting configuration parameters are documented, for all platforms, in the Dyalog Configuration Guide: -Configuration files use JSON5 (a superset of standard JSON) syntax, as described below. These files are portable across all systems supported by Dyalog. +- [Application Configuration Files](../../dyalog-configuration-guide/how-to-set/application-configuration-files) +- [User Configuration Files](../../dyalog-configuration-guide/how-to-set/user-configuration-files) +- [Configuration File Structure](../../dyalog-configuration-guide/how-to-set/configuration-file-structure) +- [Order of Precedence](../../dyalog-configuration-guide/how-to-set/order-of-precedence) -Although it is possible to include user credentials such as login details or passwords in configuration files, Dyalog very strongly recommends against doing this even if the credentials are encrypted as this should be considered to be a very significant security risk. - -**Names of configuration parameters defined in Configuration files may be specified in any combination of alphabetic case.** - -Dyalog processes up to two kinds of configuration file (each of which may cascade): - -1. An application configuration file which contains configuration values associated with a specific application -2. A user configuration file which defines configuration values for the current, and possibly only, user of the system. - -## Application Configuration File - -When Dyalog starts, it derives the name of the application configuration file as follows: - -- The name in the configuration parameter **ConfigFile** if it is set, otherwise -- The name of the workspace or script loaded at start-up using the **Load** parameter, with the extension replaced by `.dcfg`, if that file exists, otherwise -- Nothing. - -## User Configuration File - -The name of the user configuration file is specified by the **UserConfigFile** parameter. Under Windows, this parameter is not set by default but may be defined by the user. - -## Precedence - -Configuration files supplement existing methods of defining parameters. The following precedence table shows the order of precedence when a setting is defined in multiple places: - -- Command-line settings override -- Application configuration file settings, which override -- Environment variable settings, which override -- User configuration file settings, which override -- Settings in the registry (Windows only), which override -- Built-in defaults - -## Configuration Files and The Configuration Dialog - -The Configuration Dialog reflects the values of parameters stored in the Windows Registry and ignores overriding values defined on the command-line, in configuration files or in environment variables. If the user changes parameters using the Configuration Dialog, the new values are recorded in the Registry, but remain overridden by those that take precedence. - -## Configuration File Structure - -Configuration files define configuration parameters using JSON5. A JSON object contains data in the form of key/value pairs and other JSON objects. The keys are strings and the values are the JSON types. Keys and values are separated by colon. Each entry (key/value pair) is separated by comma. - -The top-level object defines an optional key named **Extend** and an optional object named **Settings**. - -**Extend** is a string value containing the name of a configuration file to import. The extended (imported) file may in turn extend another configuration file. Configuration values from the imported file(s) may be overridden by redefining them. The file name is implicitly relative to the name of the file which imports it. Any file name extension must be explicitly specified. - -**Settings** is an object containing the names of configuration parameters and their values. The values may be: - -- A string -- A number -- An array of strings - -The names and values correspond to configuration parameters, but names are not case sensitive. Any named values may be defined; an APL application may query the values using `+2⎕NQ'.' 'GetEnvironment' name`, or using the `]Config` user command. Note that `GetEnvironment` returns the value in use as defined by the precedence rules (see **Precedence above**). - -

Example

-```apl - +2 ⎕NQ '.' 'GetEnvironment' ('MaxWS' 'Captions\Session') -┌────┬───────────────────────┐ -│256M│My Dyalog V18.0 Session│ -└────┴───────────────────────┘ - ]Config MaxWS Captions\Session -┌────────────────┬───────────────────────┐ -│MaxWS │256M │ -├────────────────┼───────────────────────┤ -│Captions\Session│My Dyalog V18.0 Session│ -└────────────────┴───────────────────────┘ - -``` - -A warning will be given if names are redefined in the same configuration file; the second and subsequent definitions will be discarded. - -## File Names - -Pathnames specified in configuration files should be specified using portable forward slashes "/" rather than back-slashes "\" as the latter are used as escape characters by JSON. - -`WSPATH: ["c:/Dyalog18.0"]` or `WSPATH: ["c:\\Dyalog18.0"]` specifies the file `c:\Dyalog18.0`. - -whereas, - -`WSPATH: ["c:\Dyalog18.0"]` means `c:Dyalog18.0`. - -

Example

-```apl -{ - Extend: "my_default_configuration.dcfg", - - Settings: { - // maximum workspace - MAXWS: "2GB", - WSPATH: ["/dir1", "/dir2", ""], - UserOption: 123, - ROOTDIR: "/my/root/directory", - // references to other configuration parameters - FNAME: "[rootdir]/filename", - } -} -``` - -## Arrays - -An array may be used to define file paths etc. For example, -```apl -WSPATH: ["/dir1", "/dir2"] -``` - -The only parameters which may be defined as arrays are **WSPATH**, **WSEXT** and **CFEXT**. - -#### References to other Configuration Parameters - -Configuration parameters which are string values may include references to other configuration parameters (regardless of where they are defined) using square bracket delimiters. For example: -```apl -MySetting: "[DYALOG]/MyFile" -``` - -will replace `[DYALOG`] with the value of the **DYALOG** configuration value. - -If the string inside the `[]` delimiters is "`.`", the "`.`" is replaced is replaced with the path of the directory containing the configuration file itself. Therefore, -```apl -FILENAME: "[.]/x.txt" -``` - -will set the parameter **FILENAME** to a value which is a reference to a file called `x.txt` in the same directory as the configuration file defining it. - -Note that: - -- If the referenced configuration parameter is not defined then no substitution will take place; the reference, including square bracket delimiters, will remain in place. -- To include square brackets in a string, prefix the '[' with a '\' character. - -#### Nested Structures - -Some parameters are stored in sub-folders in the Windows Registry. Currently, all such parameters used by Dyalog APL itself relate to the Windows IDE, but you can create your own application-specific structures.. - -The Configuration file supports this structure by defining an object that corresponds to a Registry sub-folder. For example: -```apl -Captions: { - Session: "My Dyalog Session", - Status: "My Status window", -} -``` - -```apl - +2 ⎕NQ '.' 'GetEnvironment' 'Captions\Session' -My Dyalog Session - -``` +On Microsoft Windows, configuration parameters can also be held in the [Windows Registry](../../dyalog-configuration-guide/how-to-set/registry), which the Configuration Dialog reads and writes. From 41ee1dfb478db44dda7bb13b0fc39b5595886a6a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 17:59:31 +0100 Subject: [PATCH 25/37] Show the tab case for unescaped back-slashes in file names An unescaped back-slash in a path is accepted rather than reported as an error, so the corruption is silent. State that, and add the case where the character following the back-slash does form an escape sequence: "c:\temp" yields c:, a tab, then emp. The existing example only drops the back-slash, which understates the hazard. Refs Dyalog/documentation#719 --- .../docs/how-to-set/configuration-file-structure.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md index 05127d9051e..e84ddb27e7f 100644 --- a/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md +++ b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md @@ -39,7 +39,12 @@ If the referenced parameter is not defined, no substitution takes place and the ## File Names -Path names in configuration files should use portable forward slashes (`/`) rather than back-slashes (`\`), because JSON uses the back-slash as an escape character. For example, `WSPATH: ["c:/Dyalog21.0"]` (or `["c:\\Dyalog21.0"]`) specifies `c:\Dyalog21.0`, whereas `["c:\Dyalog21.0"]` means `c:Dyalog21.0`. +Path names in configuration files should use portable forward slashes (`/`) rather than back-slashes (`\`), because JSON uses the back-slash as an escape character. For example, `WSPATH: ["c:/Dyalog21.0"]` (or `["c:\\Dyalog21.0"]`) specifies `c:\Dyalog21.0`. + +An unescaped back-slash is not reported as an error. The file is accepted, and the resulting value silently differs from the path intended: + +- `["c:\Dyalog21.0"]` gives `c:Dyalog21.0`. Because `\D` is not a recognised escape sequence, the back-slash is discarded, and an absolute path becomes a drive-relative one. +- `["c:\temp"]` gives `c:`, followed by a tab character, followed by `emp`, because `\t` is the escape sequence for a tab. ## Nested Structures From 5a8c92b99074fec1a0cf988452a95965f936b516 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 23:51:22 +0100 Subject: [PATCH 26/37] Document the deprecated component file changes for 21.0 The notes about component files with both journalling and checksum properties set to 0 were written in the future tense, from before 21.0. State the position now: such files cannot be created, and existing ones are read-only. Amend the notes on FCREATE, FAPPEND, FREPLACE, FRESIZE, FSTAC and FPROPS accordingly, noting on FPROPS that the properties of an existing file can still be changed, and on the two component-file creation parameters APL_FCREATE_PROPS_C and APL_FCREATE_PROPS_J that such files cannot be created. Apply the same correction to Integrity and Security in the Programming Reference Guide, found by scanning for other pages that discuss journalling and checksumming. Record that external variables are read-only and cannot be created, on Set External Variable and Query External Variable. Document the two new configuration parameters, DYALOG_EXTVAR_SUPPORTED and DYALOG_S32_SUPPORTED, in the Windows guide with navigation entries, and in the UNIX guide's environment-variable tables. Setting either to 0 disables support, which identifies whether an application still depends on the deprecated feature. The emergency reset switches are deliberately not documented, and the release notes are covered by Dyalog/documentation#618. Refs Dyalog/documentation#949 --- .../docs/system-functions/fappend.md | 2 +- .../docs/system-functions/fcreate.md | 2 +- .../docs/system-functions/fprops.md | 2 +- .../docs/system-functions/freplace.md | 2 +- .../docs/system-functions/fresize.md | 2 +- .../docs/system-functions/fstac.md | 2 +- .../system-functions/query-external-variable.md | 2 +- .../docs/system-functions/set-external-variable.md | 2 +- .../docs/component-files/integrity-and-security.md | 2 +- .../environment-variables.md | 2 ++ .../apl-fcreate-props-c.md | 3 +++ .../apl-fcreate-props-j.md | 3 +++ .../dyalog-extvar-supported.md | 14 ++++++++++++++ .../dyalog-s32-supported.md | 14 ++++++++++++++ .../mkdocs.yml | 2 ++ 15 files changed, 47 insertions(+), 9 deletions(-) create mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md create mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md diff --git a/language-reference-guide/docs/system-functions/fappend.md b/language-reference-guide/docs/system-functions/fappend.md index 52e9b8f0588..0438e8221f2 100644 --- a/language-reference-guide/docs/system-functions/fappend.md +++ b/language-reference-guide/docs/system-functions/fappend.md @@ -28,7 +28,7 @@ Dump←{ ``` !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and component files with this combination of properties are read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/fcreate.md b/language-reference-guide/docs/system-functions/fcreate.md index 0e3161cf661..75e6b48d995 100644 --- a/language-reference-guide/docs/system-functions/fcreate.md +++ b/language-reference-guide/docs/system-functions/fcreate.md @@ -91,7 +91,7 @@ will name a variant of `⎕FCREATE` which will create component file with level ``` !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0 it will not be possible to create files with this combination of properties. For information on how to identify code that creates component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and it is no longer possible to create files with this combination of properties. For information on how to identify code that creates component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/fprops.md b/language-reference-guide/docs/system-functions/fprops.md index 2ca494c6c6d..8331cce0bfd 100644 --- a/language-reference-guide/docs/system-functions/fprops.md +++ b/language-reference-guide/docs/system-functions/fprops.md @@ -117,7 +117,7 @@ An exclusive tie is not needed to change the file property. Compression is not supported for files in which both Journalling and Checksum are disabled. !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). Be aware that converting from non-checksummed components to checksummed components can take a significant amount of time. + Component files that have both journalling and checksum properties set to `0` have been deprecated, and it is no longer possible to create files with this combination of properties. Existing files with this combination are read-only, except that their properties can still be changed. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). Be aware that converting from non-checksummed components to checksummed components can take a significant amount of time.
diff --git a/language-reference-guide/docs/system-functions/freplace.md b/language-reference-guide/docs/system-functions/freplace.md index 8a1e1fa84b3..2ae1d7e1a95 100644 --- a/language-reference-guide/docs/system-functions/freplace.md +++ b/language-reference-guide/docs/system-functions/freplace.md @@ -32,7 +32,7 @@ Frep←{ ``` !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and component files with this combination of properties are read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/fresize.md b/language-reference-guide/docs/system-functions/fresize.md index 32ea255ff71..f67a4787ec2 100644 --- a/language-reference-guide/docs/system-functions/fresize.md +++ b/language-reference-guide/docs/system-functions/fresize.md @@ -35,7 +35,7 @@ FILE FULL ``` !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and component files with this combination of properties are read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/fstac.md b/language-reference-guide/docs/system-functions/fstac.md index 6a52ccd2604..65305c1677e 100644 --- a/language-reference-guide/docs/system-functions/fstac.md +++ b/language-reference-guide/docs/system-functions/fstac.md @@ -25,7 +25,7 @@ The shy result of `⎕FSTAC` is the tie number of the file. ``` !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and component files with this combination of properties are read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/query-external-variable.md b/language-reference-guide/docs/system-functions/query-external-variable.md index d51c856fc6d..b8d40fd187c 100644 --- a/language-reference-guide/docs/system-functions/query-external-variable.md +++ b/language-reference-guide/docs/system-functions/query-external-variable.md @@ -18,7 +18,7 @@ EXT\ARRAY ``` !!! Info "Information" - Support for external variables has been deprecated, and they are scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Support for external variables has been deprecated: they are read-only, it is not possible to create new ones, and support is scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/set-external-variable.md b/language-reference-guide/docs/system-functions/set-external-variable.md index d9d08090b0f..94c1e6f16d9 100644 --- a/language-reference-guide/docs/system-functions/set-external-variable.md +++ b/language-reference-guide/docs/system-functions/set-external-variable.md @@ -104,7 +104,7 @@ An external array may be erased using the native file function: `⎕NERASE`. In a multi-user environment (UNIX or a Windows LAN) a new file associated with an external array is created with access permission for owner read/write. An existing file is opened for exclusive use (by the owner) if the permissions remain at this level. If the access permissions allow any other users to read and write to the file, the file is opened for shared use. In UNIX versions, access permissions may be modified using the appropriate Operating System command, or in Windows using the supplied function `XVAR` from the UTIL workspace. !!! Info "Information" - Support for external variables has been deprecated, and they are scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Support for external variables has been deprecated: they are read-only, it is not possible to create new ones, and support is scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/programming-reference-guide/docs/component-files/integrity-and-security.md b/programming-reference-guide/docs/component-files/integrity-and-security.md index aa27aab0e40..32f49ffc442 100644 --- a/programming-reference-guide/docs/component-files/integrity-and-security.md +++ b/programming-reference-guide/docs/component-files/integrity-and-security.md @@ -23,4 +23,4 @@ APL files are treated as normal data files by the operating system, and may be m Do not use operating system commands to copy, erase or move component files that are tied and in use by an APL session. !!! Info "Information" - Component files that have both journalling and checksum properties set to `0` have been deprecated; from Dyalog v21.0, component files with this combination of properties will be read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../release-notes/announcements/deprecated-functionality.md). + Component files that have both journalling and checksum properties set to `0` have been deprecated, and component files with this combination of properties are read-only. Dyalog Ltd recommends using `⎕FPROPS` to convert any such files to have different properties. For information on how to identify component files that have both journalling and checksum properties set to `0` in your existing codebase, see the [Release Notes](../../release-notes/announcements/deprecated-functionality.md). 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 4dedf4b26f9..59fbbecf566 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 @@ -95,6 +95,8 @@ Table: Miscellaneous Variables used by non-GUI Dyalog APL |`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`.| +|`DYALOG_EXTVAR_SUPPORTED`|This parameter is a Boolean value with a default value of 1. If set to 0, support for external variables is disabled.| +|`DYALOG_S32_SUPPORTED`|This parameter is a Boolean value with a default value of 1. If set to 0, support for small-span component files is disabled, and such files cannot be tied.| |`DYALOG_SHELL_SUBPROCESS`|On AIX, if `DYALOG_SHELL_SUBPROCESS` is `1` (the default on AIX), the interpreter starts a (small) child process that handles calls to `⎕SHELL`.| These are the remaining variables listed in the *Dyalog for Microsoft Windows Installation and Configuration Guide* which are effective in the non-GUI UNIX versions of Dyalog APL diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md index d9d3882d21e..53d6af388e5 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-c.md @@ -1,3 +1,6 @@ # APL_FCREATE_PROPS_C This parameter specifies the default checksum level for newly-created component files. If unspecified, the default checksum level is 1. + +!!! Info "Information" + Component files that have both journalling and checksum properties set to 0 have been deprecated, and it is no longer possible to create files with this combination of properties. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md index 9e5fba6ae35..609220f8324 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/apl-fcreate-props-j.md @@ -1,3 +1,6 @@ # APL_FCREATE_PROPS_J This parameter specifies the default journaling level for newly-created component files. If unspecified, the default journaling level is 1. + +!!! Info "Information" + Component files that have both journalling and checksum properties set to 0 have been deprecated, and it is no longer possible to create files with this combination of properties. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md new file mode 100644 index 00000000000..56d6a6b1d92 --- /dev/null +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md @@ -0,0 +1,14 @@ +# DYALOG_EXTVAR_SUPPORTED + +This parameter specifies whether support for external variables is enabled. + +The values of the parameter are: + +|---|------------------------------------------| +|0 |Support for external variables is disabled| +|1 |Support for external variables is enabled | + +The default value of the parameter is 1. + +!!! Info "Information" + Support for external variables has been deprecated and is scheduled for removal in a future release. Setting this parameter to 0 identifies whether an application still depends on them. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md new file mode 100644 index 00000000000..f4ddc45fc62 --- /dev/null +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md @@ -0,0 +1,14 @@ +# DYALOG_S32_SUPPORTED + +This parameter specifies whether support for small-span component files is enabled. When support is disabled, a small-span component file cannot be tied. + +The values of the parameter are: + +|---|-------------------------------------------------| +|0 |Support for small-span component files is disabled| +|1 |Support for small-span component files is enabled | + +The default value of the parameter is 1. + +!!! Info "Information" + Small-span component files have been deprecated. Setting this parameter to 0 identifies whether an application still depends on them. diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml index 4d6292d38db..7c531fa9114 100644 --- a/windows-installation-and-configuration-guide/mkdocs.yml +++ b/windows-installation-and-configuration-guide/mkdocs.yml @@ -127,11 +127,13 @@ nav: - DYALOG_DISCARD_FN_SOURCE: configuration-parameters/dyalog-discard-fn-source.md - DYALOG_EVENTLOGGINGLEVEL: configuration-parameters/dyalog-eventlogginglevel.md - DYALOG_EVENTLOGNAME: configuration-parameters/dyalog-eventlogname.md + - DYALOG_EXTVAR_SUPPORTED: configuration-parameters/dyalog-extvar-supported.md - DYALOG_GUTTER_ENABLE: configuration-parameters/dyalog-gutter-enable.md - Dyalog_LineEditor_Mode: configuration-parameters/dyalog-lineeditor-mode.md - Dyalog_NETCore: configuration-parameters/dyalog-netcore.md - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md - DYALOG_PIXEL_TYPE: configuration-parameters/dyalog-pixel-type.md + - DYALOG_S32_SUPPORTED: configuration-parameters/dyalog-s32-supported.md - DYALOG_SERIAL: configuration-parameters/dyalog-serial.md - EditorState: configuration-parameters/editorstate.md - Edit_Cols: configuration-parameters/edit-cols.md From 7821234a29806e7d05e2852ce0e74ef48ec2b284 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Wed, 29 Jul 2026 23:56:44 +0100 Subject: [PATCH 27/37] Reference DYALOG_S32_SUPPORTED from the tie functions The notes on FTIE and FSTIE record that small-span component files are read-only and that support is scheduled for removal, but not that the support can be turned off now. Mention DYALOG_S32_SUPPORTED, so that a reader looking at either tie function can find out whether an application still depends on small-span files. Refs Dyalog/documentation#949 --- language-reference-guide/docs/system-functions/fstie.md | 2 +- language-reference-guide/docs/system-functions/ftie.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/language-reference-guide/docs/system-functions/fstie.md b/language-reference-guide/docs/system-functions/fstie.md index 120f00cb3dc..c2dc3392fba 100644 --- a/language-reference-guide/docs/system-functions/fstie.md +++ b/language-reference-guide/docs/system-functions/fstie.md @@ -58,7 +58,7 @@ FILE ACCESS ERROR: cf.dcf: File is not writable ``` !!! Info "Information" - Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Setting the [DYALOG_S32_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-s32-supported) configuration parameter to `0` disables the support now, which identifies whether an application still depends on it. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/ftie.md b/language-reference-guide/docs/system-functions/ftie.md index 929eff91bac..cd2bb8e8b77 100644 --- a/language-reference-guide/docs/system-functions/ftie.md +++ b/language-reference-guide/docs/system-functions/ftie.md @@ -63,7 +63,7 @@ FILE ACCESS ERROR: cf.dcf: File is not writable ``` !!! Info "Information" - Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Setting the [DYALOG_S32_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-s32-supported) configuration parameter to `0` disables the support now, which identifies whether an application still depends on it. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
From e26b73fc7e0e6873aec357c2c500ec5ab3d6f359 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Thu, 30 Jul 2026 10:55:31 +0100 Subject: [PATCH 28/37] Document the Session layout file and the Layout menu The docking layout of the Session is now held in a Session layout file, which is loaded at start-up and written back on exit, so a layout chosen from the Layout menu survives a restart without the session file being saved. Document the new LAYOUT_FILE configuration parameter, including its default in the user's Documents directory and the layout files supplied in the Dyalog installation directory. Bring the Layout menu up to date: it offers Open..., Classic, Debugger at the bottom, and Classic with Vertical Inline Tracing. Debugger on the left has gone, the menu governs the whole Session rather than just the Debugger, and the selected layout now persists. Classic Dyalog mode is selected from that menu rather than from the Configuration dialog box, so correct The Editor accordingly and remove the ClassicMode, ClassicModeSavePosition and SessionOnTop parameters, which no longer have any effect, together with their navigation entries and their rows on the Trace/Edit tab. Parameters that remain effective in Classic Dyalog mode referred to ClassicMode being 1, and in two cases linked to its page; state that they apply in Classic Dyalog mode instead. Refs Dyalog/documentation#939 --- .../docs/configuration-parameters/classicmode.md | 7 ------- .../classicmodesaveposition.md | 8 -------- .../dockableeditwindows.md | 2 +- .../docs/configuration-parameters/edit-first-x.md | 2 +- .../docs/configuration-parameters/edit-first-y.md | 2 +- .../docs/configuration-parameters/layout-file.md | 15 +++++++++++++++ .../docs/configuration-parameters/sessionontop.md | 6 ------ .../docs/configuration-parameters/singletrace.md | 2 +- .../configuration-parameters/trace-first-x.md | 2 +- .../configuration-parameters/trace-first-y.md | 2 +- .../configuration-parameters/trace-level-warn.md | 2 +- .../configuration-parameters/trace-offset-x.md | 2 +- .../configuration-parameters/trace-offset-y.md | 2 +- .../configuration-dialog-trace-edit-tab.md | 3 --- .../mkdocs.yml | 4 +--- windows-ui-guide/docs/editor.md | 9 +++------ windows-ui-guide/docs/session-menubar.md | 15 ++++++++------- 17 files changed, 36 insertions(+), 49 deletions(-) delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md create mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md deleted file mode 100644 index 1c0e3d080e4..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmode.md +++ /dev/null @@ -1,7 +0,0 @@ -# ClassicMode - -This parameter specifies whether or not the Session operates in *Dyalog Classic mode* . The default is 0. If this parameter is set to 1, the Editor and Tracer behave in a manner that is consistent with earlier versions of Dyalog APL. - -Note that in this mode, a maximum of 50 Trace windows may be displayed. - -See also [Classic Dyalog mode](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md deleted file mode 100644 index 9c280156b00..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/classicmodesaveposition.md +++ /dev/null @@ -1,8 +0,0 @@ -# ClassicModeSavePosition - -This parameter specifies whether or not the current size and location of the first of the editor and tracer windows are remembered for next time. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). - -The size and location of the windows are saved in the registry in the subfolder WindowRects/EditWindow and TraceWindow. - -See also [Remember previous window position](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md index f78a101fb04..05081e79c57 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/dockableeditwindows.md @@ -1,6 +1,6 @@ # DockableEditWindows This parameter specifies whether or not individual edit windows can be undocked from (and docked back into) the (MDI) Editor window. Its default value is 0. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). + This applies only in Classic Dyalog mode. See also [Allow floating edit windows](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md index 7f6904a08c2..599d4fa138a 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-x.md @@ -1,5 +1,5 @@ # Edit_First_X -This parameters specify the initial x-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. +This parameters specify the initial x-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only applies in Classic Dyalog mode. See also [X Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md index fbc7262c0d1..bc11207a5d1 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/edit-first-y.md @@ -1,5 +1,5 @@ # Edit_First_Y -This parameters specify the initial y-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only apply if **ClassicMode** is 1. +This parameters specify the initial y-position on the screen of the *first* edit window in character units. Subsequent edit windows will be staggered. This parameter only applies in Classic Dyalog mode. See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md new file mode 100644 index 00000000000..fad43aac703 --- /dev/null +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md @@ -0,0 +1,15 @@ +# LAYOUT_FILE + +This parameter specifies the path (absolute or relative to the working directory) and name of the Session layout file. + +The Session layout file records the docking layout of the Session, that is, the position of the Editor, the Debugger and the other tools that can be docked in the Session window. It is loaded when Dyalog starts, and the current layout is written back to it when Dyalog exits. A layout selected from the [Layout menu](../../../windows-ui-guide/session-menubar#the-layout-menu) is therefore still in effect the next time Dyalog starts, without the session file having to be saved. + +A layout file contains no APL code. + +NOTE: If a user-defined Form is docked in the Session, its docking state cannot be recorded in the layout file; the session file must be saved to preserve it. + +The default is __\Dyalog APL- Files\default.layout__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 21.0 Unicode Files\default.layout__ + +Layout files supplied with Dyalog, such as __classic.layout__ and __Bottom.layout__, are installed in the directory identified by the [dyalog](./dyalog.md) parameter, for example, __C:\Program Files\Dyalog\Dyalog APL-64 21.0 Unicode__. + +See also [Session_File](./session-file.md) and [Log_File](./log-file.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md deleted file mode 100644 index 9b914013101..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/sessionontop.md +++ /dev/null @@ -1,6 +0,0 @@ -# SessionOnTop - -Specifies whether or not the Session may appear on top of Edit and Trace Windows in Classic Dyalog mode. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). - -See also [Allow session above edit windows](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md index a6cfc859a2b..fa498c27733 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md @@ -1,6 +1,6 @@ # SingleTrace Specifies whether there is a single Trace window, or one Trace window per function. - This applies only if **ClassicMode** is 1. See [ ClassicMode](./classicmode.md). + This applies only in Classic Dyalog mode. See also [Single trace window](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md index f0dfa66c53a..16ca9e46e0f 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-x.md @@ -1,5 +1,5 @@ # Trace_First_X -This parameters specifies the initial horizontal position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. +This parameters specifies the initial horizontal position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only in Classic Dyalog mode. See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md index da0ecc3f7fc..6e827eaabf1 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-first-y.md @@ -1,5 +1,5 @@ # Trace_First_Y -This parameters specifies the initial vertical position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only if **ClassicMode** is 1. +This parameters specifies the initial vertical position on the screen of the *first* trace window in character units. Subsequent trace windows will be staggered. This applies only in Classic Dyalog mode. See also [Y Pos](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md index d1d9522400b..96de20cae35 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md @@ -1,5 +1,5 @@ # Trace_Level_Warn -This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only in Classic Dyalog mode and if **SingleTrace** is 0. See also [Warn if trace stack bigger than](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md index 48d75f6e954..40d2f9e853f 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md @@ -1,5 +1,5 @@ # Trace_Offset_X -This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only in Classic Dyalog mode and if **SingleTrace** is 0. See also [X Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md index 5ec33c4c196..a0c31e01db9 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md @@ -1,5 +1,5 @@ # Trace_Offset_Y -This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only if **ClassicMode** is 1 and **SingleTrace** is 0. +This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only in Classic Dyalog mode and if **SingleTrace** is 0. See also [Y Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md index 578fa14a506..4f6c75322d5 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md @@ -6,10 +6,7 @@ Table: Configuration dialog: Trace/Edit |Label|Parameter|Description| |---|---|---| -|Classic Dyalog mode|[ClassicMode](../../configuration-parameters/classicmode.md)|Selects pre-Version 9 behaviour for Edit and Trace windows.| -|Allow session above edit windows|[SessionOnTop](../../configuration-parameters/sessionontop.md)|Specifies whether or not the Session may appear on top of Edit and Trace Windows| |Single trace window|[ SingleTrace](../../configuration-parameters/singletrace.md)|Specifies whether or not there is a single Trace window| -|Remember previous window position|[ClassicModeSavePosition](../../configuration-parameters/classicmodesaveposition.md)|Specifies whether or not the current size and location of the first of the editor and tracer windows are remembered in the registry for next time.| |Allow floating edit windows|[DockableEditWindows](../../configuration-parameters/dockableeditwindows.md)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| |Show status bars|[ StatusOnEdit](../../configuration-parameters/statusonedit.md)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| |Show tool bars|[ ToolBarsOnEdit](../../configuration-parameters/toolbarsonedit.md)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml index 4d6292d38db..093b7a2e2a4 100644 --- a/windows-installation-and-configuration-guide/mkdocs.yml +++ b/windows-installation-and-configuration-guide/mkdocs.yml @@ -97,8 +97,6 @@ nav: - AutoIndent: configuration-parameters/autoindent.md - auto_pw: configuration-parameters/auto-pw.md - CFEXT: configuration-parameters/cfext.md - - ClassicMode: configuration-parameters/classicmode.md - - ClassicModeSavePosition: configuration-parameters/classicmodesaveposition.md - CMD_PREFIX and CMD_POSTFIX: configuration-parameters/cmd-prefix-and-cmd-postfix.md - ConfigFile: configuration-parameters/configfile.md - confirm_abort: configuration-parameters/confirm-abort.md @@ -154,6 +152,7 @@ nav: - InitialKeyboardLayoutShowAll: configuration-parameters/initialkeyboardlayoutshowall.md - input_size: configuration-parameters/input-size.md - KeyboardInputDelay: configuration-parameters/keyboardinputdelay.md + - LAYOUT_FILE: configuration-parameters/layout-file.md - Load: configuration-parameters/load.md - localdyalogdir: configuration-parameters/localdyalogdir.md - log_file: configuration-parameters/log-file.md @@ -178,7 +177,6 @@ nav: - SaveLogOnExit: configuration-parameters/savelogonexit.md - SaveSessionOnExit: configuration-parameters/savesessiononexit.md - Serial: configuration-parameters/serial.md - - SessionOnTop: configuration-parameters/sessionontop.md - session_file: configuration-parameters/session-file.md - ShowStatusOnError: configuration-parameters/showstatusonerror.md - SingleTrace: configuration-parameters/singletrace.md diff --git a/windows-ui-guide/docs/editor.md b/windows-ui-guide/docs/editor.md index 292533de8cc..40e0b6fae36 100644 --- a/windows-ui-guide/docs/editor.md +++ b/windows-ui-guide/docs/editor.md @@ -16,7 +16,7 @@ If the name is followed by a line-number in square brackets, for example, `MyFn[ ## Window Management (Standard) -Unless *Classic Dyalog mode* is selected (*Options/Configure/Trace/Edit*), the Editor is a Multiple Document Interface (MDI) window that may be a stand-alone window, or be docked in the Session window. Each of the objects being edited is displayed in a separate sub-window. Individual edit windows are managed using standard MDI facilities. +Unless Classic Dyalog mode is selected from the *Layout* menu, the Editor is a Multiple Document Interface (MDI) window that may be a stand-alone window, or be docked in the Session window. Each of the objects being edited is displayed in a separate sub-window. Individual edit windows are managed using standard MDI facilities. ![](img/editor-2.png) @@ -44,12 +44,9 @@ Note that when the Editor has the focus, the Editor menubar is displayed in plac ## Window Management (Classic Dyalog mode) -If *Classic Dyalog mode* is selected (*Options/Configure/Trace/Edit*) each Edit window is a top-level window created as a child of the Session window. This means that normally Edit windows appear on top of the Session. However, if the **SessionOnTop** parameter is set, the Session window, when given the focus, will appear on top of Edit windows. +If Classic Dyalog mode is selected from the [Layout menu](session-menubar.md#the-layout-menu), each Edit window is a top-level window created as a child of the Session window. This means that normally Edit windows appear on top of the Session. -When the first Edit window is opened, its position is determined as follows: - -- If the **ClassicModeSavePosition** parameter is set, the first Edit window is displayed at the position that was previously occupied by the most recently saved Edit window. -- If not, the first edit window is created at the position specified by the **edit_first_y** and **edit_first_x** parameters which are specified in terms of the size of a character in the current font relative to the top-left corner of the screen. +The first Edit window is created at the position specified by the **edit_first_y** and **edit_first_x** parameters which are specified in terms of the size of a character in the current font relative to the top-left corner of the screen. The initial size of an edit window is specified by the **edit_rows** and **edit_cols** parameters. diff --git a/windows-ui-guide/docs/session-menubar.md b/windows-ui-guide/docs/session-menubar.md index 0e34de2ff76..a779093e112 100644 --- a/windows-ui-guide/docs/session-menubar.md +++ b/windows-ui-guide/docs/session-menubar.md @@ -163,17 +163,18 @@ Table: Threads Menu Operations {: #threads-menu-operations } ## The Layout Menu -The *Layout* menu (`⎕SE.mb.layout`) provides layout options for the Debugger. +The *Layout* menu (`⎕SE.mb.layout`) selects the layout of the Session and of the tools that are docked in it, including the Editor and the Debugger. Table: Layout Menu Operations {: #debugger-layout-menu-operations } -|Item |Action |Description | -|-----------------------|-------------------|---------------------------------------------------| -|Classic |APL callback |Detaches the Debugger window | -|Debugger at the bottom |APL callback |Docks the Debugger at the bottom (default) | -|Debugger on the left |APL callback |Docks the Debugger on the left | +|Item |Action |Description | +|------------------------------------|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| +|Open… |APL callback|Displays the *Open Session layout* dialog box, from which a Session layout file (*.layout*) can be selected | +|Classic |APL callback|Selects Classic Dyalog mode, in which the Debugger is a separate window containing the Tracer, with the Left Argument pane docked to its left and the Right Argument pane docked to its right| +|Debugger at the bottom |APL callback|Docks the Debugger at the bottom of the Session window (default) | +|Classic with Vertical Inline Tracing|APL callback|As *Classic*, but with the Left Argument pane docked above the Tracer and the Right Argument pane docked below it | -The selected option does *not* persist if you restart the session. +The selected layout is saved when Dyalog exits and is restored the next time it starts; see the [LAYOUT_FILE](../../windows-installation-and-configuration-guide/configuration-parameters/layout-file) parameter. ## The Help Menu From 94a4b281542a6978ce2af5afc0d6fcba6c0a87ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Thu, 30 Jul 2026 11:19:00 +0100 Subject: [PATCH 29/37] Correct the default path and extension rule for LAYOUT_FILE The Documents folder name omits the width for the 32-bit interpreter and omits the edition for the Classic edition, so the 32-bit Classic edition of Dyalog 19.0 uses Dyalog APL 19.0 Files. State the rule and give an example of each form, rather than implying that both parts are always present. Also record that the .layout extension has to be given; unlike the session file, it is not assumed. Refs Dyalog/documentation#939 --- .../docs/configuration-parameters/layout-file.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md index fad43aac703..fb132fad84b 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/layout-file.md @@ -1,6 +1,6 @@ # LAYOUT_FILE -This parameter specifies the path (absolute or relative to the working directory) and name of the Session layout file. +This parameter specifies the path (absolute or relative to the working directory) and name of the Session layout file. The name must include the __.layout__ extension; it is not assumed. The Session layout file records the docking layout of the Session, that is, the position of the Editor, the Debugger and the other tools that can be docked in the Session window. It is loaded when Dyalog starts, and the current layout is written back to it when Dyalog exits. A layout selected from the [Layout menu](../../../windows-ui-guide/session-menubar#the-layout-menu) is therefore still in effect the next time Dyalog starts, without the session file having to be saved. @@ -8,7 +8,7 @@ A layout file contains no APL code. NOTE: If a user-defined Form is docked in the Session, its docking state cannot be recorded in the layout file; the session file must be saved to preserve it. -The default is __\Dyalog APL- Files\default.layout__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 21.0 Unicode Files\default.layout__ +The default is __default.layout__ in the Dyalog folder of your Documents directory, for example, __C:\Users\Bob\Documents\Dyalog APL-64 21.0 Unicode Files\default.layout__. The folder name identifies the interpreter: __-64__ is included for the 64-bit interpreter and __Unicode__ for the Unicode edition, so the 32-bit Classic edition of Dyalog 19.0 uses __Dyalog APL 19.0 Files__. Layout files supplied with Dyalog, such as __classic.layout__ and __Bottom.layout__, are installed in the directory identified by the [dyalog](./dyalog.md) parameter, for example, __C:\Program Files\Dyalog\Dyalog APL-64 21.0 Unicode__. From 0ef38a5bba91a4bc8d6f98cb9de0046a6c46054d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Thu, 30 Jul 2026 11:35:35 +0100 Subject: [PATCH 30/37] Remove SingleTrace and correct how the Layout menu items are driven There is no longer a single Trace window setting, in Classic Dyalog mode or otherwise. Remove the SingleTrace parameter, its navigation entry and its row on the Trace/Edit tab, and drop the condition from the trace window stagger and warning-level parameters, which now depend only on Classic Dyalog mode. The Layout menu items are managed by the interpreter rather than by APL callbacks, so leave their Action column empty, as the View menu does. Refs Dyalog/documentation#939 --- .../docs/configuration-parameters/singletrace.md | 6 ------ .../docs/configuration-parameters/trace-level-warn.md | 2 +- .../docs/configuration-parameters/trace-offset-x.md | 2 +- .../docs/configuration-parameters/trace-offset-y.md | 2 +- .../configuration-dialog-trace-edit-tab.md | 1 - windows-installation-and-configuration-guide/mkdocs.yml | 1 - windows-ui-guide/docs/session-menubar.md | 8 ++++---- 7 files changed, 7 insertions(+), 15 deletions(-) delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md deleted file mode 100644 index fa498c27733..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/singletrace.md +++ /dev/null @@ -1,6 +0,0 @@ -# SingleTrace - -Specifies whether there is a single Trace window, or one Trace window per function. - This applies only in Classic Dyalog mode. - -See also [Single trace window](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md index 96de20cae35..cbede6de02d 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-level-warn.md @@ -1,5 +1,5 @@ # Trace_Level_Warn -This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only in Classic Dyalog mode and if **SingleTrace** is 0. +This parameter specifies the maximum number of Trace windows that will be displayed when an error occurs and **Trace_on_error** is set to 1. If there are a large number of functions in the state indicator, the display of their Trace windows may take several seconds. This parameter allows you to restrict the potential delay to a reasonable value and its default is 16. If the number of Trace windows would exceed this number, the system instead displays a warning message box. This parameter is ignored if you invoke the Tracer explicitly. This parameter applies only in Classic Dyalog mode. See also [Warn if trace stack bigger than](../configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md index 40d2f9e853f..1a08ba8a0ce 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-x.md @@ -1,5 +1,5 @@ # Trace_Offset_X -This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only in Classic Dyalog mode and if **SingleTrace** is 0. +This parameter specifies the number of characters by which a trace window is staggered horizontally from the previous one. This applies only in Classic Dyalog mode. See also [X Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md index a0c31e01db9..93798d4de90 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/trace-offset-y.md @@ -1,5 +1,5 @@ # Trace_Offset_Y -This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only in Classic Dyalog mode and if **SingleTrace** is 0. +This parameter specifies the number of characters by which a trace window is staggered vertically from the previous one. This applies only in Classic Dyalog mode. See also [Y Offset](../configuring-the-ide/configuration-dialog/configuration-dialog-windows-tab.md). diff --git a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md index 4f6c75322d5..e754bf0f143 100644 --- a/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md +++ b/windows-installation-and-configuration-guide/docs/configuring-the-ide/configuration-dialog/configuration-dialog-trace-edit-tab.md @@ -6,7 +6,6 @@ Table: Configuration dialog: Trace/Edit |Label|Parameter|Description| |---|---|---| -|Single trace window|[ SingleTrace](../../configuration-parameters/singletrace.md)|Specifies whether or not there is a single Trace window| |Allow floating edit windows|[DockableEditWindows](../../configuration-parameters/dockableeditwindows.md)|Allows individual Edit windows to be undocked from (and re-docked in) the main Edit window| |Show status bars|[ StatusOnEdit](../../configuration-parameters/statusonedit.md)|Specifies whether or not status bars are displayed along the bottom of individual Edit windows| |Show tool bars|[ ToolBarsOnEdit](../../configuration-parameters/toolbarsonedit.md)|Specifies whether or not tool bars are displayed along the top of individual Edit windows| diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml index 093b7a2e2a4..a5169cb9cd2 100644 --- a/windows-installation-and-configuration-guide/mkdocs.yml +++ b/windows-installation-and-configuration-guide/mkdocs.yml @@ -179,7 +179,6 @@ nav: - Serial: configuration-parameters/serial.md - session_file: configuration-parameters/session-file.md - ShowStatusOnError: configuration-parameters/showstatusonerror.md - - SingleTrace: configuration-parameters/singletrace.md - SkipLines: configuration-parameters/skiplines.md - SM_Cols: configuration-parameters/sm-cols.md - SM_Rows: configuration-parameters/sm-rows.md diff --git a/windows-ui-guide/docs/session-menubar.md b/windows-ui-guide/docs/session-menubar.md index a779093e112..6a27027c982 100644 --- a/windows-ui-guide/docs/session-menubar.md +++ b/windows-ui-guide/docs/session-menubar.md @@ -169,10 +169,10 @@ Table: Layout Menu Operations {: #debugger-layout-menu-operations } |Item |Action |Description | |------------------------------------|------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| -|Open… |APL callback|Displays the *Open Session layout* dialog box, from which a Session layout file (*.layout*) can be selected | -|Classic |APL callback|Selects Classic Dyalog mode, in which the Debugger is a separate window containing the Tracer, with the Left Argument pane docked to its left and the Right Argument pane docked to its right| -|Debugger at the bottom |APL callback|Docks the Debugger at the bottom of the Session window (default) | -|Classic with Vertical Inline Tracing|APL callback|As *Classic*, but with the Left Argument pane docked above the Tracer and the Right Argument pane docked below it | +|Open… |  |Displays the *Open Session layout* dialog box, from which a Session layout file (*.layout*) can be selected | +|Classic |  |Selects Classic Dyalog mode, in which the Debugger is a separate window containing the Tracer, with the Left Argument pane docked to its left and the Right Argument pane docked to its right| +|Debugger at the bottom |  |Docks the Debugger at the bottom of the Session window (default) | +|Classic with Vertical Inline Tracing|  |As *Classic*, but with the Left Argument pane docked above the Tracer and the Right Argument pane docked below it | The selected layout is saved when Dyalog exits and is restored the next time it starts; see the [LAYOUT_FILE](../../windows-installation-and-configuration-guide/configuration-parameters/layout-file) parameter. From b74e29bacb1a957b4f66dea50d6ded8cd3743c4e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Thu, 30 Jul 2026 11:41:15 +0100 Subject: [PATCH 31/37] Show the Documents folder name as it actually varies The width is omitted for the 32-bit interpreter and the edition for the Classic edition, so the folder is Dyalog APL 19.0 Files for the 32-bit Classic edition, not Dyalog APL-32 19.0 Classic Files. Mark both parts optional instead of implying that each is always present, in the current guide and in the copy carried by the v19.0 release notes. While here, add the separator between the major and minor version numbers in the current guide, which the example already shows. Refs Dyalog/documentation#959 --- .../release-notes-v19-0/configuration-parameters/log-file.md | 2 +- .../docs/configuration-parameters/log-file.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/earlier-release-notes/docs/release-notes-v19-0/configuration-parameters/log-file.md b/earlier-release-notes/docs/release-notes-v19-0/configuration-parameters/log-file.md index 1dc10f4ac12..778cbff1ddc 100644 --- a/earlier-release-notes/docs/release-notes-v19-0/configuration-parameters/log-file.md +++ b/earlier-release-notes/docs/release-notes-v19-0/configuration-parameters/log-file.md @@ -4,7 +4,7 @@ This parameter specifies the pathname to the Session log file; it can be absolut The Session log file is not interchangeable between different versions/editions/widths of Dyalog – this means that opening a new instance of Dyalog will overwrite any contents of the Session log file populated by an already‑running instance. However, if the LOG_FILE parameter contains a '`*`' (for example, `JD.*.dlf` ) then at start-up Dyalog will attempt to open, and then **lock**, a file where the '`*`' has been replaced with an increasing integer value (starting with 000, so `JD.000.dlf`, `JD.001.dlf` etc). If said file cannot be opened and locked, the value will be incremented. The process will fail, and no log will be used if the extension number would exceed 999. -The default is `Users\\Documents\Dyalog APL- . Files\default_*.dlf`, for example, `Users\Bob\Documents\Dyalog APL-64 19.0 Unicode Files\default_*.dlf` +The default is `Users\\Documents\Dyalog APL[-64] . [Unicode ]Files\default_*.dlf`, for example, `Users\Bob\Documents\Dyalog APL-64 19.0 Unicode Files\default_*.dlf` Note that the LogFile property of `⎕SE` reports the name of the log file that is being used. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md index 43209765b71..2d849383391 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/log-file.md @@ -8,6 +8,6 @@ This is mitigated by including a __\*__ character in the default Session log’s NOTE: The LogFile property of `⎕SE` reports the name of the log file that is being used. -The default is __\Dyalog APL- Files\default_\*.dlfx__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 20.0 Unicode Files\default_\*.dlfx__ +The default is __\Dyalog APL[-64] . [Unicode ]Files\default_\*.dlfx__, for example, __C:\Users\Bob\Documents\Dyalog APL-64 20.0 Unicode Files\default_\*.dlfx__ See also [Use log file](../configuring-the-ide/configuration-dialog/configuration-dialog-session-tab.md). From fde01b1c36db85323045747eef2a4e172693465a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Fri, 31 Jul 2026 09:26:50 +0100 Subject: [PATCH 32/37] Correct the external variable and small-span switches DYALOG_S32_SUPPORTED was dropped from the project and never implemented, so remove the parameter page, its navigation entry, its row in the UNIX environment-variable table, and the references to it added to FTIE and FSTIE, which return to their earlier wording. DYALOG_EXTVAR_SUPPORTED defaults to 0, not 1: external variables are not supported at all by default, and setting the parameter to 1 reinstates them for the time being. Correct the parameter page and the UNIX table, and say so on Set External Variable and Query External Variable, which described them as read-only instead. Refs Dyalog/documentation#949 --- .../docs/system-functions/fstie.md | 2 +- .../docs/system-functions/ftie.md | 2 +- .../system-functions/query-external-variable.md | 2 +- .../docs/system-functions/set-external-variable.md | 2 +- .../environment-variables.md | 3 +-- .../dyalog-extvar-supported.md | 4 ++-- .../dyalog-s32-supported.md | 14 -------------- .../mkdocs.yml | 1 - 8 files changed, 7 insertions(+), 23 deletions(-) delete mode 100644 windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md diff --git a/language-reference-guide/docs/system-functions/fstie.md b/language-reference-guide/docs/system-functions/fstie.md index c2dc3392fba..120f00cb3dc 100644 --- a/language-reference-guide/docs/system-functions/fstie.md +++ b/language-reference-guide/docs/system-functions/fstie.md @@ -58,7 +58,7 @@ FILE ACCESS ERROR: cf.dcf: File is not writable ``` !!! Info "Information" - Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Setting the [DYALOG_S32_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-s32-supported) configuration parameter to `0` disables the support now, which identifies whether an application still depends on it. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/ftie.md b/language-reference-guide/docs/system-functions/ftie.md index cd2bb8e8b77..929eff91bac 100644 --- a/language-reference-guide/docs/system-functions/ftie.md +++ b/language-reference-guide/docs/system-functions/ftie.md @@ -63,7 +63,7 @@ FILE ACCESS ERROR: cf.dcf: File is not writable ``` !!! Info "Information" - Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Setting the [DYALOG_S32_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-s32-supported) configuration parameter to `0` disables the support now, which identifies whether an application still depends on it. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Small-span (32-bit) component files are currently read-only; this support is scheduled for removal in a future release, after which it will not be possible to tie small-span component files. Dyalog Ltd recommends using `⎕FCOPY` to convert any such files to large-span (64-bit). For information on how to identify calls to small-span component files in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/query-external-variable.md b/language-reference-guide/docs/system-functions/query-external-variable.md index b8d40fd187c..ed0e6feb9bf 100644 --- a/language-reference-guide/docs/system-functions/query-external-variable.md +++ b/language-reference-guide/docs/system-functions/query-external-variable.md @@ -18,7 +18,7 @@ EXT\ARRAY ``` !!! Info "Information" - Support for external variables has been deprecated: they are read-only, it is not possible to create new ones, and support is scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Support for external variables has been deprecated: they are not supported by default, and support is scheduled for removal in a future release. Setting the [DYALOG_EXTVAR_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-extvar-supported) configuration parameter to `1` reinstates support for the time being. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
diff --git a/language-reference-guide/docs/system-functions/set-external-variable.md b/language-reference-guide/docs/system-functions/set-external-variable.md index 94c1e6f16d9..1417c0843c7 100644 --- a/language-reference-guide/docs/system-functions/set-external-variable.md +++ b/language-reference-guide/docs/system-functions/set-external-variable.md @@ -104,7 +104,7 @@ An external array may be erased using the native file function: `⎕NERASE`. In a multi-user environment (UNIX or a Windows LAN) a new file associated with an external array is created with access permission for owner read/write. An existing file is opened for exclusive use (by the owner) if the permissions remain at this level. If the access permissions allow any other users to read and write to the file, the file is opened for shared use. In UNIX versions, access permissions may be modified using the appropriate Operating System command, or in Windows using the supplied function `XVAR` from the UTIL workspace. !!! Info "Information" - Support for external variables has been deprecated: they are read-only, it is not possible to create new ones, and support is scheduled for removal in a future release. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/). + Support for external variables has been deprecated: they are not supported by default, and support is scheduled for removal in a future release. Setting the [DYALOG_EXTVAR_SUPPORTED](../../../windows-installation-and-configuration-guide/configuration-parameters/dyalog-extvar-supported) configuration parameter to `1` reinstates support for the time being. For information on how to identify uses of external variables in your existing codebase, see the [Release Notes](../../../release-notes/announcements/deprecated-functionality/).
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 59fbbecf566..3fe4f544303 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 @@ -95,8 +95,7 @@ Table: Miscellaneous Variables used by non-GUI Dyalog APL |`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`.| -|`DYALOG_EXTVAR_SUPPORTED`|This parameter is a Boolean value with a default value of 1. If set to 0, support for external variables is disabled.| -|`DYALOG_S32_SUPPORTED`|This parameter is a Boolean value with a default value of 1. If set to 0, support for small-span component files is disabled, and such files cannot be tied.| +|`DYALOG_EXTVAR_SUPPORTED`|This parameter is a Boolean value with a default value of 0. If set to 1, support for external variables is reinstated.| |`DYALOG_SHELL_SUBPROCESS`|On AIX, if `DYALOG_SHELL_SUBPROCESS` is `1` (the default on AIX), the interpreter starts a (small) child process that handles calls to `⎕SHELL`.| These are the remaining variables listed in the *Dyalog for Microsoft Windows Installation and Configuration Guide* which are effective in the non-GUI UNIX versions of Dyalog APL diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md index 56d6a6b1d92..a06fd6f96cd 100644 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md +++ b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-extvar-supported.md @@ -8,7 +8,7 @@ The values of the parameter are: |0 |Support for external variables is disabled| |1 |Support for external variables is enabled | -The default value of the parameter is 1. +The default value of the parameter is 0. !!! Info "Information" - Support for external variables has been deprecated and is scheduled for removal in a future release. Setting this parameter to 0 identifies whether an application still depends on them. + Support for external variables has been deprecated and is scheduled for removal in a future release. External variables are not supported by default; setting this parameter to 1 reinstates support for the time being. diff --git a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md b/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md deleted file mode 100644 index f4ddc45fc62..00000000000 --- a/windows-installation-and-configuration-guide/docs/configuration-parameters/dyalog-s32-supported.md +++ /dev/null @@ -1,14 +0,0 @@ -# DYALOG_S32_SUPPORTED - -This parameter specifies whether support for small-span component files is enabled. When support is disabled, a small-span component file cannot be tied. - -The values of the parameter are: - -|---|-------------------------------------------------| -|0 |Support for small-span component files is disabled| -|1 |Support for small-span component files is enabled | - -The default value of the parameter is 1. - -!!! Info "Information" - Small-span component files have been deprecated. Setting this parameter to 0 identifies whether an application still depends on them. diff --git a/windows-installation-and-configuration-guide/mkdocs.yml b/windows-installation-and-configuration-guide/mkdocs.yml index 7c531fa9114..3b0b340664b 100644 --- a/windows-installation-and-configuration-guide/mkdocs.yml +++ b/windows-installation-and-configuration-guide/mkdocs.yml @@ -133,7 +133,6 @@ nav: - Dyalog_NETCore: configuration-parameters/dyalog-netcore.md - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md - DYALOG_PIXEL_TYPE: configuration-parameters/dyalog-pixel-type.md - - DYALOG_S32_SUPPORTED: configuration-parameters/dyalog-s32-supported.md - DYALOG_SERIAL: configuration-parameters/dyalog-serial.md - EditorState: configuration-parameters/editorstate.md - Edit_Cols: configuration-parameters/edit-cols.md From 5812b3260c20e96bec1a4f9e5ec4b66eb676680f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Mon, 10 Aug 2026 16:15:54 +0100 Subject: [PATCH 33/37] Generalise configuration-setting substitution in the guide Move the References to Other Configuration Parameters section out of the configuration file structure page into the general How to Set overview, since substitution applies to all configuration settings regardless of how they are defined, and note the pre-defined [=DOCUMENTS] substitution on Microsoft Windows. Part of #988. --- .../docs/how-to-set/configuration-file-structure.md | 6 ------ dyalog-configuration-guide/docs/how-to-set/overview.md | 8 ++++++++ 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md index e84ddb27e7f..a99d1501ca2 100644 --- a/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md +++ b/dyalog-configuration-guide/docs/how-to-set/configuration-file-structure.md @@ -31,12 +31,6 @@ If the same name is defined more than once within a file, the first definition i A value can be an array of strings, used mainly for file paths, for example `WSPATH: ["/dir1", "/dir2"]`. The only parameters that can be defined as arrays are **WSPATH**, **WSEXT**, and **CFEXT**. -## References to Other Configuration Parameters - -A string value can refer to another configuration parameter, wherever it is defined, using square-bracket delimiters. For example, `MySetting: "[DYALOG]/MyFile"` replaces `[DYALOG]` with the value of the **DYALOG** parameter. If the string inside the brackets is `.`, it is replaced with the path of the directory containing the configuration file itself. - -If the referenced parameter is not defined, no substitution takes place and the reference, including its brackets, remains in place. To include a literal square bracket in a string, prefix it with a `\` character. - ## File Names Path names in configuration files should use portable forward slashes (`/`) rather than back-slashes (`\`), because JSON uses the back-slash as an escape character. For example, `WSPATH: ["c:/Dyalog21.0"]` (or `["c:\\Dyalog21.0"]`) specifies `c:\Dyalog21.0`. diff --git a/dyalog-configuration-guide/docs/how-to-set/overview.md b/dyalog-configuration-guide/docs/how-to-set/overview.md index f8aaf1d4e11..d3ff87fb9c4 100644 --- a/dyalog-configuration-guide/docs/how-to-set/overview.md +++ b/dyalog-configuration-guide/docs/how-to-set/overview.md @@ -12,3 +12,11 @@ A configuration parameter can be set from any of the following sources: When the same parameter is set in more than one source, the [order of precedence](order-of-precedence.md) determines which value is used. This gives a great deal of flexibility: a usual value can be defined in a configuration file and then temporarily overridden from the command line. Dyalog Ltd recommends configuration files for all run-time applications, in preference to environment variables. + +## References to Other Configuration Parameters + +A string value can refer to another configuration parameter, wherever it is defined, using square-bracket delimiters. For example, `MySetting: "[DYALOG]/MyFile"` replaces `[DYALOG]` with the value of the **DYALOG** parameter. If the string inside the brackets is `.`, it is replaced with the path of the directory containing the configuration file itself. + +If the referenced parameter is not defined, no substitution takes place and the reference, including its brackets, remains in place. To include a literal square bracket in a string, prefix it with a `\` character. + +On Microsoft Windows, `[=DOCUMENTS]` is a pre-defined substitution parameter that is replaced with the location of the user's Documents folder (for example, `C:\Users\Bob\Documents`). From cd502d1c0800db561c3067b3ccdbcdbabe282768 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 11 Aug 2026 12:49:51 +0100 Subject: [PATCH 34/37] Add DYALOG_INITSESSION to the configuration guide Document the parameter that governs Session Initialisation on start-up: default 1 for interactive sessions, 0 for executable scripts and run-time versions. Register it in the navigation and list it under Start-up and workspace loading. --- .../configuration-parameters-by-category.md | 1 + .../configuration-parameters/dyalog-initsession.md | 10 ++++++++++ dyalog-configuration-guide/mkdocs.yml | 1 + 3 files changed, 12 insertions(+) create mode 100644 dyalog-configuration-guide/docs/configuration-parameters/dyalog-initsession.md diff --git a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md index b3bca66c5a8..f59e2357d61 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/configuration-parameters-by-category.md @@ -177,6 +177,7 @@ These control what is loaded and run when Dyalog starts, and where workspaces ar |[`DyalogStartup`](dyalogstartup.md)|The name of a file containing APL code to be run each time Dyalog starts| |[`DyalogStartupSE`](dyalogstartupse.md)|One or more *Session initialisation* directories containing APL code to be installed in `⎕SE`| |[`DyalogStartup_X`](dyalogstartup-x.md)|During Session initialisation, code is loaded from the directories given by `DyalogStartupSE` into a corresponding namespace tree in `⎕SE`, and is then optionally executed| +|[`DYALOG_INITSESSION`](dyalog-initsession.md)|Whether Dyalog performs Session Initialisation on start-up| ## Interpreter and runtime diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-initsession.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-initsession.md new file mode 100644 index 00000000000..2bd227eb9c1 --- /dev/null +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-initsession.md @@ -0,0 +1,10 @@ +# DYALOG_INITSESSION + +Whether Dyalog performs [Session Initialisation](../../../windows-ui-guide/the-session-object/session-initialisation) on start-up. Session initialisation makes Link, SALT, and other features available. + +Valid values are: + +- `0` : the Session is not initialised +- `1` : the Session is initialised + +Default is `1` for interactive sessions, and `0` for executable scripts and run-time versions. diff --git a/dyalog-configuration-guide/mkdocs.yml b/dyalog-configuration-guide/mkdocs.yml index 39a865c1db2..0b4264f7efd 100644 --- a/dyalog-configuration-guide/mkdocs.yml +++ b/dyalog-configuration-guide/mkdocs.yml @@ -134,6 +134,7 @@ nav: - DYALOG_EVENTLOGNAME: configuration-parameters/dyalog-eventlogname.md - DYALOG_EXTVAR_SUPPORTED: configuration-parameters/dyalog-extvar-supported.md - DYALOG_GUTTER_ENABLE: configuration-parameters/dyalog-gutter-enable.md + - DYALOG_INITSESSION: configuration-parameters/dyalog-initsession.md - Dyalog_LineEditor_Mode: configuration-parameters/dyalog-lineeditor-mode.md - Dyalog_NETCore: configuration-parameters/dyalog-netcore.md - DYALOG_NOPOPUPS: configuration-parameters/dyalog-nopopups.md From f8b7c393526c15abb0b4739c188c16c9b96f9bb4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 11 Aug 2026 13:18:43 +0100 Subject: [PATCH 35/37] Cross-link and expand DYALOG_SERIALFILE in the configuration guide Link DYALOG_SERIAL to DYALOG_SERIALFILE, and note on the DYALOG_SERIALFILE page the default location $HOME/.dyalog/serial, how DYALOG_SERIAL is populated from the file, and the multi-user use. Part of #898. --- .../docs/configuration-parameters/dyalog-serial.md | 2 ++ .../docs/configuration-parameters/dyalog-serialfile.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md index 7127a5921de..674ea5039d4 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md @@ -5,3 +5,5 @@ Your Dyalog serial number. This must be set to the serial number issued to you; Valid values are your issued serial number. 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). + +Related parameters: [DYALOG_SERIALFILE](dyalog-serialfile.md). diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md index 337588ec4c5..6b3978f014e 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serialfile.md @@ -3,7 +3,7 @@ !!! Info "Information" This configuration parameter is only relevant on the UNIX and macOS operating systems. -The full path to the text file that contains your Dyalog serial number. +The full path to the text file that contains your Dyalog serial number. If it is not set, the default location `$HOME/.dyalog/serial` is used. When Dyalog starts, if [`DYALOG_SERIAL`](dyalog-serial.md) is not already set it is set to the contents of this file. Setting this parameter is useful in a multi-user environment: a system administrator can maintain a single serial number file for all users. Valid values are a file path. From be263296d0f520ad593564795768bd5739389e74 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 11 Aug 2026 13:28:57 +0100 Subject: [PATCH 36/37] Correct AplCoreName behaviour for multiple wild-cards Only one * can be used. If AplCoreName contains more than one *, the setting is ignored and the aplcore is named aplcore, rather than the string being used as is. Part of #884; aligns with the single-* valid values already stated on the page. --- .../docs/configuration-parameters/aplcorename.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md b/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md index 3a0691d5932..6da9e425956 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/aplcorename.md @@ -1,6 +1,6 @@ # AplCoreName -The directory and name of the file in which an *aplcore* is saved. An optional wild-card character (`*`) is replaced by a number when the file is written; if there is more than one `*`, the string is used as is, with no substitution. Dyalog terminates with an exit code of `3` when an aplcore is generated. +The directory and name of the file in which an *aplcore* is saved. An optional wild-card character (`*`) is replaced by a number when the file is written; only one `*` can be used. If there is more than one `*`, the setting is ignored and the aplcore is named `aplcore`. Dyalog terminates with an exit code of `3` when an aplcore is generated. Valid values are a file path, optionally containing a single `*`. From 132ed7730ef271d823c12f84f13020c77c6e8a4b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ad=C3=A1m?= <10961427+abrudz@users.noreply.github.com> Date: Tue, 11 Aug 2026 14:28:48 +0100 Subject: [PATCH 37/37] Do not link cross-platform DYALOG_SERIAL to the non-Windows DYALOG_SERIALFILE DYALOG_SERIALFILE is only relevant on UNIX and macOS, so the cross-platform DYALOG_SERIAL page no longer references it. The DYALOG_SERIALFILE page still links back to DYALOG_SERIAL. Part of #898. --- .../docs/configuration-parameters/dyalog-serial.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md index 674ea5039d4..7127a5921de 100644 --- a/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md +++ b/dyalog-configuration-guide/docs/configuration-parameters/dyalog-serial.md @@ -5,5 +5,3 @@ Your Dyalog serial number. This must be set to the serial number issued to you; Valid values are your issued serial number. 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). - -Related parameters: [DYALOG_SERIALFILE](dyalog-serialfile.md).