% VAX-11 Librarian V04-00 ]t۬t۬m~n5>Commands* CopyrightsHelp Introductiont۬1 HelpN This library contains Help information on Pandora, as condensed by Miles.M (No warranty or guarantee is expressed, offered, implied, or hinted at.)& See Copyright for important data.1 (vers 2.0) ww@3t۬ 1 Copyrights The EVE system is very much...< Copyright (c) 1985 by Digital Equipment Corporation- All Rights Reserved.A The following are trademarks  of Digital Equipment Corporation... DEC, VAX, VMS, VT, TPU< The EVEPlus system and all the derivatives are very much...E "DECUS-type PubDomain stuff, and probably Copyrighted by the individual authors."1 The Kept_Eve.Com and Logout.Com are very much...H "Copyrighted by Kevin Carosso, Marty Sasaki, Mukesh Prasad, et al."D Anything else left over is the intellectual property of M.P.Gerlek.ww@t۬1 Introduction, Welcome to the w onderful world of EVE, the9 " { Easy | Extensible | Efficient } VAX Editor ".L EVE offers even the most casual tourist more flexibilty and fun thanE anything they've seen before. She offers everything EDT doesn't --C multiple buffers, multiple windows, DCL Windows, many specializedL commands, full use of keyboard, highly and easily customized "init" files,# and completely open source codes.F Short of switching to EMACS, it's the best you'll find on THISH no de. But then again, even with Richard M. Stallman's EMACS you mightM not find it as easy to write your own commands and procedures. Do you knowG LISP? I don't, either, but I'm willing to bet VAXTPU -- the VAX TextJ Processing Utility -- is a lot easier for the beginner to learn and play around with.K Consider, if you will, the VAXTPU to be the material with which theE original vanilla EVE was built. The VAX world looked upon this newI building and rejoiced; it was good and sturdy house, and the landlord,H DEC, was not an absentee landlord like the owner of the other property" across the street, Mr. Stallman.H Independent programmers with nothing better to do (or, at least,J nothing as interesting) recognized the wonder EVE was and promptly movedG in. They (with their benevolent landlord's consent) put in new lightL fixtures, added on a room here, repainted a wall there, carpeted from wallG to wall, and so on. Their house, EVE, evolved into a home, "EVEPlus".H The good programmers gave the world the plans for their evolvingI castle in hopes that, as had been done across the street, everyone else+ could live in a castle as nice as theirs.D This, then, is not really an EVE editor, but in fact an everH expanding version of EVEPlus. Hopefully, there are many who recognizeJ the need for changes here and there, and go ahead and make those changesH -- the home will grows one step larger. While even vanilla EVE can beK used as an editor, EVEPlus, for all its worth, still can go much farther.N It could include more flexible windowing commands. It could be very LanguageJ Sensitive. It could have a decent built-in TPU debugger for making your@ own extensions. It could have... Anything your heart desires.I This particular flavor of EVEPlus is called, for complex reasons,J "Pandora". Pandora was created by Miles for the Flaxen Hackers. She isJ dedicated, in part, to James McNeill Whistler's masterwork painting "TheI White Girl (Symphony in White No. 1)". Pandora has become, like Flaxen= itself, more than just a name. Pandora is a state of mind.< -M.P.Gerlekwwt۬ 1 Commands> This is a incomplete listing of all the Pandora commands.I These commands may be entered from the command level by pressing theG DO key and typing in the command. In some cases, you may enter theD command directly via a predefined key (e.g., pressing pf2 will/ automatically execute the command "HELP").D Command names are followed by their default key bindings, whereH appropriate. The keys are referred to by abbreviation: "kp" refersE to the keypad, "e1" refers to the vt200 mini-pad, "^X" refers toJ control-X, and "gold_F" refers to the TPU "shifted" F key. The shift, key is, of course, the "gold" key, pf1. 2 Attach& ATTACH { ^Z } F Use this command to "step out" of the Pandora subprocess. ATTACHM suspends the current Pandora editing session and reconnects the terminalI to the parent process. (Usually this is your top-level DCL process.)H Entering the DCL command $Pandora will return you to where you wereJ before executing the ATTACH command; all buffers and windows and suchD remain intact. To leave Pandora entirely, use the EXIT command.2 Ascii_Insert< ACSII INSERT number  { kp_comma }H The ACSII INSERT command will insert at the current cursor positionF the ascii representation of the number specified. This command isK useful for inserting Multinational and control characters in a buffer. For example, ASCII INSERT 84 will insert a "T".2 Beginning_of_Line' BOL { kp1 }J Moves the cursor to the start of the current line. If you are alreadyF at the start of the current line, the cursor will be moved to the start of the PREVIOUS line. 2 Bottom' BOTTOM { kp4 }7 Moves the cursor to the end of the current buffer. 2 Buffer6 BUFFER buffer_name { ^B }< Changes the buffer in the current window. For example, BUFFER test.txtD will display the buffer named TEST.TXT. The BUFFER command mayH be used to create a new buffer as well as return you to one alreadyI in the editor. Buffer names are displayed in the status line at theJ bottom of the window. Use the LIST BUFFERS command to find out which" buffers are currently in use.% Buffer names may be abbreviated.2 Capitalize_Word CAPITALIZE WORDF Capitalizes the current word by making the first letter uppercaseF and the remaining letters lowercase. The cursor moves to the end of the current word.E If the current cursor position is between words, CAPITALIZE WORD5 capitalizes the word to the right of the cursor.2 Center_Line CENTER LINEF Centers the current line between the left and right margins. YouD may place the cursor anywhere on the line to be centered before using CENTER LINE.2 Change_Direction/ CHANGE DIRECTION { kp9 }> Changes the current direction of the buffer. The currentC direction is displayed on the status line at the bottom of the1 window and may be either Forward or Reverse.F The current direction affects the way that certain commands work.K For example, when the direction is Forward, FIND searches in a forwardJ direction in the buffer for the specified string. When the direction6 is Reverse, FIND searches backward in the buffer.2 Change_Mode4 CHANGE MODE { gold_kp9 }A Changes the current mode of the buffer. The current mode isE displayed on the status line at the bottom of the window and may$ be either Insert or Overstrike.E In Insert mode, typed characters are inserted to the left of theE current cursor position. In Overstrike mode, typing a characterG replaces the character at the current cursor position. The DELETEE key in Overstrike mode replaces the character before the current" cursor position with a space.2 DCL1 DCL dcl_command { enter }H ( Importa nt Note: This is a Privileged Command and may require yourL account's quotas to be increased before it will work.M See your system manager for more information on this.)E Executes a DCL (Digital Command Language) command from Pandora's command line. For example, DCL directoryA will display the contents of your current default directory.C The DCL command and the resulting output go into a special DCLK buffe r. When the command is executed, Pandora's second window will beH displayed (if needed), and the DCL buffer will be mapped to it. InK the above example, your current directory's filename's will be written into this buffer.C The DCL buffer is treated just like any other buffer. You canG move output from a DCL command into another buffer with Select and Remove, for example.J ("A VAX/VMS limitation prevents DCL prompts from appearing in the DCLJ buffer." This, quite frankly, sucks. Any improvements on this nasty( set_up will be gleefully welcomed.) 2 Define_Key DEFINE KEYJ Tells Pandora that you want to be able to issue a command by pressingH a single key. Pandora will prompt you for the key that you want to: use to invoke the command. For example, after typing" DEFINE KEY dcl directoryG Pandora asks for the "Key to be defined". Assume you then pressedI the 4 key on the numeric keypad (kp4). For the rest of that editingH session, pressing the kp4 will show you a directory listing of yourI current default directory. You may also enter a comment for the key: which can be displayed with the DESCRIBE KEY command.I It is not technically possible to "undefine" a key, but the UNDEFINE8 KEY command will do so for all intensive porpoises. 2 DeleteE DELETE { standard "DELETE" or "RUBOUT" key }E Deletes the character preceding the cursor. In Insert mode, theE rest of the the line moves left one space to close up the space.G In Overstrike mode, the character preceding the cursor is replacedF by a space; the rest of the line remains in the same place on the screen.E When the cursor is at the start of a line, the Return at the endF of the previous line is deleted. The text on the current line is6 moved to the right of the text in the line above.2 Describe_Key DESCRIBE KEYJ This command requests a key to be pressed and then returns a one-lineN description of that key's function. This may be either a Pandora commandJ or a user's comment for a key that the user has defined or "learned".2 Destroy_Buffer> DESTROY BUFFER buffer_name { ^K }O This command will destroy the contents of a buffer, as well as the bufferK itself. If the buffer you are destroying has been modified or is a? system buffer, you will be asked to confirm the operation.K The DESTROY BUFFER command is useful when you no longer wish to have a$ buffer in your editing session.I (If the buffer was mapped to a visible window, another buffer isI substituted in most cases. If, however, a "hole" is left, simply mapP another buffer to that portion of the screen by switching windowing modes.)2 Display_Character DISPLAY CHARACTERD When Pandora cannot displ ay a character (e.g., a controlK character) it substitutes a reverse question mark in its place. ThisI command will interpret the character the cursor is on, and display aM message containing information about the character, including its octal,% decimal, and hexadecimal values.2 Do/ DO { DO (vt200), ^D, kp7 }F Allows you to enter a Pandora command. Press the DO key and thenC type the command using the keys on the main keyboar d. End the6 command by pressing the RETURN key or the DO key.M To get help on Pandora and her commands, use the HELP command to examine these help files.A Command names may be abbreviated. Press the DO key twice toF repeat the last command. You can also press the DO key, and thenH press the up-arrow key to edit and/or re-execute previous commands.O While typing a command, you may edit what you have typed by using standardF edit commands. You may pr!ess DO or RETURN anywhere on the line to issue the command.2 Eliminate_Tabs ELIMINATE TABSK This command will remove tabs from your file and substitute the properK number of spaces to keep the appearance of the document the same. TheJ ELIMINATE TABS command assumes tabs are "Set Every" n positions (i.e.# where n is an integer like 8).2 End_Of_line' EOL { kp3 }G Moves the cursor to the end of the current line". The "end" of theI line is defined as the last character on that line - trailing spacesK and pads are not considered. If the cursor is at or "past" the end ofJ the current line, this command will position the cursor at the end of the next line.2 Erase_Character4 ERASE CHARACTER { kp_comma }D Erases the character at the current cursor position. In InsertD mode, the rest of the the line moves left one space to close up@ the s#pace. In Overstrike mode, the character at the cursorE position is replaced by a space; the rest of the line remains in" the same place on the screen.F When the cursor is at the end of a line, the Return at the end ofE that line is deleted. The text on the next line is moved to the+ right of the text in the current line. 2 Erase_Line' ERASE LINE { pf4 }F Erases from the current cursor position to the end of the current@ line, a $ppending the next line to the current line. You canL reinsert the erased line into a buffer with the RESTORE LINE (gold_pf4) command. 2 Erase_Word, ERASE WORD { kp_minus }E Erases the current word and moves the cursor to the start of theF next word. If the cursor is between words, then the next word isG erased. If the cursor is at the end of a line, the next line willF be appended to the current line. The erased word can be inserted%J back into a buffer by using the RESTORE WORD (gold_kp_minus) command.2 Exit& EXIT { ^E }J Allows you to leave Pandora permanently. The editing environment willE not merely be suspended as with the ATTACH command -- it will be terminated.K If you made any modifications during your session which were not savedM with the WRITE FILE command, EVE asks you if you really want to continueM quitting. Answering yes ("y") causes y&ou to leave the editor; answeringM no ("n") keeps you in the editor. This allows you to review the currentK editing situation before discarding any changes. You can use the LIST> [ALL] BUFFERS command to see which buffers were modified. 2 Extend_TPU EXTEND TPUK Extends the power of Pandora by compiling your own procedures, written$ in the VAXTPU language. Typing EXTEND TPU *0 compiles the entire current buffer. Typing 'EXTEND TPU mpg_yowH compiles the procedure called mpg_yow in the current buffer. A bugF ("feature") requires that the cursor must be positioned below theG procedure's first line. In this example, you must currently be on4 a line after the line with "procedure mpg_yow".( Procedure names may be abbreviated.D If syntax errors are reported, the error messages are displayedG very quickly in the message window. The BUFFER command allows you@ to switch to th(e "Messages" buffer to examine the messages.2 Fill_Paragraph FILL PARAGRAPHF Reformats the current paragraph so the text fits between the leftC and right margins. The cursor moves to the end of the current paragraph.G Pandora recognizes both blank lines and RUNOFF (Digital's standardD text formatting program) command lines as paragraph boundaries.F You can place the cursor anywhere in the current paragraph before& using the FILL PARAGRAPH co)mmand.2 FindG FIND target_string { e1 (vt200), pf3, ^F }A Searches for and positions you to an occurrence of a string.C FIND is case-insensitive if the string contains only lowercaseG letters; it is case-sensitive if the string contains any uppercase letters.F The direction of the search (Forward or Reverse) is determined byE the current direction of the buffer, as shown in the status lineE at the bottom of the buff*er. If the string can be found only byI searching in the opposite direction, Pandora asks you if you want to' move the cursor in that direction.H The gold_F key works as a "Find Next" command. That is, the cursor@ will move to the next occurrence of the last target string. 2 Fix_CRLFs FIX CRLFSK This command removes carriage returns and linefeeds from buffersK (e.g., if you are reading a file generated by Runoff). This is usefulF if yo+u wish to strip a formatted text file of its printer control characters. 2 Forward FORWARD> Sets the current direction of the buffer to forward. TheG direction is displayed in the buffer's status line. The direction4 affects the operation of such commands as FIND. 2 Get_File6 GET FILE file_name { ^G }K Use the GET FILE command when you want to bring another file into yourI editing environment. GET FILE reads a ,file from the current defaultF directory (unless you specify a different directory/device), putsI the file in a new buffer, and displays the new buffer in the currentI window. The cursor is moved to the beginning of the file. The fileK still exists in its original form in the directory until it is written% out with the WRITE FILE command. For example, GET FILE test.txtG will move the cursor to the beginning of the file test.txt, in the - new buffer test.txt.H If you try to GET a file that you already have in a buffer, PandoraJ will prompt you for a new buffer name for the file, or just stick you in the old buffer.2 Go_To5 GO TO mark_name { see below }E Moves the cursor to the previously marked text. (See MARK.) For example, GO TO glossaryE moves the cursor to the position that was named "glossary" by an: earlier mark command. Mark names. may be abbreviated.G If the new position is not in the current buffer, the cursor stillF moves to the new position. A new buffer is mapped to the current window if necessary.H By default, gold_kp3 is defined as "GOTO SPOT" and kp3 is define asK "MARK SPOT". This means that these two keys can be used to temporarilyG store and goto a particular position (called "SPOT") in the buffer with ease.2 HelpF HELP string { HELP/ (vt200), ^H, gold_pf2 }) Provides help on the Pandora system.J To get help on Pandora and her commands, use the HELP command. PressD the DO key, type help, and press RETURN. The HELP library will6 then prompt you with a list of topics to explore.J Type the name of the subject that you want help on, or type ? to see the list of topics again.C You can ask for help on a particular command in one step. For example, help top* wil0l provide help on the TOP command.2 Include_File INCLUDE FILE filenameF Makes it possible to combine files. The file that you specify isC read from the file system and placed before the current cursorG position. The cursor moves to the beginning of the inserted file.A The file still exists in its original form in your directory after you include it. For example, INCLUDE FILE test.txtE will insert the file test.txt before 1the current cursor position6 and move the cursor to the beginning of test.txt.2 Insert_HereJ INSERT HERE { gold_I, e2 (vt200), gold_enter }D Use INSERT HERE to move and copy text. To copy text, press theD INSERT HERE key immediately after hitting the REMOVE key. ThisD will put the text back in its original position. Then move theD cursor to the place where you want the text inserted, and press8 INSERT HERE again to make another c2opy of the text.F To move text from one place to another, press the INSERT HERE key> only after you have moved the cursor to the new position.A When you use INSERT HERE, the text is inserted regardless of8 whether the buffer is in Insert or Overstrike mode.2 Insert_Mode INSERT MODEG Changes the mode of the current buffer to Insert. In Insert mode,G typing characters are inserted before the current cursor position.2 Learn* LEARN 3 { gold_[ }F Asks Pandora to "learn" or record a sequence of keystrokes. ThisB learning process begins when the LEARN command is entered andJ continues until stopped by a REMEMBER command (gold_]). The sequenceH of learned keystrokes is then remembered, and assigned to a key forE the current editing session. See REMEMBER for more information.A You can use the LEARN command in combination with the REPEATB command when you need to use an editing4 function throughout aJ file. Use the SAVE EXTENDED TPU command or create a tpu command file) to create permanent key definitions.2 Life LIFE number 7 Implements a TPU version of Conway's Life game. ? Taken from the Spring '86 DECUS Langs&Tools Session Notes.; (Author's name currently unknown; good job, though...) F Just "DO" Life n where n is number of generations desired. Will E translate current buffer to *'s (live cells) and be5gin. Buffer G ought be VERY SHORT and have NOT MANY cells in it, else will take  nigh on forever to run. 2 Line. LINE number { ^L }F Moves the cursor to the start of a particular line in the current: buffer. For example, with just an integer specified, line 42D will move the cursor to the beginning of the forty-second line.G If, however, the number entered is prefixed by a + or - sign, theJ cursor will 6 be moved forward of backward in the buffer by that numberH of lines. This is useful if you wish, for example, to move ahead aI certain number of line and aren't quite sure just where the hell you are now.2 List_Buffers< LIST [ALL] BUFFERS { gold_kp0 }K This command will produce a list of buffers currently in use. If youK specify ALL buffers, then both system and user buffers are listed,M otherwise only user buffers are 7 listed. The LIST ALL BUFFERS command9 produces something similar to the following display:1 Buffer name Lines Attributes? $LOCAL$INI$ 4 System? CHOICES 0 Modified No-write System? COMMANDS 5 Modified No-write System? DCL 0 No-write System? HELP 0 No-write System? INSERT 8 HERE 0 No-write System? LIST BUFFER 12 Modified No-write System- MAIL_20E00748.TMP 17 Modified? MESSAGES 11 Modified No-write System? PROMPTS 0 No-write System? SHOW 0 No-write SystemG After you issue the command, the Select and Remove keys (e4 and e3M (vt200), or gold_S and gold_R) change their function (see ta9ble below).K When you leave the buffer containing the buffer listing (e.g., via theG BUFFER, GET FILE, or GOTO commands) the keys are restored to their original function. Function Key OperationD