| 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 it does not have the |
| 15 |
copyright restrictions present in GNU Emacs. (However, some modules |
| 16 |
do have copyright notices.) The Mg authors individually may or may |
| 17 |
not agree with the opinions expressed by Richard Stallman in "The GNU |
| 18 |
Manifesto". |
| 19 |
|
| 20 |
This program is intended to be a small, fast, and portable editor for |
| 21 |
people who can't (or don't want to) run real Emacs for one reason |
| 22 |
or another. It is compatible with GNU because there shouldn't be |
| 23 |
any reason to learn more than one Emacs flavor. |
| 24 |
|
| 25 |
|
| 26 |
Beyond the work of Dave Conroy, author of the original public domain |
| 27 |
v30, the current version contains the work of: |
| 28 |
|
| 29 |
[email protected] Bob Larson |
| 30 |
[email protected] Mic Kaczmarczik |
| 31 |
[email protected] Mike Meyer |
| 32 |
[email protected] Sandra Loosemore |
| 33 |
[email protected] Michael Portuesi |
| 34 |
[email protected] Stephen Walton |
| 35 |
[email protected] Marion Hakanson |
| 36 |
|
| 37 |
People who have worked on previous versions of Mg: |
| 38 |
|
| 39 |
[email protected] Dave Brower |
| 40 |
|
| 41 |
Early release history: |
| 42 |
|
| 43 |
* Nov 16, 1986: First release to mod.sources |
| 44 |
* Mar 3, 1987: First Release (mg1a) via comp.sources.unix |
| 45 |
* May 26, 1988: Second release: (mg2a) via comp.sources.misc |
| 46 |
* Jan 26, 1992: Linux port released by Charles Hedrick. This version |
| 47 |
later makes its way onto tsx-11, Infomagic, and various other Linux |
| 48 |
repositories. |
| 49 |
* Feb 25, 2000: First import into the OpenBSD tree, where it is |
| 50 |
currently maintained with contributions from many others. |
| 51 |
|
| 52 |
---------------------------------------------------------------------- |
| 53 |
|
| 54 |
Known limitations: |
| 55 |
|
| 56 |
Recursive bindings may cause help and key rebinding code to go into |
| 57 |
an infinite loop, aborting with a stack overflow. |
| 58 |
|
| 59 |
Overwrite mode does not work in macros. (Characters are inserted |
| 60 |
rather than overwriting.) |
| 61 |
|
| 62 |
Dired mode has some problems: .. and . are not recognized as special |
| 63 |
cases. Also, mg uses the output of the command 'ls' to populate a |
| 64 |
dired buffer. This is not ideal, dired mode should probably be |
| 65 |
rewritten to use the directory(3) set of functions. |
| 66 |
|
| 67 |
On systems with 16 bit integers, the kill buffer cannot exceed 32767 |
| 68 |
bytes. |
| 69 |
|
| 70 |
Unlike GNU Emacs, Mg's minibuffer isn't multi-line aware and hence |
| 71 |
some commands like "shell-command-on-region" always pop up a buffer to |
| 72 |
display output irrespective of output's size. |
| 73 |
|
| 74 |
While navigating source code using Mg's cscope commands, the cursor |
| 75 |
is always at the match location rather than in *cscope* buffer. Mg uses |
| 76 |
the same keybindings of GNU Emacs's xcscope package for it's cscope commands. |
| 77 |
As Mg's keybindings are case-insensitive some of the commands don't have a |
| 78 |
default keybinding. |
| 79 |
|
| 80 |
New implementation oddities: |
| 81 |
|
| 82 |
insert and define-key are new commands corresponding to the mocklisp |
| 83 |
functions in GNU Emacs. (Mg does not have non-command functions.) |
| 84 |
(Mg's insert will only insert one string.) |
| 85 |
|
| 86 |
The display wrap code does not work at all like that of GNU emacs. |
| 87 |
|
| 88 |
Some commands that do not mimic emacs exactly don't have a "standard" |
| 89 |
emacs name. For example 'backup-to-home-directory' is only a partial |
| 90 |
implementation of emacs' range of commands that allow a user to |
| 91 |
customise the backup file location. If a more complete implementation |
| 92 |
were coded of these commands the non standard commands would probably |
| 93 |
be removed. |