Mg is a Micro Emacs clone created in 1987, based on the original
MicroEMACS v30 released by Dave Conroy in 1985. The name, "Micro
GNU Emacs", was disputed early on by the FSF, so today it simply goes by
mg. This software is fully free and in public domain.
The intention is to be a small, fast, and portable Emacs-like editor for users who cannot, or do not want to, run the real Emacs for one reason or another. Compatibility with GNU Emacs is key for Mg, separating it from other ErsatzEmacs clones, because there should never be any reason to learn more than one Emacs flavor.
Try the latest release, use the tarball with a version in the name, avoid GitHub generated links!
When Emacs was born keyboards had a
Meta key. Accessing functions
Meta combinations today is usually the same as holding down the
Alt key, or tapping
Other editors use short forms like
^V, in Emacs this is
C-v. Some usage examples:
|Ctrl||C-||C-x C-c||Hold down
To access the built-in Quick Help, press
C-h q, meaning: hold down
Ctrl and tap
h, then release
Ctrl and tap
- has a
meaning, as you can see.
This project is completely self hosting. However, by default you need a
termcap library, like Ncurses, to provide APIs like:
See below for how to build without Ncurses.
On recent Debian/Ubuntu based systems
libtinfo-dev can be used, on
older ones the include file
term.h is missing, so
must be used instead:
sudo apt install libtinfo-dev
sudo apt install libncurses-dev
On other systems you have to install the full Ncurses library instead, on RHEL, CentOS, and Fedora:
sudo yum install ncurses-devel
sudo dnf install ncurses-devel
On macOS you need the Xcode command line tools and headers:
Then build Mg from the unpacked release tarball:
./configure make sudo make install
make clean ./configure --without-curses make sudo make install
Users who checked out the source from GitHub must run
first to create the configure script. This requires GNU autotools to be
installed on the build system.
There are several options to the configure script to disable features, e.g., to reduce the size, or remove features if you want to be on par with the official Mg. By default, all below features are enabled:
./configure --help [..] --disable-autoexec Disable auto-execute support --disable-cmode Disable C-mode support --disable-compile Disable C compile & grep mode, used by C-mode --disable-cscope Disable Cscope support --disable-ctags Disable ctags(1) support, required by Cscope --disable-dired Disable directory editor --disable-notab Disable notab mode support (not in OpenBSD) --disable-regexp Disable full regexp search --disable-togglenl Disable toggle-newline-prompt extension (not in OpenBSD) --disable-all Disable all optional features [..] --with-startup=FILE Init file to run at startup if ~/.mg is missing --with-mglog Enable debugging to log file, default: ./log/*.log --without-curses Build without curses/termcap, default: auto
To build the smallest possible mg, with many features removed:
./configure --disable-all --enable-size-optimizations make sudo make install-strip
To build a completely static mg with all features:
./configure LDFLAGS="-static" make sudo make install-strip
The history is long and intertwined with other MicroEMACS spin-offs but goes something like this:
See the source distribution for the list of AUTHORS.
This project is derived from OpenBSD Mg, which is the best (maintained) source of the original Micro Emacs based on mg2a. The intention of this project is to develop new usability features, track as many other Mg clones as possible, and, unlike the upstream OpenBSD version, enable hidden features using a standard GNU configure script, while remaining friendly to porting to resource constrained systems. New features:
¹) This project has been extensively tested on Debian GNU/Linux, Ubuntu, CentOS, Fedora, Alpine Linux, Solaris/Illumos based systems like OmniOS, FreeBSD, NetBSD, OpenBSD, DragonFly BSD, Apple macOS >= 10.10, Cygwin, MSYS2, as well as a few embedded Linux systems using musl libc and uClibc-ng.
Merged, and continously tracked, clones:
Note: the official portable Mg project, used by Debian and other GNU/Linux distributions, is maintained by Han Boetes. Unlike this project, which is stand-alone, Boetes relies on libbsd to maintain portability.
Please report any bugs and problems with the packaging and porting to the GitHub issue tracker https://github.com/troglobit/mg/issues