home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc / ded2.lzh / DED.DOC next >
Text File  |  1986-01-14  |  49KB  |  1,099 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 Users Manual For
  21.  
  22.                                        DED
  23.                                   Version 2.00
  24.  
  25.                A full-screen text editor for DEC Rainbow computers
  26.  
  27.  
  28.  
  29.  
  30.                              Written by Dan Pleasant
  31.                               Lower Falls Software
  32.                                    Newton, MA
  33.  
  34.                              (C) Copyright 1985,1986
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.           TABLE OF CONTENTS
  43.           =================
  44.  
  45.  
  46.           Disclaimer . . . . . . . . . . . . . . . . . . . . . . .    1
  47.  
  48.           Introduction . . . . . . . . . . . . . . . . . . . . . .    2
  49.  
  50.           Getting Started  . . . . . . . . . . . . . . . . . . . .    2
  51.  
  52.           The First Few Steps  . . . . . . . . . . . . . . . . . .    3
  53.  
  54.           Finding and Replacing strings of text  . . . . . . . . .    7
  55.  
  56.           Block Operations . . . . . . . . . . . . . . . . . . . .    9
  57.  
  58.           File Insertion . . . . . . . . . . . . . . . . . . . . .   10
  59.  
  60.           User-Defineable Keys (Macros)  . . . . . . . . . . . . .   11
  61.  
  62.           Control Characters . . . . . . . . . . . . . . . . . . .   12
  63.  
  64.           Foreign Language Characters  . . . . . . . . . . . . . .   12
  65.  
  66.           Printing . . . . . . . . . . . . . . . . . . . . . . . .   14
  67.  
  68.           Cancelling a Command . . . . . . . . . . . . . . . . . .   15
  69.  
  70.           Exiting to MS-DOS  . . . . . . . . . . . . . . . . . . .   15
  71.  
  72.           Additional Options . . . . . . . . . . . . . . . . . . .   15
  73.  
  74.           Other Functions  . . . . . . . . . . . . . . . . . . . .   16
  75.  
  76.           Editing Very Large Files . . . . . . . . . . . . . . . .   17
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.                                           i
  96.  
  97.  
  98.  
  99.  
  100.  
  101.           Disclaimer
  102.           ==========
  103.  
  104.                DED  is  a  copyrighted  program.  It  is  available  as
  105.           "freeware" for non-commercial use only. DED may not be copied
  106.           or sold  for any  commercial purpose whatsoever except by the
  107.           owner  of  the  copyright   or   his   legal  representative.
  108.           Commercial  companies  may  contact  the author for licensing
  109.           information.
  110.  
  111.                No warranty of any sort whatsoever is supplied with DED.
  112.  
  113.                Whew!! Now that  the  pseudo-legal  mumbo-jumbo  is over
  114.           with, we can get down to the good stuff.
  115.  
  116.                DED  is   a  fairly   mature  product,  having  been  in
  117.           widespread use for well over a year now, and most of the bugs
  118.           have been worked out. However, any large program is likely to
  119.           contain bugs. If you  find any,  and if  you can successfully
  120.           document  them,  please  contact  the author through FIDO net
  121.           number 101, node number 202, at (617) 721-1688.
  122.  
  123.                Your friendly programmer would  like  to  take  time now
  124.           for a  commercial message.  DED is a fully functional editor,
  125.           and as such, it could be worth as  much as  $200 on  the open
  126.           market. DED  is supplied free to private individuals who want
  127.           it. However, if you like the  program,  and  if  you  use it,
  128.           PLEASE help  a starving  programmer by  sending $25.00 to the
  129.           address below. This will allow two  things to  happen. First,
  130.           the extra  cash will  allow me to continue development of the
  131.           program, as well as  keeping my  enthusiasm at  a high level.
  132.           Second, those  who send money will get questions answered and
  133.           bugs fixed. Those who do not will be ignored.
  134.  
  135.                Send checks to:
  136.  
  137.                          Dan Pleasant
  138.                          153 Concord St., #16
  139.                          Newton, MA 02162
  140.  
  141.  
  142.                Thanks!!!
  143.  
  144.                DED is written in  assembly  language,  so  it  would be
  145.           fairly  difficult  anyone  but  the  original  author to make
  146.           additions to the program.  However, should  anyone think that
  147.           they're  up  to  it,  the  source  code  is  available (for a
  148.           fairly  large  price).  Contact   the   author   for  further
  149.           information.
  150.  
  151.  
  152.  
  153.  
  154.                                           1
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.           Introduction
  162.           ============
  163.  
  164.                DED is a sophisticated, high performance text editor for
  165.           use with DEC Rainbow computers. It  is not  a word processor,
  166.           but  a   program-oriented  text   editor  with  cut-and-paste
  167.           abilities. It runs under MS-DOS, and is intended  to fill the
  168.           void  caused  by  the  absence  of  good, fast, full-function
  169.           editors for the Rainbow.
  170.  
  171.                DED's   features   include   4   cut-and-paste  buffers,
  172.           auto-indenting, 24 user-defineable keys, unlimited file size,
  173.           and  block  move/find/delete  operations.  All  commands  are
  174.           executed in  1 or  2 keystrokes  using the Rainbow's function
  175.           keys. There is no limitation  on  file  size  other  than the
  176.           capacity  of  the  mass  storage  device. DED is also written
  177.           completely in assembly language  and takes  advantage of many
  178.           of the Rainbow's advanced features, which makes it incredibly
  179.           fast.
  180.                DED requires 256 Kbytes of RAM and MS-DOS 2.0 or higher.
  181.           It uses three temporary files for virtual memory operations.
  182.  
  183.  
  184.           Getting Started
  185.           ===============
  186.  
  187.                To begin the program, simply type
  188.  
  189.                          DED
  190.  
  191.           and hit  the <Return> key. This will cause DED to load itself
  192.           into memory and  reserve  memory  space  for  your  input. To
  193.           edit an existing file, type
  194.                            
  195.                          DED filename
  196.  
  197.           and  hit  the  <Return>  key.  This  will  cause  DED to load
  198.           itself, and then load the  specified  file  for  editing. The
  199.           top 22  lines of  your file  will appear  on the screen, with
  200.           the cursor positioned at the first character.
  201.  
  202.                If an error occurs during  loading,  DED  will  print an
  203.           error message and halt. This can happen if:
  204.  
  205.                     There is  less than  256 Kbytes of memory
  206.                     in your Rainbow.
  207.  
  208.                     There is not enough  room on  the default
  209.                     disk  for  DED  to  create  the temporary
  210.                     files it needs.
  211.  
  212.  
  213.                                           2
  214.  
  215.  
  216.  
  217.  
  218.  
  219.                     You  specified  a  file  that  DED cannot
  220.                     read.  This  can  be caused by specifying
  221.                     the name of a  file  that  is  zero bytes
  222.                     long,  or  by  specifying an illegal file
  223.                     name.
  224.  
  225.                Once DED is loaded, the top 22 lines of the  screen will
  226.           be  used  for  editing.  There  will  be a solid line in line
  227.           23, and the bottom line is  maintained by  DED as  a "status"
  228.           line. The  status line  is used by DED for communication with
  229.           the user. The "Insert  Mode"  status  always  appears  at the
  230.           end of the status line in reverse video. This will always say
  231.           "Insert ON" or "Insert OFF". Just before this is the  name of
  232.           the file you are editing. If no file name is listed here, you
  233.           must specify one before you can save your file.
  234.  
  235.                A new feature of  DED,  version  2.0,  is  the  line and
  236.           column  number  notation  at  the  far  left  of  the  status
  237.           line. The cursor  line and  column number  will always appear
  238.           here.
  239.  
  240.                All commands in DED are initiated by pressing one of the
  241.           Rainbow's special function keys.  Different  commands  can be
  242.           specified  by  holding  the  <Shift>  or  <Ctrl>  keys  while
  243.           pressing a function key. To see what any individual key does,
  244.           press <Help>  and then  the function  key. DED will clear the
  245.           screen and print a  brief  explanation  of  that  key's three
  246.           possible functions.  Not every  possible keystroke executes a
  247.           command, however. If you press a  key that  does nothing, the
  248.           computer will just beep.
  249.  
  250.                By  the   way,  you  should  also  press  <Shift>-<Help>
  251.           and read the message that you find there.
  252.  
  253.                It  is  probably  possible  to  discover  all  of  DED's
  254.           features  just  by  pressing  the HELP key and experimenting.
  255.           However, on  the  assumption  that  not  everyone  likes that
  256.           sort  of  puzzle,  the  following pages present a tutorial on
  257.           the care and feeding of DED.
  258.  
  259.  
  260.           The First Few Steps
  261.           ===================
  262.  
  263.                Let's suppose you have started DED  as described  in the
  264.           last  section.  You  did  not  enter  a file name, so the top
  265.           23 lines of the screen  are  blank,  there  is  no  file name
  266.           listed in  the status  line, and "Insert" is on. (Insert mode
  267.           is always on when DED is first started.)
  268.  
  269.                The first thing you want to do is  specify a  file name,
  270.           so  you  can  save  the  text  you are about to type. To tell
  271.  
  272.                                           3
  273.  
  274.  
  275.  
  276.  
  277.  
  278.           DED that you want to  enter  a  file  name,  press  the <Main
  279.           Screen>  key.  (Most  of  the  other  function keys are named
  280.           more logically than  this  one.  Unfortunately,  DEC  did not
  281.           see  fit  to  include  an  "Enter-new-file-name"  key  on the
  282.           Rainbow's  keyboard.)  When  you  press  <Main  Screen>,  the
  283.           cursor will  move to  the status  line and the message "Enter
  284.           new file name:" will appear. At this point,  you can  type in
  285.           any file  name you  wish, including  a drive  specifier and a
  286.           path name  if necessary.  In fact,  you can  enter an illegal
  287.           file name  here if  you want  to, but  DED won't let you save
  288.           anything with an illegal file name. If you enter  a full path
  289.           name,  the  string  might  be  too  long  to fit in the space
  290.           provided on  the status  line. This makes  things look funny,
  291.           but don't worry about it. Nothing bad will happen.
  292.  
  293.                Now  let's  suppose  you  have entered a file name, like
  294.           "TEST.TXT". When  you  press  the  <Return>  key,  the cursor
  295.           will jump  back to  the top  of the  screen and  the new file
  296.           name TEST.TXT  will appear  in the  status line.  Now you can
  297.           enter text.
  298.  
  299.                To enter  text, just type it. Anything you type now will
  300.           appear in the top 22 lines of the screen. There  is virtually
  301.           no limit  to the  length of a line, even though the screen is
  302.           only 80 characters wide (the real limit is  1800 characters).
  303.           If you  type more than 80 characters on a line, the the whole
  304.           screen will move 30 characters to the left  to give  you more
  305.           room to  type. (This  happens VERY  FAST and  can be a little
  306.           disconcerting the first few times it  happens.) When  you hit
  307.           the <Return>  key, the screen will return to the beginning of
  308.           the next line. DED  will scroll  horizontally in  this way as
  309.           many times as you need it to.
  310.  
  311.                If you are using this manual as a tutorial, type in some
  312.           text now so you can practice editing it later.
  313.  
  314.                Now that you have some text to work with, try  using the
  315.           cursor movement keys. These keys have been defined so that if
  316.           pressing the key alone does something, holding the <Ctrl> key
  317.           does more of the same thing, and holding the <Shift> key does
  318.           even more. For instance, the "Up Arrow" key  moves the cursor
  319.           up one  line. Holding  the <Ctrl>  key while pressing the "Up
  320.           Arrow" key moves the cursor  up  11  lines,  and  holding the
  321.           <Shift>  key  while  pressing  the  "Up  Arrow" key moves the
  322.           cursor all the way to the top of the screen.  The four cursor
  323.           control keys are defined as follows:
  324.  
  325.                <Up>:               Move up 1 line
  326.                <Crtl>-<Up>:        Move up 11 lines
  327.                <Shift>-<Up>:       Move to the top of the screen
  328.  
  329.                <Down>:             Move down 1 line
  330.  
  331.                                           4
  332.  
  333.  
  334.  
  335.  
  336.  
  337.                <Crtl>-<Down>:      Move down 11 lines
  338.                <Shift>-<Down>:     Move to the bottom of the screen
  339.  
  340.                <Left>:             Move left 1 character
  341.                <Crtl>-<Left>:      Move left 1 word
  342.                <Shift>-<Left>:     Move to the beginning of the line
  343.  
  344.                <Right>:            Move right 1 character
  345.                <Crtl>-<Right>:     Move right 1 word
  346.                <Shift>-<Right>:    Move to the end of the line
  347.  
  348.                The  <Next  Screen>  and  <Prev Screen> keys are defined
  349.           similarly. For instance,  pressing  <Next  Screen>  will move
  350.           the  cursor  down  22  lines.  This  also  happens VERY FAST.
  351.           Pressing <Shift>-<Next  Screen> moves  the cursor  to the end
  352.           of  the  file.  <Prev  Screen>  moves the cursor up 22 lines,
  353.           and <Shift>-<Prev Screen> moves  the cursor  to the beginning
  354.           of the file.
  355.  
  356.                <Ctrl>-<Next  Screen>  and  <Ctrl>-<Prev  Screen>  are a
  357.           little different. The move  the  cursor  up  or  down  in the
  358.           file continuously until you press any key. This is useful for
  359.           scanning through a file until  you  find  the  place  you are
  360.           looking for.
  361.  
  362.                After  you  have  typed  in some text, try experimenting
  363.           with these  keys,  especially  the  <Next  Screen>  and <Prev
  364.           Screen> keys.  If you  are accustomed  to another full-screen
  365.           editor, the speed at which  DED  moves  to  a  new  screen is
  366.           almost frightening.
  367.  
  368.                One thing  that programmers usually need to do is find a
  369.           specific line number within the file. Of course, you can just
  370.           hold down  the <Down  Arrow> key until you reach the line you
  371.           want, but it is much faster to use the <Resume> key. When you
  372.           press <Resume>,  DED will  ask you  what line  you want to go
  373.           to. Type  in  the  line  number,  and   you  will   be  there
  374.           exceptionally quickly.
  375.  
  376.                The next  function key  to try is the <Insert Here> key.
  377.           This key toggles DED's  insertion  function.  The  first time
  378.           you press  <Insert Here>,  the indication  in the status line
  379.           will change to "Insert OFF", the  second time  it will change
  380.           to  "Insert  ON",  and  so  on. If the insertion mode is OFF,
  381.           anything you type will appear "on  top of"  anything that was
  382.           already there. If the insertion mode is ON, anything that has
  383.           already been entered will move  to the right to make room for
  384.           the new  text.  Try experimenting with this for a while until
  385.           you see how it works.
  386.  
  387.                If you make a mistake, DED supplies a  truly frightening
  388.           variety of  ways to  erase your error, from deleting a single
  389.  
  390.                                           5
  391.  
  392.  
  393.  
  394.  
  395.  
  396.           character to erasing the entire file. The basic key to use is
  397.           the <Remove>  key. <Remove> won't erase more than a line full
  398.           of characters at a time, so it is fairly safe  to use.  It is
  399.           defined as follows:
  400.  
  401.                         <Remove>:   Remove 1 character
  402.                  <Crtl>-<Remove>:   Remove 1 word
  403.                 <Shift>-<Remove>:   Remove 1 line
  404.  
  405.                 This is all fairly benign. Now let's suppose you made a
  406.           REALLY big mistake, and you want to erase a lot  of text. The
  407.           <F4>  key  is  one  way  to  handle  this. <F4> is defined as
  408.           follows:
  409.  
  410.                     <F4>:     Erase everything  from the  cursor to the
  411.                               end of the file
  412.              <Crtl>-<F4>:     Erase   everything   from  the  beginning
  413.                               of the file to the cursor
  414.             <Shift>-<F4>:     Erase the entire file
  415.  
  416.                Another method of selectively  deleting large  blocks of
  417.           text is  discussed later,  in the "Block Operations" section.
  418.           You can  also delete  specific strings  of text  by using the
  419.           <Shift>-<Find> or <Shift>-<Addtnl Options> keys, as described
  420.           in the next section.
  421.  
  422.                Now you should be able to enter, change and delete text,
  423.           and  to  move  the  cursor  around at will. The next question
  424.           is, how do you save it?
  425.  
  426.                There are 2 ways to save your file, and both of them are
  427.           initiated  by   pressing  the   <Exit>  key.   If  you  press
  428.           <Shift>-<Exit> your file will  be saved  and DED  will return
  429.           control to  MS-DOS. If  you press  <Exit> without holding the
  430.           <Shift> key, DED will save your file and return, allowing you
  431.           to  make  further  changes.  In  both cases, a backup file is
  432.           maintained on the disk with a  ".BAK" extension.  If the disk
  433.           fills up,  DED will  tell you  so. If this happens you should
  434.           use the <Main Screen> key to rename the file, only  this time
  435.           you should  specify another  disk. DO  NOT remove the default
  436.           disk because DED keeps its temporary files there.
  437.  
  438.                If you decide that you are  completely dissatisfied with
  439.           everything you  have done  so far, you can press the <Cancel>
  440.           key. This will cause DED to return control  to MS-DOS without
  441.           saving any  changes you  may have made. (DED will ask you for
  442.           verification  before  it  halts,  just  in  case  you pressed
  443.           <Cancel> by accident.)
  444.  
  445.                The commands discussed so far are enough to allow you to
  446.           create, edit and save  text  files.  However,  DED  (like all
  447.           other  text    editors)  includes  features  that allow  much
  448.  
  449.                                           6
  450.  
  451.  
  452.  
  453.  
  454.  
  455.           greater flexibility in file and text  menipulation. These are
  456.           covered in detail in the next sections.
  457.  
  458.  
  459.           Finding and Replacing strings of text
  460.           =====================================
  461.  
  462.                As you  might expect, the <Find> key causes the computer
  463.           to find any string of text. This saves you a lot of  time and
  464.           eye-strain. The <Find> key is defined as follows:
  465.  
  466.                          <Find>:   Find a string that you specify
  467.                   <Crtl>-<Find>:   Find the same string again
  468.                  <Shift>-<Find>:   Find  a  string  and replace it with
  469.                                    another string
  470.  
  471.                If you press <Find>, DED  will  print  an  arrow  in the
  472.           status line  followed by  the message "Find what?". The arrow
  473.           represents the direction the search will  be made  in. If the
  474.           arrow points  to the  right, DED  will search from the cursor
  475.           position to the end of the  file. If  it points  to the left,
  476.           DED will search in the opposite direction. At this point, you
  477.           can type the string you want to find. You can enter up to 200
  478.           characters. If  you want to search in the opposite direction,
  479.           press any of the four cursor  movement keys.  Pressing "left"
  480.           or "up"  causes DED to search backwards, and pressing "right"
  481.           or "down" causes DED to search forward.   When you  press the
  482.           <Return>  key  DED  will  find  the string you entered, if it
  483.           exists. If  not, the  cursor will  return to  wherever it was
  484.           before you pressed the <Find> key.
  485.  
  486.                If you press <Crtl>-<Find>, DED will try to find to same
  487.           string again. If you have never pressed <Find>  and entered a
  488.           string,   pressing   <Crtl>-<Find>   will  not  do  anything.
  489.           <Crtl>-<Find> does not allow you to  change the  direction of
  490.           the search.
  491.  
  492.                If  you  want  to  replace a string with another string,
  493.           press <Shift>-<Find>. DED will prompt  you  for  a  string to
  494.           search for,  and then  it will  ask you "Replace with what?".
  495.           Enter the  string with  which you  want to  replace the first
  496.           string.  To  delete  the  first  string  entirely, just press
  497.           <Return>  without  entering  anything.  You  can  change  the
  498.           direction of  the search  at any  time, as  before. After you
  499.           enter the replacement  string,  DED  will  ask  you  how many
  500.           times you  want to  do the replacement. The default is 1, and
  501.           the maximum is 65537.  Then  DED  will  ask  if  you  want to
  502.           confirm each  replacement before  it is made. Press "Y", "N",
  503.           <Break>, or <Return>. <Break>  cancels the  command entirely,
  504.           and <Return>  takes the default. The default is "Y" the first
  505.           time you  use  <Shift>-<Find>.  After  that,  the  default is
  506.           whatever you entered the last time.
  507.  
  508.                                           7
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.                The  <Find>  key  finds  what  you  are looking for VERY
  516.           quickly, but it  has  a  few  limitations. For  instance, you
  517.           cannot  search  for  a  tab character because DED changes all
  518.           tabs to spaces. And sometimes you will  want to  search for a
  519.           string that  looks like  "AxBCD", where  "x" can be "anything
  520.           except an A" or maybe "any  series of  spaces, no  matter how
  521.           long". Furthermore, the <Find> key is case-sensitive, meaning
  522.           that you have to know if the string you are  searching for is
  523.           upper-case  or  lower-case. Version  2.0  of  DED solves this
  524.           problem through the <Addtnl Options> key.
  525.  
  526.                Pressing the <Addtnl Options>  key allows  you to  use a
  527.           wide  variety  of  wild-card  characters when searching for a
  528.           string. When you press <Addtnl Options>, DED  will prompt you
  529.           with "Find  What?" in the status line, exactly as it did when
  530.           you pressed the  <Find>  key. This  time,  however,  DED will
  531.           allow you  to use  the <Select>  key while you are typing the
  532.           string you want to search  for. The  <Select>  key  tells DED
  533.           that  you  are  going  to  use  a wild card character in this
  534.           search. To see what all the possible wild cards  are, you can
  535.           press  the  <Help>  key  after you press the <Addtnl Options>
  536.           key. All of the wild cards are  two- or  three-key sequences,
  537.           starting with the <Select> key, as in the table below:
  538.  
  539.                <Select>-X          Accept ANY character as a match
  540.                <Select>-A          Accept any alphabetic character
  541.                <Select>-1          Accept any digit
  542.                <Select>-N          Accept any alphanumeric character
  543.                <Select>-<ESC>      Accept      any     non-alphanumeric
  544.                                    character
  545.                <Select>-~          Accept any  character  from  the DEC
  546.                                    extended character set
  547.                <Select>-L          Accept   any  lower-case  alphabetic
  548.                                    character
  549.                <Select>-U          Accept  any   upper-case  alphabetic
  550.                                    character
  551.                <Select>-<Space>    Accept  any  string of spaces and/or
  552.                                    tabs
  553.                <Select>-<Select>-x Accept any character EXCEPT "x"
  554.  
  555.                When you enter a wild card character, it  will appear in
  556.           boldface on  the screen. If you use the last wild card in the
  557.           list above (<Select>-<Select>-x), the  whatever character you
  558.           enter for "x" will appear in reverse video instead of bold.
  559.  
  560.                Wild  card  characters  can  be  entered anywhere in the
  561.           string, including the first  character. Furthermore, a search
  562.           that  is  started  with  the  <Addtnl  Options>  key  is  NOT
  563.           case-sensitive. This makes the search routine very flexible.
  564.  
  565.                The <Shift>-<Addtnl Options> and <Ctrl>-<Addtnl Options>
  566.  
  567.                                           8
  568.  
  569.  
  570.  
  571.  
  572.  
  573.           keys    are    defined    analogously    with    the   <Find>
  574.           key. <Crtl>-<Addtnl Options> finds the same string (including
  575.           wild  cards)  again,  and  <Shift>-<Addtnl  Options>  finds a
  576.           string and replaces it  with  another. (You  cannot  put wild
  577.           cards  in  the  replacement string.) Additionally, the <Find>
  578.           and <Addtnl Options> keys  are  completely  separate. You can
  579.           set them  up so  that one  key searches forward and the other
  580.           backward, if you wish.
  581.  
  582.                Why are there two separate ways to search  in DED? There
  583.           are   two   reasons. First,   the  <Find>  key's  routine  is
  584.           blindlingly  fast  when  compared  to  the  <Addtnl  Options>
  585.           key. Second, the  <Find> key  is easier to use in many cases,
  586.           because you don't have to worry about wild  cards. This makes
  587.           the  <Find>  key  the  one  to use unless you really need the
  588.           extra flexibility allowed by the <Addtnl Options> key.
  589.  
  590.  
  591.           Block Operations
  592.           ================
  593.  
  594.                One of the best features of any good text editor  is the
  595.           ability to  move and delete selected blocks of text. DED uses
  596.           two different  function keys  for this  purpose: <Select> and
  597.           <Do>.
  598.  
  599.                The <Select>  key defines the beginning of a block. Just
  600.           move the cursor to the first  line in  the block  you want to
  601.           define and  press <Select>. Nothing will visibly happen until
  602.           you define the end of the block. To  do this,  go to  the end
  603.           of  the  block  and  press  <Ctrl>-<Select>.  (You  can press
  604.           <Select> and <Crtl>-<Select> in either order.)  When you have
  605.           defined both  a beginning  and an  end of a block, the entire
  606.           block will appear in reverse video.  (If you  decide you want
  607.           to  "un-define"  the  block, press <Shift>-<Select>.) Now you
  608.           can use this block of text in any of several ways.
  609.  
  610.                The <Do> key is used as  a prefix  for block operations.
  611.           If  you  press  <Do>  before  you  have  defined a block, the
  612.           computer  will  beep.  You  must  define  a  block  using the
  613.           <Select> key  before the <Do> key will function. Assuming you
  614.           have already defined a  block,  pressing  the  <Do>  key will
  615.           cause DED  to ask  "Do what?" in the status line. Now you can
  616.           press any of several keys, which are:
  617.  
  618.                <Help>              Prints a list of options.
  619.  
  620.                <Print Screen>      Sends the block to the printer.
  621.  
  622.                <Find>              Moves the cursor to the beginning of
  623.                                    the block.
  624.  
  625.  
  626.                                           9
  627.  
  628.  
  629.  
  630.  
  631.  
  632.                <Remove>            Deletes the entire block.
  633.  
  634.                <Insert Here>       Copies  the   block  to  the  cursor
  635.                                    location.
  636.  
  637.                <PF1>               Saves  the  block  in  a  disk  file
  638.                                    called "BUFFER1.DED".
  639.  
  640.                <PF2>               Saves  the  block  in  a  disk  file
  641.                                    called "BUFFER2.DED".
  642.  
  643.                <PF3>               Saves  the  block  in  a  disk  file
  644.                                    called "BUFFER3.DED".
  645.  
  646.                <PF4>               Saves  the  block  in  a  disk  file
  647.                                    called "BUFFER4.DED".
  648.  
  649.                The <PF1..4> keys have a  dual  function.  If  you press
  650.           <Shift>-<PF1..4>,  DED   will  overwrite  anything  that  was
  651.           previously written to the buffer file. If you  don't hold the
  652.           <Shift> key,  DED will append the block of text to the end of
  653.           whatever was already in the file.  The BUFFERn.DED  files can
  654.           be  inserted  elsewhere  in  your  file  or into another file
  655.           through  use  of  the  <Crtl>-<Insert  Here>  key,  which  is
  656.           explained more  fully in the next section. Normally, DED will
  657.           erase these  four files  when you  quit. However,  one of the
  658.           options you can set by pressing the <Shift>-<Main Screen> key
  659.           allows you to tell  DED to  save them  instead. You  can also
  660.           make  DED  save  them  by  default, by setting an environment
  661.           variable. This  is  described  fully   in   the   section  on
  662.           "Additional Options".
  663.  
  664.                There are a few limitations on the use of blocks. First,
  665.           blocks can only be made up  of complete  lines --  you cannot
  666.           make a  block begin or end in the middle of a line. Second, a
  667.           few   operations   (notably   the    <Shift>-<Insert   Here>,
  668.           <Crtl>-<Insert  Here>,  <F4>,  <Shift>-<F4>  and  <Crtl>-<F4>
  669.           keys) will  automatically un-define  any block  that you have
  670.           defined. Also,  certain virtual memory operations can cause a
  671.           block definition to  be  lost.  If  this  happens,  a warning
  672.           message will  appear. However,  virtual memory operations are
  673.           seldom necessary except in files larger  than about 55K-bytes
  674.           or  so,  and  even  then  it  is  very rare for a block to be
  675.           un-defined.
  676.  
  677.  
  678.           File Insertion
  679.           ==============
  680.  
  681.                As you saw briefly in the last section, pressing <Crtl>-
  682.           <Insert Here>  allows you  to insert  one of the buffer files
  683.           BUFFER1.DED,  BUFFER2.DED,  BUFFER3.DED  or  BUFFER4.DED. DED
  684.  
  685.                                          10
  686.  
  687.  
  688.  
  689.  
  690.  
  691.           will ask  you which of the four files you wish to insert, and
  692.           you answer by pressing PF1, PF2, PF3 of PF4. If  the file you
  693.           selected does  not exist  in the  current directory, DED will
  694.           print an  error  message. Note  that  you  can  transfer data
  695.           between different files by this method.
  696.  
  697.                You can  also insert a file other than one of the buffer
  698.           files. Pressing <Shift>-<Insert Here>  causes DED  to ask you
  699.           for a file name. You can enter any legal file name, including
  700.           a drive specifier and a path name if necessary. If DED cannot
  701.           find the  file, an  error message will appear. Otherwise, the
  702.           file will be inserted to the cursor position.
  703.  
  704.  
  705.           User-Defineable Keys (Macros)
  706.           =============================
  707.  
  708.                The <F17>, <F18>,  <F19>,  <F20>,  <PF1>,  <PF2>, <PF3>,
  709.           and  <PF4>  keys,  and  <Shift>  and  <Crtl>  combinations of
  710.           them, are all user-defineable  keys. This  allows a  total of
  711.           24 possible macros. Macros in DED can include any combination
  712.           of    keystrokes,  including   function   keys   AND  ILLEGAL
  713.           KEYSTROKES. No  error checking  is done during the definition
  714.           of a macro. Macros can be used to enter text,  to "press" any
  715.           function  key,  or  to  answer  any  prompt.  In  fact, it is
  716.           possible to define a macro that  defined itself,  but this is
  717.           not recommended  and will  probably hang up the computer. The
  718.           user-defineable  keys  are  intended  to  be  as  flexible as
  719.           possible, but this flexibility can sometimes be dangerous.
  720.  
  721.                If you  press a macro key that has not been defined, the
  722.           computer will just beep. To define a macro, press <Crtl>-<Do>
  723.           and then  press the  key you  wisk to define. DED will prompt
  724.           you in the status line. You can enter up to  50 keystrokes in
  725.           the definition  of a macro. If you press a function key or an
  726.           illegal key, a funny character will appear. Don't worry about
  727.           it.  This  is  just  DED's  way  of telling you that you have
  728.           entered something other than  an  alphanumeric  character. To
  729.           end    the    macro    definition,   press   <Crtl>-<Return>.
  730.           (<Crtl>-<Return> is used here so that you can  enter <Return>
  731.           as part of the macro.)
  732.  
  733.                After a  key has  been defined you just have to press it
  734.           again to  execute the  new macro.  If you  pressed a function
  735.           key  during  the  macro  definition, that key's function will
  736.           be executed.  Any  alphanumeric  characters  will  be entered
  737.           just as though you had typed them yourself.
  738.  
  739.                DED also  allows you  to save  your macro definitions on
  740.           disk. Pressing <Shift>-<Do> causes DED to  store them  on the
  741.           default disk in the file MACROS.DED. If this file exists, DED
  742.           will overwrite whatever is in it. When DED initializes itself
  743.  
  744.                                          11
  745.  
  746.  
  747.  
  748.  
  749.  
  750.           it looks  for this  file and, if it exists, uses it to define
  751.           the macro keys. Otherwise,  all 24  macros will  be undefined
  752.           until you use <Crtl>-<Do> to define them.
  753.  
  754.           Control Characters
  755.           ==================
  756.  
  757.                DED allows only 4 control characters to be inserted in a
  758.           file.  Pressing  the  <F11>,  <F12>,  or  <F13>  keys enters,
  759.           respectively,  escape,   backspace,  and  linefeed.  Pressing
  760.           <Shift>-<F13> enters a form feed.
  761.  
  762.                If DED encounters a control character other than  one of
  763.           these  in  a  file,  it  changes  it  to  a  space.  The only
  764.           exceptions are the TAB character and <Crtl>-Z. 
  765.  
  766.                By  default,  tab  characters  are  usually  expanded to
  767.           fields of  8 spaces.  DED tries  to handle  tab settings in a
  768.           semi-intelligent way. When you  start  DED,  the  tab setting
  769.           will be  8 spaces  UNLESS you  have entered  a file name that
  770.           ends with ".C" or  ".PAS". If the  file extension  is ".C" or
  771.           ".PAS", then  the tab setting will be automatically be set to
  772.           4 spaces. This is  generally  convenient  for programmers. If
  773.           you  want  to  set  the  tab  stops yourself, you can use the
  774.           <Shift>-<Main Screen>  key to  do so,  and you  can create an
  775.           environment   variable   that   will   change  DED's  default
  776.           values. See the section on  "Additional  Options"  for better
  777.           instructions.
  778.  
  779.                <Crtl>-Z   is   interpreted   as  end-of-file.  This  is
  780.           consistent with the CP/M  convention.  Since  a  fairly large
  781.           number of  MS-DOS programs were converted from CP/M, DED also
  782.           appends a <Crtl>-Z to the end of the file to  accommodate any
  783.           other program that may expect it.
  784.  
  785.           Foreign Language Characters
  786.           ===========================
  787.  
  788.                DED  allows   you  to  insert  DEC  8-bit  multinational
  789.           characters in your file. If you  have a  Rainbow 100-B, which
  790.           does directly  supports the  <Compose Character> key, all you
  791.           have to do is press <Compose Character> followed by the usual
  792.           key sequence  for whatever  character you want. If you have a
  793.           Rainbow 100-A, which does not support the <Compose Character>
  794.           key,  press   <Compose  Character>   followed  by  any  other
  795.           alphanumeric key to access  the special  characters. DED will
  796.           insert a  character into your file according to the following
  797.           table.
  798.  
  799.                     You Press             To Get
  800.                          a                      
  801.                          b                      
  802.  
  803.                                          12
  804.  
  805.  
  806.  
  807.  
  808.  
  809.                          c                      
  810.                          d                      
  811.                          e                      
  812.                          f                      
  813.                          g                      
  814.                          h                      
  815.                          i                      
  816.                          j                      
  817.                          k                      
  818.                          l                      
  819.                          m                      
  820.                          n                      
  821.                          o                      
  822.                          p                   not allowed
  823.                          q                      
  824.                          r                      
  825.                          s                      
  826.                          t                      
  827.                          u                      
  828.                          v                      
  829.                          w                      
  830.                          x                      
  831.                          y                      
  832.                          z                      
  833.                          A                      
  834.                          B                      
  835.                          C                      
  836.                          D                      
  837.                          E                      
  838.                          F                      
  839.                          G                      
  840.                          H                      
  841.                          I                      
  842.                          J                      
  843.                          K                      
  844.                          L                      
  845.                          M                      
  846.                          N                      
  847.                          O                      
  848.                          P                   not allowed
  849.                          Q                      
  850.                          R                      
  851.                          S                      
  852.                          T                      
  853.                          U                      
  854.                          V                      
  855.                          W                      
  856.                          X                      
  857.                          Y                      
  858.                          Z                      
  859.                          1                      
  860.                          2                      
  861.  
  862.                                          13
  863.  
  864.  
  865.  
  866.  
  867.  
  868.                          3                      
  869.                          4                   not allowed
  870.                          5                      
  871.                          6                       
  872.                          7                      
  873.                          8                   not allowed
  874.                          9                      
  875.                          0                      
  876.                          !                      
  877.                          @                      
  878.                          #                      
  879.                          $                   not allowed
  880.                          %                      
  881.                          ^                   not allowed
  882.                          *                      
  883.                          (                      
  884.                          )                      
  885.  
  886.                This arrangement  is not  consistent with  the  <Compose
  887.           Character>  function  as  implemented  by  DEC on the Rainbow
  888.           100B. It does not seem to be a problem, however. Note that if
  889.           you  have  the  extended  character  ROM in your Rainbow, the
  890.           characters that you get will not be the same. 
  891.  
  892.  
  893.           Printing
  894.           ========
  895.  
  896.                DED allows you to  print all  or part  of a  file at any
  897.           time. If  you press  <Print Screen>,  DED will  do just that.
  898.           To print the whole  file,  press  <Shift>-<Print  Screen>. To
  899.           print any  part of  a file, define that part of the file as a
  900.           block, then press <Do> and <Print Screen>.
  901.  
  902.                By default, DED will send a  form feed  character to the
  903.           printer at  the end  of each page. This will work fine if you
  904.           own a printer that uses pin-fed sheets of paper, like the DEC
  905.           LA-50.  However,  some  people  may  own printers that do not
  906.           respond to form feeds or that only take one sheet of paper at
  907.           a  time.  If  you  own  such a printer, use the <Shift>-<Main
  908.           Screen> key to tell DED not  to  send  form  feeds.  When you
  909.           press  <Shift>-<Main   Screen>,  one  line  that  appears  on
  910.           the screen will say "Pause each page while  printing". If you
  911.           set this  option to  "Yes", DED  will pause after it prints a
  912.           page and wait for you to  insert a  new sheet  of paper. When
  913.           the paper is inserted, press any key to resume printing.
  914.  
  915.                While DED  prints a  special character on the screen for
  916.           each  of  the  four  allowable  control  characters,  it will
  917.           send  the  actual  character  to  the  printer.  This  allows
  918.           you to create special  printer functions  by inserting escape
  919.           codes into  your file,  and then testing them on your printer
  920.  
  921.                                          14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.           without exiting DED.
  928.  
  929.                To abort printing at any time,  press any  key. Printing
  930.           may not  cease for a second or two if the computer is waiting
  931.           for the  printer to  drop its  XOFF signal  or if  you have a
  932.           large printer buffer.
  933.  
  934.           Cancelling a Command
  935.           ====================
  936.  
  937.                You can  terminate any  command by  pressing the <Break>
  938.           key if  DED  is  asking  for  keyboard  input.  Press <Break>
  939.           if  you  have  started  a  command  (such  as <Find>) and you
  940.           decide that you don't  want  that  command  to  continue. The
  941.           cursor will  return to  the main screen, and the command will
  942.           abort.
  943.  
  944.           Exiting to MS-DOS
  945.           =================
  946.  
  947.                Besides using  the <Shift>-<Exit>  key to  exit DED, you
  948.           can execute  MS-DOS commands by using the <Interrupt> key. If
  949.           you press <Interrupt>, DED  will attempt  to run COMMAND.COM.
  950.           If  COMMAND.COM  cannot  be  found,  DED  will print an error
  951.           message. If COMMAND.COM exists, DED will  temporarily exit to
  952.           MS-DOS. However, the status line will remain on the screen as
  953.           a reminder that DED is still active. To  return to  DED, type
  954.           "EXIT" at the MS-DOS command level.
  955.  
  956.                If you  use <Interrupt> to enter MS-DOS and then print a
  957.           directory of the current disk, you  will see  the three files
  958.           that  DED  uses  for  virtual memory operations. DO NOT ERASE
  959.           THESE FILES.  If you  are using  any of  the four BUFFERn.DED
  960.           files,  do  not  erase  them  either. DED will not be able to
  961.           properly close the files if  you  erase  them,  and  you will
  962.           probably lose a portion of your data.
  963.  
  964.  
  965.           Additional Options
  966.           ==================
  967.  
  968.                The <Shift>-<Main  Screen> key allows you to toggle four
  969.           of DED's less-often used functions. these  are "Tab Setting",
  970.           "Save   Buffer   Files",   "Auto-Indent"  and  "Pause  Before
  971.           Printing". When you press the <Shift>-<Main Screen> key these
  972.           options are listed on the screen, followed by either "Yes" or
  973.           "No", except for "Tab Setting" which  is either  4 or  8. The
  974.           first  three  are  set  to  "No"  by  default when DED starts
  975.           up. Tab  settings  are  set  as  described  in  the  "Control
  976.           Characters" section above.
  977.  
  978.                To set  any of  these functions, type "Y" or "N" (or "4"
  979.  
  980.                                          15
  981.  
  982.  
  983.  
  984.  
  985.  
  986.           or "8") when the cursor is at the  appropriate spot. <Return>
  987.           moves  the  cursor  to  the  next option without changing the
  988.           current one, and <Break> cancels the command.
  989.  
  990.                If "Save  Buffer Files"  is set  to "Yes",  DED will not
  991.           erase  the  four  files  BUFFERn.DED  (n=1,2,3,4).  Note that
  992.           these files are not created unless you use  the <Do> <PF1..4>
  993.           sequence to do so.
  994.  
  995.                If "Auto-Indent" is set to "Yes", DED will automatically
  996.           indent the cursor each time you type <Return>  while entering
  997.           text. The  cursor will  be indented  to the same depth as the
  998.           preceeding line.
  999.  
  1000.                If "Pause Before Printing" is  set  to  "Yes",  DED will
  1001.           pause at  the end  of each  page while printing a document to
  1002.           allow you file put in another sheet of paper.
  1003.  
  1004.                You can set the default  values  of  any  of  these four
  1005.           functions by using environment variables. When DED starts up,
  1006.           it looks for four environment variables:
  1007.  
  1008.                DEDIND  sets  the  auto-indent  feature. You  should set
  1009.           either DEDIND=Y or DEDIND=N.
  1010.  
  1011.                DEDBUF tells  DED whether or not to save the BUFFERn.DED
  1012.           buffer files. Set DEDBUF=Y or DEDBUF=N.
  1013.  
  1014.                DEDPAG  sets  the  "pause  while  printing" feature. Set
  1015.           DEDPAG=Y or DEDPAG=N.
  1016.  
  1017.                DEDTAB sets the tab setting. Set DEDTAB=4 or DEDTAB=8.
  1018.  
  1019.                If DED  finds any of these four variables when it starts
  1020.           up, it sets the  default  accordingly. For  instance,  if you
  1021.           want to use tab stops in columns of 4 all the time, type
  1022.  
  1023.                          SET DEDTAB=4
  1024.  
  1025.           at the  MS-DOS command  level before  you start DED. Then all
  1026.           tabs will be expanded in columns  of 4  spaces. You can still
  1027.           change the tab setting at any time by using the <Shift>-<Main
  1028.           Screen> key.
  1029.  
  1030.           Other Functions
  1031.           ===============
  1032.  
  1033.                For those of you who, like the author, tend to transpose
  1034.           characters,     the     <Crtl>-<Compose     Character>    and
  1035.           <Shift>-<Compose   Character>    keys   may    be   of   some
  1036.           use. NOTE: These  functions  ONLY  operate  on  Rainbow 100-A
  1037.           computers.
  1038.  
  1039.                                          16
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                <Crtl>-<Compose  Character>  will  swap   the  last  two
  1047.           letters  you  have  typed.  <Shift>-<Compose  Character> will
  1048.           swap the last two lines.
  1049.  
  1050.  
  1051.           Editing Very Large Files
  1052.           ========================
  1053.  
  1054.                Theoretically, there is no limit to file size when using
  1055.           DED. However,  the usual disk size rules apply, with a couple
  1056.           of caveats related to "virtual memory".
  1057.  
  1058.                When you edit a  file,  DED  will  attempt  to  read the
  1059.           entire file  into memory. Most files will fit with no problem
  1060.           since DED uses a  64K-byte  buffer.  (Allowing  for overhead,
  1061.           this allows  DED to  completely read  any file up to about 55
  1062.           Kbytes.) For longer files, DED uses 3 temporary  files in the
  1063.           current  default  directory.  One  of  these  files is always
  1064.           empty. However, the other two contain  that part  of the file
  1065.           that DED  could not  put into memory. These files are swapped
  1066.           into memory as needed during the editing session.
  1067.  
  1068.                A problem may occur when the  disk drive  fills up while
  1069.           DED  is  swapping  the  files.  There  is a point during this
  1070.           time when DED cannot recover if  the disk  fills up.  If this
  1071.           happens,  DED  will  print  an  error  message and exit. This
  1072.           problem is easy  to  avoid,  and  there  are  several obvious
  1073.           ways  of  doing  so.  If  you  rarely fill up a disk you will
  1074.           probably never encounter the  problem. In  fact,  in  all the
  1075.           time  DED  has  been  in  use  this  problem  has  never been
  1076.           encountered by anyone.
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.                                          17
  1099.