The Toronto ACM SIGAPL Toolkit Version 2.1 1992-06-04 The Toronto Toolkit is a collection of useful ISO Standard APL utility functions collected by the Toronto Chapter of ACM SIGAPL, and provided without charge as a service to the computing community. The functions conform to the 1984 ISO (International Standards Organization) APL Standard N8485. The Toronto Chapter of ACM SIGAPL is a group of people interested in APL, based in Toronto, Canada. Accessing the Toolkit The Toolkit file (Toolkit.zip) is a compressed file containing several smaller files, each one being the Toolkit in a different format. Here is the procedure to access the Toolkit -- it assumes Toolkit.zip is on the DOS diskette (device b:) on which it was originally distributed. (If this is not the case, please make the appropriate changes to the procedure.) First of all, it is a good idea to make a new subdirectory (mkdir xxx) on the hard disk, and change to that directory (chdir xxx). Then uncompress Toolkit.zip by executing pkunzip (b:pkunzip.exe b:Toolkit.zip). After the "unzip" operation is complete, the directory will contain the Toolkit in files of several formats: (.saw) Sharp PC APL workspace (.apl) IBM PC APL2 (32 bit) workspace (.ws ) STSC APL*PLUS II (Version 3) workspace (.atf) APL2 apl transfer format (.slt) STSC source level transfer format (.wsi) WSIS0 interchange transfer format The size of the workspace is about 500k bytes. The files in "workspace" format should be accessible via a )LOAD command from the respective interpreter, although the workspace may need to be moved to a different directory before APL can access it. The files in "transfer" format should be accessible using vendor-supplied procedures for the respective APL; for example, the STSC .slt file is input to the vendor-supplied SLT workspace. The user is expected to know the particular procedures and restrictions that apply for using these transfer format files. (Note that these files have not been tested for all combinations of versions and machines, so unexpected compatibility difficulties not mentioned here may arise.) (Note also that a format for Dyalog APL has not been provided in the original distribution of Version 2.1. However, this and other formats may be created and provided by other organizations, and the Toronto SIG encourages this activity.) Each workspace contains the complete Toolkit. Loading the workspace "toolkit" for one of these systems, then typing "describe", will provide a description of the workspace and its documentation. Distribution Policy All functions in these workspaces are Copyright (c) 1992 by the author of the function or by the Toronto Chapter of ACM SIGAPL. However, the Toronto Chapter of SIGAPL is making this toolkit available with the understanding that any or all of the contents may be freely reproduced and/or used. No charge should be made except to cover the cost, if any, of reproduction and distribution. It is the best understanding of the Group that no copyright and/or proprietary rights pertaining to the contributed functions will be infringed in so doing. If this is not so, please inform the Toolkit editor at the address noted below. Credit Credit should be given the Toronto Chapter of ACM SIGAPL when distributing this workspace. The source note (.n tagline), where present in a function, should be preserved without alteration when separately publishing or distributing any toolkit function. This readme file should be distributed along with the workspaces and Workspace Interchange files when copying or sharing the toolkit. The Toolkit project was begun in 1983 and has progressed through two versions (a manual in 1985 and 1988) and has now progressed to version 2.1, the most complete version so far, in machine-readable format. The toolkit was edited by Richard Levine. Disclaimer No warranty or liability on the part of the Toronto Chapter of ACM SIGAPL for the Toolkit, either for the original distribution, or any subsequent distribution by individuals or organizations distributing or using the Toolkit, is expressed or implied by any statement appearing in the Toolkit or version thereof. For Further Information For further information about the Toolkit, including comments, questions, additions, and corrections, feel free to contact the Toolkit editor at the address below. For further information about the Toronto Chapter of the ACM APL SIG, and for information about joining SIGAPL or ACM, write to: Toronto APL Special Interest Group, P.O. Box 384, Adelaide Street Station, Toronto, Ontario, Canada. M5C 2J5 For current phone numbers for the Toolkit editor or any other member of the executive, refer to a current issue of the SIG newsletter, or write to the editor at the above address.