home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / me34src.zip / me3 / doc / errata < prev    next >
Text File  |  1995-01-14  |  7KB  |  154 lines

  1.                                 -*-text-*-
  2. ========================================================================
  3. ==        ME2 Errata and machine/OS specifics    Craig Durland ==
  4. ========================================================================
  5.         
  6. ========================================================================
  7.             BUGS
  8. ========================================================================
  9. * MS-DOS
  10.     If you install TSRs (terminate and stay resident - things like Side
  11.       Kick) from within ME (ie ^X!  or from a shell invoked by ME) and
  12.       don't exit ME, there is a good chance that sometime later ME will
  13.       not be able to write out files (it will say something like "Error
  14.       closing file").  If this happens, you are screwed - your file is
  15.       cleared from the disk and there is no way you can save it.
  16.       Another symptom is problems allocating memory ("Cannot allocate x
  17.       bytes").  print.com is the only TSR I have verified causing these
  18.       problems but don't press your luck.
  19.       Note: is OK to use TSRs from within ME.  ie using print.com to
  20.       print a file while in ME is OK as long as print was installed
  21.       outside of ME.
  22.     EGA 43 line mode: If you are using nansi.sys, switching into 43 line
  23.       mode and then invoking a shell or running a program (^X!) the cursor
  24.       may disappear.  This is caused by a bug in nansi.sys.  When going
  25.       into 43 line mode it should set 40:87H bit 0 and clear that bit when
  26.       returning to 25 line mode but it don't.
  27. * UNIX
  28.     XON/XOFF can screw things up.  ME turns off XON/XOFF because XON is
  29.       ^S and XOFF is ^Q and most Emacs users are very attached to those
  30.       keys.  This can lead to terminal overruns if the terminal cannot
  31.       keep up at the baud rate selected or there is not enough padding.
  32.       Sometimes the connection to the computer runs though a server
  33.       device that also talks XON/XOFF.  If this is the case ^S will stop
  34.       the display and some times ME will start searching for no apparent
  35.       reason.  Talk to a guru and find out how to fix the server or
  36.       rebind ^S and ^Q to "" and use the alternate keys (^\ and ^^).
  37.  
  38. =========================================================================
  39.         MS-DOS specifics
  40. =========================================================================
  41. * Filenames can contain "/" or "\".  Case is ignored.
  42. * Filename completion may be turned off.  If not, you can use csh like
  43.     wild cards.  See UNIX specifics.
  44. * Strango characters
  45.     MS-DOS ME allows you to enter ^Z or NULL (0) and write out the file but
  46.       a line with NULL in it gets truncated (at the NULL) when read in.
  47.    Some versions allow you to enter a character by typing in its decimal
  48.       value (eg "A" is decimal 65) (see below).  Note that entering most
  49.       keys is like pressing the key on the keyboard so you may want to
  50.       quote (^Q) the character.
  51.     IBM PC: hold down ALT and type the value on the number pad.  The
  52.       character is added when the ALT key is lifted.
  53.     Portable Plus: Put into Num pad mode (Extend Num), hold down Extend and
  54.       press the value on the number pad (the blue numbers).  The character
  55.       is added when the ALT key is lifted.  Now switch back to regular mode
  56.       (Extend Num).  This is easier to do than to say.
  57.  
  58. *Eric Turnblom (turnblom@nature.berkeley.edu) writes:
  59.   On my Amdek monitor, driven by AST HERCULES monochrome graphics
  60.   emulation card, (cursor-shape "1:8") gave me a nice reverse video
  61.   block cursor with the top slightly above the line of text, and the
  62.   bottom slightly below the line of text.
  63. Mark van der Velden adds:
  64.   On my XT (hercules) the scan lines are from 0 to 12.  (cursor-shape
  65.   "8:12") activates exactly scan lines 8 up to 12, which gives a nice
  66.   big underscore.
  67.  
  68.  
  69. ========================================================================
  70.         UNIX specifics
  71. ========================================================================
  72. * You can use csh style wildcards:  ~, [], [^], ?, * (eg ~craig,
  73.     ~/tools, foo[123], foo*, etc) for (insert-file), (read-file),
  74.     (rename-buffer), (visit-file), (write-file) and current-directory.
  75.     Note that ? and " " are also used for filename completion so you
  76.     might want to quote them (C-q?).
  77.   See dir.mut for examples of cwd, dirs, push directory, pop directory.
  78.  
  79. * If you want to input 8 bit text (eg edit European languages) make sure:
  80.   - Your terminal will pass 8 bit data.  You can check this by using
  81.     "stty -a".  Look for "-istrip" (don't set the 8th bit to zero) and
  82.     "cs8" (pass 8 bit data, probably only effects terminals connected to
  83.     serial ports).  To set these, use "stty -istrip cs8".
  84.   - Your keyboard can generate characters with the 8th bit set.
  85.   - Your terminal font character set has the right characters above 127.
  86.     Here is a Mutt program that will put all 255 characters into the
  87.     current buffer.  You can use it to look at your font.
  88.     (include me2.h)
  89.     (include mod.mut)
  90.  
  91.     (defun
  92.       all-the-ASCII-characters
  93.       {
  94.         (int j)
  95.  
  96.         (for (j 1) (< j 256) (+= j 1)
  97.         {
  98.           (insert-text (convert-to CHARACTER j))
  99.           (if (== 0 (mod j 32)) (newline))
  100.         })
  101.       })
  102.  
  103. * Function keys, arrow keys, other termainal specific things.  I don't
  104.   try to parse keys other than the ASCII character set.  Trying to use
  105.   the termcap entries for special keys (function, arrow, etc) has been a
  106.   real pain (especially on HP terminals) and I can never figure out
  107.   everything for all termainals.  So I don't bother.  What I do do is
  108.   parse some of them in Mutt.  xterm.mut parses vt100 and xterms,
  109.   hpterm.mut does HP terminal function keys.
  110.  
  111. ========================================================================
  112.  
  113. ========================================================================
  114. * Screen size:
  115.   Sometimes the same code runs on machines with different screen sizes.
  116.     If this is your case, you'll need to resize the screen.
  117.   For example:
  118.     HP110:  use me150.exe and put (screen-length 16) in your myme file.
  119.     EGA 43 line mode:  If you have a IBM PC, EGA and NANSI.SYS (or some
  120.       other way to get into 43 line mode), ME can use all 43 lines.
  121.       If you are already in 43 line mode: (screen-length 43).
  122.       To switch into 43 line mode: (puts "^[[=43h")(screen-length 43)
  123.       2 handy pgms:
  124.       (defun
  125.     EGA {(puts "^[[=43h")(screen-length 43)}
  126.     noEGA {(puts "^[[=3h")(screen-length 25)}
  127.       )
  128.  
  129. ==================================================================
  130. ==            Philosophy                ==
  131. ==================================================================
  132. * ME should behave the same on every machine it runs on.
  133. * ME is an editing engine:
  134.     The core functionality should allow ME to be used stand alone.  The
  135.       core has been patterned after (a subset of) Emacs (where Emacs is
  136.       usually GNU Emacs and sometimes Unipress (Goslings') Emacs).
  137.     The bells, whistles and features that "personalize" an editor are
  138.       Mutt extensions added by the user.
  139.  
  140. * If you find bugs I want to fix them so let me know.
  141.   If you have enhancement requests or stuff you would like to see added,
  142.     I am interested.
  143.  
  144. Restrictions:
  145.   Distributed under the terms of the GNU General Public License:  Use,
  146.     share, enjoy.
  147.    
  148. * No Warranty - you get what you pay for.
  149.  
  150. * I am:
  151.   Craig Durland       (503) 750-3354
  152.   3419 SW Knollbrook, Corvallis, OR 97333
  153.   craig@cv.hp.com
  154.