inter AEDIT-86 TEXT EDITOR USER'S GUIDE Copynght (1') 1983, 1984 Intel Corporation Intel Corporation, 3065 Bowers Avenue, Santa ClalCl Call1orrlla 95051 Order Number: 121756-003
AEDIT-86 TEXT EDITOR USER'S GUIDE Order Number: 121756-003 I Copyright © 1983, 1984 Intel Corporation Intel Corporation, 3065 Bowers Avenue, Santa Clara, CA 95051 r
Additional copies of this manual or other Intel literature may be obtained from: Literature Department Intel Corporation 3065 Bowers Avenue Santa Clara, CA 95051 Intel retains the right to make changes to these specifications at any time, without notice. Contact your local sales office to obtain the latest specifications before placing your order. Intel Corporation makes no warranty of any kind with regard to this material, including.
REV. REVISION HISTORY DATE -001 Original issue. 1/83 -002 Includes additionaJ macro files for non-Intel terminals. 5/83 -003 Corrects bugs; adds PARAGRAPH. WINDOW, and KILL_ WND commands; adds CALC and local and global variables; adds features to SET command; adds invocation controls; enlarges OTHER buffer. 12/84 APPD. M.K.S.
PREFACE This manual provides instructions for using the AEDIT-86 interactive text editor. AEDIT-86 can be run within several environments including Series Ill, Series IV, and iRMX operating system. Basic knowledge of your system (ISIS and RUN, iNDX or iRMX), is assumed. Specific information on running AEDfT-86 on different systems is given in the appendixes. This manual is for both new users and those who are already familiar with microcomputers and text editors.
Preface AEDIT-86 User's Guide • • • • Appendix D, "Using AEDIT-86 on the Series IV," describes the systemdependent usage of AEDIT-86 on a Series IV. Appendix E, "Using AEDIT-86 on iRMX Based System," describes the systemdependent usage of AEDIT-86 on iRMX based systems. Appendix F, ~'Configuring AEDIT-86 for Other Terminals," describes how to configure AEDIT-86 for several terminals and provides tested configurations for specific terminals.
TABLE OF CONTENTS CONTENTS PART I CHAPTER I INTRODUCTION AND TUTORIAL PAGE 1.1 Introduction ................................................................................................................... 1.2 AEDIT-86 Tutorial ....................................................................................................... 1.2.1 Activating the Editor ................................................................................................. 1.2.2 Entering. Changing, and Deleting Text .....
Table of Contents AEDIT-86 User's Guide PAGE J.7
AEDIT-86 User's Guide Table of Contents PAGE 3.23.1 Description ............................................................................................................... Input ......................................................................................................................... Output ................... ............................................. ......... ............................................. 3.23.2 Examples .............................................................
Table of Contents AEDIT-86 User's Guide PAGE 5.3 Macro Modes ................................................................................................................ 5.4 EXECUTE Command .................................................................................................. 5.4.1 Description ......................................... .......... .............................................................. 5.5 Macros and AEDIT-86 Variables .................................................
AEDIT-86 User's Guide CHAPTER 9 CONFIGURATION COMMANDS Table of Contents PAGE 9.1 Introduction ................................................................................................................... 9.1.1 Configuration Command Notes ................................................................................. 9.2 Configuration Values .................................................................................................... 9.3 Delay Codes .......................................
Table of Contents AEDIT-86 User's Guide APPENDIXF CONFIGURING AEDIT-86 FOR OTHER TERMINAlS PAGE F.! Tested Configurations ................................................................................................... 1510E.MAC-Hazeltine™ 1510 ..................................................................................... 1510T.MAC-Hazeltine™ 1510 ..................................................................................... ADM3A.MAC-Lear Siegler™ ADM3A ................................
PART I Part I includes Chapters 1 through 4. It gives a general overview of AEDIT-86 and describes the basics required to use AEDIT-86, including a tutoria1. An AEDIT-86 commands are described in Part I, most of them in depth. However, some are mentioned briefly here, then fully described in Part II. Read Part I in the order it is presented before going on to Part II. Chapter 1, ~'Introduction and Tutorial," introduces AEDIT-86 and gives a short tutorial.
·n CHAPTER 1 INTRODUCTION AND TUTORIAL ~ i 1. 1 Introduction AEDIT-86 is an interactive, screen-oriented text editor with menu style command prompts. AEDIT-86 can be run within several environments including Series III, Series IV and iRMX Operating System. Specific information on running AEDIT-86 on the different systems is given in the appendixes. AEDIT-86 requires a minimum of 96 Kbytes of free RAM. Additional free RAM improves AEDIT-86's performance significantly.
Introduction and Tutorial AEDIT-86 User's Guide This manual makes no references to any particular operating system; the appendixes give operating-system dependent information. 1.2.1 Activating the Editor Specific invocation commands are given in the appendixes. In general, AEDIT-86 is activated by typing the following: ':'EDIT The editor displays the following prompt at the bottom of the screen: - ??- Again system-id Block AED I T Vx.y Cop y rig h t yyyy I n tel Cor p .
Introduction aad Tutorial AEDIT-86 User's Guide The line you just typed may be deleted character-by-character with the < RUBOUT) key or in its.entirety with the key configured to < DELLI ), delete line (usually configured to (CTRL-Z». Delete the line. The file is now empty, and the EOF marker is back in the upper left-hand corner of the screen. The cursor, however, remains in the same position on tbe screen until the next command is given. Now type the following sentence.
latroductioa .ad Tatorial AEDIT-86 User's Guide First, position the cursor over the first character of the section. In this case you want the period to close the sentence, so position the cursor on the space before the f in from.· Then press B for BLOCK. The @ sign covers the space. Then position the cursor one character past the end of the section you wish to block; i.e., place the cursor on the period immediately after the e in code.
AEDIT-86 User's Guide Introduction and Tutorial 1.2.4 Using the OTHER Command AEDIT-86 has two distinct and equivalent files: the main file and the OTHER file. The OTHER file increases the power of AEDIT-86, allowing you to switch between two editing files. To enter the OTHER file, use the OTHER command. Press a to enter the OTHER file. Press 0 a second time to return to the main file. The OTHER command is fully described in Chapter 3. 1.2.5 Exiting the Editor To exit from the editor, press Q for QUIT.
CHAPTER 2 THE EDITOR BASICS The following editor basics are described in this chapter: • • • • Keyboard Cursor End-of-file (EOF) marker • Screen-mode editing AEDIT-86 display and menu format Beep warning Lines and line terminators Printing and non printing characters Tags Repeat function (count) • Buffer • • • • • 2. 1 Keyboard The keyboard is your interface with the editor. It is a typewriter style. electronic keyboard that supports the ASCI I character set.
AEDIT-8() User's Guide De Editor Basics cRUBOUT) The RUBOUT key deletes the character to the left of the cursor at main command level or INSERT mode. In XCHANGE mode, < RUBOUT) replaces the new character to the left of the cursor with the original character.
AEDIT-86 User's Gaide The Editor Basics Figure 2-1 shows the screen after AEDIT-86 is called but before any text has been typed. 2.5. 1 The Prompt Line The prompt line is the bottom line of the display. (The first position of the prompt line is blank.) The prompt line contains information on the options of commands or subcommands that you may perform.
TIle Editor Basics AEDIT-86 User's Guide Bloc' Calc Delete Elecute find ·flnd --.ore-- Hel Illserl Ju.p Kill.wnd "aero Other ·-.ore-- Tag View -., ,Get -""- Paragraph Qult 1-"-.... ,; Replace 'replace Set --.ore-- .. ~ --., -- lchang!! . Figure 2-2. Menu Prompt Lines 121756·2 The Line-Edited Prompt Line-edited prompts ask for information (such as a filename) that requires more than a single-character user response. The response can be up to 60 characters.
AEDIT-86 User·s Guide The Editor Basics If you want to enter new information. simply type it in. As soon as any key is pressed (except for (1...EFT). < RIGHT). < HOME) . or (ESC»). the prompt line is blanked and the nev." characters are entered. Press < ESC) or < RETURN) to finish the command and send the information. To enter a character using its ASCII value in the line-edit prompt. simply type < HEX) (usually configured as (CTRL-H ) ) followed by t"'O hexadecimal digits. For example.
De Editor Basics AEDIT-86 User's Guide AEDIT-86 does not write past the last column of the message line. If a message does not fit. ! is printed as the last character. . When the message line contains status information, usually an error message, the message line goes blank as soon as any key is pressed. 2.5.3 Text Area The rest of the screen is the text area. 2.
AEDIT-86 User's Guide The Editor Basics 2.10 Repeat Function (Count) Count is displayed on the message line and indicates the number of times to repeat a command. Some commands ignore count or, like delete character < DELCH ), limit count. Enter count before typing a command letter. It is then displayed at the left side of the message line. < RUBOUT) can be used to delete the vaJue being entered for count.
'.
CHAPTER 3 EDITING COMMANDS This chapter describes all AEDIT-86 commands. Most of the commands are described in depth. However, some commands are only mentioned here and fully described in Part II. 3. 1 Cursor Movement Commands The cursor movement commands control cursor movement in a file. (LEFT), (RIGHT), (UP), and < DO\\'N) refer to keys labeled with directional arrows; < HOME) refers to the key labeled (HOME) (or configured for this function). 3. 1.
AEDIT-86 User's Guide Editing Commands 3.1.3 (UP) The UP command moves the cursor up one line in the same column. Special cases of < UP) are• If the cursor is in the top line of the file, the command is ignored. • If the cursor is in the top line of the screen, the screen is rewritten/scrolled to display previous line(s) of text. The cursor remains in the same column as before the command. Count. This command accepts any count where count multiplies the distance moved.
Editing Commands Count. Count is significant only for (UP) and (DOWN) it multiplies the distance moved. Related Commands. < HOME) s, where < LEFT), < RIGHT), < UP), < DOWN) 3.2 CARRIAGE RETURN Command The < RETURN) key moves the cursor to the beginning of the next line. Special cases of < RETUR N) are- < RETURN) moves the cursor to the • If the cursor is on the last line of the file, end of the file. • If the auto indent option (SET Indent) is on, to the first nonblank character of the next line.
Editing Commands AEDIT-86 User's Guide 3.5.2
AEDIT-86 User's Guide Count. The Editing Commands < UNDO) command ignores count. Related Commands. < DELL), < DELR ), < DELLI) 3.7 < HEX) Function Key The < HEX) prefix (usual1y configured to < CTRL-H » is used to insert a character into the text as its ASCII value. This feature is useful in the following cases: • When the character to be inserted has no key; e.g., a character with a hexadecimal value over 7FH. • When the character to be inserted has a special function in the current mode, e.g.
FAlitiBg Commands AEDIT-86 User's Guide
AEDIT-" User's Guide Editing Commands
FAlitiag Commands AEDIT-86 User's Guide 3.10 FIND Command The FIND command searches forward from the current cursor position to the end of the file for a string of characters and positions the cursor after the next occurrence of the string. 3.10.1 Description Press F; AEDIT-86 prompts-
Editing Commands AEDIT-86 User's Guide Count. The FIND command accepts any count where count indicates the number of times to search for a target string. The search stops after the last occurrence of the target string is found or count is exhausted. Error. ""not found: targeLstring" is displayed if no match is found, and the editor returns to main command level. Related Commands. SET Case, SET K_token, SET Showfind 3.
EtiitiDg Commands • • • AEDIT-86 User's Guide If you want to return to editing the target string, press < RUBOUT) with the cursor on the first position of the replacement string. Press < ESC) if you are on the target string and < RUBOUT) if you are on the first character of the replacement string to reedit the target string and the replacement string as necessary. Press < ESC) while editing the replacement string to terminate editing the target/replacement strings and to start the replacement process.
Editing Commands AEDIT-86 User's Guide The ?REPLACE works exactly the same as the REPLACE command except that the following prompt is displayed on each find: ok to replece? (y or [n]) If y (or Y) is typed, the replacement is made. Any other key is considered a negative response. ·3.14 TAG Command The TAG command allows you to specify four locations in a file and, with the JUMP command, move the cursor to one of these locations. The TAG command relates to the current cursor position.
AEDIT-86 User's Guide Editing Commands The Tag subcommand is executed by pressing A, B, C, or D. The cursor jumps to the specified tag, previously set with the TAG command. Error. Uno such tag" is displayed if the specified tag does not exist. Related Command. TAG Start The Start subcommand is executed by pressing S. It moves the cursor to the start of the file. End The End subcommand is executed by pressing E. It moves the cursor to the end of the file.
AEDIT-86 User's Guide Editing Commands deleted, moved, or copied. The Buffer subcommand copies the delimited section to the Block buffer. The Delete subcommand deletes the delimited section and places it in the Block buffer. The Put subcommand copies the section to an external file. The commands (- )FIN D, JUMP, and the cursor movement commands < LEFT) , < RIGHT), < UP). < DO\VN ), < HOME). and < RETURN) work the same as at main command le\ t:1.
AEDIT-86 User's Guide Editing Commands Delete To execute the Delete subcommand, press D. It deletes the delimited section from the text and moves it to the Block buffer. If the deleted text does not fit in the portion of the Block buffer that is in memory, the menu prompts- cannot 5ave in memorY--5ave anyway? ([yl or n) If n is specified, the delimited section of text is deleted, but the Block buffer is not updated. If you press any other key, the delimited section is written to a temporary file.
Editing Commands AEDIT-86 User's Guhle 3.18 GET Command The GET command retrieves the contents of the Block buffer or an external file and inserts it at the current cursor position in your file. 3.18.1 Description Move the cursor to the point in your file where you want the contents of the buffer (or external file) to be placed.
AEDIT-86 User's Guide Editing Commands Pressing 0 a second time returns the editor to the main buffer. Main and OTHER buffer text may be displayed simultaneously by splitting the screen into two windows using the WINDOW command. 3.20.
Editing Commands AEDIT-86 User's Guide Most SET subcommands relate to switches. A switch is an option that has only two states: yes or no. When a subcommand of this type is activated, a yes/no question is displayed on the prompt line. The value currently in effect is enclosed in square brackets. Each feature has a default value; this value is in effect until it is reset using the SET command. 3.22.
AEDIT-86 User's Guide Editiag ComlDods For example, If the target string for the FIND command is tHe and the option is set to y, AEDIT86 will find tHe only. If the target string for the FIND command is tHe and the option is set to n, AEDIT86 will find tHe, the, THE, etc. Related commands. (-)FIND, (?)REP-LACE Display To execute the Display option, press D. This options allows you to display the text changes resulting from macro execution.
EAliting Commands AEDIT-86 User's Guide Related Commands. (-)FIND, (?)REPLACE, SET K_token Go To execute the Go option~ press G. It relates to macro execution continuation after a (-)FIND/(?)REPLACE command failed. It prompts- continue macro execution after a failure? Cy or [n]) This option is meaningful only in macro execution; it has no meaning at main command level. The default for the SET Go option, when a macro is started, is No for all macros regardless of the current setting of the option.
FAliring ColDllUlndS AEDIT-86 User's Guide To execute the K_token option, press K. This option allows you to find a string only if it is enclosed by delimiters and is not part of a larger string. It prompts- find only token strings? (y or [n]) Token characters are all the characters that are not delimiters. A token is defined as a nonempty string surrounded by delimiters. Delimiters in this context are the characters specified in SET E_delimit.
AEDIT-86 User's Guide Editing Commands The current values for indent, left, and right are displayed to the right of the colon separated by commas. The first number sets the indentation, the second the left margin, and the third the right margin. Indent may be set at any value from 0-253; left, from 0-253; and right, from 1--254. The value of the right margin must be greater than the indentation and the left margin. When entering the values, separate them by one or more blanks or CJ comma.
AEDIT-86 User's Guide EditiD& ColDDlaDds Related Commands. FIND, (?)REPLACE Tabs To execute the Tabs option, press T. This option allows you to set tabs. It prompts- ---- (HOME) T I b is: to re-edit 4 The prompt line lists the current tab settings. If you want only to inspect the tab settings, type (CTRL~C) to return to main command level. To enter tabs, type a list of decimal numbers separated by at least one blank or a comma. The numbers must be specified in increasing order, from }-253.
AEDIT-86 User's Gaide Editing Commands Related Commands. VIEW, WINDOW 3.23 HEX Command The HEX command allows you to insert the ASCII equivalents of hexadecimal values in the text. This command also displays the hexadecimal values of text contents in the message line. 3.23.1 Description Press H; AEDIT-86 prompts- I n put Output To specify a subcommand, press the initial letter of that subcommand.
Editing Commands 3.23.2 Examples Example 1 To insert the form-feed character (hexadecimal value OC) to the current location, typelEX) Input) ~ Example 2 To insert the digits 1, 2, and 3 to the text, typelEX) Input) 3 1 3233 Position the cursor over the one and type 3 H(EX) O(utput) to display the characters. The characters are displayed on the message line. 3.24 QUIT Command The QUIT command performs several functions depending on its subcommand.
Editing Commands AEDIT-86 User's Guide Exit To execute the Exit subcommand, press E. When activated, AEDIT-86 rewrites the current file. Then, if the secondary file has also been changed, AEDIT-86 automatically performs the OTHER command and asks "all changes lost? (y or [n»". A y returns AEDIT-86 to the operating system without rewriting the secondary file. Any response other than y return~ the editor to main command level. Init To execute the Init subcommand. press I.
AEDIT·86 User's Guide Editing COlDlDands Note that: • QUIT Abort and QUIT Exit relate to the entire AEDIT-86 session, i.e., to both the current file and the secondary file. QUIT Init, QUIT Update, and QUIT Write relate only to the file you are currently editing. • An output file indicated by the TO clause can be specified for a file in either the invocation line or at the QUIT Init command. Only the subcommands Update and Exit relate to this output file; Write does not. 3.24.
AEDIT-86 User's Guide Editing Commands margins or from line to line if necessary. The first line is indented according to the value of indent. Words are moved to the left as much as possible. Words are not split and lines are not right-justified. Justify Press J to perform justification. The first step is as described in the filling process.
Editing Commands - AEDIT-86 User's Guide 3.28 CALC Command To invoke the CALC command, press C. It provides you with computation capabilities. 3.28.1 Description Press C; AEDIT-86 prompts- ----
AEDIT-86 User's Guide Editing Commands Macro files are described in Chapter 5; AEDIT -86 invocation is described in Chapter 4. Related Command.
CHAPTER 4 AEDIT -86 INVOCATION This chapter describes AEDIT -86 invocation and the AEDIT -86 controls: FORWARDONLY, VIEWONLY, RECOVER, MACRO, MACROSIZE and BATCH. 4.1 Invocation Invocation details for a particular system are given in the appendixes.
AEDIT-86 User's Guide AEDIT-86 Ia.ocatioa Example 3 The following example shows an invocation of AEDIT -86. The main input file and the OTHER input file have the same filename but different filename extensions. The controls MACRO and MACROSIZE are also specified. The main filename and the OTHER filename can be shortened using a hyphen (-), as follows: ~=:- P~=G.SR>LS~ vIE ... O~'LV I"CEATCH MACRO{FROG.
AEDIT-86 User's Guide • • AEDIT-86 In~ocation When an output file is specified, these controls may be specified only in their negative form, e.g., NOVIEWONL Y. VIEWONLY and FOR W ARDONL Yare the only controls that can be specified under QUIT Init. The processing mode for the main input file uses the RECOVER control. • This control may be specified only in the invocation line and only for the main input file. The execution mode uses the MACRO, MACROSIZE, and BATCH controls.
AEDIT-86 Invocation AEDIT-86 User's Guide 4.2. 1 FORWARDONL Y Syntax FORWARDOtiLY I tfOFORWARDOHLY Abbreviation [HOlFD Default HOFORWARDOHLY Control Type Processing mode for an input file Description FOR W ARDONL Y allows much faster editing of large files because it instructs AEDIT-86 to allocate a fixed amount of memory for the file. If the file is larger than the amount of memory allocated, some text may be lost.
AEDIT-86 User's Guide AEDIT-86 Invocation 4.2.2 VIEWONL Y Syntax VIEWOHLY HOVIEWOHLY Abbreviations [HOlVO Default HOVIEWOHLY Control Type Processing mode for an input file Description A large file, e.g., a large listing file that you do not want to change, may be viewed much faster using the VI EWON L Y control. It is also an advantage to use VIEWONL Y if you want to be certain that no changes are made unintentionally.
AEDIT-86 Invocation AEDIT-86 User's Guide 4.2.3 RECOVER Syntax RECOVER I HORECOVER Abbreviations [H01RC Default HORECOVER Control Type Processing mode for the main input file on invocation Description The RECOVER option can be used to help you reconstruct edited files if a fatal system error occurs during AEDIT-86 operation or if an unintentional termination of an AEDIT-86 session occurs using QUIT Abort. If a crash occurs, reinvoke AEDIT-86 with the RECOVER control.
AEDIT-86 Invocation AEDIT-86 User's Guide 4.2.4 MACRO Syntax (II A CR0 [ ( macro_file ) 1 I H 0 !WI A C R 0 Abbreviations [H01!WIR Default !WI A C R 0 ( A E D I T _filename. !WI A C ) Control Type Execution mode Description The MACRO control allows you to specify a macro file for the current AEDIT-86 invocation. The NOMACRO option prevents AEDIT-86 from reading a macro file. Not specifying this control or just specifying MACRO is equivalent to the default.
AEDIT-86 Infocation AEDIT-86 User's Guide 4.2.5 MACROSIZE Syntax MAC R0 S I ZE ( macro_buffer_size ) Abbreviations MS Default MACROSIZE ( 3072 ) Control Type Execution mode Description This control is useful to allocate more macro buffer space if, for example, a huge batch operation is implemented using macros. Also, more macro space may be required if many or long macros are used. The subject of macros and macro files is more thoroughly described in Part II.
AEDIT-86 Invocation AEDIT-86 User's Guide 4.2.6 BATCH Syntax BATCH I HoBATCH Abbreviations [HolBA Default HoBATCH Control Type Execution mode The BATCH control is used to activate AEDIT-86 in a noninteractive mode, usually from a command file. When BATCH is in effect, AEDIT-86 suppresses al1 output except the MESSAGE line. Although AEDIT-86 may receive input from the console in BATCH mode (implying a semi-batch mode where input is from the keyboard). this is not recommended.
AEDIT-86 IavocatiOD AEDIT-86 User's Guide In this example, the following command file may be used: AEDIT EXAMPL.SRC BATCH MGEXAMPL.MACcESC) IRdogcESC)cetcESC) QE where EXAMPL.SRC MG EXAMPL.MAC jR QE is the input file. is the MACRO Get command. is the macro file containing the configuration command AFIG=ODOA. means replace all occurrences. is the QUIT Exit command. Example 3.
AEDIT-86 Invocation AEDIT-86 User's Guide 4.3 Various SATCH Modes The BATCH control can be either BATCH or NOBA TCH. NOBA TCH is the default. The activation source can be either the keyboard or a command file. NOBA TCH with input from the keyboard is the usual interactive mode. BATCH with input from a submit file is the usual batch operation. The remaining combinations, NOBATCH with input from a submit file and BATCH with input from the keyboard, are seldom used. 4.
PART II Part II describes the more advanced uses of AEDIT-86. In this part, the macro commands and macro files, AEDIT-86 variables, the CALC command, advanced usage of AEDIT-86, and configuration commands are explained in detail. Chapter 5, "Macro Commands," discusses the manipulation of macros and how to create and use them. Macros, sequences of commands that have been collected and given a name, are typically used for command sequences that are executed often.
CHAPTER 5 MACRO COMMANDS AEDIT-86 macros are sequences of AEDIT-86 commands (sequences of keystrokes) that have been collected and given a name. Macros are typically used for frequently executed command sequences. Instead of entering a series of commands, you can call a previously created macro to execute a command sequence automatically. Macros speed your work and reduce the typing errors associated with long command sequences. A set of macros may be grouped in a macro file.
Macro Commands AEDIT-86 User's Guide Press C; AEDIT-86 prompts- ----
AEDIT-86 User's Guide Macro Commands Macro files are described later in this chapter. The new macro definitions are added to the current set of available macros. If a macro in the new set has the same name as a macro already available, the new macro overrides the previous one. Configuration commands and SET commands are executed. Press G; AEDIT-86 prompts- ----
Macro Commands AEDIT-86 User's Guide The following text is inserted into filename: M\OOC\BR\CR\CL\CH\MM MM terminates the macro definition (see also Section 5.3, uMacro Modes"). List The List subcommand displays on the message line the names of all currently available macros. If there are more macros available than can be listed on the message line, the message "hit space to continue" is displayed. Press the space bar to continue; any other character returns the editor to main command level.
l\EDIT-86 User's Guide Macro Commands 5.3 Macro Modes A macro may be either modeless (terminated with \MM after it is converted to macro form) or non-modeless (terminated with \EM after it is converted to macro form). All macros created with MACRO Create are modeless. A non-modeless macro may be created using MACRO Insert or by editing a saved modeless macro. Any modeless or non-modeless macro may be used at main command level or in either INSERT or XCHANGE modes.
AEDIT-86 User's Guide Macro Commaads 5.4. 1 Description Press [count] E; AEDIT-86 prompts- ----
AEDIT-86 User's Guide Macro Commands ( MEXEC) is a configurabJe key (usually (CTRL-E». To activate the singlecharacter macro, press (MEXEC) followed by the macro name. For example, if you are using the macros from USEFUL.MAC in INSERT mode, typing ( MEXEC) t converts the word that starts "under" the cursor to uppercase letters. A digit may not be used as a single-character macro at main command level because it is always interpreted as a count.
Macro Commands AEDIT-86 User's Guide The following representations of control characters and control codes are ased in the macro definitions.
AEDIT-86 User9 s Guide Macro Commands A cursor movement command prefixed by / is never marked as failed. If the SET Go option is on, the (-)FIND and (?)REPlACE commands are never marked failed. When a command in a macro is marked as failed, the following occurs: Macro execution is terminated, and control is returned to the caller. If the caller is main command level, AEDIT -86 simply waits for the next command. If the caller itself is a macro, execution continues with the caller's next command.
Macro Commands AEDIT-86 User's Guide If SET Display Yes is in effect, all changes and cursor movements are displayed on the screen, even if the cursor leaves the screen or a VIEW command is given. Regardless of the SET Display value, the text is updated if you give the ?REPLACE command or the FIND/REPLACE command and SET Showfind Yes is in effect. 5.9.2 Message The message line is updated only in the following cases: • Error message display. The error message display lasts for about a second.
AEDIT-86 User's Guide Macro Commands These macros can be defined interactively using the MACRO Create command. For example. the first macro can be created by entering the following commands: ~ACRO) I
AEDIT-86 User's Guide Macro Commands 5.10.4 Example 4 The following sequence of commands saves, in a new file named EXMPL.MAC, an interactively defined macro named asterisk (*) that allows you to scroll backwards ten lines. Create macro I Command sequence aTHER) DUIT) t nit ) ::XMPL .
CHAPTER 6 AEDIT-86 VARIABLES AEOIT -86 has a set of variables that can be accessed by the user. This set has the following characteristics: string variables versus numeric variables, read-only variables versus read-write variables, local variables versus global variables. • Read-only variables renect internal AEOIT-86 values that you can retrieve but not modify. Read-write variables can be modified freely. Read-write variable assignment can be done only in the CALC command.
AEDIT-86 Variables • AEDIT-86 User's Guide Under the CALC command. The variable may be retrieved as in any line-edit prompt. Also, the variable name may be used as is, e.g., N I instead of < FETN ) I. In this case the name, rather than the value, is displayed, e.g., N I instead of 45. The entire processing is done by the CALC command, not by the line-editing mechanism. A variable may be modified only if it appears in CALC with its name on the left-hand side of an assignment statement.
AEDIT-86 User's Guide AEDIT-86 Variables The S-variables may be used in the following circumstances: • In any line-edit prompt, e.g., target-string, replacement-string, GET filename. The contents are inserted and displayed as an ASCII string. The conversion from < FETS »)( to the ASCII string is done by the line-editing mechanism, regardless of which command is currently being executed. • In INSERT and XCHANGE modes. For example, if contents of S 1 are inserted in the text.
AEDIT-86 Variables AEDIT-86 User's Guide NXTCH ASCII value of the next character. NXTTAB The column number of the next (Le., to the right of the cursor) tab position as defined by SET Tab. If there are no tabs to the right of the cursor in the current line, the value of NXTTAB is zero. NXTWD ASCII value of the second and third bytes following the current cursor location. ROW Current cursor row (actual row, not the logical line in the text).
AEDIT-86 User's Guide AEDIT-86 Variables The following ·values relate to the margin and indentation settings used by PARAGRAPH and SET Autonl commands: IMARGN The value of current indent margin setting. LMARGN The value of current left margin setting. RMARGN The value of current right margin setting. The following values are returned by the UOI-call OQ$GETSTIME: DATE Date returned by DQ$GETSTIME in decimal format mmddyy.
AEDIT-86 Variables AEDIT-86 User's Guide SM The name of the last file specified for the MACRO Get command. so The name of the OTHER input file. SP The name of the last file specified for the BLOCK Put command. SR The replacement string of (?)REPLACE. ST The target string of (-)FIND and (?)REPLACE. SW The name of the last file specified for the QUIT Write command. 6.4.2 Local Variables All local variables are read-only numeric variables.
AEDIT-86 User's Guide AEDIT-86 Variables The following values are offset from the beginning of the currently processed input file: CURPOS The offset of current location in file. TAGA The offset of tag A. TAGB The offset of tag B. TAGC The offset of tag C. TAGD The offset of tag D. The following values relate to the S-variables: SLO-SL9 Relates to the S-variables SO-S9. SLx Relates to the S-variables, Sx, where x is a second letter of one of the global read-only variable names (e.g., B, E, G).
CHAPTER 7 CALC COMMAND The CALC command provides you with computation capabilities. These capabilities coupled with AEDIT-86 variables enable the following, for example: centering a phrase on a line, finding the size of an input file, or changing a letter from lowercase to uppercase or vice versa. To execute the CALC command, press C; AEDIT-86 prompts- ----
AEDIT-86 User's Guide CALC Command L .........: ~.---n_.- ~ . .temen-t 8trin~con.tant r--. Notes: • n_statement, s_statement : n stands for numeric, s stands for string. • LeIement, r_element : I stands for left, r stands for right. • Uppercase and lowercase letters are not distinguished from each other except in string constants. For example, curpos and CURPOS are interchangeable. • One or more blanks may be inserted between tokens.
AEDIT-86 User's Guide CALC Command Table 7-1. Operators' Precedence and Associativity Operator Cia •• Operator Parentheses ( Unary + Power .. Arithmetic (mul/div) Interpretation ) - - ./ ! # \ - Arithmetic (add/sub) + Shift/rotate SHL,SHR,SAL.SAR,ROL,ROR Relational < Logical & I 1\ <= === <> => > A..
CALC ColDlDand AEDIT-86 User's Guide second occurrence of that character signifies the right end of the string. To prevent ambiguity, the following characters may not serve as string delimiters: letters, digits, blank, and tab. A natural delimiter choice is a quotation mark. However, if the string constant includes a quotation mark, a different character, one that does not appear in the string, should be used as the delimiter. The case of the letters within the string is preserved. 7.
AEDIT-86 User's Guide CALC Command 7.6 Expression Evaluation Operators in the CALC command have an implied order that determines how operands and operators are grouped and evaluated. Table 7-1 lists the CALC command operators from highest to lowest precedence (i.e., those that take effect first are listed first). Operators in the same line are of equal precedence. The evaluation order is the same as that used in most programming languages.
· CALC Command AEDIT-86 User's Guide Message 7-6 Explanation Divide by zero error An attempt was made to divide by zero. Expression too complex The expression is too complex; simplify the expression. Floating point not allowed Real values (e.g., 5.2) are not allowed. Illegal exponential operation Usually occurs when a negative value is used as the right operand. The illegal exponential expression is displayed on the message line. Correct it and rerun CALC.
CHAPTER 8 ADVANCED AEDIT-86 USAGE Macros give AEDIT-86 great flexibility and power. Macros can be written to incorporate the CALC command and AEDIT-86 variables. These macros allow you to print dates, directories, use an on-line calculator, and convert letters from uppercase to lowercase and vice versa. Several macros are included with AEDIT-86 in the file USEFUL.MAC. You must have AEDIT-86 version V2.0 or later to use this macro file. To activate these macros, type the following: I.
Ad,anced AEDIT-86 Usage AEDIT-86 User's Guide
AEDIT-86 User's Guide Ad ••nced AEDIT-86 Usage SHP Display the current position in the line. (CTRL-R) On-line calculator. In INSERT or XCHANGE modes you may enter an arithmetic expression. Press (CTRL-R) and the result is displayed at the cursor position. SMP Set the indentation and left and right margins according to the values for the paragraph in which the cursor is currently positioned. NUM Insert line number prefix on each line in a text file. The macro uses Tag D for internal computations.
Adya.cM AEDIT-86 Usage AEDIT-86 User's Guide 8.2.2 Simulate "IF cond THEN RETURN" (to the caller) This construct is done by using the "fail" characteristic of the FIND command. Recall that searching an empty string always fails (assuming that SET Go No is in effect), but searching zero times always succeeds, regardless of the operand.
AEDIT-86 User's Guide Advanced AEDIT-86 Usage (e.g., ISDEL, CURCH = 20H). The method consists of two nested macros. The "low level" macro advances one character and fails when the condition is not met (named Advance_One). The "main" macro executes the first one an infinite number of times and actually terminates when the condition is not met, and continues with the next instruction: Advance_While: ... / E(XECUTE) Advance_One ...
Ad,anced AEDIT-86 Usage AEDIT-86 User9s Guide 8.3.2 Example 2 Macro
CHAPTER 9 CONFIGURATION COMMANDS 9.1 Introduction AEDIT-86 is designed to run within several environments and with various terminals. In some cases-for example, Series IV AEDIT-86 is able to identify the host environment. In other cases, you should specify the characteristics of your particular environment or terminal. The characteristics of your environment or terminal are specified with configuration commands. The parameters and control sequences that must be specified are listed in Table 9-1.
Configuration Commands AEDIT-86 User's Guide Table 9-1. Configuration Commands .Command Meaning Terminal Attribute. and Generals AH=.trlng Hardware Identification string stands for one of the following configuration commands. v~lues. Each of the specified values implies a set of
Coufiguration Commands AEDIT-86 User's Guide Table 9-1. Configuration Commands (Cont'd .
CoDfiguration Commands AEDIT-86 User's Guide Table 9-1. Configuration Commands (Cont'd.) lleanlng Command Delete/insert: AFIL=hhhh Insert line code. Used in line 0 for reverse scrolling. AFDL=hhhh Delete line code. Used to speed up display on the Hazeltine 1510 and similar terminals. Reverse video: AFRV=hhhh Start reverse video character(s). Used on the PROMPT line display. AFNV=hhhh Return to normal video characters. Used to restore the display after a reverse video line.
AEDIT-86 User's Guide Configuration Commands Table 9-2. Configuration Values Command AH=; Default AH=S3 (5111) AH=S3E (S IIIE) AH=$4 (5 IV) AH=ANSI AH=VT100 Meaning Terminal Attributes and Gener.
ConfiguratiOD Commands AEDIT-86 User's Guide Table 9-2. Configuration Values (Cont'd.
AEDIT-86 User's Guide Configuration Commands 9.4 Determining the Configuration Values The default values are given in Table 9-2. The following list describes the order in which AEDIT -86 processes configurationcommand-related information: I. Sets the default value for each configuration command. 2. Checks to see if the system is a S III. If the system-id is SERIES III, then sets the configuration commands as defined under S III in Table 9-2. 3. Checks to see if the system is S IV.
APPENDIX A AEDIT -86 COMMAND SUMMARY This appendix lists the AEDIT-86 commands, their formats and functions. In the alphabetic list, < CTRL) represents the CONTROL key. Angle brackets « » indicate a key configured for a function. A. 1 Function Keys The following commands are executed by pressing the specifically configured key or by typing the indicated < CTRL) commands. Function Command ( LEFT) Moves cu rsor left, left arrow. (RIGHT) Moves cursor right, right arrow. (UP) Moves cursor up, up arrow.
AEDIT-86 Command Summary AEDIT-86 User's Guide
AEDIT-86 Command Summary AEDIT-86 User's Guide GET [count] G Retrieves contents of Block buffer or external file; places contents at current cursor position. Count must be a finite number. HEX [count] H Hex command Input Inserts the ASCII equivalent of hexadecimal values in text. o Displays hexadecimal values of ASCII characters in message line. [/1 I Begins INSERT mode; inserts text at cursor position. J Moves cursor to a specified location in text. A_tag A Moves cursor to tag A.
AEDIT-86 eomDWKI Summary Abort A Returns to operating system; all changes are lost. Exit E Returns to operating system; the file is updated. Init I Restarts editing; initializes new file without returning to operating system. Update U Updates file without returning to operating system. Write W Writes file to the output file specified without returning to opera ting system. REPLACE [count] R Searches forward for target string; replaces it with new string if found.
AEDIT-86 User's Gaide AEDIT-86 Command Summary K A string in the text needs to be a token string to be found (default=no). Leftcol L Allows you to view lines over 80 characters long (default=O). Margin M Sets indentation, and left and right margins used by the PARAGRAPH and SET Autonl commands (default: indent=4, left =0, right = 76). Notab N Inserts blanks in place of tabs in INSERT or XCHANGE mode (default=no).
AEDIT-86 User's Guide AEDIT-86 Command Summary WINDOW W Splits the text area of the screen in two, enabling the user to look at two different parts of the same file or two different files. XCHANGE x Enters XCHANGE mode; replaces characters on a one-forone basis. A.3 AEDIT-86 Advanced Commands The following is an alphabetic list of the AEDIT-86 advanced commands, their formats and functions. Command CALC EXECUTE Format C [count] E Provides computing capabilities. Executes specified macro.
APPENDIX B AEDIT-86 ERROR MESSAGES This appendix lists the error messages reported by AEDIT-86 when a problem is encountered in the invocation line, editing command, CALC command, or macro file. B. 1 Invocation Errors AEDIT-86 issues a message when an error occurs in the invocation line. AEDIT-86 displays the sign-on message followed by the error message, and control returns to the operating system.
AEDIT-86 User's Guide AEDIT-86 Error Messages B-2 bad margins Attempt to set margins out of the legal range. Editor returns to main command level. bad right margin Attempt to set right margin out of the legal range. Editor"returns to main command level. bad tabs Attempt to set bad tabs; e.g., 4,2 is illegal since the second value is less than the first. Editor returns to main command level. bad Leftcol Attempt to set bad left column, Leftcol accepts any number from 0 to 176.
AEDIT-86 User's Gtdde AEDIT-86 Error Messages text does not fit Attempt to edit a file that is too large under the FORDW ARDONL Y control. Editor returns to main command level. filename (error message supplied by operating system) An error occurs during a QUIT Exit, QUIT Init, QUIT Update, GET, or BLOCK Put command. Editor returns to main command level. Xchange limit is 100 Attempt to exchange over 100 characters without restarting XCHANGE mode. Editor remains in XCHANGE mode.
AEDIT-86 Error Messages AEDIT-86 User's Guide Macro errors have the following form: Err 0 r 1 n I l n e nnn :
APPENDIX C USING AEDIT-86 ON THE SERIES III AEDIT-86 will run on the Series III Microcomputer Development System under the ISIS/RUN operating system. c. 1 Invocation Command The invocation line is as described in Chapter 4. If you are not in the RUN subsystem, the invocation must be preceded by RUN. If you are starting the tutorial in Chapter 1, type the following: C.
Using AEDIT-86 on the Series III AEDIT-86 User's Guide . AEDIT-86 executes much faster on the integrated Series HIE terminal than on the regular integrated Series III terminal. C.4.1 Configuration Commands To use Series III with the integrated Series HIE terminal, use AH =S3E configuration command. If the integrated Series HIE terminal is used as a terminal for another host (via asynchronous communication), use AH =S3ET. In this case, the fast block movement feature is not exploited.
APPENDIX D USING AEDIT-86 ON THE SERIES IV AEDIT-86 runs on the iNDX operating system on the Intellec Series IV Microcomputer Development System. o. 1 Invocation Command The invocation line is as described in Chapter 4. If you are starting the tutorial in Chapter 1, type the following: - ~ ~ J T (R E T URN > 0.2 Keyboard The Series IV keyboard has soft keys. Therefore, all commands may be invoked either with the initial letter of the command or with the corresponding soft key.
Using AEDIT-86 on the Series IV AEDIT-86 User's Guide 0.3 Message Line The message line on the Series IV is 60 columns wide instead of 80. The last 20 columns are reserved for the Series IV system. 0.4 Scrolling The Series IV has no reverse scrolling. Reverse scrolling is implemented as the VIEW command, and the screen is rewritten. D.5 Printing and Nonprinting Characters Except for the ESC, NUL.
Using· AEDIT-86 on' the Series IV AEDIT-86 User's Guide 0.9 Work File The predefined file :WORK: must be properly assigned when AEDIT-86 is invoked. Under Series IV, :WORK: is automatica))y assigned to your home directory when you log in on the system. If. for any reason, the assignment does not exist or must be modified. :WORK: must be assigned to a write-enabled directory using the ASSIGN or the LNAME commands. 0.
APPENDIX E USING AEDIT-86 ON THE iRMX™-BASED SYSTEM AEDIT-86 runs on the iRMX operating system. The iRMX operating system may be used with various terminals. Please check the characteristics of your particular environment and/or terminal. E. 1 Invocation Command The invocation line is as described in Chapter 4. If you are starting the tutorial in Chapter 1, type the fol1owing: - : : : T (R [ T uRN ) E.2 Special Considerations Note that under iRMX-86 releases 5 and 6, you must specify AT= F. E.
APPENDIX F CONFIGURING AEDIT-86 FOR OTHER TERMINALS F.1 Tested Configurations This appendix contains configurations for several other terminals. The terminals described here are not the only ones on which you can use AEDIT-86; they are merely the ones that have been tested. The following sections list the configuration functions and values required to run AEDIT-86 on the Intel-tested terminals. Configuration files for the following terminals are supplied with the AEDIT -86 program.
CoIIfipring AEDIT-86 for Other Tel'lBinais AEDIT-86 User's Guide Table F-l. Switch Settings Switch Setting BAUD RATE MU$t match system. Use the maximum baud rate possible.
AEDIT-16 Vier'S Gtdde CoIIfipriag AEDIT-86 for Other Terminals Macro file: IS 10E.MAC - for the Hazeltine 1510 with escape lead-in. AV=24; AFCU= OC; AFCD= OB; AFCR=IO; AFCL=8; AFCH= 12; AFMU= IB OC; AFMD= IB OB; AFMR= 10; AFML=8; AFMH= IB 12; AFES=; AFER=IB 18; AFEK=; AFEL=IB OF; AFDL=IB 13; AFIL=IB lA; AFAC=lB 11; AO=O; AX=T; AFRV=IB IF; AFNV=IB 19; AC=T; AI=T; ADDL=20; ADIL=20; \ . 19200 baud· \ AB=7E; AFIG= IB; AFXH=16; Notes: Tilde is used for < ESC) .
Configuring AEDIT-86 for Other Terminals AEDIT-86 User's Guide MICROS.MAC-Beehive1M Mini-Bee This Beehive terminal can be formatted to display either 12 or 25 lines of 80 characters per line. Only the 25-character format is usable with AEDIT-86. Each character is generated in a 5 X 7 dot matrix. The maximum transmission rate for this terminal is 9600 baud. Note that the ESCAPE character has to be changed so that the default ESCAPE code can be used; < CTRL-K) is typed instead of escape.
AEDIT-86 User's Guide Coafipring AEDIT-86 for Other Terminals 54.MAC-Series IV Terminal Macro file: S4.MAC for the Series IV terminal. AH=S4; TV91OP.MAC-Televideo 1lol 910 Plus This terminal displays 24 lines with 80 characters per line. The maximum transmission rate is 19.2K baud. Macro file: TV910P.MAC for the Televideo 910 Plus.
Coafiguring AEDIT-86 for Other Terminals AEDIT-86 User's Guide Macro file: VIEW3A.MAC for ADDS Viewpoint 3A Plus, in 3A plus mode. AV=24; AFCU=OB; AFCD=OA; AFCR=OC; AFCL=08; AFCH= IE; AFMU=OB; AFMD=OA; AFMR=OC; AFML=08; AFMH= IE; AFES= IB 2A; AFER= IB 59; AFEK=; AFEL= IB 54; AFAC= IB 3D; AO=20; AX=F; AFXH=I6; Notes: < CTRL-V) is used for < HEX) . Setting Switch
AEDIT-86 User9 s Guide Configuring AEDIT-86 for Other Terminals ZENTEC.MAC-Zentec™ Zepher and Cobra This terminal displays 24 lines of 80 characters per line. The maximum transmission rate is 19.2K baud. To rub out a character on this terminal you must use SHIFT plus ESC. Macro file: ZENTEC.MAC for the Zentec Zepher and Cobra.
APPENDIX G ASCII CODES ASCII Character NUL SOH STX ETX EOT ENQ ACK BEL BS HT LF (t@) (tA) (t B) (t C) (t D) (t E) (t F) (t G) (t H) ( t I) (t J) VT (t K) FF (t L) CA (t M) SO (t N) (to) SI OLE (t P) OCI (to) OC2 (t A) OC3 (t S) OC4 (tT) NAK (t U) SYN (t V) ETB (tW) CAN (t X) EM (t Y) SUB (t Z) ESC FS GS AS US space .. ! II $ % & ( ) .
INDEX -FIND command (-).
AEDlT-86 User's Guide Index Display, 2-2 Display (SET subcommand), 3-) 8 DOWN command, 3-2 E_delimit (SET subcommand), 3-18 End (JUMP subcommand), 3-12 ending an editing session, ]-5, 3-24-3-26 End-Of-File (EOF) marker, ] -2, 2-2 error messages, B-] -B-4 ESC key, 2-1 exchanging text, 3-6-3-7 EXECUTE command (E) 5-5-5-6 Exit (QUIT command), 3-25 (FETN),6-]-6-2 ( FETS ) , 6-2-6-3 file backup, 3-] 7 Fill (PARAGRAPH subcommand), 3-26 FIND command (F), 3-8-3-9 Find (BLOCK subcommand), 3-14 -FIND command (-), 3
Index AEDIT-86 User's Guide Position (JUMP subcommand), 3-12 printing and non-printing characters, 2-6, D-2 prompt line, 2-3-2-5 prompts, menu prompts, 2-3-2-4 line~ited prompts, 2-4-2-5 yes/no prompts, 2-5 Put (BLOCK subcommand), 3-14 QUIT command (Q), 3-24-3-26 Abort, 3-24 Exit, 3-25 Init, 3-25 Update, 3-25 Write, 3-25 Qume QVTI02 terminals, F-4 Radix (SET subcommand). 3-32, 6-1 read-only variables, 6-2 read-write variables.
•
inter AEDIT-86 Text Editor User's Guide 121756-003 REQUEST FOR READER'S COMMENTS Intel's Technical Publications Departments attempt to provide publications that meet the needs of all Intel product users. This form lets you participate directly in the publication process. Your comments will help us correct and improve our publications. Please take a few minutes to respond. Please restrict your comments to the usability, accuracy, readability, organization, and completeness of this publication.
WE'D LIKE YOUR COMMENTS ••• This document is one of a series describing Intel products. Your comments on the back of this form will help us produce better manuals. Each reply will be carefully reviewed by the responsible person. All comments and suggestions become the property of Intel Corporation. 111111 NO POSTAGE NECESSARY IF MAILED IN U.S.A. BUSINESS REPLY MAIL FIRST CLASS PERMIT NO.
INTEL CORPORATION, 3065 Bowers Avenue, Santa Clara, California 95051 (408) 987-8080 Printed in U.S.A.
