GNU Mes is a Scheme interpreter and C compiler for bootstrapping the GNU System.
Go to file
Andrius Štikonas a34f255f40 riscv64: Fix arguments of main function in tcc.
* lib/linux/riscv64-mes-tcc/crt1.c
2023-10-06 19:54:40 +01:00
build-aux mescc: Fix switch statements' fallthrough 2023-09-13 13:48:33 +02:00
doc DRAFT doc: Add ANNOUNCE-0.25. 2023-09-12 11:04:11 +02:00
guix/git guix: m2-planet: Update to 0.10.0-1-c82fb8c353. 2023-09-12 11:04:11 +02:00
include Revert "crt1: Move main declaration to mes/lib-mini.h." 2023-09-12 11:04:11 +02:00
lib riscv64: Fix arguments of main function in tcc. 2023-10-06 19:54:40 +01:00
mes/module DRAFT doc: Update `AUTHORS'. 2023-09-12 11:04:11 +02:00
module squash! mescc: Fix switch statements' fallthrough 2023-09-17 07:44:16 +02:00
scaffold riscv64: Cater for M2-Planet. 2023-09-12 11:04:11 +02:00
scripts build: Drop support for mescc-tools 0.5.2. 2023-05-03 14:52:25 +02:00
src core: Remove duplicate environment initialization. 2023-09-12 11:04:11 +02:00
tests tests: Make tests/vector.test compatible with Guile. 2023-08-27 10:05:20 +02:00
.dir-locals.el .dir-locals: Add test macro indentation. 2020-12-30 11:47:32 +01:00
.gitignore build: Ignore /m2 build directory. 2023-09-12 11:04:11 +02:00
.mailmap Add .mailmap. 2023-09-12 11:04:11 +02:00
AUTHORS DRAFT doc: Update `AUTHORS'. 2023-09-12 11:04:11 +02:00
BLURB doc: Release update. 2019-11-04 19:59:13 +01:00
BOOTSTRAP doc: Migration to Libera Chat. 2021-06-14 20:05:19 +02:00
COPYING doc: Use HTTPS. 2022-10-30 09:40:40 +01:00
ChangeLog Add missing copyright headers and READMEs. 2018-07-26 19:17:12 +02:00
HACKING doc: Use HTTPS. 2022-10-30 09:40:40 +01:00
INSTALL DRAFT doc: Bump M2-Planet requirement to 1.11.0. 2023-09-12 11:04:11 +02:00
NEWS DRAFT doc: Update `NEWS'. 2023-09-12 11:04:11 +02:00
PORTING doc: Update `PORTING'. 2023-09-12 11:04:11 +02:00
README DRAFT doc: Update `README'. 2023-09-12 11:04:11 +02:00
ROADMAP doc: Update `ROADMAP'. 2023-02-13 09:18:57 +01:00
configure configure: Recognize RISC-V architectures. 2023-09-12 11:04:10 +02:00
configure.sh build: Drop support for mescc-tools 0.5.2. 2023-05-03 14:52:25 +02:00
guix.scm doc: Use `guix shell' instead of `guix environment'. 2022-04-30 09:44:57 +02:00
kaem.arm x86_64: build: Cater for M2-Planet. 2023-09-12 11:04:02 +02:00
kaem.riscv64 riscv64: Cater for M2-Planet. 2023-09-12 11:04:11 +02:00
kaem.run riscv64: Cater for M2-Planet. 2023-09-12 11:04:11 +02:00
kaem.x86 x86_64: build: Cater for M2-Planet. 2023-09-12 11:04:02 +02:00
kaem.x86_64 kaem: Pass --64 to blood_elf on 64-bit arches. 2023-09-12 11:04:02 +02:00
simple.make lib: linux: Add wait4. 2023-05-03 08:04:32 +02:00
simple.sh lib: linux: Add wait4. 2023-05-03 08:04:32 +02:00

README

#+COMMENT:                                                            -*- org -*-
#+TITLE: About GNU Mes

#+SUBTITLE: Maxwell Equations of Software

[[https://www.gnu.org/software/mes][GNU Mes]] is a Scheme interpreter and C compiler for bootstrapping the GNU
System.  It has helped to decimate the number and size of binary seeds
that were used in the bootstrap of [[https://www.gnu.org/software/guix][GNU Guix]] 1.0.  Recently, version
0.24.2 has realized the first [[https://guix.gnu.org/en/blog/2023/the-full-source-bootstrap-building-from-source-all-the-way-down/][Full Source Bootstrap]] for Guix.  The final
goal is to help create a full source bootstrap as part of the
[[https://bootstrappable.org][bootstrappable builds]] effort for any UNIX-like operating system.

The Scheme interpreter is written in ~5,000 LOC of simple C, and the C
compiler written in Scheme and these are mutual self-hosting.  Mes can
now be bootstrapped from [[https://github.com/oriansj/m2-planet][M2-Planet]] and [[https://savannah.nongnu.org/projects/mescc-tools][Mescc-Tools]].

Mes 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]] --and test suite, just enough to
support a REPL and a C99 compiler: mescc.

Mes + MesCC + Mes C Library can build a [[https://gitlab.com/janneke/tinycc][bootstrappable TinyCC]] that is
self-hosting.  Using this bootstrappable-tcc and the Mes C library we
can build an ancient version of the GNU tools triplet: glibc-2.2.5,
binutils-2.20.1, gcc-2.95.3.  This is enough to bootstrap Guix for
i686-linux, x86_64-linux, armhf-linux and aarch64-linux.

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

We are very grateful to NLNet for sponsoring the [[https://nlnet.nl/project/GNUMes][Reduced Binary Seed
bootstrap]], the [[https://nlnet.nl/project/GNUMes-arm][ARM port]], and the [[https://nlnet.nl/project/GNUMes-ARM_RISC-V][Full Source Bootstrap.]]

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

* Get it

   #+BEGIN_SRC bash
   git clone git://git.savannah.gnu.org/mes.git
   #+END_SRC

* Build it (see [[file:INSTALL][INSTALL]] for full instructions)

   #+BEGIN_SRC bash
   ./configure
   make all
   make check
   #+END_SRC

* REPL it

   #+BEGIN_SRC bash
   ./pre-inst-env mes
   #+END_SRC

* MesCC compiler

   #+BEGIN_SRC bash
   ./pre-inst-env mescc -c scaffold/main.c
   #+END_SRC

* Bugs

    Please send Mes bug reports to [[mailto:bug-mes@gnu.org][bug-mes@gnu.org]].

* Links
  [0] https://www.gnu.org/software/mes
  [1] https://www.gnu.org/software/guix
  [2] https://guix.gnu.org/en/blog/2023/the-full-source-bootstrap-building-from-source-all-the-way-down/
  [3] https://bootstrappable.org
  [4] https://github.com/oriansj/m2-planet
  [5] https://savannah.nongnu.org/projects/mescc-tools
  [6] https://github.com/schemeway/lalr-scm
  [7] https://www.cs.indiana.edu/chezscheme/syntax-case/old-psyntax.html
  [8] https://www.nongnu.org/nyacc
  [9] https://gitlab.com/janneke/tinycc
  [10] [[https://www.softwarepreservation.org/projects/LISP/book/LISP%201.5%20Programmers%20Manual.pdf]]
  [11] https://savannah.nongnu.org/projects/stage0
  [12] https://nlnet.nl/project/GNUMes
  [13] https://nlnet.nl/project/GNUMes-arm
  [14] https://nlnet.nl/project/GNUMes-ARM_RISC-V

* Legalese
Copyright © 2016,2017,2018,2019,2020,2021,2022,2023 Jan (janneke) Nieuwenhuizen <[[mailto:janneke@gnu.org][janneke@gnu.org]]>

  Copying and distribution of this file, with or without modification,
  are permitted in any medium without royalty provided the copyright
  notice and this notice are preserved.