mg

port of mg editor (openbsd to linux)
Log | Files | Refs | README

README (3979B)


      1 [This is an edited version of the original mg README, updated slightly to
      2 reflect changes in the last 20 years.]
      3 
      4 
      5 Mg (mg) is a Public Domain EMACS style editor.  It is "broadly"
      6 compatible with GNU Emacs, the latest creation of Richard M.
      7 Stallman, Chief GNUisance and inventor of Emacs.  GNU Emacs (and other
      8 portions of GNU as they are released) are essentially free, (there are
      9 handling charges for obtaining it) and so is Mg.  You may never have
     10 to learn another editor.  (But probably will, at least long enough to
     11 port Mg...)  Mg was formerly named MicroGnuEmacs, the name change was
     12 done at the request of Richard Stallman.
     13 
     14 Mg is not associated with the GNU project, and most of it does not
     15 have the copyright restrictions present in GNU Emacs.  (However, some
     16 of the system dependent modules and the regular expression module do
     17 have copyright notices.  Look at the source code for exact
     18 copyright restrictions.)  The Mg authors individually may or may not
     19 agree with the opinions expressed by Richard Stallman in "The GNU
     20 Manifesto".
     21 
     22 This program is intended to be a small, fast, and portable editor for
     23 people who can't (or don't want to) run real Emacs for one reason
     24 or another.  It is compatible with GNU because there shouldn't be
     25 any reason to learn more than one Emacs flavor.
     26 
     27 
     28 Beyond the work of Dave Conroy, author of the original public domain
     29 v30, the current version contains the work of:
     30 
     31 	blarson@ecla.usc.edu		Bob Larson
     32 	mic@emx.utexas.edu		Mic Kaczmarczik
     33 	mwm@violet.berkeley.edu		Mike Meyer
     34 	sandra@cs.utah.edu		Sandra Loosemore
     35 	mp1u+@andrew.cmu.edu		Michael Portuesi
     36 	RCKG01M@CALSTATE.BITNET		Stephen Walton
     37 	hakanson@mist.cs.orst.edu	Marion Hakanson
     38 
     39 People who have worked on previous versions of Mg:
     40 
     41 	rtech!daveb@sun.com		Dave Brower
     42 
     43 Early release history:
     44 
     45 * Nov 16, 1986: First release to mod.sources
     46 * Mar 3, 1987: First Release (mg1a) via comp.sources.unix
     47 * May 26, 1988: Second release: (mg2a) via comp.sources.misc
     48 * Jan 26, 1992: Linux port released by Charles Hedrick. This version
     49   later makes its way onto tsx-11, Infomagic, and various other Linux
     50   repositories.
     51 * Feb 25, 2000: First import into the OpenBSD tree, where it is
     52   currently maintained with contributions from many others.
     53 
     54 ----------------------------------------------------------------------
     55 
     56 Known limitations:
     57 
     58 Recursive bindings may cause help and key rebinding code to go into
     59 an infinite loop, aborting with a stack overflow.
     60 
     61 Overwrite mode does not work in macros.	 (Characters are inserted
     62 rather than overwriting.)
     63 
     64 Dired mode has some problems:  Rename does not update the buffer.
     65 Doing a dired again will update the buffer (whether it needs it or
     66 not) and will lose any marks for deletion.  .. and . are not
     67 recognized as special cases.
     68 
     69 On systems with 16 bit integers, the kill buffer cannot exceed 32767
     70 bytes.
     71 
     72 Unlike GNU Emacs, Mg's minibuffer isn't multi-line aware and hence
     73 some commands like "shell-command-on-region" always pop up a buffer to
     74 display output irrespective of output's size.
     75 
     76 While navigating source code using Mg's cscope commands, the cursor
     77 is always at the match location rather than in *cscope* buffer. Mg uses
     78 the same keybindings of GNU Emacs's xcscope package for it's cscope commands.
     79 As Mg's keybindings are case-insensitive some of the commands don't have a
     80 default keybinding.
     81 
     82 New implementation oddities:
     83 
     84 insert and define-key are new commands corresponding to the mocklisp
     85 functions in GNU Emacs.	 (Mg does not have non-command functions.)
     86 (Mg's insert will only insert one string.)
     87 
     88 The display wrap code does not work at all like that of GNU emacs.
     89 
     90 Some commands that do not mimic emacs exactly don't have a "standard"
     91 emacs name. For example 'backup-to-home-directory' is only a partial
     92 implementation of emacs' range of commands that allow a user to
     93 customise the backup file location. If a more complete implementation
     94 were coded of these commands the non standard commands would probably
     95 be removed.