Annotation of src/usr.bin/mg/README, Revision 1.1
1.1 ! deraadt 1: Mg 2a README May 15, 1988
! 2:
! 3: Mg (mg) is a Public Domain EMACS style editor. It is "broadly"
! 4: compatible with GNU Emacs, the latest creation of Richard M.
! 5: Stallman, Chief GNUisance and inventor of Emacs. GNU Emacs (and other
! 6: portions of GNU as they are released) are essentially free, (there are
! 7: handling charges for obtaining it) and so is Mg. You may never have
! 8: to learn another editor. (But probably will, at least long enough to
! 9: port Mg...) Mg was formerly named MicroGnuEmacs, the name change was
! 10: done at the request of Richard Stallman.
! 11:
! 12: Mg is not associated with the GNU project, and most of it does not
! 13: have the copyright restrictions present in GNU Emacs. (However, some
! 14: of the system dependent modules and the regular expression module do
! 15: have copyright notices, specificly the VMS/primos termcap routines and
! 16: the amiga specific routines. Look at the source code for exact
! 17: copyright restrictions.) The Mg authors individually may or may not
! 18: agree with the opinions expressed by Richard Stallman in "The GNU
! 19: Manifesto".
! 20:
! 21: To avoid GNU copyright restrictions, replace the re_search.c, regex.h
! 22: and regex.c files with empty files.
! 23:
! 24: Documentation of Mg is in the TeX file mg.tex. This should be
! 25: formatted with the TeX text formatter and printed. A start twords a mg
! 26: programmers guied in in mgprog.doc, and some of the changes from 1b
! 27: are mentioned briefly in mg2a.change.
! 28:
! 29: This program is intended to be a small, fast, and portable editor for
! 30: people who can't (or don't want to) run real Emacs thing for one
! 31: reason or another. It is compatible with GNU because there shouldn't
! 32: be any reason to learn more than one Emacs flavor. We have excised
! 33: most MicroEMACS features that were incompatible with the big brother,
! 34: and added missing features that seemed essential.
! 35:
! 36: There are at least two other major versions of MicroEMACS in
! 37: circulation. One comes from Daniel Lawrence, (based on an old version
! 38: from Dave Conroy) and is several versions have been posted to usenet.
! 39: It uses a 3.x version numbering scheme, and the latest I know about is
! 40: 3.9i. It has some features not found in Mg, missing others, is
! 41: bigger, and is incompatible with GNU Emacs. It might be a better
! 42: choice for you if you *must* have something not present here and can't
! 43: run GNU.
! 44:
! 45: Another variety uses a different numbering scheme, and is up to v30.
! 46: This also comes from mod.sources, and is the latest version from the
! 47: original MicroEMACS author Dave Conroy. Mg is derived from this
! 48: version, and for the most part has replaced it.
! 49:
! 50: Mg is continuing to diverge from other MicroEmacs varients.
! 51: Significant modifacations would me nessisary to adapt code from either
! 52: the 3.x strains or v30. Command functions and key mapping, for
! 53: instance, are completely different.
! 54:
! 55: This is the third distribution release of Mg. (It went through four
! 56: beta releases to iron out the changes made by the various authors.)
! 57: Prior releases were known as MicroGnuEmacs 1a and MicroGnuEmacs 1b.
! 58: Beyond the work of Dave Conroy, author of the original public domain
! 59: v30, the current version contains the work of:
! 60:
! 61: blarson@ecla.usc.edu Bob Larson
! 62: mic@emx.utexas.edu Mic Kaczmarczik
! 63: mwm@violet.berkeley.edu Mike Meyer
! 64: sandra@cs.utah.edu Sandra Loosemore
! 65: mp1u+@andrew.cmu.edu Michael Portuesi
! 66: RCKG01M@CALSTATE.BITNET Stephen Walton
! 67: hakanson@mist.cs.orst.edu Marion Hakanson
! 68:
! 69: People who have worked on previos versions of Mg:
! 70:
! 71: rtech!daveb@sun.com Dave Brower
! 72:
! 73: These systems are known to work in the current version:
! 74:
! 75: 4.2 & 4.3 BSD Unix, SunOs 3.2, Ultrix-32
! 76: System V
! 77: OS9/68k
! 78: VMS
! 79: Amiga
! 80: Primos
! 81: Atari ST
! 82:
! 83: Ms-Dos support is planned, but did not get done in time for this
! 84: release. (Jeff Siegal <jbs@eddie.mit.edu> was the one doing it.)
! 85: The Ms-Dos files will probably be distributed seperatly when it
! 86: becomes available.
! 87:
! 88: Cpm/68k support was dropped due to compiler bugs. Eunice support was
! 89: dropped because of lack of interest. Mg 1b does support those
! 90: systems.
! 91:
! 92: One change to late to make it into mg.tex is readding bsmap-mode (only
! 93: if BSMAP is #defined when compiling). This is a toggle that controls
! 94: input mapping to exchange the ^H (backspace) and DEL characters. Like
! 95: GNU emacs input keymaps, it is not displayed on the mode line and will
! 96: cause them to be treated as each other for echoing. (With bsmap-mode
! 97: enabled, DEL will echo ^H in the echo line.)
! 98:
! 99:
! 100: How to Make a Mg
! 101: ---------------------------
! 102:
! 103: On UNIX at least, it's easy. (Note that even on these systems you may
! 104: want to change a compile time option.) If you have BSD UNIX, do:
! 105:
! 106: ln sys/bsd/Makefile .
! 107: make
! 108:
! 109: For System V, do:
! 110:
! 111: ln sys/sysv/Makefile .
! 112: make
! 113:
! 114: There are several other directories under sys: osk, vms, amiga, atari,
! 115: prime. You should follow the directions contained therein to make one
! 116: of those versions.
! 117:
! 118: For most systems (everyting except the amiga, and atari currently),
! 119: the termcap terminal definition is used. There is a readme file in
! 120: the default subdirectory of the sys directory explaining what entries
! 121: are used and how. (Termcap is a way to do display manipulation in a
! 122: terminal independent manner.) Besides the normal startup file (usually
! 123: .mg) terminal specific initialization files may be used. (For
! 124: example, in .mg.vt100 you may want to (global-set-key "\e[A"
! 125: 'previous-line) to have the up arrow key work.)
! 126:
! 127: Some changes made to make this version more like Gnu Emacs may break
! 128: startup files. Gnu Emacs 18 has both backward-delete-char and
! 129: delete-backward-char that apperently do the same thing. This version
! 130: has only the latter because that is what is documented in my manual
! 131: (version 17) and bound by Gnu Emacs to DEL.
! 132:
! 133: ----------------------------------------------------------------------
! 134:
! 135: Known limitaions:
! 136:
! 137: Recursive bindings may cause help and key rebinding code to go into
! 138: an infinite loop, aborting with a stack overflow.
! 139:
! 140: Overwrite mode does not work in macros. (Characters are inserted
! 141: rather than overwriting.)
! 142:
! 143: Dired mode has some problems: Rename does not update the buffer.
! 144: Doing a dired again will update the buffer (whether it needs it or
! 145: not) and will lose any marks for deletion. .. and . are not
! 146: recognized as special cases.
! 147:
! 148: On systems with 16 bit integers, the kill buffer cannot exceed 32767
! 149: bytes.
! 150:
! 151:
! 152:
! 153: New implementation oddities:
! 154:
! 155: insert and define-key are new commands corresponding to the mocklisp
! 156: functions in Gnu Emacs. (Mg does not have non-command functions.)
! 157: (Mg's insert will only insert one string.)
! 158:
! 159: The display wrap code does not work at all like that of GNU emacs.
! 160:
! 161: ------------------------------------------------------------------------
! 162:
! 163: If you have a change to make that you think should be incorporated
! 164: into the next version of Mg, send it the mg-support mail
! 165: list. Addresses are:
! 166:
! 167: mg-support%ais1@ecla.usc.edu
! 168: {cit-vax,sdcrdcf,trwrb}!oberon!ais1!mg-support
! 169:
! 170: Support for additional systems and terminals should include being
! 171: available for beta testing as other changes are made. (Send a short
! 172: note to mg-support.) Currently, beta test copies of Mg are made
! 173: available via Internet ftp, so beta testers need access to the
! 174: Internet. (UUCP sites that are customers of uunet can get it via
! 175: them. Contact uunet!uunet-request for details.) If you can't reach
! 176: one of us via a computer network, I suppose you could send a change to
! 177: my snail mail address below on 5" os9 format disks or 9 track tape
! 178: (ANSI variable label or Prime magsav format), but this effectivly
! 179: rules you out as a potential beta tester. (Don't expect the disk or
! 180: tape back unless you inculude a SASE with sufficent postage.) I will
! 181: not be sending out copies on magnetic media, so please don't ask. If
! 182: you somehow got an incomplete or non-standard copy, (i.e. missing one
! 183: of the sys directories mentioned here as working) complain to who you
! 184: got it from not to me.
! 185:
! 186: Robert Larson
! 187: 309 S. Alexandria Ave.
! 188: Apt. 117
! 189: Los Angeles, CA 90020
! 190:
! 191: Alternatively, and under the same conditions, you can send either a 3"
! 192: AmigaDOS format disk or a 9 track tape (Unix tar format) to:
! 193:
! 194: Mike Meyer
! 195: P.O. Box 4730
! 196: Berkeley, CA 94704
! 197: