Help version: 11 february 1993

                                 xwe
                       a public domain editor    
                          by Dov Grobgeld
                     The Weizmann Instite of Science       

THE RESOURCE FILE

  Before any customization can be carried out you should copy the 
  /usr/local/lib/wafe/system.waferc file to a .waferc file in your
  home directory.

  This file is a general customization file for all wafe applications.
  

FONTS

   Change the four variables $normalFont, $boldFont, $buttonFont, and
   $textFont. 
   
   E.g. to declare all of these fonts to be 'rom10.iso1':
   
      $normalFont = 'font rom10.iso1';
      $boldFont =   $normalFont;
      $buttonFont = $normalFont;
      $textFont =   $normalFont;
   
   Note that the keyword 'font' is needed in the declarations.
   
   
COLORS
   
   The $opt_c variable determines the colors used. You may hardwire
   it to any of your preferences. E.g.
   
      $opt_c = 'bisque-ish';
      
   which will make all colors different nuances of bisque.
   

KEY BINDINGS

  Keybindings are declared in the file .waferc under the variable 
  @genericTextActions. 
  
  A list of all available actions, will eventually be written.
  
  Here is a list of the default keybindings:
  
    Ctrl<Key>A: beginning-of-line() 
    Ctrl<Key>B: backward-character() 
    Ctrl<Key>D: delete-next-character() 
    Ctrl<Key>E: end-of-line() 
    Ctrl<Key>F: forward-character() 
    Ctrl<Key>G: multiply(Reset) 
    Ctrl<Key>H: delete-previous-character() 
    Ctrl<Key>J: newline-and-indent() 
    Ctrl<Key>K: kill-to-end-of-line() 
    Ctrl<Key>L: redraw-display() 
    Ctrl<Key>M: newline() 
    Ctrl<Key>N: next-line() 
    Ctrl<Key>O: newline-and-backup() 
    Ctrl<Key>P: previous-line() 
    Ctrl<Key>R: search(backward) 
    Ctrl<Key>S: search(forward) 
    Ctrl<Key>T: transpose-characters() 
    Ctrl<Key>U: multiply(4) 
    Ctrl<Key>V: next-page() 
    Ctrl<Key>W: kill-selection() 
    Ctrl<Key>Y: insert-selection(CUT_BUFFER1) 
    Ctrl<Key>Z: scroll-one-line-up()) 
    <Key>Right:forward-character()
    <Key>Left: backward-character()
    <Key>Down: next-line()
    <Key>Up: previous-line()
    <Key>Delete: delete-previous-character()
    <Key>BackSpace: delete-previous-character()
    <Key>Linefeed: newline-and-indent()
    <Key>Return: newline()
    <Key>: insert-char() 
  
  Example of how to declare a keybinding. Add the following line
  to the lines in the declaration of @genericTextActions: 

     @genericTextActions = (
        .... # lines deleted  
         "Ctrl<Key>Prior : beginning-of-file()",
     );    
    
  
XWE COMMANDS BINDINGS
  
  In order to bind a command to keybinding that are specific to xwe
  (and not valid for other wafe applications) you may use the special
  keyword @xweTextActions in your .waferc file. 
  
  E.g. to bind Alt-C to do the latex command put the following into 
  your .waferc file:
  
  @xweTextActions = (
    "$meta<Key>c: exec(echo command:latex)",
    );
  

PCMD BINDINGS

  There are also a set of commands called the pcmd commands, that 
  are general for all wafe applications. They may be bound with the
  following actions:
  
  @generalTextActions = (
     ...  # stuff deleted
     "Shift<Key>F7: exec(echo pcmd:unindent %w)",
     "Shift<Key>F8: exec(echo pcmd:indent %w)",
    );
    
  Note that the "%w" is necessary for these actions to tell wafe in
  which widget the action occured.
  
  The PCMD commands supported are described below.


XWE COMMANDS

  Commands are entered in the command line, below the editor window.
  To write a command, you may either move the mouse cursor to the command
  line, or press the escape button.
  
  The last command in the command line may be repeated by pressing
  Shift-Enter.
  
  The current commands supported are:
  
  /foo      Searches for the next occurance of the string 'foo'.
  
  latex     Latexes selection or the whole file if no selection is active..
  
  s/a/b/    Invokes the perl 's///' command on the current selection.
            It is equivalent to piping the current selection through
            the pipe:
              
              | perl -pe 's/a/b/'
              
            options may be added to the end. E.g. 's/a/b/g'. The options
            are the standard perl options:
             
               g  global change. Change all occurences on all lines. Without
                  this option, only the first occurence is changed.
               i  Case insensitive search.
              
  |foo      Runs the current selection through the external pipe foo
            and replaces the selection with the output of the pipe.
            
  p|foo     Equal to 
  
              | perl -pe 'foo'
              
            but faster since no external process has to be started.
            
  >foo      Save the current selection in the file foo.
  

PCMD COMMANDS

   pcmd commands are only available by keybindings as described above.
   The pcmd commands currently supported are:
   
      indent -  indent the current selection four spaces
      unindent - unindent the current selection four spaces