PE II Help Document

1. Getting Started

  1.1 The Person Editor Screen:

    1.1.1 TEXT AREA:
 The text area is the area between '=== Top of file ==='
     and   '=== Bottom of file ==='
 There are 255 characters you can type in a line. You can use ctrl-left
 or ctrl-right to move the screen in 40 characters a time.

    1.1.2 COMMAND LINE:
 The line of white background in line 23.
 Press Esc key to switch between COMMAND LINE and TEXT AREA.
 The blinking underscore(_) is called the cursor.

    1.1.3 STATUS LINE:
 The line just below the COMMAND LINE.
 There are three pieces of information in the line:
      1. the name of the current file.
      2. line & column numbers of the cursor.
      3. Replace / Insert
 Naming the first file : Type 'name hello' in COMMAND LINE and you will
 get file name in the STATUS LINE.
 Press Ins key and you will get a insert mode to insert characters
 between text you typed, and the STATUS LINE will show Insert in the
 placw of Replace. Use Ins key to switch between Replace mode and
 Insert mode.

    1.1.4 MESSAGE LINE:
 The line below the STATUS LINE.
 You can type '? MEMORY' in COMMAND LINE and you will get a message
 showed in the MESSAGE LINE.

2. Moving The Cursor

  2.1 Moving cursor between COMMAND LINE and TEXT AREA:
      Using Esc key to switch between COMMAND LINE and TEXT AREA.

  2.2 Moving cursor UP, DOWN, LEFT, RIGHT:
      Using keys UP, DOWN, LEFT, RIGHT to move cursor in the text area.
      NOTE: Do not use backspace to move cursor backward. It will cause
   erasing of the text.

  2.3 Moving right 40 characters:
      Hold down the Ctrl key and press the RIGHT key (c-RIGHT), and the cursor
      will move right 40 columns. You can see the column indicator in the
      STATUS LINE shows column 41.
      Now type a letter 'a' in column 41.

  2.4 Returning to column 1:
      By pressing the HOME key, the cursor will be back to column of the line.

  2.5 Moving to end of line:
      Press the END key now. The cursor moves to the column 43. The END key
      moves the cursor after the last character in the line.

  2.6 Moving left 40 characters:
      The Ctrl-LEFT key combination moves the cursor 40 characters to the left.
      By pressing Ctrl-RIGHT keys six times, you will get the last column in
      the line, ie column 255. A Personal Editor line is 255 column wide.
      Now return to column 1 by pressing the Ctrl-RIGHT key seven tomes.

  2.7 Top of file:
      Press the Ctrl-HOME combination keys. The top of file marker appears.
      Keep an eye on the line indicator on the status line.

  2.8 Bottom of file:
      Press the Ctrl-END keys. The bottom of file marker appears.
      The Ctrl-HOME and Ctrl-END keys move the cursir to the top and bottom
      lines of the file.

  2.9 Top and bottom of the screen:
      Pressing the Ctrl-PgUp key will cause cursor to move to top of the screen.
      To move cursor to the bottom of the screen, press Ctrl-PgDn.
      Ctrl-PgUp and Ctrl-PgDn are aimilar to Ctrl-HOME and Ctrl-END except they
      work within the current screen.

  2.10 Summary of Moving cursor:

     !   Keys      !      Move cursor      !
     ! Esc      ! to switch cursor between COMMAND LINE and     !
     !      ! TEXT AREA.      !
     ! Cursor Up      ! up one space      !
     ! Cursor Down      ! down one space      !
     ! Cursor Left      ! left one space      !
     ! Cursor Right      ! right one space      !
     ! Ctrl-LEFT      ! 40 columns left      !
     ! Ctrl-RIGHT      ! 40 columns right      !
     ! HOME      ! to the first column of the line      !
     ! END      ! after the last character of the line      !
     ! Ctrl-HOME      ! to the top of the file      !
     ! Ctrl-END      ! to the bottom of the file      !
     ! PgUp      ! none (page of the text moving up)      !
     ! PgDn      ! none (page of the text moving down)      !
     ! Ctrl-PgUp      ! to the top of the current screen      !
     ! Ctrl-PgDn      ! to the bottom of the current screen      !
     !      !      !

  2.10 Other functions:

     !   Keys      !      Move cursor      !
     ! F9      ! to insert a line below the cursor      !
     ! Ctrl-backspace      ! to delete the line where cursor is standing   !
     ! Ins      ! to switch between Replace and Insert mode     !
     ! Del      ! to delete the character in the position of    !
     !      ! cursor      !
     ! Backspace      ! to delete the character before the position   !
     !      ! of cursor      !
     ! s-F1      ! to turn a page of the screen      !
     ! s-F2      ! to reverse a page of the screen      !
     ! Ctrl-ENTER      ! to execute command in the COMMAND LINE without!
     !      ! regarding the position of cursor      !
     ! F8      ! to switch between actives files      !

3. Personal Editor Command

  3.1 CHANGE:
      Purpose: The CHANGE command replaces a character or string of characters
      with another string. You can selectively replace strings or
      replace them all at one time.
      Format:  c/presentstring/newstring/<-><*>
      Remark:  To replace a string throughout a file , type '*' following the
      second slash.
      To selectively replace some strings and not others, do not
      include '*'. When you do not include the '*' then press the
      ENTER key on the command line, the Personal Editor moves the
      cursor to the first occurence of the string past the cursor
      To change that present string to the new string use s-F5 key.
      After changing the string or not, type Ctrl-ENTER to continue
      the CHANGE command. This allows you to search the next string
      without type the command again.
      A character must follow the CHANGE command. The Personal Editor
      reads the first character after CHANGE command as the separator.
      The optional minus sign in the CHANGE command controls the
      direction of the search. If you do not type a minus sign,
      searching begins from the cursor to the end of the line then to
      the bottom of the file .
      If you type minus sign, the searching begins from the cursor to
      the beginning of the line then to the top of the file.
      The Personal Editor ignores whether you type the present string
      in upper, lower or mixed case. However the Personal Editor does
      insert the new string exactly as ypu type.

  3.2 DEFINE:
      Purpose: The DEFINE command assigns a meaning to a key.
      Format:  def key = <'literal'> < [ function ] >
      Remark:  Omitted

  3.3 DIR:
      Purpose: The DIR command lists either all files from a diskette or
      specified files.
      Format:  dir <device:> <filenaem <.ext>>
      Remark:  Type DIR command and you will get a file .DIR. The .DIR file
      is an internal file that you can rename and save.
      You can use the global characters ? and * in the filename and
      the extension.

  3.4 EDIT:
      Purpose: The EDIT command switches between one active file and another.
      Format:  e <device:> <filename <.ext><notabs>>
      Remark:  If you want to look at or change a file while another file is on
      the screen, type the EDIT command and the name of the file on the
      command line.
      If the file you want is not active, the Personal Editor looks for
      it on the diskette and reads it into memory if it exists.
      Otherwise, the Personal Editor creats a new file with that name.
      You can use F8 key to switch between the active files.
      When the Personal Editor starts, it expands tab characters into
      the correct number of blanks to reach the next tab stop, where
      tab stops are at file columns 9, 17, 25, 33, etc. The Personal
      Editor does this to fill out the blank spaces that were
      compressed with the SAVE command.
      To defeat tab expansion, type 'notabs' after the filename. This
      is not the usual procedure unless you want compressed text.

  3.5 ERASE:
      Purpose: The ERASE command deletes a file from diskette.
      Format:  erase <device:> filename<.ext>
      Remark:  You can use the global characters ? and * in the filename and

  3.6 FILE:
      Purpose: The FILE command saves a copy of the current file to diskette and
      removes it from memory.
      Format:  file <filename <notabs>>
      Remark:  The Personal Editor allows you three options when you quit and
      save a file with the FILE command.
1. type FILE
2. type FILE and a filename : the file will be saved in the
     as you typed.
3. type with options notabs.
      The Personal Editor compresses the file as it saves.
      Compression means eliminating sequences of more the one blank
      from the text in order to save diskette space.
      When you edit the file again and want to print it, the PRINT
      command inserts the spaces back into the file.
      The Personal Editor compresses the file unless you tell it not to
      with the notabs option.
      Errors can occure using Hollerith constants in FORTRAN FORMAT
      statemants. Use the notabs option to prevent the errors.

  3.7 LOCATE:
      Purpose: The LOCATE command finds the next (or previous) occurence of a
      string from the cursor position.
      Format:  <l> /pattern</<->>
      Remark:  The Personal Editor searches for the string and moves the cursor
      to the first place it is found, displaying a new screen if
      The LOCATE command and the string remain on the command line
      after you press the ENTER key. This allows you to repeat the
      search without retyping the command.
      The optional minus sign in the LOCATE command controls the
      direction of the search.
      The LOCATE command ignores whether you type the string in
      uppercase or lowercase when it searches for the string.

  3.8 MACRO:
      Purpose: The MACRO command reads in a file of commands and performs each
      of the commands in the order entered.
      Format:  m <device:> filename <.ext>
      Remark:  Omitted.

  3.9 NAME:
      Purpose: The NAME command changes the name of the current file.
      Format:  n filename
      Remark:  The new name will appear in the STATUS LINE.

  3.10 PRINT
      Purpose: The PRINT command prints the current file to the printer.
      Format:  p
      Remark:  You can pause the printer by holding down the Ctrl key and
      pressing the Num Lock key. The printer pauses after the current
      line is printed. Press any key to continue.
      You can stop the print by holding down the Ctrl key and
      pressing the Scroll Lock-Break key. The printer stops after the
      current line is printed.
      If the printer is turned off, out of paper, or not on line, the
      following message appears:
      No printer; type r or c (resume/cancel)
      Check for these possible conditions and correct them.

     Purpose: The QUESTION MARK command displays the requested information.
     Format:  ? tabs
     ? margins
     ? key < keyname >
     ? memory
     Remark:  Omitted.

  3.12 QUIT
     Purpose: The QUIT command stops editing of a file and removes the file from
     memory without writing it to diskette.
     Format:  q
     Remark:  If you modified the current file or have changed its name since
     the last time the file was saved, the Personal Editor writes the
     message 'Are you sure?  Type y or n ' in the status area.
     If you want to start over by removing the command, type N for NO.
     Typing Y for YES erases any changes you made since the last save.

  3.13 RENAME:
     Purpose: The RENAME command changes the name of a file on the specified
     disk drive.
     Format:  rename <device:> oldname.ext newname.ext
     Remark:  You can use the global characters ? and * with the file name.

  3.14 SAVE:
     Purpose: The SAVE command writes a copy of the current file to the diskette
     Format:  save<filename <.ext><notabs>>
     Remark:  The Personal Editor will not quit after executing the SAVE command
     It is recommended that you shouid save your file periodly to
     prevent power fault.
     see FILE command for more information about notabs option.

     Purpose: The SET DISPLAY command changes the display of current file.
     Format:  s display mono
     s display color 40
     s display color 80
     s display b/w 40
     s display b/w 80
     Remark:  Omitted.

     Purpose: The SET MARGINS command marks the boundaries so you can type
     without pressing the ENTER key for a carriage return. You also
     reformat text inside these boundaries.
     Format:  s margins n n <n>
     Remark:  The three numbers in the command are the left margin number, the
     right margin number, and the optional paragraph margins. If you
     do not give the paragraph margin, the Personal Editor uses the
     value as the left margin.

  3.17 SET TABS:
     Purpose: The SET TABS command allows you to change the tab markers from the
     default setting.
     Format:  s tabs t1 t2 t3 t4 ... t20
     Remark:  You can assign 20 tabs to a file between column 1 and 255.
     Those 20 tabs settings become the tab settings for all active
     The numbers must follow in increasing order.
     The tab key is ->| and |<- on the keyboard.

4. Storage Consideration

  4.1 Active file:
      The PE can maintain up to 20 active files in one session. You can use EDIT
      command to enter any file you want to edit. All active files are stored in
      memory. You can use F8 to switch between active files.

  4.2 What takes memory?
      The following require memory:
      .  the number of active files in memory at one time.
      .  the number of lines in a file.
      .  bringing in new files to be edited including internal files.
      .  doing things with marked text.
      .  copying and shifting lines.
      .  adding or inserting lines in a file.
      .  the number of functions assigned to keys in the PR.PRO file.

  4.3 Disk spill
      When you use all the available memory, the PE uses the diskette on the
      default drive as a place to store more information. The file created by
      PE is called PE.TMP ( could be up to 128KB). When the file is too big, PE
      will spill the file and show the message 'SPILL FILE CREATED'.
      When you fill the spill file, you get a message saying 'SPILL DISK IS
      FULL'. You then have only the minimum amount of memory available. When
      that is used up, the PE goes into a memory full condition where you are
      restricted from normal operation. This is explained below.

  4.4 When memory is full
      When you have used up all the available memory, the PE cannot operate
      normally. The message 'MEMORY IS FULL-REMOVE FILES', appears on the
      message line. The 0 character (a circle with a line through it) appears on
      the same line.
      The message leaves after a keystroke, but the special character remains on
      the status line until memory is available.
      When this happened, you can use following method to get out of the
      .  use the EDIT command to see whitch files you want to remove from memory
      .  use the QUIT or FILE command to remove active files from memory.
      .  use PgUp and PgDn key to see the bottom of the file that causes the
memory to be full. If that file was not entirely loaded into memory, do
not use FILE command or text that did not appear on the screen will be
      When memory is available, the special character goes away and the message
      'MEMORY FULL CONDITION ENDED' appears on the message line.

5. Marking area of text

  5.1 Marking lines
      You use line marks when you want to erase, copy, or move several lines.
      Move the cursor to the top of the area you want you mark, hold the ALTER
      key and press the letter L. After doing so you can see the line is now
      in white background. Move the cursor to the bottom of the area you want to
      mark, hold the ALTER key and press the letter L again. After doing so you
      can see the whole area is in white background. And now you can use a-D,
      a-Z, a-M to erase, copy, or move the marked area. You can use a-U to
      unmark the area.
  5.2 Marking blocks
      Use the a-B instead of a-L, What happened ? You can use a-D, a-Z, a-M as
      same as above, more you can use a-O to overlay an area.

  5.3 Marking sentences, phrases, or words
      Use the a-C instead of a-L. Now what happened ? You can use a-D, a-Z, a-M
      but not the a-O.

  5.4 The position of the cursor

      !   Types of   !    Type of mark     !
      !     ========================================================!
      !  Operation   !    line !      block   !  char     !
      !     !    Alt-L !      Ail-B   !  Ail-C      !
      !     copy     !     line ! at   !   at     !
      !     Alt-Z    !     above ! line   !  line     !
      !    delete    !      any ! any   !   any     !
      !     Alt-D    !    positi on !     position   ! position    !
      !    overlay   !       X !     top left   !    X     !
      !     Alt-O    ! !      corner   !     !
      !      move    !     line !     top left   ! top left    !
      !     Alt-M    !     above !      corner   !  corner     !
      !    unmark    !      any ! any   !   any     !
      !     Alt-U    !    position !      position    ! position    !

  5.5 Other functions about marked area:

      Alt-F : to full fill the marked area with a character. When you type Alt-F
     the message  'type a character' will show in the message line.
     After you type a character a character, The marked area will be
     filled with the character you have just typed.
      Alt-F7: shifts text in marked area one position left.
      Alt-F8: shifts text in marked area one position right.
      Alt-P : reformats paragraph separated by blank lines to set margins.

6. Internal files

   The Personal Editor has three internal files, the .KEYDEFS file, the .UNNAMED
   file, and the .DIR file. Internal mean that the file in generated inside the
   Personal Editor program and does not occupy space on the diskette. Internal
   files provide information you can use when editing.

  6.1 .KEYDEFS file:
  6.2 .UNNAMED file:
  6.3 .DIR file:

7. The Personal Editor Functions