home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / editor / me_cd.arc / ERRATA.DOC < prev    next >
Text File  |  1988-10-24  |  15KB  |  274 lines
  1. ========================================================================
  2. ==        ME Errata and machine/OS specifics    Craig Durland ==
  3. ========================================================================
  4.         
  5. ========================================================================
  6.         Supported versions of ME
  7. ========================================================================
  8.   FILE        NOTES
  9.   ----        -----
  10.   mepc.exe    PC, FV, Ansi, Snow
  11.   mepcs.exe    PC, SV, Ansi
  12.   meat.exe    AT, FV, Ansi, Snow
  13.   me150.exe    HP150, HP110, SV
  14.   mepp.exe    HP Portable Plus, FV, fonts & inverse video
  15.   I also have versions for HP 9000 Series 300 and 800 HPUX.
  16.   
  17.   Notes:
  18.     All  versions  of ME are Mutt  object code  compatible.  ie the .mco
  19.       files are the same no matter what machine you are running ME on.
  20.     The PC versions can use EGA 43 line mode.
  21.   Ansi = Requires ANSI.SYS or NANSI.SYS (a faster ANSI.SYS (which I can
  22.     supply)).
  23.   AT = IBM ATs or clones.  80286 code.  Somewhat faster and smaller.
  24.   FV = Fast video ie writes directly to video ram.
  25.   PC = IBM PCs, ATs, or clones.  8086 code.
  26.   Snow = Will snow the screen if you have a IBM color display card.
  27.     Most other cards do not have this problem.
  28.   SV = Slow video ie uses escape sequences.
  29.  
  30. ========================================================================
  31.             BUGS
  32. ========================================================================
  33.   MS-DOS
  34.     If you install TSRs (terminate and stay resident - things like Side
  35.       Kick) from within ME (ie ^X!  or from a shell invoked by ME) and
  36.       don't exit ME, there is a good chance that sometime later ME will
  37.       not be able to write out files (it will say something like "Error
  38.       closing file").  If this happens, you are screwed - your file is
  39.       cleared from the disk and there is no way you can save it.
  40.       Another symptom is problems allocating memory ("Cannot allocate x
  41.       bytes").  print.com is the only TSR I have verified causing these
  42.       problems but don't press your luck.
  43.       Note: is OK to use TSRs from within ME.  ie using print.com to
  44.       print a file while in ME is OK as long as print was installed
  45.       outside of ME.
  46.     EGA 43 line mode: If you are using nansi.sys, switching into 43 line
  47.       mode and then invoking a shell or running a program (^X!) the cursor
  48.       may disappear.  This is caused by a bug in nansi.sys.  When going
  49.       into 43 line mode it should set 40:87H bit 0 and clear that bit when
  50.       returning to 25 line mode but it don't.
  51.   UNIX
  52.     XON/XOFF can screw things up.  ME turns off XON/XOFF because XON is
  53.       ^S and XOFF is ^Q and most Emacs users are very attached to those
  54.       keys.  This can lead to terminal overruns if the terminal cannot
  55.       keep up at the baud rate selected or there is not enough padding.
  56.       Sometimes the connection to the computer runs though a server
  57.       device that also talks XON/XOFF.  If this is the case ^S will stop
  58.       the display and some times ME will start searching for no apparent
  59.       reason.  Talk to a guru and find out how to fix the server or
  60.       rebind ^S and ^Q to "" and use the alternate keys (^\ and ^^).
  61.     Softkeys:  Most terminals send escape codes when you press a function
  62.       key or softkey.  This is a problem when the codes overlap valid ME
  63.       user key sequences (eg HP terminals send "ESC B" for down arrow which
  64.       is also the ME sequence for (backward-word)).  The version of ME for
  65.       HP terminals (MEH), trys to tell the difference with timing, however,
  66.       this method if far from foolproof.  To tell if you have a problem,
  67.       type ^X^V (visit-file) and then press a function key (such as down
  68.       arrow) rapidly.  You should see
  69.       F-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-DF-D.  If you don't or see
  70.       something like F-DM-BM-BF-DF-DM-B you have a problem and you have to
  71.       either give up softkeys or the mappings they cover.  Or get a
  72.       "better" terminal.  Regular ME leaves soft key processing to Mutt
  73.       pgms (see vt100.mut for an example).
  74.  
  75. =========================================================================
  76.         MS-DOS specifics
  77. =========================================================================
  78.   Filenames can contain "/" or "\".
  79.   Strango characters
  80.     MS-DOS ME allows you to enter ^Z or NULL (0) and write out the file but
  81.       a line with NULL in it gets truncated (at the NULL) when read in.
  82.    Some versions allow you to enter a character by typing in its decimal
  83.       value (eg "A" is decimal 65) (see below).  Note that entering most
  84.       keys is like pressing the key on the keyboard so you may want to
  85.       quote (^Q) the character.
  86.     IBM PC: hold down ALT and type the value on the number pad.  The
  87.       character is added when the ALT key is lifted.
  88.     Portable Plus: Put into Num pad mode (Extend Num), hold down Extend and
  89.       press the value on the number pad (the blue numbers).  The character
  90.       is added when the ALT key is lifted.  Now switch back to regular mode
  91.       (Extend Num).  This is easier to do than to say.
  92. * Portable Plus version:
  93.   The Clr dsp, +Line and -Line function key are not mapped.
  94. * HP150 version:
  95.   The function keys (f1...f8) don't work unless the user keys are turned
  96.     on AND f1 is programmed to send Normal ESCp, f2 Normal ESCq, ...  f8
  97.     Normal ESCw.  This is because of a bug in the 150.
  98.       This can be done with:
  99.     (puts "^[&f0a1k5d2L   f1^[p") (puts "^[&f0a2k5d2L   f2^[q")
  100.     (puts "^[&f3k0a5d2L   f3^[r") (puts "^[&f4k0a5d2L   f4^[s")
  101.     (puts "^[&f5k0a5d2L   f5^[t") (puts "^[&f6k0a5d2L   f6^[u")
  102.     (puts "^[&f7k0a5d2L   f7^[v") (puts "^[&f8k0a5d2L   f8^[w")
  103.     (puts "^[&jB")
  104.  
  105. ========================================================================
  106.         UNIX specifics
  107. ========================================================================
  108.   You can use csh style wildcards: ~, [], [^], ?, *
  109.       (eg ~craig, ~/tools, foo[123], foo*, etc) for (insert-file),
  110.       (read-file), (rename-buffer), (visit-file), (write-file) and
  111.       current-directory.
  112.     See dir.mut for examples of cwd, dirs, push directory, pop directory.
  113.  
  114. ========================================================================
  115.     Color, inverse video, fonts, etc
  116. ========================================================================
  117.   This is very machine dependent.  See modeline-color, text-color in
  118.     MEMUTT.DOC.
  119.   IBM PC fast video (CGA, EGA):
  120.     bit7-> |blink|R|G|B| |intensity|R|G|B| <-bit 0  (foreground)
  121.       where R=red, G=green, B=blue, blink makes the character blink and
  122.       intensity only affects the foreground color.
  123.     For example:
  124.       green foreground, blue background:  |0|0|0|1| |0|0|1|0| ==0x12 ==18
  125.       monochrome inverse video:  |0|1|1|0| |1|1|0|1| ==0x6D ==109
  126.   Portable Plus:
  127.     bit7-> |0|0|f1|f2| |0|underline|inverse video|blinking|
  128.       where f1f2 are the font selector: 00 for normal font, 01 for stick
  129.     For example: inverse video stick font: |0|0|0|1| |0|0|1|0| ==0x12 ==18
  130.   HP150, UNIX:
  131.     0: normal, 1: half bright inverse video.
  132.     Note:  If the color is set to something outside this range, you get
  133.       normal color for everything and slightly faster screen updates - 
  134.       ie the color stuff is ignored.  Do this if the color is screwing 
  135.       up your screen.
  136.   ANSI mode: This has been tested only on IBM PC like things.
  137.     The  format is xxyy.  xx is one  color  and yy is the  other.  These
  138.       numbers  come  from  the  ansi  spec  for the  ansi  set  graphics
  139.       rendition (SGR) escape sequence.
  140.     For example:  if 32 is green foreground, 41 red background and 44 is
  141.       blue background, then (text-color  3241)(modeline-color 4432) sets
  142.       green text on a red background  with the modeline  green text on a
  143.       blue background.
  144. * Screen size:
  145.   Sometimes the same code runs on machines with different screen sizes.
  146.     If this is your case, you'll need to resize the screen.
  147.   For example:
  148.     HP110:  use me150.exe and put (screen-length 16) in your init file.
  149.     EGA 43 line mode:  If you have a IBM PC, EGA and NANSI.SYS (or some
  150.       other way to get into 43 line mode), ME can use all 43 lines.
  151.       If you are already in 43 line mode: (screen-length 43).
  152.       To switch into 43 line mode: (puts "^[[=43h")(screen-length 43)
  153.       2 handy pgms:
  154.       (defun
  155.     EGA {(puts "^[[=43h")(screen-length 43)}
  156.     noEGA {(puts "^[[=3h")(screen-length 25)}
  157.       )
  158.  
  159. ========================================================================
  160.         Initialization and customization
  161. ========================================================================
  162. * ME has an initialization file "INIT.MCO".  It attempts to load this
  163.     file first from the current directory.  If it is not there then it
  164.     looks at the environment variable ME and tries that directory.  Note
  165.     that a trailing slash is required for the ME variable.  So, in MS-DOS,
  166.     "set ME=C:/medir/" will cause C:/medir/init.mco to be loaded.
  167. * The init file I use is in INIT.MUT.  You are encourged to change it to
  168.     do the things you think an editor should do.
  169.   Heres whats in it:
  170.   - Brace matching.  (Bound to F-6).  Matches (){}.  Shows the matching
  171.     brace and leaves the mark there.
  172.   - Region indenting (M-X indent).  Shifts the region right or left a
  173.     specified amount.  Blank lines are not shifted.  See indent.mut for
  174.     more info.
  175.   - A mark ring (F-9 or M-C-P to push a mark, M-P to pop a mark).  A
  176.     mark ring is queue of up to 4 marks in a buffer.  Used to remember
  177.     lots of places in a buffer and get to them quickly.  See markring.mut
  178.     for more info.
  179.   - A easy way to change system variables (documented in MEMUTT.DOC).  "M-X
  180.     get-sysvar" will display the value of a sys var and "M-X set-sysvar"
  181.     will display and let you change a sys var.  Command completion is on.
  182.   - Multiple files on the command line (C-XF).  By default, ME only reads
  183.     the first file on the command line.  This command will read the next
  184.     one.  Note that wildcards must be expanded by the shell (MS-DOS
  185.     users take note).
  186.   - Show stats on the current buffer (C-X=).
  187.   - Show stats on all the buffers (C-XC-B).
  188.   - Incremental searching (C-S, C-R).  Search as you type.  See isearch.mut
  189.     for more info.
  190.   - Directory stack ala c-shell (UNIX only).  "M-X pu" will push to a
  191.     directory (+n will bring the nth stack entry to the top (counting from
  192.     0), "" will swap the top two entries), "M-X po" will pop the stack,
  193.     "M-X pwd" shows the current directory, "M-X dirs" pops up a window
  194.     showing the directory stack.  See dir.mut for more info.
  195.   - Programmers calculator (M-X calculator).  Does bit twiddling
  196.     programmers are interested in.  Numbers are 32 bits, uses any base 2
  197.     to 16.  To get more info, run the calculator and press ?.  It has no
  198.     floating point.
  199.   - Rectangle commands:
  200.       copy-rect:  copies the rectangle-region to the kill buffer.
  201.       cut-rect:   copies and deletes the rectangle.
  202.       erase-rect: deletes the rectangle.
  203.       clear-rect: sets the rectangle to blanks.
  204.   - M-x buffer-nomunge sets a read-only mode for the current buffer.
  205.   - F-1 removes all white space from the cursor to the first non blank
  206.       character or end of line.
  207.     F-5 deletes the current line.
  208.     F-7 binds the Enter key to newline.
  209.     F-8 binds the Enter key to newline and indent.
  210.     F-10 sets the mark.
  211.     Ins (insert) moves the text so that the cursor is centered in the
  212.       window.
  213.     C-X0 deletes the current window.
  214.     M-X describe-key tells what a key is bound to.
  215.     C-XC-V is the same as visit-file except it does not split the window.
  216.   - Several modes are autoloaded to help edit certain types of files.  If
  217.     you don't want the help, either remove the .mco file or take the mode
  218.     out of (set-mode) in init.mut.  If you do want the mode, make sure that
  219.     the Mutt file that contains the mode code has been compiled.  For
  220.     example, to enable C mode, make sure cmode.mut has been compiled
  221.     (mc -tme cmode).
  222.     - Electric C mode.  A collection of routines I've found usefull when
  223.       editing C code.  It is turned on when ever you edit a .c or .h file.
  224.       Helps with comments, backspacing over tabs, { and a few others.  See
  225.       cmode.mut for more info.
  226.     - Electric Mutt mode.  Pretty much the same as C mode but for Mutt
  227.       code.  See muttmode.mut for more info.
  228.     - Text mode.  Help with editing documents, etc.  Does line centering,
  229.       region centering, auto word wrap, format paragraphs, mark paragraphs,
  230.       move the cursor about in a paragraph, etc.  See textmode.mut for more
  231.       info.  This mode is triggered by .txt or .doc extensions.  To change
  232.       or add extensions, change set-mode in init.mut.
  233.     - Picture mode.  This mode is used to edit tables, text pictures, etc.
  234.       Well documented in picture.mut or use the GNU Emacs manual.  Invoke
  235.       this mode with M-X edit-picture.
  236.   - Files that are autoloaded:
  237.     File        In response to
  238.     adjust.mco       Format a comment (C or Mutt mode), format text (text mode).
  239.     calc.mco       M-x calculator.
  240.     cmode.mco       Editing a .c or .h file.
  241.     muttmode.mco   Editing a .mut file.
  242.     textmode.mco   Editing a .txt or .doc file.
  243.     dir.mco       M-x pu, M-x cd, M-x pwd.
  244.     picture.mco       M-x edit-picture.
  245.  
  246.     Make sure you have compiled the corresponding .mut file if you want
  247.       these capabilities.
  248.   - Directory local ME extensions.  This can be useful for performing
  249.     certain types of jobs that will only be done in a specific directory.
  250.     To enable this, move to the directory where you want the extensions,
  251.     put the extensions into mext.mut and compile them.  When ME is run in a
  252.     directory with mext.mco, mext is loaded.
  253.  
  254. ========================================================================
  255.             Philosophy
  256. ========================================================================
  257. * ME should behave the same on every machine it runs on.
  258. * ME is an editing engine.
  259.     The core functionality should allow ME to be used stand alone.  The
  260.       core has been patterned after (a subset of) Emacs (where Emacs is
  261.       usually Unipress (Goslings') Emacs).
  262.     The bells, whistles and features that "personalize" an editor are
  263.       Mutt extensions added by the user.
  264. * If you find bugs I want to fix them so let me know.
  265.   If you have enhancement requests or stuff you would like to see added I am
  266.     interested.
  267.   If you want me to change the default key bindings I probably won't be too
  268.     receptive.
  269. * ME is for anyone's personal use - NOT to be sold for profit.
  270.   No Warranty - you get what you pay for.
  271. * I am:    Craig Durland    (503) 750-3354, telenet 81-757-3354
  272.     Hewlett-Packard, 1000 NE Circle, Corvallis, OR 97330
  273.         ...!hp-pcd!craig or hp-pcd@craig
  274.