home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / APOG / EDIT.ZIP / EDITDOC3.PRN < prev    next >
Encoding:
Text File  |  1985-03-01  |  85.2 KB  |  1,321 lines

  1.         Commands                                                          3-1
  2.  
  3.  
  4.         3.  COMMANDS
  5.         3.  COMMANDS
  6.                     
  7.         The following sections describe each of EDIT's  commands  in  detail.
  8.         These  sections  are  organized  as  tables of related commands.  The
  9.         command key is given at the left of the table.  On the right  is  the
  10.         name  of  the  command,  followed  by  a  description  of  the action
  11.         performed by that command.  Where a command requires the user to type
  12.         a  key  to  select from a variety of subcommands, the subcommands are
  13.         indented, and the description of each subcommand is preceeded by  the
  14.         letter the user must type for that subcommand.
  15.                     
  16.                     
  17.         3.1.  Basic Text Insertion and Deletion
  18.         3.1.  Basic Text Insertion and Deletion
  19.                     
  20.         Command Key     Command Description
  21.         Command Key     Command Description
  22.         ___________     ___________________
  23.  
  24.         Ins             Toggle  Insert/Replace  mode.  If the current mode is
  25.         Ins                                                                  
  26.                         ____________________________                         
  27.                         Insert mode, this command switches  EDIT  to  Replace
  28.                         mode, and vice versa.
  29.  
  30.         text character  Insert  character  (Insert  mode).  All characters to
  31.         text character                                                       
  32.                         _________________                                    
  33.                         the right of the cursor are moved to the  right,  and
  34.                         the character is inserted at the cursor position.
  35.  
  36.                         Replace  character  (Replace  mode).    The character
  37.                         __________________                                   
  38.                         typed replaces the character at  the  current  cursor
  39.                         location.
  40.  
  41.         Shift-Ins       Insert  special  character.    The  following  single
  42.         Shift-Ins                                                            
  43.                         __________________________                           
  44.                         keystroke is inserted into the  buffer,  even  if  it
  45.                         would  normally be interpreted as a command.  This is
  46.                         useful for inserting characters like Esc into a file,
  47.                                                              Esc             
  48.                         which  many  printers  require  in  order  to specify
  49.                         printer options, like line spacing.
  50.  
  51.         Enter           Insert line.  A carriage return is  inserted  at  the
  52.         Enter                                                                
  53.                         ___________                                          
  54.                         cursor  position, and the current line is broken into
  55.                         two pieces.  The rest of the line to the right of the
  56.                         cursor  is  moved to the next line down, and the rest
  57.                         of the lines below the cursor are moved one  position
  58.                         down to make room for this line.
  59.  
  60.                         The  new  line is indented according to the following
  61.                         rule.  In Word-Processing mode, the line is  indented
  62.                         at  the  left  margin  setting  plus  the indentation
  63.                         specified  (which  may  be  a  positive  or  negative
  64.                         number).  The margins may be set via the Set command,
  65.                         explained below.
  66.  
  67.                         Otherwise, the new line is indented at the same level
  68.                         as  the preceeding line.  This is particularly useful
  69.                         for editing text that has a  hierarchical  structure,
  70.                         like programs or outlines.
  71.  
  72.  
  73.  
  74.                                   EDIT Users Manual                          
  75.         Commands                                                          3-2
  76.  
  77.  
  78.                         Note  that  the  carriage  return  inserted  by Enter
  79.                                                                         Enter
  80.                         indicates the end  of  a  paragraph.    There  are  a
  81.                         variety  of  commands  that  operate  on  paragraphs,
  82.                         including both  cursor  movements,  and  re-adjusting
  83.                         lines  so  that  they fit nicely between the left and
  84.                         right margins.
  85.  
  86.                         Also note that the  Enter  key  is  sometimes  called
  87.                                             Enter                            
  88.                         "Return".
  89.                     
  90.         Tab             Insert  Tab.  A tab character is inserted, the cursor
  91.         Tab                                                                  
  92.                         ___________                                          
  93.                         is moved right to the next tab stop, and a  temporary
  94.                         left  margin  is set at that tab stop.  The temporary
  95.                         left margin is used  to  re-adjust  the  lines  in  a
  96.                         paragraph  in  Word-Processing  mode  when  they  are
  97.                         modified so that they extend beyond the right  margin
  98.                         or do not reach to the right margin.  Word-Processing
  99.                         mode is explained in greater detail below, under  the
  100.                         "Set Word processing mode" command.
  101.  
  102.                         Tabs may be set via the Set command, explained below.
  103.                         The default tab stops are in columns  0,  4,  8,  ...
  104.                         Note  that  the  Tab key is near the left side of the
  105.                                          Tab                                 
  106.                         keyboard, just left of the "Q" key.
  107.         
  108.         Shift-Tab       Insert spaces to tab stop.  Insert spaces to next tab
  109.         Shift-Tab                                                            
  110.                         _________________________                            
  111.                         stop.      Note  that  this  allows  tabbing  without
  112.                         resetting the temporary left margin.
  113.                     
  114.         Ctrl-L          Insert form feed (new page).  A form  feed  character
  115.         Ctrl-L                                                               
  116.                         ___________________________                          
  117.                         is  inserted.  This character is displayed as a small
  118.                         circle with  a  plus  sign  underneath.    When  this
  119.                         character  is  printed, it causes the printer to skip
  120.                         to the  next  page  before  printing  any  subsequent
  121.                         pages.
  122.                     
  123.         Del             Delete  right.    Delete the character at the cursor.
  124.         Del                                                                  
  125.                         _____________                                        
  126.                         When the cursor is at the right end of a  line,  this
  127.                         character  is  the carriage return that separates the
  128.                         current line from the following line.
  129.         
  130.         Backspace       Delete left.  Delete the character to the left of the
  131.         Backspace                                                            
  132.                         ___________                                          
  133.                         cursor.    When  the  cursor  is  in  column  0,  the
  134.                         character left of the cursor is the  carriage  return
  135.                         that  separates  the  current  line from the previous
  136.                         line.
  137.                     
  138.         Shift-Del       Delete line.  Delete the entire line  containing  the
  139.         Shift-Del                                                            
  140.                         ___________                                          
  141.                         cursor,  leaving  the  cursor at the same position in
  142.                         the following line.
  143.                     
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                                   EDIT Users Manual                          
  150.         Commands                                                          3-3
  151.  
  152.  
  153.         pad-minus       Delete word left.  Delete the word to the left of the
  154.         pad-minus                                                            
  155.                         ________________                                     
  156.                         cursor,  including  any intervening spaces, tabs, and
  157.                         line breaks.  Note  that  a  word  is  defined  as  a
  158.                         contigious  sequence  of  letters  and digits, or any
  159.                         other single non-blank character.
  160.                     
  161.                         Note that pad-minus  refers  to  the  darker  colored
  162.                                   pad-minus                                  
  163.                         "minus"  ("-")  key  in  the  numeric pad area on the
  164.                         right side of the keyboard, just  right  of  the  key
  165.                         labeled  PgUp.    It  should not be confused with the
  166.                                  PgUp                                        
  167.                         normal minus key, which is  in  the  lighter  colored
  168.                         central  region of the keyboard.  Similarly, pad-plus
  169.                                                                      pad-plus
  170.                         refers to the large,  darker  colored,  large  "plus"
  171.                         ("+") key in the numeric pad area.
  172.                     
  173.         pad-plus        Delete  word  right.   Delete the word at the cursor,
  174.         pad-plus                                                             
  175.                         ___________________                                  
  176.                         including any trailing spaces, tabs, and line breaks.
  177.                     
  178.         Shift-pad-minus Delete  to  beginning  of  line.    Delete  all   the
  179.         Shift-pad-minus                                                      
  180.                         _______________________________                      
  181.                         characters   between  the  cursor  position  and  the
  182.                         beginning of the current line.
  183.                     
  184.         Shift-pad-plus  Delete to end of line.   Delete  all  the  characters
  185.         Shift-pad-plus                                                       
  186.                         _____________________                                
  187.                         between  the  cursor  position  and  the  end  of the
  188.                         current line.
  189.                     
  190.  
  191.         3.2.  Basic Cursor Movements
  192.         3.2.  Basic Cursor Movements
  193.                     
  194.         Command Key     Command Description
  195.         Command Key     Command Description
  196.         ___________     ___________________
  197.  
  198.         Left            Move left.  Move the  cursor  one  character  to  the
  199.         Left                                                                 
  200.                         _________                                            
  201.                         left.  When the cursor is at the beginning of a line,
  202.                         it moves to the end of the previous line.
  203.                     
  204.                         Note that the Left key is located at the  right  side
  205.                                       Left                                   
  206.                         of the keyboard in the numeric pad and cursor-control
  207.                         key area (as are the keys Right, Up, and Down).  If a
  208.                                                   Right  Up      Down        
  209.                         number  is  inserted when the user presses one of the
  210.                         cursor control keys, he should press Num  Lock  once,
  211.                                                              Num  Lock       
  212.                         to  switch  to  the  cursor  control meaning of these
  213.                         keys.
  214.                     
  215.         Right           Move right.  Move the cursor  one  character  to  the
  216.         Right                                                                
  217.                         __________                                           
  218.                         right.
  219.                     
  220.         Up              Move  up.  Move the cursor one line up, scrolling the
  221.         Up                                                                   
  222.                         ________                                             
  223.                         screen as needed to keep the cursor on the screen.
  224.         
  225.         Down            Move down.  Move the cursor one line down,  scrolling
  226.         Down                                                                 
  227.                         _________                                            
  228.                         the  screen  as  needed  to  keep  the  cursor on the
  229.                         screen.
  230.  
  231.  
  232.  
  233.  
  234.                                   EDIT Users Manual                          
  235.         Commands                                                          3-4
  236.  
  237.  
  238.                     
  239.         Home            Move to beginning of line.  Move the  cursor  to  the
  240.         Home                                                                 
  241.                         _________________________                            
  242.                         column 0 in the current line.
  243.                     
  244.         End             Move  to  end  of line.  Move the cursor to the right
  245.         End                                                                  
  246.                         ______________________                               
  247.                         end of the current line (just past the last character
  248.                         in the line).
  249.                     
  250.         PgUp            Move   page  up.    Move  the  cursor  23  lines  up,
  251.         PgUp                                                                 
  252.                         _______________                                      
  253.                         redisplaying the screen with the cursor in  the  same
  254.                         position  on  the screen as it was before giving this
  255.                         command.
  256.                     
  257.         PgDn            Move page down.   Move  the  cursor  23  lines  down,
  258.         PgDn                                                                 
  259.                         ______________                                       
  260.                         redisplaying  the  screen with the cursor in the same
  261.                         position on the screen as it was before  giving  this
  262.                         command.
  263.                     
  264.         Shift-Left      Move  word  left.   Move the cursor one "word" to the
  265.         Shift-Left                                                           
  266.                         ________________                                     
  267.                         left.  Note that a word is defined  as  a  contigious
  268.                         sequence  of  letters and digits, or any other single
  269.                         non-blank character.
  270.                     
  271.         Shift-Right     Move word right.  Move the cursor one "word"  to  the
  272.         Shift-Right                                                          
  273.                         _______________                                      
  274.                         right.
  275.                     
  276.         Shift-Up        Move   structure  up.    Move  the  cursor  back  one
  277.         Shift-Up                                                             
  278.                         ____________________                                 
  279.                         "structure".  In general, this moves  the  cursor  to
  280.                         the  beginning  of the previous line that is indented
  281.                         at the same level as the current line  or  the  first
  282.                         line  indented  less  than  the current line.  If the
  283.                         cursor  is  to  the  left  of  the  first   non-blank
  284.                         character  in  the  line, then this command moves the
  285.                         cursor to the previous line that is indented  at  the
  286.                         same level as the current cursor position.
  287.                     
  288.                         Note  that  this  command and the Move structure down
  289.                         command are useful for moving around structured  text
  290.                         like  source  code  written in a programming language
  291.                         like Pascal or "C", provided that the user is careful
  292.                         to   use   indentation  to  indicate  the  levels  of
  293.                         structure in his program.
  294.                     
  295.         Shift-Down      Move structure down.  Move  the  cursor  forward  one
  296.         Shift-Down                                                           
  297.                         ___________________                                  
  298.                         "structure".    The meaning of "structure" is defined
  299.                         above, under the Shift-Up command.
  300.                                          Shift-Up         
  301.                     
  302.         Shift-Home      Move sentence left.  Move the cursor  one  "sentence"
  303.         Shift-Home                                                           
  304.                         __________________                                   
  305.                         to  the left.  The beginning a sentence is defined to
  306.                         be the first non-blank character following  a  period
  307.                         (".").
  308.                     
  309.  
  310.  
  311.  
  312.  
  313.  
  314.                                   EDIT Users Manual                          
  315.         Commands                                                          3-5
  316.  
  317.  
  318.         Shift-End       Move  sentence right.  Move the cursor one "sentence"
  319.         Shift-End                                                            
  320.                         ____________________                                 
  321.                         to the right.
  322.                     
  323.         Shift-PgUp      Move paragraph up.  Move the cursor  one  "paragraph"
  324.         Shift-PgUp                                                           
  325.                         _________________                                    
  326.                         up.    The beginning of a paragraph is defined as the
  327.                         first non-blank character following a carriage return
  328.                         inserted by the user via the Enter key.
  329.                                                      Enter     
  330.                     
  331.         Shift-PgDn      Move paragraph down.  Move the cursor one "paragraph"
  332.         Shift-PgDn                                                           
  333.                         ___________________                                  
  334.                         down.
  335.                     
  336.  
  337.         3.3.  Setting Display, Editing, and Formatting Options
  338.         3.3.  Setting Display, Editing, and Formatting Options
  339.                     
  340.         Command Key     Command Description
  341.         Command Key     Command Description
  342.         ___________     ___________________
  343.  
  344.         F3              Set.  The Set  command  allows  the  user  to  change
  345.         F3                                                                   
  346.                         ___                                                  
  347.                         various  settings  that affect the operation of EDIT,
  348.                         such as tabs, margins, page size, and  such.    There
  349.                         are  two groups of settings, settings that effect the
  350.                         file being edited  (like  changing  tab  stops),  and
  351.                         settings  that  effect  the editing environment (like
  352.                         changing the color of the screen).
  353.                                         
  354.                         At the beginning of the Set  command,  EDIT  displays
  355.                         the  current  values  of each of these settings.  The
  356.                         user selects which option to set by typing the  first
  357.                         letter of the desired option (for example, "t" or "T"
  358.                         for setting tabs).  EDIT then  prompts  the  user  to
  359.                         enter new values for the selected item as follows:
  360.                                         
  361.         
  362.                     Settings that affect the File being edited:
  363.                     Settings that affect the File being edited:
  364.                                         
  365.                         W.  Set Word processing mode.  EDIT's word processing
  366.                             ________________________                         
  367.                             mode determines  what  happens  when  a  line  is
  368.                             modified  so  that it does not fit neatly between
  369.                             the left and right margins.  The  Word-Processing
  370.                             mode  also  determines  how  a  new  line will be
  371.                             indented when the user types Enter  to  insert  a
  372.                                                          Enter               
  373.                             carriage  return  into  the text, as explained in
  374.                             section 3.1, above.
  375.                     
  376.                             In response to the prompt for this  command,  the
  377.                             user should type a single character, as follows:
  378.                                         
  379.                             N.  No.    In  this mode, EDIT completely ignores
  380.                                 the  margins,  and  allows  lines  to  extend
  381.                                 arbitrarily  long.    However,  this  mode is
  382.                                 useful for editing  things  like  the  source
  383.                                 text for programs.
  384.                                         
  385.  
  386.  
  387.  
  388.  
  389.                                   EDIT Users Manual                          
  390.         Commands                                                          3-6
  391.  
  392.  
  393.                             Y.  Yes.    Whenever  a  line  is  edited (either
  394.                                 extending or  decreasing  its  length),  that
  395.                                 line  and  any following lines in the current
  396.                                 paragraph are adjusted so that each  line  is
  397.                                 as  long  as  possible without extending past
  398.                                 the right margin.
  399.                     
  400.                         T.  Set Tab stops.  The user is prompted to  enter  a
  401.                             _____________                                    
  402.                             list  of  tab  stops.    EDIT  will automatically
  403.                             continue tab stops past the last one  entered  in
  404.                             the  list,  every  n'th  column, where "n" is the
  405.                             number of columns the  last  specified  stops  is
  406.                             past  the  previous  stop (if any).  For example,
  407.                             the following list of specified tab stops
  408.         
  409.                                 10, 14, 24, 28
  410.         
  411.                             will effectively set tab stops in columns
  412.         
  413.                                 10, 14, 24, 28, 32, 36, ...
  414.         
  415.                             Giving a single tab stop value of "n" will simply
  416.                             set  tab  stops  every "n" columns, starting with
  417.                             column "n".  The maximum number of tab stops that
  418.                             may be set is 16.
  419.         
  420.                             It  is  recommended  that a tab stop be placed at
  421.                             the left margin column when EDIT is being used in
  422.                             word processing mode.
  423.         
  424.                         M.  Set  Margins.    The  margin  setting consists of
  425.                             ____________                                     
  426.                             three values, the left margin, indent value,  and
  427.                             right  margin.    The  user  may  enter enter new
  428.                             values for  the  margins  by  typing  the  values
  429.                             separated  by  commas,  followed  by return.  The
  430.                                                                  return      
  431.                             indent value specifies the indentation level  for
  432.                             the  first  line  of  a  paragraph.    It  may be
  433.                             negative (as it  is  in  this  paragraph).    The
  434.                             margin values are given in columns.  For example,
  435.                             a left margin of 10 means that the left margin is
  436.                             at the 10th character position on a line.
  437.                                             
  438.                             The  user may omit any of the three values of the
  439.                             margin setting to use the current value for  that
  440.                             setting,  while  changing  the other values.  For
  441.                             example, if the current margin settings are
  442.                                         
  443.                                 8, 0, 77
  444.                                         
  445.                             (left margin = 8, indentation = 0, right margin =
  446.                             77), then entering
  447.                                         
  448.  
  449.  
  450.  
  451.  
  452.                                   EDIT Users Manual                          
  453.         Commands                                                          3-7
  454.  
  455.  
  456.                                 12
  457.                                         
  458.                             will  change  only the left margin to 12, leaving
  459.                             the other values unchanged.  Entering
  460.                                         
  461.                                 ,4
  462.                                         
  463.                             will leave the left and right  margins  unchanged
  464.                             but change the indentation to 4.
  465.                         
  466.                         P.  Set  Page  options.   The page options consist of
  467.                             __________________                               
  468.                             four values - the number of lines per  page,  and
  469.                             three   values   that   control  when  EDIT  will
  470.                             automatically skip to a new page near the  bottom
  471.                             of  a  page,  based  on encountering the end of a
  472.                             paragraph, 1 blank  line,  or  two  blank  lines.
  473.                             (These  latter  three  values  allow some control
  474.                             over "orphans", single lines from a paragraph  or
  475.                             section  occuring  at the bottom of a page.)  The
  476.                             user  enters new values for the page  options  by
  477.                             typing  the  values separated by commas, followed
  478.                             by Enter, as in the Margin command.
  479.                                Enter                           
  480.                                             
  481.                             The meaning  of  the  values  in  the  pagination
  482.                             control is as follows:
  483.                             
  484.                             -   lines:  the maximum number of lines that will
  485.                                 be printed on a page.
  486.                                             
  487.                             -   new page (para):  the distance from  the  end
  488.                                 of  a  page  that will cause a new page to be
  489.                                 automatically  generated  if  the  end  of  a
  490.                                 paragraph is encountered.
  491.                     
  492.                             -   new page (1 line):  the distance from the end
  493.                                 of a page that will cause a new  page  to  be
  494.                                 automatically  generated  if  a  single blank
  495.                                 line is encountered.
  496.                             
  497.                             -   new page (2 lines):  the  distance  from  the
  498.                                 end  of  a page that will cause a new page to
  499.                                 be automatically generated if two blank lines
  500.                                 are encountered.
  501.                                             
  502.                         H.  Set  Header.    This  option  allows  the user to
  503.                             ___________                                      
  504.                             specify a line of text to be printed at  the  top
  505.                             each  printed  page.   It also him to specify the
  506.                             first page on which the header is to be  printed.
  507.                             It also allows the user to optionally specify the
  508.                             position that the page number should  be  printed
  509.                             within  the  header  text.    In  response to the
  510.                             Header prompt,  the  user  should  enter  a  line
  511.                             containing  four  sections  separated  by commas.
  512.                             These four sections are:
  513.  
  514.  
  515.                                   EDIT Users Manual                          
  516.         Commands                                                          3-8
  517.  
  518.  
  519.                                         
  520.                             -   Start page.  This value should  be  a  number
  521.                                 specifying the first page on which the header
  522.                                 is to be printed.
  523.                                         
  524.                             -   Left  text.    This  text  will  be   printed
  525.                                 starting in the left margin.
  526.                                         
  527.                             -   Center  text.    This  text  will  be printed
  528.                                 centered between the left and right margins.
  529.                                         
  530.                             -   Right  text.    This  text  will  be  printed
  531.                                 justified to the right margin.
  532.                                         
  533.                             The  position in the header where the page number
  534.                             should be printed is indicated by  the  character
  535.                             "#" in the header.  For example, the header
  536.                                         
  537.                                 2,,,Page #
  538.                                         
  539.                             will print page numbers right justified at top of
  540.                             the page, starting on page  2.    Note  that  two
  541.                             blank  lines are automatically produced after the
  542.                             header.
  543.                            
  544.                             If the user has previously  specified  a  header,
  545.                             and  he  does  not want that header, he may enter
  546.                             "N" (for None) in response to the Header prompt.
  547.                                         
  548.                         F.  Set Footer.   This  option  allows  the  user  to
  549.                             __________                                       
  550.                             specify  a  line  of  text  to  be printed at the
  551.                             bottom  of  each  page,  similar  to  the  Header
  552.                             option.    The line that the user should enter in
  553.                             response to the prompt for this  option  has  the
  554.                             same sections and meaning as the line entered for
  555.                             the Header option.  The footer  will  be  printed
  556.                             preceeded by at least two blank lines.
  557.                                         
  558.                         N.  Set  Number.    This  option  allows  the user to
  559.                             ___________                                      
  560.                             specify number of the first  page  printed.    In
  561.                             response  to the prompt for this option, the user
  562.                             should enter a single  number.    Note,  however,
  563.                             that  no  number  will  be  printed  on any page,
  564.                             unless the user has defined a  header  or  footer
  565.                             containing  the "#" character, as explained above
  566.                             under the Set Header command.
  567.         
  568.                         S.  Set Spacing.  This  option  allows  the  user  to
  569.                             ___________                                      
  570.                             specify  whether  the  document should be printed
  571.                             with single  spacing,  or  double  spacing.    In
  572.                             response  to  this prompt, the user should select
  573.                             one  of  the  two  options  by  typing  a  single
  574.                             character as follow:
  575.  
  576.  
  577.  
  578.  
  579.                                   EDIT Users Manual                          
  580.         Commands                                                          3-9
  581.  
  582.  
  583.                                         
  584.                             S.  Single spacing.
  585.                                         
  586.                             D.  Double spacing.
  587.                                         
  588.                         J.  Set  Justify.    This  option  allows the user to
  589.                             ____________                                     
  590.                             specify whether EDIT should print the  text  with
  591.                             lines  within  paragraph  right justified or not.
  592.                             Edit performs right  justification  by  expanding
  593.                             the  spaces  following  the last tab character or
  594.                             first non-blank character in a line.  In response
  595.                             to  this  prompt,  the  user should type a single
  596.                             character to select whether or  not  EDIT  should
  597.                             perform right justification, as follows:
  598.                                         
  599.                             Y.  Yes.   EDIT should right justify lines within
  600.                                 paragraphs.
  601.                                         
  602.                             N.  No.  EDIT should print each line  exactly  as
  603.                                 it appears on the screen.
  604.                         
  605.                             
  606.                     Settings that only affect the editing environment:
  607.                     Settings that only affect the editing environment:
  608.                                         
  609.                         I.  Set  Insert/Replace mode.  This option allows the
  610.                             ________________________                         
  611.                             user to select whether EDIT should be  in  Insert
  612.                             mode  or  Replace  mode.    These  two  modes are
  613.                             explained above, under the Toggle  Insert/Replace
  614.                             mode  command in section 3.1.  In response to the
  615.                             prompt for this option, the  user  should  select
  616.                             the   mode  by  typing  a  single  character,  as
  617.                             follows:
  618.                                         
  619.                             I.  Insert mode.
  620.                                         
  621.                             R.  Replace mode.
  622.  
  623.                         C.  Set Color.    This  option  allows  the  user  to
  624.                             _________                                        
  625.                             specify   the  display  color  (or  attribute  on
  626.                             monochrome displays) for  different  sections  of
  627.                             the  CRT  screen.    It  also  allows the user to
  628.                             specify color for boldface  or  underlined  text.
  629.                             The default colors (attributes) are different for
  630.                             systems using  the  IBM  monochrome  adaptor  (or
  631.                             compatible), and the color/graphics adaptor.  The
  632.                             user may want to  experiment  to  determine  what
  633.                             actual  colors  are displayed for different color
  634.                             values on a particular color monitor.
  635.                                         
  636.                             In response to  the  prompt  for  the  Set  Color
  637.                             option,  the  user  may  enter  up  to six values
  638.                             separated by commas.  Any of the three values may
  639.                             be optionally omitted.  Each value determines the
  640.                             color EDIT uses for a different  regions  of  the
  641.                             screen, or different kinds of text, as follows:
  642.  
  643.  
  644.                                   EDIT Users Manual                          
  645.         Commands                                                         3-10
  646.  
  647.  
  648.                                         
  649.                             -   Normal  text display.  This is the color EDIT
  650.                                 uses for normal text displayed on the top  23
  651.                                 lines of the screen.
  652.                                         
  653.                             -   Prompt area.  This is the color EDIT uses for
  654.                                 the bottom two lines on  the  screen  contain
  655.                                 EDIT's prompt and message lines.
  656.                                         
  657.                             -   Marker.   This is the color EDIT uses to mark
  658.                                 the character at the cursor position  in  the
  659.                                 text  display  area when the screen cursor is
  660.                                 moved down to the prompt area for the user to
  661.                                 enter a character or line of text in response
  662.                                 to a command prompt.
  663.  
  664.                             -   Bold text display.   This  is  the  color  or
  665.                                 attribute  EDIT  uses  to  display text which
  666.                                 will be "boldface" when printed.
  667.  
  668.                             -   Underlined text display.  This is  the  color
  669.                                 or  attribute EDIT uses to display text which
  670.                                 will be underlined when printed.
  671.  
  672.                             -   Bold-Underlined text display.   This  is  the
  673.                                 color  or attribute EDIT uses to display text
  674.                                 which will be  printed  both  "boldface"  and
  675.                                 underlined.
  676.                                         
  677.                         D.  Set Default repetition count.  This option allows
  678.                             ____________________________                     
  679.                             the user to specify the default value  that  will
  680.                             be  used when the Esc key is pressed to repeat an
  681.                             EDIT command.  EDIT commands that may be repeated
  682.                             include  the  cursor  movement commands, the Find
  683.                             and  Reverse  Find  commands,  the  Replace   and
  684.                             Conditional   Replace   commands,   and  the  Get
  685.                             command.
  686.         
  687.         
  688.         Shift-F3        Get Settings from file.  This command allows the user
  689.         Shift-F3                                                             
  690.                         ______________________                               
  691.                         to  retrieve  setting  values from a file.  Note that
  692.                         setting values may be saved in a file  via  the  Save
  693.                         Settings  option  of  the  Quit command, explained in
  694.                         section 3.4.
  695.         
  696.                         In response to the prompt for this command, the  user
  697.                         should  enter the name of a file.  EDIT will read the
  698.                         specified file and change its settings  according  to
  699.                         the commands in the file.
  700.                     
  701.                         Each  setting  command in the file should be a single
  702.                         line long.  The first character of the line should be
  703.                         the  first  character  of  the setting to change (for
  704.                         example, 'h' to change the header).    The  remaining
  705.                         characters  in  the  line  specify  the value for the
  706.  
  707.  
  708.                                   EDIT Users Manual                          
  709.         Commands                                                         3-11
  710.  
  711.  
  712.                         setting, using the save  format  as  if  the  setting
  713.                         value were changed interactively with the Set command
  714.                         described above.
  715.                     
  716.                         The following is an example of a  setting  file  that
  717.                         contains commands that change the margins and header:
  718.                     
  719.                                 m 10, 5, 75
  720.                                 h 2,,,Page #
  721.                     
  722.                             
  723.         3.4.  File Selection and/or Exiting EDIT
  724.         3.4.  File Selection and/or Exiting EDIT
  725.                     
  726.         Command Key     Command Description
  727.         Command Key     Command Description
  728.         ___________     ___________________
  729.  
  730.         F1              Quit.    The  Quit  command  allows  the user to stop
  731.         F1                                                                   
  732.                         ____                                                 
  733.                         editing the current file, save it, initialize editing
  734.                         of  a  different file, and/or exit EDIT and return to
  735.                         DOS.  In response to the prompt for this command, the
  736.                         user should select the desired subcommand by pressing
  737.                         a single key, as follows:
  738.                     
  739.                         E.  Quit-Exit.  This subcommand  writes  the  current
  740.                             _________                                        
  741.                             contents  of the editing buffer to the file being
  742.                             edited and then exits EDIT to DOS.  This  is  the
  743.                             normal  way  to  exit  EDIT, saving the work done
  744.                             while editing a file.
  745.                                             
  746.                         U.  Quit-Update.  This subcommand simply  writes  out
  747.                             ___________                                      
  748.                             the  buffer  contents  to  the file, but does not
  749.                             exit to DOS.  This subcommand, together with  the
  750.                             Initialize  subcommand,  is  used  when  the user
  751.                             wants to edit several files, one  after  another,
  752.                             without leaving EDIT.
  753.                                             
  754.                         W.  Quit-Write.   This subcommand prompts the user to
  755.                             __________                                       
  756.                             enter the name of a file.  The  contents  of  the
  757.                             editing  buffer  will be saved in the file.  This
  758.                             subcommand is used to save the work while in EDIT
  759.                             in  a  file  other  that the file currently being
  760.                             edited.
  761.                         
  762.                         A.  Quit-Abort.   This  subcommand  directs  EDIT  to
  763.                             __________                                       
  764.                             simply exit to DOS.
  765.                                             
  766.                         S.  Quit-Save-Settings.    This subcommand allows the
  767.                             __________________                               
  768.                             user to save in a file the current values of  the
  769.                             settings  that  affect editing and printing.  The
  770.                             settings are saved in a form so that they can  be
  771.                             read  by  the  "Get  Settings  from file" command
  772.                             described above.
  773.                     
  774.  
  775.  
  776.  
  777.  
  778.                                   EDIT Users Manual                          
  779.         Commands                                                         3-12
  780.  
  781.  
  782.                             This subcommand prompts the  user  to  enter  the
  783.                             name  of  a  file in which the settings are to be
  784.                             saved.  The default name for  this  file  is  the
  785.                             same  name  as  the  file currently being edited,
  786.                             except that the extension is  changed  to  "SET".
  787.                             
  788.                             After  the  user  has entered the file name, EDIT
  789.                             prompts  the  user  to  select  which  group   of
  790.                             settings  should  be  saved  in  the  file.    In
  791.                             response to this prompt, the user should enter  a
  792.                             single key, as follows:
  793.                     
  794.                             F.  The  settings  that  affect  the  file  being
  795.                                 edited are saved in the file.
  796.                     
  797.                             E.  The settings that  only  affect  the  editing
  798.                                 environment are saved in the file.
  799.                     
  800.                             After the user has selected one group of settings
  801.                             to be saved, EDIT will  continue  to  prompt  the
  802.                             user to select the other groups that have not yet
  803.                             been saved.  If the user types any  other  single
  804.                             key, EDIT will leave the Save Settings command.
  805.                     
  806.                             The Set command (described above) specifies which
  807.                             settings belong to each of these  two  groups  of
  808.                             settings.
  809.                     
  810.                             Note  that  EDIT  uses certain naming conventions
  811.                             for the files in which settings are saved.  These
  812.                             conventions     determine    when    EDIT    will
  813.                             automatically retrieve the settings from a  file.
  814.                             
  815.                         I.  Quit-Initialize.    This  subcommand  prompts the
  816.                             _______________                                  
  817.                             user to type the name of a file.   This  text  in
  818.                             the  file  is then loaded into the editing buffer
  819.                             (replacing the previous buffer contents) and  the
  820.                             cursor is placed at the beginning of the file.
  821.                     
  822.                             After  EDIT reads the file, it will also look for
  823.                             a  "setting  file"  that  gives   tab   settings,
  824.                             margins, page length specifications, headers, and
  825.                             such.  The Quit-Save-Settings subcommand,  above,
  826.                             describes  the format of "setting files", and how
  827.                             to create them.
  828.                     
  829.                             The following example illustrates the rules  EDIT
  830.                             follows when it automatically retrieves a Setting
  831.                             file.  Suppose the user specifies  the  following
  832.                             file to edit with the Quit-Initialize command:
  833.                     
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                   EDIT Users Manual                          
  840.         Commands                                                         3-13
  841.  
  842.  
  843.                                 b:memo.txt
  844.                     
  845.                             After reading "memo.txt" from drive "b" EDIT will
  846.                             look to see if it can find the file
  847.                     
  848.                                 b:memo.set
  849.                     
  850.                             If this file exists, EDIT will read the  settings
  851.                             from  this file.  Otherwise, it will look for the
  852.                             file
  853.                     
  854.                                 txt.set
  855.                     
  856.                             If this file exists, EDIT will read the  settings
  857.                             from this file.
  858.                     
  859.                             Thus,  the  settings  that  apply to a particular
  860.                             file should be saved in a file with the same name
  861.                             as  that  file, but with the extension changed to
  862.                             ".set".  This setting file should reside  on  the
  863.                             same drive as the file to which it applies.
  864.                     
  865.                             However,  the  user  may  use a single, "generic"
  866.                             setting file for all the files  having  the  same
  867.                             extension.    This  "generic" setting file should
  868.                             reside  on  the  current  default  drive.     For
  869.                             example, the user could create the setting files
  870.                     
  871.                                 rep.set
  872.                                 mem.set
  873.                     
  874.                             The  first file might contain settings specifying
  875.                             margins, page length, and such for  reports,  and
  876.                             the second file might contain settings for memos.
  877.                             Then the user would name all files  that  contain
  878.                             reports with the extension
  879.                     
  880.                                 .rep
  881.                     
  882.                             and  all  files  containing  memos would be named
  883.                             with the extension
  884.                     
  885.                                 .mem
  886.                     
  887.                             The following would be  example  names  of  files
  888.                             containing reports:
  889.                     
  890.                                 a:yearend.rep
  891.                                 january.rep
  892.                     
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.                                   EDIT Users Manual                          
  900.         Commands                                                         3-14
  901.  
  902.  
  903.                             Sample names of files containing memos might be:
  904.                     
  905.                                 bill.mem
  906.                                 b:staff.mem
  907.                     
  908.                     
  909.                             Note   that   EDIT  will  automatically  retrieve
  910.                             settings from a setting file when Edit  is  first
  911.                             started  from  DOS,  not  just when a new file is
  912.                             specified for  editing  via  the  Quit-Initialize
  913.                             command.
  914.                                             
  915.                         If  the  user  selects the Initialize or Abort option
  916.                         and the contents of the  buffer  have  been  modified
  917.                         without saving them or the current file settings have
  918.                         been modified without saving them, EDIT will  display
  919.                         one or both of the following two messages:
  920.         
  921.                             File  settings  modified.   Okay to lose changes?
  922.                             Select (Yes or No):
  923.                                         
  924.                             Text is modified.  Okay to lose changes?   Select
  925.                             (Yes or No):
  926.                                         
  927.                         If  the user selects yes (by typing "Y" or "y"), then
  928.                         the Initialize or Abort operation will proceed.    If
  929.                         the  user types anything else, the operation will not
  930.                         proceed, and EDIT will go back to the  Quit  command.
  931.                         This  gives  the user another chance to save the work
  932.                         he has done before losing it.
  933.                     
  934.                         
  935.         3.5.  Miscelleneous Word Processing and Printing
  936.         3.5.  Miscelleneous Word Processing and Printing
  937.                     
  938.         Command Key     Command Description
  939.         Command Key     Command Description
  940.         ___________     ___________________
  941.  
  942.         Shift-PrtSc     Print.  The  Print  command  is  used  to  produce  a
  943.         Shift-PrtSc                                                          
  944.                         _____                                                
  945.                         printed  version  of  the file currently being edited
  946.                         (the contents of the editing buffer).    The  current
  947.                         settings  (explained  in  section  3.3) determine how
  948.                         EDIT will break the printed file into pages,  whether
  949.                         it will right justify lines, and such.
  950.                     
  951.                         The print command allows the user to specify that the
  952.                         printed output should go to a file  or  device  other
  953.                         than  the  standard  printer device (PRN:).  The user
  954.                         may want to print to a file for one of  two  reasons.
  955.                         First, the "printed" file will be divided into pages,
  956.                         with headers and  footers,  and  possibly  justified.
  957.                         Thus,  the  user can look at the file to see if it is
  958.                         formatted exactly the way he  wants  before  actually
  959.                         printing  it  on the printer.  Also, the user can use
  960.                         the DOS 2.0 PRINT command to  print  the  file  as  a
  961.                         background  task,  and  continue  to  use EDIT in the
  962.  
  963.  
  964.                                   EDIT Users Manual                          
  965.         Commands                                                         3-15
  966.  
  967.  
  968.                         foreground.
  969.                     
  970.                         The Print command also allows the user to specify the
  971.                         starting  page  and  maximum last page to print.  The
  972.                         default starting page  is  generally  page  1.    The
  973.                         default  last  page is page 9999 (or the last page of
  974.                         the file, whichever comes first).    This  is  useful
  975.                         when  one  or  two  minor changes have been made to a
  976.                         file after it has  already  been  printed,  since  it
  977.                         allows  the  user to print only those pages that have
  978.                         changed.
  979.                     
  980.                         EDIT prompts the user for each of  these  options  by
  981.                         displaying  the  current  default for the option.  To
  982.                         use the default, the user should  just  press  Enter.
  983.                                                                        Enter 
  984.                         To  select  a  value other than the default, the user
  985.                         should type the new value and then press Enter.    To
  986.                                                                  Enter       
  987.                         cancel  the  Print  command,  the  user may type Esc.
  988.                                                                          Esc 
  989.                         After all three options have been selected, EDIT will
  990.                         display the message
  991.                     
  992.                             Printing to: file-or-device
  993.                                          file-or-device
  994.                     
  995.                         and  begin  printing.   As each page is printed, EDIT
  996.                         will display the message
  997.  
  998.                             Page: #
  999.                                   #
  1000.  
  1001.                         to the right of the file-or-device name.
  1002.                                             file-or-device      
  1003.  
  1004.                         The user may abort the Print  command  after  it  has
  1005.                         started by typing Ctrl-Break.
  1006.                                           Ctrl Break 
  1007.  
  1008.  
  1009.                         Note  that  under  version  2.0 (or later) of DOS, it
  1010.                         possible to use the System command to print files  in
  1011.                         the  background  while continuing to edit other files
  1012.                         using EDIT.  The following is the recommended way  to
  1013.                         this:
  1014.  
  1015.                         -   Before   starting   EDIT,  enter  the  DOS  PRINT
  1016.                             command.    This  causes  the  background   print
  1017.                             program  to  be  loaded into memory so that it is
  1018.                             accessible to EDIT.  A convenient way to this  is
  1019.                             to  put  the PRINT command in the AUTOEXEC.BAT so
  1020.                             that it will be automatically executed  when  the
  1021.                             computer  is turned on.  The following line in an
  1022.                             AUTOEXEC.BAT file will accomplish this:
  1023.  
  1024.                                 print
  1025.                                 print
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.                                   EDIT Users Manual                          
  1033.         Commands                                                         3-16
  1034.  
  1035.  
  1036.                         -   Use EDIT's Print command to print to a file.  For
  1037.                             example, when editing the file memo.txt, the user
  1038.                                                            memo.txt          
  1039.                             may want to print to a file named memo.prn.
  1040.                                                               memo.prn 
  1041.  
  1042.                         -   After EDIT has finished creating the print  file,
  1043.                             use  EDIT's  System command to start printing the
  1044.                             print file in  the  background.    The  following
  1045.                             command  would print the file created in the last
  1046.                             example:
  1047.  
  1048.                                 Command: print memo.prn
  1049.                                          print memo.prn
  1050.  
  1051.                         -   It is then possible to continue working with EDIT
  1052.                             while the file prints in the background.
  1053.  
  1054.                         Note  that  EDIT's  System  command  is  explained in
  1055.                         section 3.8, below.
  1056.  
  1057.         Alt-W           Toggle Word-processing mode.    This  command  causes
  1058.         Alt-W                                                                
  1059.                         ___________________________                          
  1060.                         EDIT  to  change  the  Word-Processing  mode  without
  1061.                         having  to   use   the   Set   command.      If   the
  1062.                         Word-Processing mode is currently "Yes", this command
  1063.                         will switch the Word-Processing  mode  to  "No",  and
  1064.                         vice  versa.   The effect of the Word-Processing mode
  1065.                         is explained above, in section  3.3,  under  the  Set
  1066.                         command, and in section 3.1, under the Enter command.
  1067.                                                                Enter         
  1068.                     
  1069.                         The current Word-processing mode setting is indicated
  1070.                         on the staus line.
  1071.                     
  1072.         Alt-P           Paragraph.  Reformat the current paragraph using  the
  1073.         Alt-P                                                                
  1074.                         _________                                            
  1075.                         current  left, indent, and right margin values.  Note
  1076.                         that the end of  a  paragraph  is  indicated  by  the
  1077.                         carriage  return  which  is inserted into the text by
  1078.                         typing Enter.
  1079.                                Enter 
  1080.                     
  1081.         Alt-C           Center.  Reformat the current  line  so  that  it  is
  1082.         Alt-C                                                                
  1083.                         ______                                               
  1084.                         centered between the current left and right margins.
  1085.                     
  1086.         Alt-R           Right-justify  line.    Expand  or  shrink  the  line
  1087.         Alt-R                                                                
  1088.                         ___________________                                  
  1089.                         containing the cursor so that it is  flush  with  the
  1090.                         right  margin.   The expansion or contraction is made
  1091.                         by expanding only the character left of  the  cursor.
  1092.                         All   other   characters  in  the  line  will  remain
  1093.                         unchanged.   Note that for most uses of this  command
  1094.                         (a  table  of  contents,  for  example) the character
  1095.                         expanded or contracted will be either a  space  or  a
  1096.                         period (".").
  1097.                     
  1098.         Alt-B           Toggle boldface on/off.  This command allows the user
  1099.         Alt-B                                                                
  1100.                         ______________________                               
  1101.                         to indicate whether text should be boldface  or  not.
  1102.                         Initially  all text entered is "normal text", neither
  1103.                         boldface nor underlined.  When the Alt-B  command  is
  1104.                                                            Alt-B             
  1105.                         given,  all  text  entered  will  be boldface until a
  1106.  
  1107.  
  1108.                                   EDIT Users Manual                          
  1109.         Commands                                                         3-17
  1110.  
  1111.  
  1112.                         subsequent Alt-B command is given.    When  the  user
  1113.                                    Alt-B                                     
  1114.                         turns  the  boldface option on, EDIT actually inserts
  1115.                         two special characters into the  text,  a  Control-B,
  1116.                         which turns boldface on, and a Control-A, which turns
  1117.                         boldface off.  The user may  also  insert  or  delete
  1118.                         either  of  these  two  characters directly to change
  1119.                         change whether existing text is  to  be  boldface  or
  1120.                         not.    Boldface  is also turned off automatically at
  1121.                         the end of a paragraph.
  1122.  
  1123.                         Whenever the cursor is a  region  of  boldface  text,
  1124.                         EDIT  indicates  this by displaying the letter "B" on
  1125.                         the status line, just  left  of  the  Word-Processing
  1126.                         mode indicator.
  1127.  
  1128.         Alt-U           Toggle  underline  on/off.    This  command functions
  1129.         Alt-U                                                                
  1130.                         _________________________                            
  1131.                         similar to the the  Alt-B  command,  except  that  it
  1132.                                             Alt-B                            
  1133.                         turns  underlining on or off.  The special characters
  1134.                         EDIT  stores  in  the  text  for   underlining   are:
  1135.                         Control-D (for underline) to turn underlining on, and
  1136.                                          d                                   
  1137.                         Control-C to turn underlining off.    Like  boldface,
  1138.                         underlining is automatically turned off at the end of
  1139.                         a paragraph.  When the  cursor  is  in  a  region  of
  1140.                         underlined  text,  EDIT  indicates this by displaying
  1141.                         the letter "U" on the status line, adjacent to  where
  1142.                         the boldface status is displayed.
  1143.  
  1144.  
  1145.         3.6.  Block Commands:  Save, Delete, Get, and Move Text
  1146.         3.6.  Block Commands:  Save, Delete, Get, and Move Text
  1147.                     
  1148.         Command Key     Command Description
  1149.         Command Key     Command Description
  1150.         ___________     ___________________
  1151.  
  1152.         F7              Mark  block.    Mark  the  character  at  the  cursor
  1153.         F7                                                                   
  1154.                         ___________                                          
  1155.                         position as one  end  of  a  block  of  text.    This
  1156.                         "marked"  character  is used to indicate one end of a
  1157.                         block of  text  for  the  Delete  and  Save  commands
  1158.                         described  below.    The  block  is defined to always
  1159.                         consist of the characters between the last  character
  1160.                         marked   and   the  current  cursor  position.    For
  1161.                         convenience in describing the  commands  below,  this
  1162.                         region of text is refered to as "the marked text".
  1163.                     
  1164.         F9              Delete  and save block.  If less than 2000 characters
  1165.         F9                                                                   
  1166.                         ______________________                               
  1167.                         are in the marked text, delete all  those  characters
  1168.                         and save them in a special buffer (the block buffer).
  1169.                         If there  are  more  than  2000  characters  print  a
  1170.                         message indicating that there is not room to save the
  1171.                         deleted characters and do not delete them.
  1172.                     
  1173.         Shift-F9        Delete block without saving.  Delete  all  characters
  1174.         Shift-F9                                                             
  1175.                         ___________________________                          
  1176.                         in  the  marked  text  (regardless  of how many there
  1177.                         are).  The characters will not be saved.
  1178.  
  1179.  
  1180.  
  1181.  
  1182.                                   EDIT Users Manual                          
  1183.         Commands                                                         3-18
  1184.  
  1185.  
  1186.                     
  1187.         F10             Save block.  If there are less than  2000  characters
  1188.         F10                                                                  
  1189.                         __________                                           
  1190.                         in  the  marked  text,  copy  them  into  the  "block
  1191.                         buffer".  Otherwise, print a message indicating  that
  1192.                         there is not room to save the characters.
  1193.                     
  1194.         Shift-F10       Save  block  in  file.  Enter the name of a file into
  1195.         Shift-F10                                                            
  1196.                         _____________________                                
  1197.                         which the marked text is to be saved.  A copy of  the
  1198.                         marked text is then saved in the file.
  1199.                     
  1200.         F8              Get  block.  Insert the current contents of the block
  1201.         F8                                                                   
  1202.                         __________                                           
  1203.                         buffer at the cursor position, leaving the cursor  at
  1204.                         the beginning of the inserted text.
  1205.                     
  1206.         Shift-F8        Get  block from file.  Enter the name of a file.  The
  1207.         Shift-F8                                                             
  1208.                         ____________________                                 
  1209.                         contents of that file are inserted into the buffer at
  1210.                         the  current  cursor  position, leaving the cursor at
  1211.                         the beginning of the inserted text.
  1212.                     
  1213.                         Note that a "block  move"  may  be  accomplished  for
  1214.                         small  blocks  by  the  Delete and Save command, then
  1215.                         moving the cursor to the new location and  using  the
  1216.                         Get command.  For blocks larger than 2000 characters,
  1217.                         a block move is done by Save in File, Delete  without
  1218.                         saving,  moving  the  cursor to the new position, and
  1219.                         then Get from file.
  1220.                     
  1221.  
  1222.         3.7.  GoTo, Find, and Replace
  1223.         3.7.  GoTo, Find, and Replace
  1224.                     
  1225.         Command Key     Command Description
  1226.         Command Key     Command Description
  1227.         ___________     ___________________
  1228.  
  1229.         Shift-num-pad-5 GoTo.  The GoTo command allows the user to  move  the
  1230.         Shift-num-pad-5                                                      
  1231.                         ____                                                 
  1232.                         cursor  directly  to  a  position  in the file.  EDIT
  1233.                         prompts the user to select from one of the  following
  1234.                         options:
  1235.                     
  1236.                         B.  Goto  beginning of file.  The cursor will be move
  1237.                             _______________________                          
  1238.                             to the beginning of the file.
  1239.                                             
  1240.                         E.  Goto end of file.  The cursor will  be  moved  to
  1241.                             ________________                                 
  1242.                             the end of the file.
  1243.                                             
  1244.                         L.  Goto  line.    The  user  may  enter  an positive
  1245.                             __________                                       
  1246.                             integer value.  The cursor will be moved to  that
  1247.                             line  in  the  file.   The column position of the
  1248.                             cursor is not changed.  Specifying a line  beyond
  1249.                             the  end  of the file will move the cursor to the
  1250.                             end of the file.
  1251.                                             
  1252.                         C.  Goto column.   The  user  may  enter  a  positive
  1253.                             ___________                                      
  1254.                             integer  value.  The cursor will be moved to that
  1255.                             column in the current line.  Specifying a  column
  1256.                             beyond  the  end of the line will move the cursor
  1257.                             to the end of the line.
  1258.  
  1259.  
  1260.                                   EDIT Users Manual                          
  1261.         Commands                                                         3-19
  1262.  
  1263.  
  1264.                                             
  1265.                             Note that the GoTo  command  is  located  in  the
  1266.                             center  of the cursor control keys (right between
  1267.                             the left and right keys).  Thus,  althougth  this
  1268.                                 left     right                               
  1269.                             key   is  not  labeled,  it  should  be  easy  to
  1270.                             remember, since it allows the user to "center in"
  1271.                             on a particular position in the file.
  1272.                     
  1273.         F6              Find.   Enter a target string.  Type Enter at the end
  1274.         F6                                                   Enter           
  1275.                         ____                                                 
  1276.                         of the string  to  enter  it  and  execute  the  Find
  1277.                         command.   EDIT will search for the first instance of
  1278.                         the target string following the cursor and  move  the
  1279.                         cursor to the first character after that string.
  1280.                     
  1281.                         During  string  entry, typing Esc will abort the Find
  1282.                                                       Esc                    
  1283.                         command.
  1284.                     
  1285.         Shift-F6        Reverse Find.  This command is exactly  the  same  as
  1286.         Shift-F6                                                             
  1287.                         ____________                                         
  1288.                         the  "find"  command,  execpt  that  EDIT will search
  1289.                         backwards for the first instance of the target string
  1290.                         preceeding the cursor.
  1291.                     
  1292.         F5              Replace.    Enter a target string, then a replacement
  1293.         F5                                                                   
  1294.                         _______                                              
  1295.                         string.  EDIT will execute  the  Replace  command  as
  1296.                         soon  as  the  second string is entered, by searching
  1297.                         for the first instance of the target string following
  1298.                         the  cursor  and  replacing  it  with the replacement
  1299.                         string.
  1300.                     
  1301.         Shift-F5        Conditional Replace.  Enter a target string,  then  a
  1302.         Shift-F5                                                             
  1303.                         ___________________                                  
  1304.                         replacement  string, as in the Replace command. After
  1305.                         the second string has been entered, EDIT will  search
  1306.                         for the first instance of the target string following
  1307.                         the  cursor,  and  move  the  cursor  to  the   first
  1308.                         character  after  that string.  EDIT will then prompt
  1309.                         the user to select from the following set of options:
  1310.                     
  1311.                         Y.  Yes.  The target string should be replaced by the
  1312.                             replacement string.
  1313.                                             
  1314.                         N.  No.   The target string should not be replaced by
  1315.                             the replacement string.
  1316.                                             
  1317.                         S.  Stop.  The target string should  be  replaced  by
  1318.                             the  replacement string.  Then EDIT will exit the
  1319.                             conditional replacement command.
  1320.                                             
  1321.                         A.  Abort.  The target string  is  not  replaced  and
  1322.                             EDIT   will   exit  the  conditional  replacement
  1323.                             command.
  1324.                                             
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.                                   EDIT Users Manual                          
  1332.         Commands                                                         3-20
  1333.  
  1334.  
  1335.                         Note that the Stop and Abort options are designed for
  1336.                         use  with  a  repeat count applied to the conditional
  1337.                         replacement command.
  1338.                     
  1339.                     
  1340.         3.8.  Miscelleneous Commands:  Help, Macros, and DOS Commands
  1341.         3.8.  Miscelleneous Commands:  Help, Macros, and DOS Commands
  1342.                     
  1343.         Command Key     Command Description
  1344.         Command Key     Command Description
  1345.         ___________     ___________________
  1346.  
  1347.         F2              Help.  This command allows the user to view a a  file
  1348.         F2                                                                   
  1349.                         ____                                                 
  1350.                         of  "help"  information.  This information lists each
  1351.                         EDIT command, together with a  brief  description  of
  1352.                         what  it  does.    Subcommands and options are listed
  1353.                         indented under each command.   The  information  also
  1354.                         describes  briefly  any  values that the commands may
  1355.                         require the user to  enter,  and  what  those  values
  1356.                         mean.
  1357.                     
  1358.                         The  information  in  the  Help file is displayed one
  1359.                         page at a time.  To view the next page  of  the  help
  1360.                         list, the user may press the space bar.  To abort the
  1361.                         Help command and return to EDIT's  normal  operation,
  1362.                         the user may type any other key.
  1363.                     
  1364.                         As the first screen of the Help text, EDIT displays a
  1365.                         message regarding EDIT's  status  as  free  software.
  1366.                         The actual Help text follows this first screen.
  1367.  
  1368.                         Note that EDIT obtains the information it displays in
  1369.                         the Help command from a file called "EDIT.HLP".   For
  1370.                         the  Help command to operate properly, this file must
  1371.                         be on  the  current  "default"  disk  while  EDIT  is
  1372.                         running.    For  an explanation of default disks, the
  1373.                         user should refer to the  documentation  provided  by
  1374.                         IBM.
  1375.                     
  1376.         Alt-H           Help  menu.    Turn  on/off  the function key prompts
  1377.         Alt-H                                                                
  1378.                         __________                                           
  1379.                         printed on EDIT's prompt line.
  1380.                             
  1381.         Shift-F4        Macro define.  Start or end a macro definition.  When
  1382.         Shift-F4                                                             
  1383.                         ____________                                         
  1384.                         a  macro  definition is started, "Macro" is displayed
  1385.                         near the right side of the bottom line on the screen.
  1386.                         All   subsequent   commands  up  to  the  next  Macro
  1387.                         Shift-F4 command are  saved  in  a  macro  buffer  in
  1388.                         Shift-F4                                             
  1389.                         addition to being executed.
  1390.                     
  1391.                         Typing  Shift-F4 again ends the macro definition, and
  1392.                                 Shift-F4                                     
  1393.                         erases "Macro" from the bottom line  of  the  screen.
  1394.                         The  sequence  of commands may then be re-executed by
  1395.                         typing F4.
  1396.                                F4 
  1397.                     
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.                                   EDIT Users Manual                          
  1404.         Commands                                                         3-21
  1405.  
  1406.  
  1407.         F4              Macro Execute.    Execute  the  macro  most  recently
  1408.         F4                                                                   
  1409.                         _____________                                        
  1410.                         defined  via  the Macro command.  Prior to defining a
  1411.                         macro, the current macro is null.
  1412.  
  1413.         Alt-V           View.  Redisplay the contents of the screen with  the
  1414.         Alt-V                                                                
  1415.                         ____                                                 
  1416.                         line  containing  the  cursor centered on the screen,
  1417.                         and the current version number of EDIT  displayed  on
  1418.                         the  message  line.  If the cursor is in the first 12
  1419.                         lines of the file or it is already  centered  on  the
  1420.                         screen,  then  the  contents  of  the screen will not
  1421.                         change.
  1422.                     
  1423.         Shift-F1        System Command.  This  command  allows  the  user  to
  1424.         Shift-F1                                                             
  1425.                         ______________                                       
  1426.                         execute  any DOS command from EDIT.  EDIT prompts the
  1427.                         the user to enter a command.  The user  should  enter
  1428.                         the  command  exactly  as  it  would  be  entered  in
  1429.                         response to the DOS prompt.   After  the  command  is
  1430.                         entered,  EDIT clears the screen and executes the DOS
  1431.                         command.    When  the  command  has  completed,  EDIT
  1432.                         prompts  the user to press any key to return to EDIT.
  1433.                         Then EDIT  restores  the  screen  as  it  was  before
  1434.                         executing  the  DOS command and the user can continue
  1435.                         editing.
  1436.  
  1437.                         The following examples illustrate the use  of  EDIT's
  1438.                         System command:
  1439.  
  1440.                             Command: dir *.txt
  1441.                                      dir *.txt
  1442.  
  1443.                             Command: print chap1.prn
  1444.                                      print chap1.prn
  1445.  
  1446.                             Command: cd \memos
  1447.                                      cd \memos
  1448.  
  1449.                             Command: rename memo1.txt memo1.bak
  1450.                                      rename memo1.txt memo1.bak
  1451.  
  1452.                         Note  that EDIT only supports the System command with
  1453.                         DOS version 2.0 or later.  In order  for  the  System
  1454.                         DOS version 2.0 or later                             
  1455.                         command  to work, there should be about 128K bytes of
  1456.                         free memory before running  EDIT.    Some  additional
  1457.                         memory  may  be  required to execute non-resident DOS
  1458.                         commands from EDIT.  It is necessary to have  a  copy
  1459.                         of  COMMAND.COM  in the root directory of the current
  1460.                         default device in order for  the  System  command  to
  1461.                         work.
  1462.  
  1463.                         Caution:    Certain  DOS  commands  stay  resident in
  1464.                         Caution:                                             
  1465.                         memory when they are first  executed  after  DOS  has
  1466.                         been  started.    The DOS PRINT and GRAPHICS commands
  1467.                         are in this category.  It is not good to execute such
  1468.                         commands  for  the  first  time  from  EDIT.  This is
  1469.                         because they reserve not only  the  memory  they  use
  1470.                         themselves,  but also the memory of any other program
  1471.                         that is currently executing (like EDIT), even if that
  1472.                         program  normally releases the memory it uses when it
  1473.  
  1474.  
  1475.                                   EDIT Users Manual                          
  1476.         Commands                                                         3-22
  1477.  
  1478.  
  1479.                         exits.  Before using such commands  from  EDIT,  they
  1480.                         should  be  executed before EDIT is started.  Putting
  1481.                         them in the AUTOEXEC.BAT file is one way to do this.
  1482.  
  1483.                         For a further explanation of DOS commands,  the  user
  1484.                         should consult the DOS reference manual.
  1485.  
  1486.         
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.                                   EDIT Users Manual                          
  1537.