Dyalog for Macos Installation and Configuration Guide
Total Page:16
File Type:pdf, Size:1020Kb
Dyalog for macOS Installation and Configuration Guide Dyalog version 18.0 The tool of thought for software solutions Dyalog is a trademark of Dyalog Limited Copyright © 1982-2020 by Dyalog Limited All rights reserved. Dyalog for macOS Installation and Configuration Guide Dyalog version 18.0 Document Revision: 20200603_180 Unless stated otherwise, all examples in this document assume that ⎕IO ⎕ML ← 1 No part of this publication may be reproduced in any form by any means without the prior written permission of Dyalog Limited. Dyalog Limited makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Dyalog Limited reserves the right to revise this publication without notification. email: [email protected] https://www.dyalog.com TRADEMARKS: SQAPL is copyright of Insight Systems ApS. Array Editor is copyright of davidliebtag.com Raspberry Pi is a trademark of the Raspberry Pi Foundation. Oracle®, Javascript™ and Java™ are registered trademarks of Oracle and/or its affiliates. UNIX® is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited. Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries. Windows® is a registered trademark of Microsoft Corporation in the United States and other countries. macOS® and OS X® (operating system software) are trademarks of Apple Inc., registered in the U.S. and other countries. All other trademarks and copyrights are acknowledged. Dyalog for macOS Installation and Configuration Guide Contents 1 About This Document 1 1.1 Audience 1 1.2 Conventions 1 2 Introduction 3 3 Pre-requisites for Installation 4 3.1 Hardware Requirements 4 3.2 Operating System Requirements 4 3.3 Hard Drive Requirements 5 4 Installing/Upgrading Dyalog 6 5 Verifying a Successful Installation 7 6 Configuration 8 6.1 Setting the Dyalog Serial Number 9 6.2 Customising the Dyalog Session 10 6.3 Installing the APL385 Unicode Font 10 6.4 Installing New Keyboard Key Mappings 11 7 Uninstalling Dyalog 14 A Default Keyboard 15 B Configuration Files 16 B.1 Configuration File Structure 17 B.2 Arrays 18 B.3 References to other Configuration Parameters 18 B.4 Nested Structures 18 B.5 Example Configuration File Content 18 C Configuration Parameters 20 Index 24 revision 20200603_180 i Dyalog for macOS Installation and Configuration Guide 1 About This Document This document covers the installation procedure and configuration options for Dyalog on macOS. It details the pre-requisites for installation and the configuration parameters that can be used to customise individual instances. This document is only part of the full documentation set for Dyalog (updated regularly and available to download from https://docs.dyalog.com). In cases where the information given is different between this document and any of the others, this document should be regarded as the definitive source for Dyalog for macOS. A complete documentation set is installed in the [DYALOG]/help directory when Dyalog is installed. The path to the [DYALOG] directory (that is, the directory in which Dyalog is installed) can be found from within a Session by entering: +2⎕NQ '.' 'GetEnvironment' 'DYALOG' 1.1 Audience It is assumed that the reader has a basic knowledge of macOS and software terminology; no prior knowledge of Dyalog is required. 1.2 Conventions Unless explicitly stated otherwise, all examples in Dyalog documentation assume that ⎕IO and ⎕ML are both 1. Various icons are used in this document to emphasise specific material. General note icons, and the type of material that they are used to emphasise, include: Hints, tips, best practice and recommendations from Dyalog Ltd. revision 20200603_180 1 Dyalog for macOS Installation and Configuration Guide Information note highlighting material of particular significance or relevance. Legacy information pertaining to behaviour in earlier releases of Dyalog or to functionality that still exists but has been superseded and is no longer recommended. Warnings about actions that can impact the behaviour of Dyalog or have unforeseen consequences. Although the Dyalog programming language is identical on all platforms, differences do exist in the way some functionality is implemented and in the tools and interfaces that are available. A full list of the platforms on which Dyalog version 18.0 is supported is available at https://www.dyalog.com/dyalog/current-platforms.htm. Within this document, differences in behaviour between operating systems are identified with the following icons (representing macOS, Linux, UNIX and Microsoft Windows respectively): revision 20200603_180 2 Dyalog for macOS Installation and Configuration Guide 2 Introduction Dyalog for macOS is a complete 64-bit Unicode implementation of Dyalog. It contains the same APL language engine as all other variants of Dyalog and is compatible with Dyalog running on other supported platforms – workspaces and component files can be copied between platforms or shared in real time on a network without needing to undergo conversion. The development environment on the Mac is the Remote Integrated Development Environment (RIDE). The default Mac installation causes RIDE and the APL Engine to start simultaneously and appear to be a single integrated unit. However, the RIDE can also be used to connect to remote Dyalog engines running on any platform. For more information about the full functionality of RIDE as a remote development environment, see the RIDE User Guide. revision 20200603_180 3 Dyalog for macOS Installation and Configuration Guide 3 Pre-requisites for Installation This chapter details the conditions that must be met before installing Dyalog on the macOS operating system. 3.1 Hardware Requirements The target Mac must have been introduced in 2010 or later. To check the year of introduction of your Mac 1. In the Apple () menu in the menu bar, select About This Mac. A window detailing the technical specifications is displayed. 2. Open the Overview tab. An overview of your Mac is displayed, including its model and when it was introduced, for example, "Mac mini (Early 2011)" or "MacBook Pro (Mid 2014)". 3.2 Operating System Requirements Dyalog version 18.0 is supported on macOS High Sierra onwards. To check the operating system on your Mac 1. In the Apple () menu in the menu bar, select About This Mac. A window detailing the technical specifications is displayed. 2. Open the Overview tab. An overview of your Mac is displayed, including its operating system. revision 20200603_180 4 Dyalog for macOS Installation and Configuration Guide 3.3 Hard Drive Requirements There should be at least 0.5 GB of free capacity on the target Mac. To check the free capacity of your hard drive 1. In the Apple () menu in the menu bar, select About This Mac. A window detailing the technical specifications is displayed. 2. Open the Storage tab. The storage information for your hard drive is displayed. revision 20200603_180 5 Dyalog for macOS Installation and Configuration Guide 4 Installing/Upgrading Dyalog This chapter is concerned both with new installations of Dyalog and with upgrading existing installations of Dyalog. To install/upgrade Dyalog 1. Download mac_64_<version>_unicode.pkg from my.dyalog.com. 2. Double-click on the mac_64_<version>_unicode.pkg file. The Dyalog Installer window is displayed. 3. Follow the instructions in the Dyalog Installer window. 4. Close the Dyalog Installer window. Dyalog is now installed and ready to use. revision 20200603_180 6 Dyalog for macOS Installation and Configuration Guide 5 Verifying a Successful Installation To verify that Dyalog has been successfully installed 1. Open Finder. 2. In the Go menu in the Finder menu bar, select Applications. The Applications window is displayed. 3. In the Applications window, double-click on Dyalog-<version>. A Dyalog Session is started. Starting a Dyalog Session adds the Dyalog icon to the dock. To keep the Dyalog icon in the dock permanently, right-click on the icon and select Options > Keep in Dock from the drop-down list that appears. revision 20200603_180 7 Dyalog for macOS Installation and Configuration Guide 6 Configuration Although no configuration is necessary and Dyalog can be used as soon as it has been installed, various configuration options are available so that Dyalog can be customised to meet personal preferences. During a Dyalog Session, the Preferences dialog box can be accessed from the Session window. For details of the configurations available through the Preferences dialog box, see the Dyalog for macOS UI Guide. In addition to configuring Dyalog, the APL385 font can be installed along with a locale- specific keyboard. This enables Dyalog glyphs to be entered in other applications (for example, Mail and TextEdit). Some configuration options require changes to files in the $HOME/.dyalog directory. This is a "hidden" directory; to display it so that you can access the files it contains you need to toggle the display of "hidden" directories. To toggle display of "hidden" directories 1. Open Finder. 2. In the Go menu in the Finder menu bar, select Go to Folder.... A dialog box is displayed. 3. In the field in the dialog box, enter a directory name of Users/<username>/. The listing for the Users/<username>/ directory is displayed. 4. Press the following key combination: ⌘ + Shift + . The display of "hidden" files is toggled on. revision 20200603_180 8 Dyalog for macOS Installation and Configuration Guide 6.1 Setting the Dyalog Serial Number If you have registered your copy of Dyalog or have a commercial licence then you will have been sent a Dyalog serial number; this serial number is individual to you and corresponds to the type of licence that you are entitled to use. Dyalog Ltd recommends setting the serial number either by editing a file containing the serial number directly or by running a function in a Dyalog Session to update the file containing the serial number.