epic5 for Debian
----------------

A handfull of miscellaneous notes:

  * Eight bit characters - If you're having trouble typing or seeing eight
    bit characters in epic especially under screen, it's probably because
    one of epic's sets is not set properly.  Try adding to your rc file:

       ^set EIGHT_BIT_CHARACTERS on
       ^set HIGH_BIT_ESCAPE 0

    If that doesn't fix it, the script might be overriding the settings. If
    so, change it at the input prompt and use the script's save command
    (traditionally /save) If that doesn't fix it, take a plastic foam
    rubber object such as a Pool Noodle and proceed to *FWOP!* the author
    of the script mercilessly.

  + Note from <http://www.epicsol.org/> (Jeremy Nelson): due to some
    unfortunate signed-unsigned casting conflicts, it is not possible for
    epic users to input character 255. (...) To work around this
    problem, add this to startup script:
 
    /eval bind $chr(255) parse_command {xtype -l $chr(255)}
    bind ^@ parse_command {xtype -l $chr(255)} 

  + Startup scripts: in absence of ~/.epicrc epic5 would use ~/.ircrc, but
    the primary startup script is the ~/.epicrc or anything that the
    environment variable $EPICRC points to.

  * If you've installed an epic5-script-* package, some default script
    will be run if you have neither ~/.epicrc nor ~/.ircrc files. There are
    a few script packages for epic5 now, have a look at one of them for
    making your own.  examples/wrapper.irc contains the base wrapper to use
    if your script isn't totally global-install-friendly.
  
  + TCL support explicitely disabled until someone needs that. Please
    file a wishlist bug, if you need TCL compiled in.

  + New key binding mechanism: there is completely new key binding
    mechanism in epic 1.1.7. The new mechanism is clear and easy-to-use.
    IT'S ALSO INCOMPATIBLE WITH PREVIOUS VERSIONS. THIS IS NOT A BUG.
    Support for old META-x bindings is removed. Read the
    /usr/share/doc/epic5/keys for more precise information.
    
    In short, what to do if your script suddenly stops working:
    
    Locate something like:
    
      BIND <X> META<N>_CHARACTER
      
    Where <X> is a key binding prefix and <N> is a number, e.g. 1, 2, 3.
    Remove this command or change it to what you like, e.g. you can prevent
    the prefix itself from being interpreted:
    
      BIND ^X NOTHING

    Now, locate all occurences of:
      
      BIND META<N>-<some_key>

    Where <some_key> is the rest of your chosen key binding. Replace all of
    these lines with:
      
      BIND "^X<some_key>"

    The script should work again.

(*) Joseph Carter <knghtbrd@debian.org> Sat, 24 Mar 2001 02:43:08 -0800
(+) Miros/law L. Baran <baran@debian.org> Wed,  2 Oct 2002 21:04:43 +0200

