GNU Mes is a Scheme interpreter and C compiler for bootstrapping the GNU System.
Go to file
Jan Nieuwenhuizen 72cb975213
GNU Mes.
Throughout, make these changes

   Copyright headers: GNU Mes
   First mention of name: GNU Mes
   Website: https://www.gnu.org/software/mes
   Git:     git://git.savannah.gnu.org/mes.git
2018-07-22 14:24:36 +02:00
build-aux GNU Mes. 2018-07-22 14:24:36 +02:00
doc GNU Mes. 2018-07-22 14:24:36 +02:00
guix/git GNU Mes. 2018-07-22 14:24:36 +02:00
include GNU Mes. 2018-07-22 14:24:36 +02:00
lib GNU Mes. 2018-07-22 14:24:36 +02:00
mes GNU Mes. 2018-07-22 14:24:36 +02:00
module GNU Mes. 2018-07-22 14:24:36 +02:00
scaffold GNU Mes. 2018-07-22 14:24:36 +02:00
scripts GNU Mes. 2018-07-22 14:24:36 +02:00
src GNU Mes. 2018-07-22 14:24:36 +02:00
tests GNU Mes. 2018-07-22 14:24:36 +02:00
.dir-locals.el doc: Initial version. 2018-07-12 22:29:59 +02:00
.gitignore build: Generate gcc-mesboot-graph from .dot. 2018-07-22 22:27:24 +02:00
.guix.scm GNU Mes. 2018-07-22 14:24:36 +02:00
AUTHORS build: Support --srcdir build. 2018-07-22 00:43:39 +02:00
BOOTSTRAP GNU Mes. 2018-07-22 14:24:36 +02:00
COPYING Add Guile version of John McCarthy's Maxwell Equations of Software. 2016-05-28 16:26:06 +02:00
ChangeLog GNU Mes. 2018-07-22 14:24:36 +02:00
GNUmakefile GNU Mes. 2018-07-22 14:24:36 +02:00
HACKING GNU Mes. 2018-07-22 14:24:36 +02:00
INSTALL GNU Mes. 2018-07-22 14:24:36 +02:00
NEWS GNU Mes. 2018-07-22 14:24:36 +02:00
README GNU Mes. 2018-07-22 14:24:36 +02:00
build.sh GNU Mes. 2018-07-22 14:24:36 +02:00
check.sh GNU Mes. 2018-07-22 14:24:36 +02:00
configure GNU Mes. 2018-07-22 14:24:36 +02:00
configure.sh build: Support --srcdir build. 2018-07-22 00:43:39 +02:00
install.sh build: Respect --docdir. 2018-07-22 14:44:50 +02:00
uninstall.sh build: Support uninstall. 2018-07-22 17:00:22 +02:00

README

                                                              -*- org -*-
GNU Mes --- Maxwell Equations of Software

[[https://www.gnu.org/software/mes][GNU Mes]] aims to help create full
source bootstrapping for GNU/Linux distributions such as
[[https://www.gnu.org/software/guix][GuixSD]] as part of the
[[http://bootstrappable.org][bootstrappable builds]] effort.

It currently consists of a mutual self-hosting Scheme interpreter
written in ~5,000 LOC of simple C and a Nyacc-based C compiler written
in Scheme.  This mes.c is [[https://github.com/oriansj/mes-m2][being simplified]] to be transpiled by
[[https://github.com/oriansj/m2-planet][M2-Planet]].

The Scheme interpreter prototype (mes.c) has a Garbage Collector, a
library of loadable Scheme modules-- notably Dominique Boucher's [[https://github.com/schemeway/lalr-scm][LALR]],
Pre-R6RS [[https://www.cs.indiana.edu/chezscheme/syntax-case/old-psyntax.html][portable syntax-case]] with R7RS ellipsis, Matt Wette's [[https://www.nongnu.org/nyacc][Nyacc]],
Guile's [[https://www.gnu.org/software/guile/docs/master/guile.html/PEG-Parsing.html][PEG]] --and test suite just barely enough to support a simple
REPL and simple C-compiler: MesCC.

Mes+MesCC can compile an only [[http://gitlab.com/janneke/tinycc][lightly patched TinyCC]] that is
self-hosting.  Using this tcc and the Mes C library we now have a
reduced-binary-seed bootstrap for the gnutools triplet: glibc-2.2.5,
binutils-2.20.1, gcc-4.1.0.

GNU Mes is inspired by The Maxwell Equations of Software: [[http://www.softwarepreservation.org/projects/LISP/book/LISP%2525201.5%252520Programmers%252520Manual.pdf][LISP-1.5]] --
John McCarthy page 13, GNU Guix's source/binary packaging transparency
and Jeremiah Orians's [[https://github.com/oriansj/stage0][stage0]] ~500 byte self-hosting hex assembler.

Mes is free software, it is distributed under the terms of the GNU
General Public Licence version 3 or later.  See the file COPYING.

* Get it

   git clone [[git://git.savannah.gnu.org][git://git.savannah.gnu.org/mes.git]]

* Build it (see INSTALL for full instructions)

   ./configure
   make all
   make check

* REPL it

   src/mes.gcc        # default (64 bit) gcc-compiled
   src/mes.mlibc-gcc  # 32 bit, gcc -nostdlib
   src/mes            # 32 bit, bootstrapped, mes.M1+MesCC-compiled

* MesCC compiler

   scripts/mescc -c scaffold/main.c

* Bugs

    Please send Mes bug reports to guix-devel@gnu.org.

[0] https://www.gnu.org/software/mes
[1] https://www.gnu.org/software/guix
[2] http://bootstrappable.org
[3] https://github.com/oriansj/mes-m2
[4] https://github.com/oriansj/m2-planet
[5] https://github.com/schemeway/lalr-scm
[6] https://www.cs.indiana.edu/chezscheme/syntax-case/old-psyntax.html
[7] https://www.nongnu.org/nyacc
[8] https://www.gnu.org/software/guile/docs/master/guile.html/PEG-Parsing.html
[9] http://gitlab.com/janneke/tinycc
[10] http://www.softwarepreservation.org/projects/LISP/book/LISP%25201.5%2520Programmers%2520Manual.pdf
[11] https://github.com/oriansj/stage0