1  Help

     This library contains Help information on Pandora, as condensed by Miles.
     (No warranty or guarantee is expressed, offered, implied, or hinted at.)
     See Copyright for important data.
     (vers 2.0)                                  


1  Copyrights

 The EVE system is very much...
         Copyright (c) 1985 by Digital Equipment Corporation
                         All Rights Reserved.

 The following are trademarks of Digital Equipment Corporation...
         DEC, VAX, VMS, VT, TPU

 The EVEPlus system and all the derivatives are very much...
         "DECUS-type PubDomain stuff, and probably Copyrighted by the
          individual authors."

 The Kept_Eve.Com and Logout.Com are very much...
     "Copyrighted by Kevin Carosso, Marty Sasaki, Mukesh Prasad, et al."

 Anything else left over is the intellectual property of M.P.Gerlek.


1  Introduction

  Welcome to the wonderful world of EVE, the

      " { Easy | Extensible | Efficient }  VAX  Editor ".

        EVE offers even the most casual tourist more flexibilty and fun than
  anything they've seen before.  She offers everything EDT doesn't --
  multiple buffers, multiple windows, DCL Windows, many specialized
  commands, full use of keyboard, highly and easily customized "init" files,
  and completely open source codes.

        Short of switching to EMACS, it's the best you'll find on THIS
  node.  But then again, even with Richard M. Stallman's EMACS you might
  not find it as easy to write your own commands and procedures.  Do you know
  LISP?  I don't, either, but I'm willing to bet VAXTPU -- the VAX Text
  Processing Utility -- is a lot easier for the beginner to learn and play
  around with.

        Consider, if you will, the VAXTPU to be the material with which the
  original vanilla EVE was built.  The VAX world looked upon this new
  building and rejoiced;  it was good and sturdy house, and the landlord,
  DEC, was not an absentee landlord like the owner of the other property
  across the street, Mr. Stallman.

        Independent programmers with nothing better to do (or, at least,
  nothing as interesting) recognized the wonder EVE was and promptly moved
  in.  They (with their benevolent landlord's consent) put in new light
  fixtures, added on a room here, repainted a wall there, carpeted from wall
  to wall, and so on. Their house, EVE, evolved into a home, "EVEPlus".

        The good programmers gave the world the plans for their evolving
  castle in hopes that, as had been done across the street, everyone else
  could live in a castle as nice as theirs.

        This, then, is not really an EVE editor, but in fact an ever
  expanding version of EVEPlus.  Hopefully, there are many who recognize
  the need for changes here and there, and go ahead and make those changes
  -- the home will grows one step larger.  While even vanilla EVE can be
  used as an editor, EVEPlus, for all its worth, still can go much farther.
  It could include more flexible windowing commands. It could be very Language
  Sensitive.  It could have a decent built-in TPU debugger for making your
  own extensions.  It could have... Anything your heart desires.

        This particular flavor of EVEPlus is called, for complex reasons,
  "Pandora".  Pandora was created by Miles for the Flaxen Hackers.  She is
  dedicated, in part, to James McNeill Whistler's masterwork painting "The
  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.Gerlek


1  Commands

     This is a incomplete listing of all the Pandora commands.
     These commands may be entered from the command level by pressing the
     DO key and typing in the command. In some cases, you may enter the
     command directly via a predefined key  (e.g., pressing pf2 will
     automatically execute the command "HELP").

     Command names are followed by their default key bindings, where
     appropriate.  The keys are referred to by abbreviation: "kp" refers
     to the keypad, "e1" refers to the vt200 mini-pad, "^X" refers to
     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 }

     Use this command to "step out" of the Pandora subprocess.  ATTACH
     suspends the current Pandora editing session and reconnects the terminal
     to the parent process. (Usually this is your top-level DCL process.)

     Entering the DCL command $Pandora will return you to where you were
     before executing the ATTACH command; all buffers and windows and such
     remain intact. To leave Pandora entirely, use the EXIT command.


2  Ascii_Insert

     ACSII INSERT number                        { kp_comma }

     The ACSII INSERT command will insert at the current cursor position
     the ascii representation of the number specified. This command is
     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 }

     Moves the cursor to the start of the current line. If you are already
     at the start of the current line, the cursor will be moved to the
     start of the PREVIOUS line.


2  Bottom

     BOTTOM                     { kp4 }

     Moves the cursor to the end of the current buffer.


2  Buffer

     BUFFER  buffer_name                        { ^B }

     Changes the buffer in the current window.  For example,

          BUFFER test.txt

     will display the buffer named TEST.TXT.  The BUFFER command may
     be used to create a new buffer as well as return you to one already
     in the editor.  Buffer names are displayed in the status line at the
     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 WORD

     Capitalizes the current word by making the first letter uppercase
     and the remaining letters lowercase.  The cursor moves to the end
     of the current word.

     If the current cursor position is between words, CAPITALIZE WORD
     capitalizes the word to the right of the cursor.


2  Center_Line

     CENTER LINE

     Centers the current line between the left and right margins.  You
     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 current
     direction is displayed on the status line at the bottom of the
     window and may be either Forward or Reverse.

     The current direction affects the way that certain commands work.
     For example, when the direction is Forward, FIND searches in a forward
     direction in the buffer for the specified string.  When the direction
     is Reverse, FIND searches backward in the buffer.


2  Change_Mode

     CHANGE MODE                        { gold_kp9 }

     Changes the current mode of the buffer.  The current mode is
     displayed on the status line at the bottom of the window and may
     be either Insert or Overstrike.

     In Insert mode, typed characters are inserted to the left of the
     current cursor position.  In Overstrike mode, typing a character
     replaces the character at the current cursor position.  The DELETE
     key in Overstrike mode replaces the character before the current
     cursor position with a space.


2  DCL

     DCL  dcl_command                   { enter }

     ( Important Note: This is a Privileged Command and may require your
                       account's quotas to be increased before it will work.
                       See your system manager for more information on this.)

     Executes a DCL (Digital Command Language) command from Pandora's
     command line.  For example,

          DCL directory

     will display the contents of your current default directory.

     The DCL command and the resulting output go into a special DCL
     buffer.  When the command is executed, Pandora's second window will be
     displayed (if needed), and the DCL buffer will be mapped to it.  In
     the above example, your current directory's filename's will be written
     into this buffer.

     The DCL buffer is treated just like any other buffer.  You can
     move output from a DCL command into another buffer with Select and
     Remove, for example.

     ("A VAX/VMS limitation prevents DCL prompts from appearing in the DCL
     buffer."  This, quite frankly, sucks.  Any improvements on this nasty
     set_up will be gleefully welcomed.)


2  Define_Key

     DEFINE KEY

     Tells Pandora that you want to be able to issue a command by pressing
     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 directory

     Pandora asks for the "Key to be defined".  Assume you then pressed
     the 4 key on the numeric keypad (kp4).  For the rest of that editing
     session, pressing the kp4 will show you a directory listing of your
     current default directory.  You may also enter a comment for the key
     which can be displayed with the DESCRIBE KEY command.

     It is not technically possible to "undefine" a key, but the UNDEFINE
     KEY command will do so for all intensive porpoises.


2  Delete

     DELETE                     { standard "DELETE" or "RUBOUT" key }

     Deletes the character preceding the cursor.  In Insert mode, the
     rest of the the line moves left one space to close up the space.
     In Overstrike mode, the character preceding the cursor is replaced
     by a space; the rest of the line remains in the same place on the
     screen.

     When the cursor is at the start of a line, the Return at the end
     of the previous line is deleted.  The text on the current line is
     moved to the right of the text in the line above.


2  Describe_Key

     DESCRIBE KEY

     This command requests a key to be pressed and then returns a one-line
     description of that key's function.  This may be either a Pandora command
     or a user's comment for a key that the user has defined or "learned".


2  Destroy_Buffer

     DESTROY BUFFER   buffer_name                       { ^K }

     This command will destroy the contents of a  buffer, as well as the buffer
     itself.   If  the  buffer you are destroying has been modified or is a
     system buffer, you will be asked to confirm the operation.

     The DESTROY BUFFER command is useful when you no longer wish to have a
     buffer in your editing session.

     (If  the  buffer  was  mapped to a visible window, another buffer is
     substituted in most cases. If, however, a "hole" is left, simply map
     another buffer to that portion of the screen by switching windowing modes.)


2  Display_Character

     DISPLAY CHARACTER

     When Pandora  cannot  display  a  character  (e.g.,  a  control
     character)  it substitutes a reverse question mark in its place.  This
     command will interpret the character the cursor is on, and display a
     message containing information about the character, including its octal,
     decimal, and hexadecimal values.


2  Do

     DO                 { DO (vt200), ^D, kp7 }

     Allows you to enter a Pandora command.  Press the DO key and then
     type the command using the keys on the main keyboard.  End the
     command by pressing the RETURN key or the DO key.

     To get help on Pandora and her commands, use the HELP command to examine
     these help files.

     Command names may be abbreviated.  Press the DO key twice to
     repeat the last command.  You can also press the DO key, and then
     press the up-arrow key to edit and/or re-execute previous commands.

     While typing a command, you may edit what you have typed by using standard
     edit commands. You may press DO or RETURN anywhere on the line to
     issue the command.


2  Eliminate_Tabs

     ELIMINATE TABS

     This command will remove tabs from your file and substitute the proper
     number of spaces to keep the appearance of the document the same.  The
     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 }

     Moves the cursor to the end of the current line.  The "end" of the
     line is defined as the last character on that line - trailing spaces
     and pads are not considered.  If the cursor is at or "past" the end of
     the current line, this command will position the cursor at the end of
     the next line.


2  Erase_Character

     ERASE CHARACTER                    { kp_comma }

     Erases the character at the current cursor position.  In Insert
     mode, the rest of the the line moves left one space to close up
     the space.  In Overstrike mode, the character at the cursor
     position is replaced by a space; the rest of the line remains in
     the same place on the screen.

     When the cursor is at the end of a line, the Return at the end of
     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 }

     Erases from the current cursor position to the end of the current
     line, appending the next line to the current line.  You can
     reinsert the erased line into a buffer with the RESTORE LINE (gold_pf4)
     command.


2  Erase_Word

     ERASE WORD                 { kp_minus }

     Erases the current word and moves the cursor to the start of the
     next word.  If the cursor is between words, then the next word is
     erased.  If the cursor is at the end of a line, the next line will
     be appended to the current line.  The erased word can be inserted
     back into a buffer by using the RESTORE WORD (gold_kp_minus) command.


2  Exit

     EXIT                       { ^E }

     Allows you to leave Pandora permanently. The editing environment will
     not merely be suspended as with the ATTACH command -- it will be
     terminated.

     If you made any modifications during your session which were not saved
     with the WRITE FILE command, EVE asks you if you really want to continue
     quitting.  Answering yes ("y") causes you to leave the editor; answering
     no ("n") keeps you in the editor.  This allows you to review the current
     editing situation before discarding any changes.  You can use the LIST
     [ALL] BUFFERS command to see which buffers were modified.


2  Extend_TPU

     EXTEND TPU

     Extends the power of Pandora by compiling your own procedures, written
     in the VAXTPU language.  Typing

          EXTEND TPU *

     compiles the entire current buffer.  Typing

          EXTEND TPU mpg_yow

     compiles the procedure called mpg_yow in the current buffer.  A bug
     ("feature") requires that the cursor must be positioned below the
     procedure's first line.  In this example, you must currently be on
     a line after the line with "procedure mpg_yow".

     Procedure names may be abbreviated.

     If syntax errors are reported, the error messages are displayed
     very quickly in the message window.  The BUFFER command allows you
     to switch to the "Messages" buffer to examine the messages.


2  Fill_Paragraph

     FILL PARAGRAPH

     Reformats the current paragraph so the text fits between the left
     and right margins.  The cursor moves to the end of the current
     paragraph.

     Pandora recognizes both blank lines and RUNOFF (Digital's standard
     text formatting program) command lines as paragraph boundaries.
     You can place the cursor anywhere in the current paragraph before
     using the FILL PARAGRAPH command.


2  Find

     FIND  target_string                        { e1 (vt200), pf3, ^F }

     Searches for and positions you to an occurrence of a string.

     FIND is case-insensitive if the string contains only lowercase
     letters; it is case-sensitive if the string contains any uppercase
     letters.

     The direction of the search (Forward or Reverse) is determined by
     the current direction of the buffer, as shown in the status line
     at the bottom of the buffer.  If the string can be found only by
     searching in the opposite direction, Pandora asks you if you want to
     move the cursor in that direction.

     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 CRLFS

     This command removes  carriage  returns  and  linefeeds  from  buffers
     (e.g., if you are reading a file generated by Runoff).  This is useful
     if you wish to strip a formatted text file of its printer control
     characters.


2  Forward

     FORWARD

     Sets the current direction of the buffer to forward.  The
     direction is displayed in the buffer's status line.  The direction
     affects the operation of such commands as FIND.


2  Get_File

     GET FILE  file_name                        { ^G }

     Use the GET FILE command when you want to bring another file into your
     editing environment.  GET FILE reads a file from the current default
     directory (unless you specify a different directory/device), puts
     the file in a new buffer, and displays the new buffer in the current
     window.  The cursor is moved to the beginning of the file.  The file
     still exists in its original form in the directory until it is written
     out with the WRITE FILE command.

     For example,

          GET FILE test.txt

     will move the cursor to the beginning of the file test.txt, in the
     new buffer test.txt.

     If you try to GET a file that you already have in a buffer, Pandora
     will prompt you for a new buffer name for the file, or just stick you
     in the old buffer.


2  Go_To

     GO TO  mark_name                   { see below }

     Moves the cursor to the previously marked text.  (See MARK.) For
     example,

          GO TO glossary

     moves the cursor to the position that was named "glossary" by an
     earlier mark command.  Mark names may be abbreviated.

     If the new position is not in the current buffer, the cursor still
     moves to the new position.  A new buffer is mapped to the current
     window if necessary.

     By default, gold_kp3 is defined as "GOTO SPOT" and kp3 is define as
     "MARK SPOT". This means that these two keys can be used to temporarily
     store and goto a particular position (called "SPOT") in the buffer
     with ease.


2  Help

     HELP  string                       { HELP (vt200), ^H, gold_pf2 }

     Provides help on the Pandora system.

     To get help on Pandora and her commands, use the HELP command.  Press
     the DO key, type help, and press RETURN.  The HELP library will
     then prompt you with a list of topics to explore.

     Type the name of the subject that you want help on, or type ?  to see
     the list of topics again.

     You can ask for help on a particular command in one step.  For
     example,

          help top

     will provide help on the TOP command.


2  Include_File

     INCLUDE FILE  filename

     Makes it possible to combine files.  The file that you specify is
     read from the file system and placed before the current cursor
     position.  The cursor moves to the beginning of the inserted file.
     The file still exists in its original form in your directory
     after you include it.

     For example,

          INCLUDE FILE test.txt

     will insert the file test.txt before the current cursor position
     and move the cursor to the beginning of test.txt.


2  Insert_Here

     INSERT HERE                        { gold_I, e2 (vt200), gold_enter }

     Use INSERT HERE to move and copy text.  To copy text, press the
     INSERT HERE key immediately after hitting the REMOVE key.  This
     will put the text back in its original position.  Then move the
     cursor to the place where you want the text inserted, and press
     INSERT HERE again to make another copy of the text.

     To move text from one place to another, press the INSERT HERE key
     only after you have moved the cursor to the new position.

     When you use INSERT HERE, the text is inserted regardless of
     whether the buffer is in Insert or Overstrike mode.


2  Insert_Mode

     INSERT MODE

     Changes the mode of the current buffer to Insert.  In Insert mode,
     typing characters are inserted before the current cursor position.


2  Learn

     LEARN                      { gold_[ }

     Asks Pandora to "learn" or record a sequence of keystrokes.  This
     learning process begins when the LEARN command is entered and
     continues until stopped by a REMEMBER command (gold_]).  The sequence
     of learned keystrokes is then remembered, and assigned to a key for
     the current editing session.  See REMEMBER for more information.

     You can use the LEARN command in combination with the REPEAT
     command when you need to use an editing function throughout a
     file.  Use the SAVE EXTENDED TPU command or create a tpu command file
     to create permanent key definitions.


2  Life

     LIFE number
       
     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...)
 
     Just "DO" Life n where n is number of generations desired.  Will 
     translate current buffer to *'s (live cells) and begin.  Buffer 
     ought be VERY SHORT and have NOT MANY cells in it, else will take 
     nigh on forever to run.
 

2  Line

     LINE  number                       { ^L }

     Moves the cursor to the start of a particular line in the current
     buffer.  For example, with just an integer specified,

          line 42

     will move the cursor to the beginning of the forty-second line.

     If, however,  the number entered is prefixed by a + or - sign, the
     cursor will be moved forward of backward in the buffer by that number
     of lines.  This is useful if you wish, for example, to move ahead a
     certain number of line and aren't quite sure just where the hell you
     are now.


2  List_Buffers

     LIST [ALL]  BUFFERS                        { gold_kp0 }

     This command will produce a list of buffers currently in use.  If  you
     specify  ALL  buffers,  then  both system and user buffers are listed,
     otherwise only user buffers are  listed.   The  LIST ALL BUFFERS command
     produces something similar to the following display:

         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 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  System


     After you issue the command, the Select and Remove keys (e4 and e3
     (vt200), or gold_S and gold_R) change their function  (see table below).
     When you leave the buffer containing the buffer listing (e.g., via the
     BUFFER, GET FILE, or GOTO commands) the keys are restored to their
     original function.


        Function Key   Operation

        <Select>       Maps the buffer listed on the current line to
                       this window.

        <Remove>       Destroys the buffer listed on the current line.


2  List_Commands

     LIST COMMANDS

     Lists all Pandora's (currently recognized) commands in alphabetical
     order.  Since there are a large number of commands, the LIST COMMANDS
     command will not be instantaneous.

     (You may want to have a good book handy.)


2  Lowercase_Word

     LOWERCASE WORD

     Makes the letters of the current word all lower case.  The cursor
     moves to the end of the current word.  If the current cursor
     position is between words, LOWERCASE WORD changes the word to the
     right of the cursor.


2  Mark

     MARK mark_name                     { see below }

     Adds bookmarks to your current editing session.  MARK adds a
     bookmark at the current cursor position.  The mark is a character
     or word which names the position.  You can come back to a marked
     position by using the GO TO command.  This command is useful if
     you are editing a large file and want to go back to a particular
     section; it avoids searching throughout the file.

     For example,

          MARK glossary

     adds a mark called "glossary" at the current cursor position.  You
     can return to this position later by using

          GO TO glossary

     Note that Marks are not saved across editing sessions.

     Two keys, kp5 and gold_kp5, are defined by default to perform an
     auto-marking function.  See GO TO for more information.


2  Move_Down

     MOVE DOWN                  { down arrow }

     Moves the cursor down one line on the screen.  If the cursor is on
     the last line of a window, scrolls the window forward one line.


2  Move_Left

     MOVE LEFT                  { left arrow }

     Moves the cursor left one column on the screen.  If the cursor is
     on the first column on the screen, it remains at that column; it
     does not wrap to the previous line or shift the window.


2  Move_Right

     MOVE RIGHT                 { right arrow }

     Moves the cursor right one column on the screen.  If the cursor is
     on the last column on the screen, it remains at that column; it
     does not wrap to the previous line or shift the window.


2  Move_Up

     MOVE UP                    { up arrow }

     Moves the cursor up one line on the screen.  If the cursor is on
     the first line of a window, scrolls the window backward one line.


2  Next_Screen

     NEXT SCREEN                        { e6 (vt200), gold_N }

     Moves the cursor vertically through the file, a screenful of text
     at a time.  The cursor moves forward, filling your screen with the
     following lines of information.  You can continue using NEXT
     SCREEN until you reach the end of the file.


2  Number_Lines

     NUMBER LINES

     This command will insert line numbers at the beginning of each line of
     the current editing buffer (a 6-digit number followed by 2 spaces).

     WARNING: The NONUMBER LINES command will Under Most Circumstances
     remove the line numbers.  Users should not interfere with the numbering
     pattern if they wish NONUMBER LINES to work.


2  One_Window

     ONE WINDOW

     Returns the screen to one view of the current buffer.  The window
     the cursor is in becomes the current window.  If you have been
     viewing two different documents in the two windows, Pandora removes
     the other window from the screen.  The contents of the other
     buffer is not affected; you can return to editing this buffer by
     using the BUFFER command.


2  Other_Window

     OTHER WINDOW                       { kp8 }

     Moves the cursor from one window to the other.  Many editing
     functions are performed at the current location of the cursor, so
     you may frequently want to move it from one window to the other.
     If you want scrolling in a window, for example, you must have the
     cursor in that window.


2  Overstrike_Mode

     OVERSTRIKE MODE

     Changes the mode of the current buffer to Overstrike.  In
     Overstrike mode, typing a character replaces the character at the
     current cursor position.  The DELETE key in Overstrike mode
     replaces the character before the current cursor position with a
     space.


2  Previous_Screen

     PREVIOUS SCREEN                    { e5 (vt200), gold_N }

     Moves the cursor vertically through the file, a screenful of text
     at a time.  The cursor moves backward, filling your screen with
     the previously entered lines of information.  You can continue
     using PREVIOUS SCREEN until the first line of the file is
     displayed on the screen.


2  Print

     There are several different PRINT commands, all of which do very
     different things and several of which assume a printer attached to
     your terminal.

     PRINT BUFFER

     Sends the contents of the  current  editing  buffer  to  a  designated
     printer queue (default is Sys$Print).  Embedded control characters are
     translated to a readable form (e.g., the BEL character will be printed
     as <BEL>).

     PRINT FILE

     Prints the  specified  file  on  a  printer  attached  to  the  user's
     terminal.

     PRINT FF

     Prints a form feed on a printer attached to the user's terminal.  This
     will cause the printer to place the paper at the top of a page.

     PRINT RANGE

     Prints the the contents of the  current  select  range  on  a  printer
     attached  to  the user's terminal.  If there is no select range active
     when you issue the command, the contents of the entire current  buffer
     are printed.

     PRINT SCREEN

     Prints the contents of the current screen on a printer attached to the
     user's terminal.


2  Quote

     QUOTE

     Allows you to add a character, such as a form feed and other
     control characters to the buffer.  It also allows you to add
     graphic characters, such as letters and punctuation marks, that
     are bound or programmed to other keys.  You can also use the QUOTE
     command to include special characters within commands.

     Pandora will prompt you for the key to be inserted.  Pressing CTRL/L,
     for example, enters a form feed at the current cursor position.

     See also, ASCII INSERT.


2  Recall

     RECALL

     Recalls the previously entered command that was issued using the
     DO or RECALL command.

     If you make a mistake entering a command, you do not need to enter
     the entire command again.  The RECALL command places the most
     recently entered command on the command line.  The cursor moves to
     the end of the command line, so you can edit the command.

     This is pretty mindless -- use the up arrow.


2  Rectangular_Insert_Here

     RECTANGULAR_INSERT_HERE                    { gold_e2 (vt200) }

     This command works with RECTANGULAR_SELECT -- it will insert (in
     Overstrike Mode) the Selected and Removed text in a boxy fashion.


2  Rectangular_Remove

     RECTANGULAR_REMOVE                         { gold_e3 (vt200) }

     This command works with the RECTANGULAR_SELECT to remove, in a "box"
     fashion, the selected text.  Note that this nifty hack works in
     the Overstrike Mode.


2  Rectangular_Select

     RECTANGULAR_SELECT                         { gold_e4 (vt200) }

     This command works like SELECT does, but in a "box" fashion, i.e. you
     can cut out a section of text from the middle of the screen.  This
     nifty hack works in Overstrike mode.


2  Refresh

     REFRESH                    { ^R }

     Redisplays every character on the screen, eliminating any
     extraneous characters that may have appeared on the screen and any
     messages displayed in the message window.  The cursor remains in
     the same location.


2  Release_Buffers

     RELEASE BUFFERS

     This command will write out all writable, modified  user  buffers  and
     delete  all remaining buffers for the session.  This command is useful
     since Pandora is run as a "kept" editor and occasionally you may wish to
     "clean house".


2  Remember

     REMEMBER                   { gold_] }

     Finishes a sequence of keystrokes that you plan to use repeatedly
     during an editing session.  The LEARN command is used to start the
     sequence of keystrokes.

     You will be prompted for the key that you want to use to repeat
     this sequence of keystrokes.  You cannot use the DO key, the
     RETURN key, or the typing keys for this purpose.

     These key definitions will stay in effect for the rest of your editing
     session.


2  Remove

     REMOVE                     { e3 (vt200), gold_R, gold_kp_period }

     Removes the text in the select range, which is the highlighted
     area of text on the screen.  See the help entry on the SELECT
     command for more information about select ranges.  If you have
     started a select range and want to stop without making any
     changes, press the SELECT key again to cancel the select range.

     You can move and copy a select range after using REMOVE by using
     the INSERT HERE key.  See the help entry on the INSERT HERE
     command for more information.

     Pressing the SELECT key and then immediately pressing the REMOVE
     key removes the character that the cursor is positioned on.  Each
     time REMOVE is used, the previously selected text is discarded.


2  Repeat

     REPEAT number

     Lets you repeat a command or a typing character for a
     predetermined number of times.  For example, say you press the DO
     key and type

          REPEAT 30

     and then type the letter "x".  The letter "x" will be typed thirty
     times at the current cursor position.  If instead of typing "x", you
     press the DO key and type

          CAPITALIZE WORD

     then the next 30 words will be capitalized.

     REPEAT is especially useful in combination with LEARN and REMEMBER
     for doing repetitive editing.  Use LEARN and REMEMBER to define
     the editing operation, and then use the REPEAT command to repeat
     the operation as often as necessary.


2  Replace

     REPLACE old_string new_string     { gold_pf3, gold_e1 (vt200) }

     Lets you repeatedly substitute one word or phrase for another
     throughout a buffer.  For example,

          REPLACE good excellent

     instructs Pandora to replace "good" with "excellent" in the current
     buffer.

     Each occurrence of "good" within the current buffer will be
     highlighted in reverse video, and you will be prompted for an
     action.  Typing "Yes" or just pressing RETURN replaces this
     occurrence.  "No" skips this occurrence.  "All" replaces this
     occurrence and all future occurrences without any further
     prompting.  "Last" replaces this occurrence and stops the REPLACE
     command.  "Quit" stops the REPLACE command without replacing this
     occurrence.

     In order to replace multi-word phrases, put the phrases in
     quotation marks.  For example,

          REPLACE "the first one" "the second one"


2  Restore_Line

     RESTORE LINE                       { gold_pf4 }

     Inserts the text last erased by the ERASE LINE command.


2  Restore_Word

     RESTORE WORD                       { gold_kp_minus }

     Inserts the text last erased by the ERASE WORD command.


2  Reverse

     REVERSE

     Sets the current direction of the buffer to reverse.  The
     direction is displayed in the buffer's status line.  The direction
     affects the operation of commands like FIND.


2  Save_Extended_TPU

     SAVE EXTENDED TPU filename

     Saves all currently defined key definitions, learn sequences, and
     command definitions in a section file that you specify.  The
     section file name should include a complete VMS file
     specification, including device and directory names.  These may be
     specified using a VMS logical name.

     To use the section file in future editing sessions, define the
     logical name, TPUSECINI, with the same file specification that you
     used for the SAVE EXTENDED TPU command.  For example,

          save extended tpu d1:[user]myeve.tpu$section

     saves the current editing environment, and issuing

          $ define tpusecini d1:[user]myeve.tpu$section

     at the DCL level lets you use this editing environment in future
     editing sessions.


2  Search

     SEARCH string

     This command is an enhanced version of the default searching mechanism
     built into Pandora.  The SEARCH command allows wild-carded searches.

        Meta     Operation/Matches

        *        Multi-character wildcard, do not cross record boundaries

        %        Single-character wildcard

        «        Beginning of line

        »        End of line

        #        Multi-character wildcard, cross record boundaries

        \        Quote next character

        ^        Next character is a control character


2  Select

     SELECT                     { e4 (vt200), gold_S, kp_period }

     Marks one end of a select range.  A select range is a block of
     text on which various operations (such as REMOVE) can be
     performed.  To create a select range:

     1.  Move the cursor to either the beginning or end of the text you
         want to select.

     2.  Press the SELECT key.

     3.  Move the cursor to the opposite end of the text.

     You can then press the REMOVE key to remove the select range.

     If you start a select range and want to stop without making any
     changes, press SELECT again to cancel the select range.


 2  Set_Flashing

     SET FLASHING character

     This  command  locates  corresponding  characters  in  a  buffer   and
     "flashes"  them  whenever you type the character given in the command.
     The line with the matching  character  is  displayed  in  the  message
     window.

     For example, this command can be used to make the editor display which
     "(" matches which ")" in a program with the command SET FLASHING ).

     The following characters can be  used  to  flash  their  corresponding
     character:

     ) } > » ' "


2  Set_Left_Margin

     SET LEFT MARGIN number

     Changes the left margin for the current buffer.  The right margin
     is not changed.  For example,

          set left margin 10

     sets the left margin to 10.  New text will start in column 10.
     Nine spaces will be inserted before each new line.

     The left margin is set to 1 by default.  You can use the SHOW
     command to examine the current margin settings for each buffer.


2  Set_Matching

     SET MATCHING character

     This command will automatically insert a corresponding character  into
     a  buffer.   For  example,  if  you type a "(", a matching ")" is also
     placed in the buffer.  The cursor  is  positioned  so  that  the  next
     character typed will be between the matched characters.

     The  following  characters  will  generate   a   corresponding   match
     character:

     ( { < « ` ' "


2  Set_Right_Margin

     SET RIGHT MARGIN number

     Changes the right margin for the current buffer.  The left margin
     is not changed.  For example,

          set right margin 70

     sets the right margin to 70.  New text will not go beyond column
     70.

     An eight-character "hot zone" is used to perform automatic word
     wrapping.  In this example, new words will not begin beyond column
     62 but will instead be started on the next line.  The FILL
     PARAGRAPH command reformats the paragraph between the left and
     right margins.

     The right margin is set to 79 by default.  You can use the SHOW
     command to examine the current margin settings for each buffer.


2  Set_Tabs_At

     SET TABS AT number_1 [number_2 [number_3 [number_n]]]]

     Sets tab stops at specified positions.  The specified positions
     are a sequence of numbers separated by spaces.  For example,

          SET TABS AT 8 14 22 56

     sets tab stops at positions 8, 14, 22, and 56.  The default tab
     stops are set to every eight characters.  To set tabs at equal
     intervals, use the SET TABS EVERY command.

     On any terminals or printers which have different tab settings
     from those specified, the file will not appear the same as it does
     when viewed using Pandora.  This command does not affect the hardware
     tab settings of your terminal.


2  Set_Tabs_Every

     SET TABS EVERY number

     Sets tab stops at equal intervals.  For example,

          SET TABS EVERY 10

     sets tab stops at positions 10, 20, 30, etc.  The default tab
     stops are set to every eight characters.  To set tab stops at
     specific positions, use the SET TABS AT command.

     On any terminals or printers which have different tab settings
     from those specified, the file will not appear the same as it does
     when viewed using Pandora.  This command does not affect the hardware
     tab settings of your terminal.


2  Toggle_Width

     TOGGLE WIDTH

     This command allows you to change the current width of the screen,
     which is useful for editing "wide" files.  The command will toggle
     your screen between 80 (default) and 132 columns.

     Lines longer than the width are indicated by a diamond at the end
     of the line.  Note that the SHIFT WINDOW command will allow you to see
     characters that are "off the screen" easily and without changing the
     width setting.


2  Set_Write

     SET WRITE

     When Pandora creates a buffer, she normally considers it writable.
     Sometimes,  it is convenient to mark the buffer as non-writable.  This
     command lets you change current buffer's write status.  If you  set
     the  buffer  to  "No  Write" Pandora will not automatically write out the
     buffer when you exit the editing session even if you modify  it.   The
     status  line  will indicate buffers that have been marked NO WRITE (by
     bolding and underlining) when that buffer is mapped to a window.


2  Shift_Window

     SHIFT WINDOW number                        { see below }

     Shifts the view of the window from the current column settings the
     amount specified.  For example, if your screen is in 80-column mode
     and you type

                        SHIFT WINDOW 45

     the window will "slide left" 45 columns to show you any material that
     was previously off the side of the screen.  Note that negative numbers
     are used to slide back to normal -- to reverse that action of the above
     example the command would be

                        SHIFT WINDOW -45

     The window's status line will indicate the current left and right
     columns if they are not "normal" (i.e. at 0 and 80/120).

     By default, the gold_left_arrow and gold_right_arrow keys have been
     defined to shift the window by 5 columns.


2  Show_Buffer

     SHOW BUFFER

     Shows information about the current buffer, including the name of
     the input file, the name of the output file, margin settings, tab
     settings, and the names of the marks associated with this buffer.

     If you have more than one buffer in your editing session, SHOW BUFFER
     will ask you if you want more information.  Press the DO key to
     see information about the other buffers, displayed one buffer at a
     time.  Press the RETURN key to resume editing.

     SHOW BUFFER does not display information about internal system buffers,
     such as the MESSAGES buffer, unless it is the current buffer.


2  Sort_Buffer

     SORT BUFFER

     This command alphanumerically sorts the contents of the named buffer,
     line by line.  The sort algorithm is implemented entirely in TPU --
     users may want to break for lunch while the sort is taking place.

     WARNING: There is, of course, no UNSORT BUFFER command.


2  Space

     SPACE

     Inserts or overstrikes a space character at the current cursor
     position, depending on the current mode.  SPACE also moves the
     cursor to the start of the next line, if the cursor is less than 8
     spaces away from the right margin.  If the current word extends
     beyond the right margin, that word is also moved to the next line.

     You can change the current margin settings by using the SET LEFT
     MARGIN and SET RIGHT MARGIN commands.

     The space bar (surprise!) invokes this command.


2  Spawn

     SPAWN                      { f20 }

     Suspends the current Pandora editing session and connects the terminal
     to a new DCL subprocess.  Logging out of the DCL subprocess returns you
     to Pandora.

     The SPAWN command can be used to run screen-oriented programs like
     phone and other DCL utilities without losing your current editing session.


2  Status_Line

     STATUS LINE

     This command is useful if you are making slides with Pandora: it
     toggles on or off the status line.


2  Top

     TOP                        { gold_kp4 }

     Moves the cursor to the beginning of the current buffer.


2  Tpu

     TPU command_string                     { f19 (vt200) }

     Lets you execute a VAXTPU command.  For example,

          tpu message ('Hello')

     compiles and executes the VAXTPU command, "message ('hello')".
     The word "Hello" appears in the message window.

     TPU, Digital's Text Processing Utility, is the language/system with
     which EVE and Pandora was created and written.  Familiarity with TPU
     will allow the masochistic user to customize EVE to his or her heart's
     content, much as Miles has customized vanilla EVE into Pandora.

     The VAX Text Processing Utility Reference Manual contains complete
     information about the VAXTPU language.


2  Trim

     TRIM

     This command will remove all trailing whitespace (spaces/tabs) from
     each line in the current editing buffer.


2  Two_Windows

     TWO WINDOWS

     Creates two sections on the screen, making it possible to view
     different parts of one file, or two different documents.  When you
     view one file in two windows, whatever you do to one, is done to
     the other.  (This is not true when viewing two different files in
     two windows.)

     If there is one window on the screen, TWO WINDOWS takes the
     current window and divides it into two smaller windows.  The
     current buffer is displayed in both windows, and the cursor is
     moved to the bottom window.  To view two different files at the
     same time, use the BUFFER command or the GET FILE command, after
     using TWO WINDOWS, to put a new buffer or file in the new
     current window.


2  Uppercase_Word

     UPPERCASE WORD

     Makes the letters of the current word all upper case.  The cursor
     moves to the end of the current word.  If the current cursor
     position is between words, UPPERCASE WORD changes the word to the
     right of the cursor.  If the current word is in both uppercase and
     lowercase letters, it makes the letters all upper case.


2  What_Line

     WHAT LINE                  { gold_^L }

     This command will display where you are (line number) in  the  current
     buffer.  Line number, total lines, and percentage are all displayed.


2  Write_File

     WRITE FILE                            { kp0, ^W }

     The WRITE FILE command places the contents of the current buffer
     in the file you specify.  Use

          WRITE file

     to create a new version of an existing file.  You can also write
     the buffer to a new file name.  For example,

          WRITE FILE new.txt

     writes the current buffer to the file new.txt, even if the file
     already existed with a different name.

     The WRITE FILE command does not change the buffer name, but it
     does change the output file name.  A future WRITE FILE command
     will write the buffer to the new file name.

     Note that the WRITE FILE command will not let you write out the
     file if it has not been changed or modified since it was gotten
     or last written out.



2  Undocumented_Commands

     UNDOCUMENTED_COMMANDS

            The following commands are not yet documented.
            They are easy to figger out, however, if you
                read the source code in Pandora.Tpu.

     Toggle Number Of Windows -- toggles between top and bottom windows
     Roll Down Other -- scrolls the other window up w/o having to go to it
     Roll Up Other   -- scrolls the other window down w/o having to go to it
     COL             -- move to center of current line 
     Date            -- insert date
     Time            -- insert time
     Scroll          -- continous scroll of current buffer until keypress
     Keymap          -- show "cheat-sheet"
     Graffon         -- turn on graphics interpretaion mode
     Graffoff        -- turn off graphics interpretaion mode
     Line Continue   -- inserts line-continuation character
     Auto Indent     -- changes definition of return key to do indenting
     Set Text Mode   -- turn on auto-indent
     Set Programming Mode  -- turn off auto-indent
     Ruler           -- display a "ruler" on status line w/ tabs marked
     Jump Scroll     -- change terminal setting to jump scroll
     Smooth Scroll   -- change terminal setting to smooth scroll
     Copy            -- "copy" Selected test to Insert Here buffer w/o Removing
     Next Window     -- position to other window
     Add Window      -- add strange 3rd window
     Subtract Window -- delete strange 3rd window
     Paginate        -- insert page marks to a buffer w/ prompting
     Depaginate      -- remove all pagemarks
     Reply           -- format a reply for mails
     Set Default     -- set default directory/device of subprocess
     Show Default    -- show default directory/device of subprocess

