This repository contains results and oddbits from my journey through Bernard Legrand's book Mastering Dyalog APL. The book is available for free as a PDF download from Dyalog. The files accompanying the book, which I will not include in this repository in their original form but only with the changes I made, are also available as a free ZIP file.
Errata for the book can be found on Dyalog's web pages.
Set the WSPATH
environment variable to point to the directory in which Dyalog
should look to find and save workspaces. For instance (on a Mac),
export WSPATH=/Users/.../mastering_dyalog_apl/workspaces
This can be set in a custom file ~/.dyalog/dyalog.config
. See the example
setting in that file (it will be created upon first startup of Dyalog).
In chapter D.6, the variable MyPath
is used to point to the directory where
the companion files (e.g., text files and spreadsheets) can be found. This
directory can also be set as, e.g., MY_PATH
in dyalog.config
, and then
pulled in to the workspace using MyPath ← 2 ⎕NQ '.' 'GetEnvironment' 'MY_PATH'
.
Some additional instructions for installing and configuring Dyalog can be found in this PDF file, which is targeted towards Dyalog 14.1, but still appears to be largely correct for Dyalog 16.0, which is the version of Dyalog I used.
Unicode fonts for APL can be downloaded from Dyalog.
The same page also provides keyboard layouts. This example for Mac (UK
layout)
can be installed by copying the contents of the ZIP file to /Library/Keyboard Layouts
and activating the new layout via system control.
All workspaces used during working my way through the book are placed in the
workspaces
directory in this repository. The workspace journey.dws
is
derived from the workspace DyalogTutor_EN.dws
.
In Chapter D6.6, Legrand discusses file I/O, and suggests to load contents from
a workspace named files.dws
, which appears not to be part of the Dyalog
distribution on macOS. The file workspaces/fileio.dyalog
contains some
function definitions that substitute the functions mentioned in the book.
The companion files provided by Dyalog are available under the terms and conditions of the MIT Licence, and so are the files provided here.