home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / me_cd25.zip / DOC.ZIP / ERRATA.DOC < prev    next >
Text File  |  1992-11-09  |  10KB  |  193 lines
  1. ========================================================================
  2. ==        ME2 Errata and machine/OS specifics    Craig Durland ==
  3. ========================================================================
  4.         
  5. ========================================================================
  6.             BUGS
  7. ========================================================================
  8. * MS-DOS
  9.     If you install TSRs (terminate and stay resident - things like Side
  10.       Kick) from within ME (ie ^X!  or from a shell invoked by ME) and
  11.       don't exit ME, there is a good chance that sometime later ME will
  12.       not be able to write out files (it will say something like "Error
  13.       closing file").  If this happens, you are screwed - your file is
  14.       cleared from the disk and there is no way you can save it.
  15.       Another symptom is problems allocating memory ("Cannot allocate x
  16.       bytes").  print.com is the only TSR I have verified causing these
  17.       problems but don't press your luck.
  18.       Note: is OK to use TSRs from within ME.  ie using print.com to
  19.       print a file while in ME is OK as long as print was installed
  20.       outside of ME.
  21.     EGA 43 line mode: If you are using nansi.sys, switching into 43 line
  22.       mode and then invoking a shell or running a program (^X!) the cursor
  23.       may disappear.  This is caused by a bug in nansi.sys.  When going
  24.       into 43 line mode it should set 40:87H bit 0 and clear that bit when
  25.       returning to 25 line mode but it don't.
  26. * UNIX
  27.     XON/XOFF can screw things up.  ME turns off XON/XOFF because XON is
  28.       ^S and XOFF is ^Q and most Emacs users are very attached to those
  29.       keys.  This can lead to terminal overruns if the terminal cannot
  30.       keep up at the baud rate selected or there is not enough padding.
  31.       Sometimes the connection to the computer runs though a server
  32.       device that also talks XON/XOFF.  If this is the case ^S will stop
  33.       the display and some times ME will start searching for no apparent
  34.       reason.  Talk to a guru and find out how to fix the server or
  35.       rebind ^S and ^Q to "" and use the alternate keys (^\ and ^^).
  36.     Softkeys:  Most terminals send escape codes when you press a function
  37.       key or softkey.  This is a problem when the codes overlap valid ME
  38.       user key sequences (eg HP terminals send "ESC B" for down arrow which
  39.       is also the ME sequence for (backward-word)).  The version of ME for
  40.       HP terminals (MEH), trys to tell the difference with timing, however,
  41.       this method if far from foolproof.  To tell if you have a problem,
  42.       type ^X^V (visit-file) and then press a function key (such as down
  43.       arrow) rapidly.  You should see
  44.       F-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-D.  If you don't or see
  45.       something like F-DM-BM-BF-DF-DM-B you have a problem and you have to
  46.       either give up softkeys or the mappings they cover.  Or get a
  47.       "better" terminal.  Regular ME leaves soft key processing to Mutt
  48.       pgms (see vt100.mut for an example).
  49.  
  50. =========================================================================
  51.         MS-DOS specifics
  52. =========================================================================
  53. * Filenames can contain "/" or "\".  Case is ignored.
  54. * Filename completion may be turned off.  If not, you can use csh like
  55.     wild cards.  See UNIX specifics.
  56. * Strango characters
  57.     MS-DOS ME allows you to enter ^Z or NULL (0) and write out the file but
  58.       a line with NULL in it gets truncated (at the NULL) when read in.
  59.    Some versions allow you to enter a character by typing in its decimal
  60.       value (eg "A" is decimal 65) (see below).  Note that entering most
  61.       keys is like pressing the key on the keyboard so you may want to
  62.       quote (^Q) the character.
  63.     IBM PC: hold down ALT and type the value on the number pad.  The
  64.       character is added when the ALT key is lifted.
  65.     Portable Plus: Put into Num pad mode (Extend Num), hold down Extend and
  66.       press the value on the number pad (the blue numbers).  The character
  67.       is added when the ALT key is lifted.  Now switch back to regular mode
  68.       (Extend Num).  This is easier to do than to say.
  69. * Portable Plus version:
  70.   The Clr dsp, +Line and -Line function key are not mapped.
  71. * HP150 version:
  72.   The function keys (f1...f8) don't work unless the user keys are turned
  73.     on AND f1 is programmed to send Normal ESCp, f2 Normal ESCq, ...  f8
  74.     Normal ESCw.  This is because of a bug in the 150.
  75.       This can be done with:
  76.     (puts "^[&f0a1k5d2L   f1^[p") (puts "^[&f0a2k5d2L   f2^[q")
  77.     (puts "^[&f3k0a5d2L   f3^[r") (puts "^[&f4k0a5d2L   f4^[s")
  78.     (puts "^[&f5k0a5d2L   f5^[t") (puts "^[&f6k0a5d2L   f6^[u")
  79.     (puts "^[&f7k0a5d2L   f7^[v") (puts "^[&f8k0a5d2L   f8^[w")
  80.     (puts "^[&jB")
  81.  
  82. ========================================================================
  83.         UNIX specifics
  84. ========================================================================
  85. * You can use csh style wildcards:  ~, [], [^], ?, * (eg ~craig,
  86.     ~/tools, foo[123], foo*, etc) for (insert-file), (read-file),
  87.     (rename-buffer), (visit-file), (write-file) and current-directory.
  88.     Note that ? and " " are also used for filename completion so you
  89.     might want to quote them (^Q?).
  90.   See dir.mut for examples of cwd, dirs, push directory, pop directory.
  91.  
  92. * If you want to input 8 bit text (eg edit European languages) make sure:
  93.   - Your terminal will pass 8 bit data.  You can check this by using
  94.     "stty -a".  Look for "-istrip" (don't set the 8th bit to zero) and
  95.     "cs8" (pass 8 bit data, probably only effects terminals connected to
  96.     serial ports).  To set these, use "stty -istrip cs8".
  97.   - Your keyboard can generate characters with the 8th bit set.
  98.   - Your terminal font character set has the right characters above 127.
  99.     Here is a Mutt program that will put all 255 characters into the
  100.     current buffer.  You can use it to look at your font.
  101.     (include me2.h)
  102.     (include mod.mut)
  103.  
  104.     (defun
  105.       all-the-ASCII-characters
  106.       {
  107.         (int j)
  108.  
  109.         (for (j 1) (< j 256) (+= j 1)
  110.         {
  111.           (insert-text (convert-to CHARACTER j))
  112.           (if (== 0 (mod j 32)) (newline))
  113.         })
  114.       })
  115.  
  116. * Function keys, arrow keys, other termainal specific things.  I don't
  117.   try to parse keys other than the ASCII character set.  Trying to use
  118.   the termcap entries for special keys (function, arrow, etc) has been a
  119.   real pain (especially on HP terminals) and I can never figure out
  120.   everything for all termainals.  So I don't bother.  What I do do is
  121.   parse some of them in Mutt.  xterm.mut parses vt100 and xterms,
  122.   hpterm.mut does HP terminal function keys.
  123.  
  124. ========================================================================
  125.     Color, inverse video, fonts, etc
  126. ========================================================================
  127. * This is very machine dependent.  See modeline-color, text-color in
  128.     MEMUTT.DOC.
  129.   IBM PC fast video (CGA, EGA):
  130.     bit7-> |blink|R|G|B| |intensity|R|G|B| <-bit 0  (foreground)
  131.       where R=red, G=green, B=blue, blink makes the character blink and
  132.       intensity only affects the foreground color.
  133.     For example:
  134.       green foreground, blue background:  |0|0|0|1| |0|0|1|0| ==0x12 ==18
  135.       monochrome inverse video:  |0|1|1|0| |1|1|0|1| ==0x6D ==109
  136.   Portable Plus:
  137.     bit7-> |0|0|f1|f2| |0|underline|inverse video|blinking|
  138.       where f1f2 are the font selector: 00 for normal font, 01 for stick
  139.     For example: inverse video stick font: |0|0|0|1| |0|0|1|0| ==0x12 ==18
  140.   HP150, UNIX:
  141.     0: normal, 1: half bright inverse video.
  142.     Note:  If the color is set to something outside this range, you get
  143.       normal color for everything and slightly faster screen updates - 
  144.       ie the color stuff is ignored.  Do this if the color is screwing 
  145.       up your screen.
  146.   ANSI mode: This has been tested only on IBM PC like things.
  147.     The  format is xxyy.  xx is one  color  and yy is the  other.  These
  148.       numbers  come  from  the  ansi  spec  for the  ansi  set  graphics
  149.       rendition (SGR) escape sequence.
  150.     For example:  if 32 is green foreground, 41 red background and 44 is
  151.       blue background, then (text-color  3241)(modeline-color 4432) sets
  152.       green text on a red background  with the modeline  green text on a
  153.       blue background.
  154. * Screen size:
  155.   Sometimes the same code runs on machines with different screen sizes.
  156.     If this is your case, you'll need to resize the screen.
  157.   For example:
  158.     HP110:  use me150.exe and put (screen-length 16) in your myme file.
  159.     EGA 43 line mode:  If you have a IBM PC, EGA and NANSI.SYS (or some
  160.       other way to get into 43 line mode), ME can use all 43 lines.
  161.       If you are already in 43 line mode: (screen-length 43).
  162.       To switch into 43 line mode: (puts "^[[=43h")(screen-length 43)
  163.       2 handy pgms:
  164.       (defun
  165.     EGA {(puts "^[[=43h")(screen-length 43)}
  166.     noEGA {(puts "^[[=3h")(screen-length 25)}
  167.       )
  168.  
  169. ========================================================================
  170.             Philosophy
  171. ========================================================================
  172. * ME should behave the same on every machine it runs on.
  173. * ME is an editing engine.
  174.     The core functionality should allow ME to be used stand alone.  The
  175.       core has been patterned after (a subset of) Emacs (where Emacs is
  176.       usually Unipress (Goslings') Emacs or GNU Emacs).
  177.     The bells, whistles and features that "personalize" an editor are
  178.       Mutt extensions added by the user.
  179.  
  180. * If you find bugs I want to fix them so let me know.
  181.   If you have enhancement requests or stuff you would like to see added,
  182.     I am interested.
  183.  
  184. Restrictions:
  185.   Distributed under the terms of the GNU General Public License.
  186.  
  187. * No Warranty - you get what you pay for.
  188.  
  189. * I am:
  190.   Craig Durland       (503) 750-3354
  191.   3419 SW Knollbrook, Corvallis, OR 97333
  192.   craig@cv.hp.com
  193.