.LM 8;RM 72;CE 3 FUNNELWEB Vn 4.40 E/A EMULATION ------------------------------- .FI (1) Programmer's Editor ~~~ ~~~~~~~~~~~~~~~~~~~ If the Central Menu Screen shows the Assembler side, selection of Editor loads the TI-Writer Editor modified for use as a program code Editor, including a new mode specifically for assembly source entry. All relevant improvements listed in FWDOC/TIWR & EDAV still apply. It is generally more convenient with these modifications than the E/A Editor ever was. .LM +3;RM -3 (i) The Editor now functions with word-wrap disabled, E/A tab defaults set, and files are saved to disk with no final tab record appended. Incoming tab records are still recognized. The disabling of word-wrap may spare you the distressing sight of 99 sectors of source code reformatting into one giant paragraph. (ii) If a DIS/FIX 80 file must be written to disk, say in editing of uncompressed object code, use the PF option as F DSKetc instead of SF. This is described in the TI-Writer manual. (iii) The Source Editor loads C2 as its character set from the E/A system drive. As supplied this contains a larger set than C1, quite suitable for Assembly source which typically has a high proportion of whitespace. If this set is not wanted, copy C1 or character file of your choice over C2. The 5-sector form saves disk space, but the 9-sector files from TI-Writer may be used. (iv) Pressing splits the current line much as does in word-wrap mode in the TI-Writer editor. The effect is not recoverable except by retyping the blank part of either line. (v) The key toggles a new Editor mode for assembly source code editing (ASMode), indicated by a diamond shaped cursor. In ASMode the alpha-lock may be left up for convenience in typing comments, and as each line is entered into the Text Buffer it is parsed as an assembly source line and converted to upper case where appropriate. Some common typing errors are flagged by a bloop if found. This will also happen on COPY directives but does not indicate any error there however. .LM -3;RM +3 (2) Assembler ~~~ ~~~~~~~~~ This loads the E/A Assembler, in a version modified for FUNNELWEB. See FWDOC/SCLL for use of Script-Load with the Assembler as a multiple file MAKE utility. .LM +3;RM -3 (i) The filenames remain visible on the screen while the Assembler is executing. Some default entries are provided, but may be deleted or added to as desired. (ii) If a filename is found in the mailbox by the freshly loaded Assembler, it is written up as the source filename, and with the last two characters altered from /S or ;S to /O or ;O as the object filename, or else just repeated for the user to modify as desired. (iii) The AID key calls up the Quick Directory routine at any time during the filename entry process. For this to be available file QF must be present on the disk in the boot drive when the Assembler is loaded. It returns on exit to the start of the entry screen with marked file installed as normal. (iv) The source filename is passed back to the Editor via the mailbox, and is immediately available for LF when the Editor is invoked after an Assembly. (v) The object filename is passed back to the Object file loaders, and appears as default. (vi) Entering any single character for List Device and ing will cause the full system print device name to appear. (vii) The assembler files load as a normal Option 2 (E/A 5) program, so other Assemblers in this form may be substituted. . .LM -3;RM +3 (3) Program File Loader ~~~ ~~~~~~~~~~~~~~~~~~~ Selection of Option 3 from this central menu screen sets up a selection screen with 8 choices of Load environment shown. The AID key for QD is available only in the Central Menu and Loaders screens. Filenames entered after the Loaders option is chosen may use disk volume or hard disk patn names and be up to 25 characters long. A full CRU search mechanism as used in SD and DR for sector access is implemented for program file loading, but not for the object loaders which use the normal E/A utilities. .LM +3;RM -3 (i) Option 1 emulates the TI-Writer module which hands over control in the GPL workspace, with Text mode set, and with a full set of characters 0-127 loaded from GROM even if they are immediately overwritten by CHARA1. The utility must be in E/A program file format. An attempt is made to load C1 from the boot drive, but no error is issued if it is not found. (ii) Option 2 sets up a GPL type of environment, as does E/A 5, adequate for most programs normally loaded by the E/A RUN PROGRAM FILE loader from GPL. Handover is in the GPL workspace and the presence of the E/A utilities cannot be assumed. (iii) Option 3 supplies the E/A RUN PROGRAM FILE function for Program files that have been prepared from E/A object files which do use the E/A utilities. Handover is in the USRWSP at >20BA, but this is not written to after file loading starts so that it does not corrupt files which ignore the E/A utilities and load over them anyway. The utilities are loaded if file EA is present on the disk in the boot drive when the option is selected (not necessary when running from the E/A module). If it is not found a warning honk is given and a discreet little message pops up. GPLLNK has been modified to work with FUNNELWEB (see FWDOC/REPT for details) and the first free address in low memory is unaltered. (iv) To load assembly program files from cassette, use either the E/A module directly or a special loader program such as CASSLOAD from XB. .LM -3;RM +3 The last program file in a sequence may overwrite FUNNELWEB at the top of high memory without trouble while loading, but if a utility overwrites FUNNELWEB either in loading or while running, it should return to the Title Screen on exit or else reload FUNNELWEB. (4) Object file loaders ~~~ ~~~~~~~~~~~~~~~~~~~ LOAD/RUN handles E/A object files, compressed or not. Files which load over FUNNELWEB in the top of high memory, if not auto-starting, will lock up the computer, and may be loaded with Script-Load instead. Otherwise programs written strictly to E/A manual specifications should run correctly. Common sources of difficulty are discussed in FWDOC/REPT. The EA file must be on the disk in the boot drive when this option is chosen or a warning is given (unless running with the E/A module). DEBUG and SAVE from your E/A package both work normally. .LM +3;RM -3 (i) Options 5-8 give variations on Load/Run. The normal Load/Run option sets the last free address in high memory (LFHM) pointer in UTLTAB to protect FUNNELWEB as far down as the User List code and/or FSAVE (currently >E98F). (ii) SCRIPTLOAD (Option 5) is a batch file loader for object files. The Utility pathname with SCRIPT as filename is supplied as default starter entry. See FWDOC/SCLL for details of SL. (iii) LOW-LOADER (Option 6) allows object files to be loaded starting in low memory at >2000, and then continuing in hi-mem. All normal REFed utilities are available as REFs. The REF/DEF table starts at >E200 and builds down from >E138. Code must not be AORGed above this. FSAVE recognizes Low-Loaded files. See FWDOC/SCLL for details of LL. (iv) If Option 7 is selected the LFHM is reset to the E/A default of >FFD7. This allows the last relocatable autostarting object file to load over FUNNELWEB if necessary, there being no memory contention because the autostart hands over to the program without returning to FUNNELWEB. (v) Option 8 intercepts the Autostart of object files and the DEF table is displayed as for a normal file load. The LFHM is as for Option 4. (vi) If a Duplicate DEFinition load error occurs, the offending DEF is displayed after the error message. .LM -3;RM +3 The Run part of the Load/Run procedure generally follows E/A conventions except that more information and help is provided along the way. Pressing with a cleared filename entry (use or clear to blanks) transfers to the RUN function. This matches E/A module function. .LM +3;RM -3 (i) RUN is activated by cursor driven selection from a screen display of the DEF table. The DEF table may be inspected at any time during a multiple file load by pressing after clearing the filename. The display shows both DEFs, and also now currently unresolved REFs which usually will appear with the first two characters either blank or with unrecognizable patterns. Cursor keys and drive the cursor through the DEF entries on the current page, while PROC'D (or ) transfers control to the program entry marked by the cursor, and REDO returns to load another file. Pressing will page through DEF tables larger than a single screen. Pressing BACK, or , aborts the load sequence. (ii) If an Unresolved REFerence is detected when RUN is invoked, the first such REF found is displayed after the error message. .LM -3;RM +3 €†€­•ŸĠĠĠĠĠĠĠĠĠĠĠĠĠ€‹