PROGRAMMER's AID CARTRIDGE™ Cartouche D'instructions Pour Le
Total Page:16
File Type:pdf, Size:1020Kb
PROGRAMMER’S AID CARTRIDGE Cartouche d’instructions pour le programmeur The information in this manual has been reviewed and is believed to be entirely reliable. No responsibility, however, is assumed for inaccuracies. The material in this manual is for information purposes only, and is subject to change without notice. Retyped and redrawn in 2006 for your enjoyment and for future generations by François Léveillé. ’-) PROGRAMMER’S AID USER MANUAL TABLE OF CONTENTS Section One – Introduction to the VIC 20 Programmer’s Aid Cartridge 1.1 Introduction............................................................................................................................. 1 1.2 The PROGRAMMER’S AID Manual..................................................................................... 1 1.3 Starting PROGRAMMER’S AID............................................................................................ 1 1.4 PROGRAMMER’S AID Commands ..................................................................................... 2 1.5 Entering Commands.............................................................................................................. 2 1.6 Indication of Errors................................................................................................................. 2 Section Two – The Commands of Programmer's Aid 2.1 Introduction............................................................................................................................. 3 2.2 Function Keys ........................................................................................................................ 3 2.3 PROGRAM and EDIT Modes ............................................................................................... 3 2.3.1 PROGRAM MODE ................................................................................................................ 3 2.3.2 EDIT MODE ........................................................................................................................... 3 2.4 AID Commands...................................................................................................................... 4 2.4.1 CONVENTIONS .................................................................................................................... 4 2.4.2 AUTO...................................................................................................................................... 4 2.4.3 RENUMBER .......................................................................................................................... 4 2.4.4 DELETE ................................................................................................................................. 5 2.4.5 FIND ....................................................................................................................................... 5 2.4.6 CHANGE................................................................................................................................ 6 2.4.7 EDIT........................................................................................................................................ 6 2.4.8 KEY......................................................................................................................................... 6 2.4.9 ADDING CARRIAGE RETURNS ......................................................................................... 7 2.4.10 HELP ...................................................................................................................................... 7 2.4.11 DUMP..................................................................................................................................... 7 2.4.12 TRACE ................................................................................................................................... 8 2.4.13 STEP ...................................................................................................................................... 8 2.4.14 OFF......................................................................................................................................... 9 2.4.15 PROG..................................................................................................................................... 9 2.4.16 MERGE .................................................................................................................................. 9 2.4.17 KILL ...................................................................................................................................... 10 2.5 Special Editing Functions .................................................................................................... 10 Section Three – Using Programmer's Aid as a Tool 3.1 Introduction........................................................................................................................... 11 3.2 The BASIC Program............................................................................................................ 11 3.3 The Procedure ..................................................................................................................... 11 3.4 Entering the Program........................................................................................................... 11 3.5 Locating the Error................................................................................................................. 13 3.6 Summary.............................................................................................................................. 14 iii TABLE OF FIGURES Figure Title 2-1 A Trace Display....................................................................................................................8 2-2 The Screen During Single-step...........................................................................................9 3-1 The First Error....................................................................................................................12 3-2 The First Error Highlighted ................................................................................................13 3-3 Dump of Variables .............................................................................................................13 iv SECTION ONE INTRODUCTION TO VIC 20 PROGRAMMER’S AID CARTRIDGE 1.1 Introduction SECTION THREE – USING PROGRAMMER’S AID AS A TOOL The VIC 20 PROGRAMMER’S AID CARTRIDGE This section illustrates the speed and has been designed to help both new and efficiency of using PROGRAMMER’S AID when experienced BASIC programmers to write, edit programming in VIC BASIC. It demonstrates and debug programs quickly and easily. This is how some of the cartridge’s attributes were used achieved by the AID commands which are to write, edit and debug a simple program. automatically incorporated into the VIC operating system when the cartridge is inserted. The cartridge also assigns some of the AID 1.3 Starting PROGRAMMER’S AID commands and some BASIC keywords to the The PROGRAMMER’S AID CARTRIDGE must function keys thus giving the programmer his always be inserted or removed from the VIC own shorthand notation during program writing. with the power off. The cartridge is inserted into This, together with the facility for the programmer the expansion port on your VIC with the label to assign his own functions to these keys, make facing up. (See your VIC 20 User Guide.) PROGRAMMER’S AID an invaluable program- If a VIC 1010 Memory Expansion Board is in ming accessory. use, this must also be turned off. The VIC 20 This manual does not attempt to teach BASIC PROGRAMMER’S AID CARTRIDGE may be programming on the VIC. If you have no used with VIC 1212 VIC Machine Code Monitor knowledge of BASIC programming, please and/or VIC 1211A Super Expander Cartridges. refer to one of the following: It may also be used with expansion RAM in the VIC 20 User Manual (supplied with your VIC 1010 Memory Expansion Board. Please computer). note, however, that some operations may An Introduction to BASIC Parts 1 and 2 by conflict if changing from one cartridge to Andrew Colin (part of the VIC learning series). another. Therefore it is recommended that the VIC be turned off to effect a good “switch”. 1.2 The PROGRAMMER’S AID To begin using PROGRAMMER’S AID type: Manual This manual is divided into three parts as SYS 28681 or SYS 7 * 40/96 + 9 and press the outlined below: RETURN key. SECTION ONE – INTRODUCTION TO PROGRAMMER’S AID Your VIC will display: – This section outlines PROGRAMMER’S AID in broad terms. It also explains how to load and -- PROGRAMMER’S AID -- start PROGRAMMER’S AID. The conventions used by this manual in describing the format of READY each PROGRAMMER’S AID commands are also included. All the PROGRAMMER’S AID commands are SECTION TWO – THE COMMANDS OF now included in the operating system of your PROGRAMMER’S AID VIC and may be used at any time like any other In this section, the format of each BASIC command. PROGRAMMER’S AID is stated, its purpose is When PROGRAMMER’S AID is started, the given, its uses explained and an example VIC is automatically in PROGRAM mode which shown. The commands are listed in the logical means that the four function keys on the right of order in which they might be used when writing the VIC keyboard have been assigned a BASIC program such as the one included in programming commands such as GOTO, Section Three of this manual. CHR$( and GOSUB. (See Section 2.3.1) The 1 alternative