ECCE(I)                      12/01/88                      ECCE(I)
 
 NAME 
      ecce - Edinburgh compatible context editor
 
 SYNOPSIS
      ecce filename
 
 DESCRIPTION
      The Edinburgh context editor  provides  many  facilities  for
      making alterations to text files.   The operation of the edi-
      tor  is directed  by a series of commands which are typed on-
      line  by  the user.   Each  command line consists of a single
      command  or  a sequence of several commands  terminated  by a
      newline.  No command separator is required between individual
      commands and unquoted spaces are not significant.   The indi-
      vidual commands in a command  sequence are executed from left
      to right.  The basic editing commands  consist of a letter or
      a letter followed by a text string.    The letter is mnemonic
      for an imperative verb.   The  text  string  is  any sequence
      of characters ( excluding newline ) enclosed within quotation
      marks.  Any command may be followed by a repetition number to
      indicate  that  the  command is to be executed repeatedly the
      number of times specified.    Compound commands may be formed
      by enclosing a sequence of commands within parentheses.
 
      Basic commands
      ==============
      m{n}                move to next line                       1
      m-{n}               move to previous line                   2
      f{m}'....'{n}       find text                            3,10
      s'....'             substitute text                         4
      g{n}                get line                                5
      k{n}                kill (delete) whole line                1
      i'....'{n}          insert text                             6
      b                   break line (insert newline)
      d{m}'....'{n}       delete text                           3,7
      j                   join (delete next newline)              6
      p{n}                print line                              1
      r{n}                move right                              8
      l{n}                move left                               9
      e{n}                erase right                             8
      e-{n}               erase left                              9
      t{m}'....'{n}       traverse text                         3,7
      u{m}'....'{n}       uncover (delete until) text           3,7
      v'....'             verify (test for) text
 
      Special commands
      ================
      %c                  close ( finish editing)
      %m                  normal monitoring (default)
      %f                  full monitoring
      %q                  quiet (no monitoring)
 






 ECCE(I)                      12/01/88                      ECCE(I)
 
      Failure conditions and notes
      ============================
 
      1                   file pointer at end of file
      2                   current line is first line of file
      3                   text not found
      4                   no text to replace
      5                   entered line begins with a :
      6                   current line too long
      7                   default scope is current line
      8                   file pointer at end of current line
      9                   file pointer at beginning of current line
      10                  default scope is rest of file
 
      m                   scope (number of lines)
      n                   repetition number
      {}                  optional part of command
 
      Sequences of commands may be enclosed in  parentheses to form
      compound commands.
 
      0 or *              indefinite repetition
                          (repeat until failure) e.g.
             r0           move file pointer to end of line
             (mr)0        find first blank line
             e-0          erase backwards to start of line
 
      ?                   optional execution
                          (failure condition is ignored) e.g.
             ((r61p)?m)0  print lines with more than  60 characters
 
      ,                   alternative execution
                          (if first fails,  execute next and so on)
             (r81lb,m)0   split lines with more than  80 characters
 
             (f/print/(v/printstring/,e5i/write/))*         replace
                          print  by  write  except  in  printstring
 
      \                   inverted failure e.g.
             (mv'+'\)0    find next line starting with '+'
                                                                  x
      A  command  line  consisting  solely  of a number repeats the
      previous command line the number of times specified.
 
      Quotation marks     All characters except letters, digits and
                          those which have defined significance may
                          be used, e.g.   " / $ > + .
 
 FILES
      /usr/local/bin/ecce 
      /usr/local/bin/ecce1
 
 AUTHOR
      H. Whitfield, Computing Laboratory, University  of  Newcastle
      upon Tyne, NE1 7RU. This editor  is based upon older versions
      by H. Dewar and others of the Department of Computer Science,
      University of Edinburgh.