doc: Release udpate.

* HACKING: Update.
* INSTALL: Update.
* NEWS: Update.
* README: Update.
* doc/ANNOUNCE-0.11: New file.
This commit is contained in:
Jan Nieuwenhuizen 2017-11-11 13:09:26 +01:00
parent d111d64e50
commit 48e8711c38
5 changed files with 124 additions and 28 deletions

57
HACKING
View file

@ -41,41 +41,56 @@ Running ./make.scm produces a `script' file.
* ROADMAP * ROADMAP
** TODO ** TODO
*** release 0.11 *** release 0.12
- mescc: compile a mes-tcc that can compile gcc-4.7. - mescc: compile a mes-tcc that can compile gcc-4.7.
*** release 0.x, unsorted *** release 0.x, unsorted
- mescc: refactor type(/ptr?) system; expr->type and ast-type->type.
- mescc: refactor initializers.
- mescc: record and support function types, and thus foo ()->bar.
- mescc: refactor switch statement to support unpatched tinycc.
- mes/mescc: bootstrap a minimal-Guile (libguile/eval.c,ice-9/eval.scm).
- mescc: have mes-tcc pass all scaffold/tests, scaffold/tinycc tests.
- mescc: compile a mes-tcc that can compile gcc-4.7.
- mescc: refactor switch; support heterogeneous switch case.
- mescc: support sizeof any expr.
- mescc: support function-static.
- mescc: support/grok global static.
- mescc: support unsigned comparison, arithmetic. - mescc: support unsigned comparison, arithmetic.
- mescc: support long long.
- mescc: support bitfields. - mescc: support bitfields.
- mescc: support floats. - mescc: support floats.
- mescc: some success with 8cc/pcc/libguile/eval.c. - mescc: some success with 8cc,pcc,guile/libguile/eval.c.
- build: guile/guix/make.scm: add file-types, intermediate, hash all dependencies - build: guile/guix/make.scm: add file-types, intermediate, hash all dependencies
- build: make.scm: imperative->declaritive - build: make.scm: imperative->declaritive
- hex2: produce ELF_sym and ELF_str tables from hex2; nicer for objdump -d, gdb (in mescc-tools?) - hex2: produce ELF_sym and ELF_str tables from hex2; nicer for objdump -d, gdb (in mescc-tools?)
- compile src/mes.c with M2-Planet.
- rewrite src/mes.c in stage0's stage2 LISP. - rewrite src/mes.c in stage0's stage2 LISP.
- and/or: rewrite src/mes.c M1 - and/or: rewrite src/mes.c M1
- and/or: connect to GNU Epsilon's VM - and/or: connect to GNU Epsilon's VM
- and/or: compile Scheme to C, rewrite Mes.c into Mes.scm. - and/or: compile Scheme to C, rewrite Mes.c into Mes.scm.
- real module support, bonus for supporting Guile's define-module/define-public syntax - real module support, bonus for supporting Guile's define-module/define-public syntax.
- get full source syntax-case up (Andre van Tonder?) OR drop it - get full source syntax-case up (Andre van Tonder?) OR drop it.
psyntax/syntax-case and rewrite Nyacc without syntax-case+R7RS Ellipsis psyntax/syntax-case and rewrite Nyacc without syntax-case+R7RS Ellipsis.
- support regexp OR rewrite Nyacc without regexps - support regexp OR rewrite Nyacc without regexps.
- split-off Guile C compiler as standalone Guile project - split-off MesCC as as standalone Guile C compiler project.
*** release 1.0 *** release 1.0
- work to replace GuixSD's bootstrap binaries for x86 - replace GuixSD's bootstrap binaries for x86.
- add x86_64, replace GuixSD's bootstrap binaries for x86_64.
- more architectures? - more architectures?
** DONE ** DONE
** 0.10: Mescc now compiles a mes-tcc that compiles a trivial C to a running a.out. *** 0.11: MesCC now compiles a mes-tcc that passes 41/69 of mescc's C tests.
** 0.9: Mescc now writes M1 macro assembly files and compiles tcc. *** 0.10: Mescc now compiles a mes-tcc that compiles a trivial C to a running a.out.
** 0.8: Mescc now writes object files in stage0's labeled hex2 format. *** 0.9: Mescc now writes M1 macro assembly files and compiles tcc.
** 0.7: Mescc supports -E, -c, -o options, include more complete set of header files, *** 0.8: Mescc now writes object files in stage0's labeled hex2 format.
enough to work on compiling tinycc's tcc.c albeit a somewhat modified version. *** 0.7: Mescc supports -E, -c, -o options, include more complete set of header files,
** 0.6: Work with unmodified, unbundled Nyacc; compile 33/55 tinycc's tests/test2 suite. eenough to work on compiling tinycc's tcc.c albeit a somewhat modified version.
** 0.5: Mutual self-hosting Scheme interpreter and C compiler: mes.c and mescc, *** 0.6: Work with unmodified, unbundled Nyacc; compile 33/55 tinycc's tests/test2 suite.
*** 0.5: Mutual self-hosting Scheme interpreter and C compiler: mes.c and mescc,
Support call-with-current-continuation, refactor catch/throw Support call-with-current-continuation, refactor catch/throw
** 0.4: Support Nyacc, Gcc-compiled Mes compiles minimal main.c using nyacc *** 0.4: Support Nyacc, Gcc-compiled Mes compiles minimal main.c using nyacc
** 0.3: Garbage collector *** 0.3: Garbage collector
** 0.2: Support psyntax *** 0.2: Support psyntax
** 0.1: Mes eval/apply feature complete; support syntax-rules, compile main.c using LALR, dump ELF *** 0.1: Mes eval/apply feature complete; support syntax-rules, compile main.c using LALR, dump ELF
* Bugs * Bugs
** eval_apply/gc + Nyacc bug ** eval_apply/gc + Nyacc bug
@ -88,7 +103,8 @@ may [un]cover the bug. So there is probably some eval_apply-construct
that Nyacc uses, possiblby indirectly via with-fluid, like (call/cc, that Nyacc uses, possiblby indirectly via with-fluid, like (call/cc,
call-with-current-continuation), that breaks when GC triggers at the call-with-current-continuation), that breaks when GC triggers at the
wrong time. wrong time.
** mescc can only compile itself, it cannot compile tcc, gcc or guile ** mescc can only compile itself, it cannot full-functionally compile tcc, gcc or guile
** mescc: 7n-struct-struct-array.c: struct file f = {"first.h"};
** mes.mes cannot read sexps, only --dump's, mes.mes cannot --dump ** mes.mes cannot read sexps, only --dump's, mes.mes cannot --dump
** Bootstrap binary mes is too big and opaque to be considered source ** Bootstrap binary mes is too big and opaque to be considered source
68kB ELF binary which can be disassembled (objdump -d mes.mes). 68kB ELF binary which can be disassembled (objdump -d mes.mes).
@ -213,6 +229,7 @@ support all C11 language features while keeping the code as small and
simple as possible. simple as possible.
*** pcc *** pcc
*** early GCC? *** early GCC?
https://miyuki.github.io/2017/10/04/gcc-archaeology-1.html
*** [[http://tack.sourceforge.net/][ack]] *** [[http://tack.sourceforge.net/][ack]]
<rain1> it may be possible to compile like this: mes |> ack |> pcc |> tcc |> <rain1> it may be possible to compile like this: mes |> ack |> pcc |> tcc |>
gcc 4.7.4 |> gcc later version... up to modern gcc 4.7.4 |> gcc later version... up to modern

View file

@ -9,7 +9,7 @@ Building and Installing Mes
** Bootstrapping ** Bootstrapping
For bootstrapping, the M1 macro assembler and hex2 linker and Nyacc For bootstrapping, the M1 macro assembler and hex2 linker and Nyacc
*** [[https://github.com/oriansj/mescc-tools][mescc-tools]], 0.2 is known to work. *** [[https://github.com/oriansj/mescc-tools][mescc-tools]], 0.2 is known to work.
*** [[https://savannah.gnu.org/projects/nyacc][Nyacc]], 0.81.0 is known to work. *** [[https://savannah.gnu.org/projects/nyacc][Nyacc]], 0.82.4 is known to work.
For development For development
** Development ** Development
For development, there are some more dependencies. For development, there are some more dependencies.
@ -20,7 +20,7 @@ For development, there are some more dependencies.
*** Other GNU/Linux *** Other GNU/Linux
**** [[https://github.com/oriansj/mescc-tools][mescc-tools]], 0.2 is known to work. **** [[https://github.com/oriansj/mescc-tools][mescc-tools]], 0.2 is known to work.
**** [[https://savannah.gnu.org/projects/nyacc][Nyacc]], [[https://gitlab.com/janneke/nyacc][0.80.41 {patched 0.80.4}]] is known to work. **** [[https://savannah.gnu.org/projects/nyacc][Nyacc]], 0.82.4 is known to work.
**** GNU Gcc, 4.9.3 is known to work. **** GNU Gcc, 4.9.3 is known to work.
The idea is to drop this requirement, of course. The idea is to drop this requirement, of course.

11
NEWS
View file

@ -10,12 +10,21 @@ Copyright © 2016,2017 Jan Nieuwenhuizen <janneke@gnu.org>
Please send Mes bug reports to janneke@gnu.org. Please send Mes bug reports to janneke@gnu.org.
* Changes in 0.11 since 0.10
** MesCC
*** MesCC now compiles a mes-tcc that passes 41/69 of mescc's C tests.
*** Messc's libc can now be compiled with tcc (syscall support: write).
*** Messc now compiles a less-patched tcc: -214/+458 lines [WAS: -333/+747].
*** MesCC now supports empty for.
*** MesCC has been greatly refactored, 500/3000 lines have been removed.
*** MesCC now supports complex [struct] by value assign foo.bar, foo->bar, foo[bar].
*** MesCC now depends on Nyacc 0.82.4.
* Changes in 0.10 since 0.9 * Changes in 0.10 since 0.9
** Core ** Core
*** 2 new functions *** 2 new functions
logand, lognot. logand, lognot.
** Mescc
*** Mes now includes M1 sources for full source bootstrapping up to tcc. *** Mes now includes M1 sources for full source bootstrapping up to tcc.
** Mescc
*** Mescc now depends on Nyacc 0.81.0. *** Mescc now depends on Nyacc 0.81.0.
*** Mescc now compiles a mes-tcc that compiles a trivial C to a running a.out. *** Mescc now compiles a mes-tcc that compiles a trivial C to a running a.out.
*** Mescc now supports several (as used my tinycc) struct by value assignments. *** Mescc now supports several (as used my tinycc) struct by value assignments.

8
README
View file

@ -13,10 +13,10 @@ 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]], 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]], 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 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 (repl.mes) and simple C-compiler (mescc.mes). REPL (repl.mes) and simple C-compiler MesCC (mescc.mes).
The simple C compiler can now compile a [[https://gitlab.com/janneke/tinycc][modified TinyCC]]. This needs MesCC can compile a [[https://gitlab.com/janneke/tinycc][modified TinyCC]] that is close to being
more work. A with gcc compiled tcc is [[https://lists.gnu.org/archive/html/tinycc-devel/2017-05/msg00103.html][known]] to compile GCC. self-hosting. A GNU Ccc-compiled tcc is [[https://lists.gnu.org/archive/html/tinycc-devel/2017-05/msg00103.html][known]] to compile GCC.
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 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 McCarthy page 13, GNU Guix's source/binary packaging transparency and
@ -51,7 +51,7 @@ General Public Licence version 3 or later. See the file COPYING.
scripts/repl.mes scripts/repl.mes
* Mescc compiler * MesCC compiler
scripts/mescc.mes scaffold/main.c > a.out scripts/mescc.mes scaffold/main.c > a.out

70
doc/ANNOUNCE-0.11 Normal file
View file

@ -0,0 +1,70 @@
Subject: Mes 0.11 released
I am pleased to announce the release of Mes 0.11, representing 16
commits over 10 weeks. MesCC now compiles a less heavily patched
TinyCC into a mes-tcc that in turn passes 41/69 of mescc's C tests.
When mes-tcc passes all 69 tests, this almost-full-source-bootstrapped
version of TinyCC should be able to compile itself. An unpatched, GNU
Gcc-compiled tcc is known to compile GNU Gcc.
* About
Mes[0] aims to create full source bootstrapping for GuixSD[1] as
part of the bootstrappable builds[2] project.
It currently consists of a mutual self-hosting [close to Guile-]
Scheme interpreter prototype in C and a Nyacc-based C compiler in
[Guile] Scheme. This C prototype will be rewritten in stage0[3]
M1 assembly (or compiled by M2-Planet or stage2 slow-LISP, or ...).
The Scheme interpreter prototype (mes.c) has a Garbage Collector,
a library of loadable Scheme modules-- notably Dominique Boucher's
LALR[4], Pre-R6RS portable syntax-case[5] with R7RS ellipsis, Matt
Wette's Nyacc[6], Guile's PEG[7] --and test suite just barely
enough to support a simple REPL (repl.mes) and simple C-compiler
MesCC (mescc.mes).
MesCC can compile a modified TinyCC[8] that is close to being
self-hosting. A GNU Ccc-compiled tcc is known[9] to compile GCC.
Mes is inspired by The Maxwell Equations of Software: LISP-1.5[10]
-- John McCarthy page 13, GNU Guix's source/binary packaging
transparency and Jeremiah Orians's stage0 ~300 byte self-hosting
hex assembler.
* Download
git clone https://gitlab.com/janneke/mes
wget https://gitlab.com/janneke/mes/repository/archive.tar.gz?ref=v0.11 -O mes-0.11.tar.gz
Mes runs from the source tree and can also be built, packaged and
installed in Guix[SD] by the usual
guix package -f guix.scm
* Changes in 0.11 since 0.10
** MesCC
*** MesCC now compiles a mes-tcc that passes 41/69 of mescc's C tests.
*** MesCC's libc can now be compiled with tcc (syscall support: write).
*** MesCC now compiles a less-patched tcc: -214/+458 lines [WAS: -333/+747].
*** MesCC now supports empty for.
*** MesCC has been greatly refactored, 500/3000 lines have been removed.
*** MesCC now supports complex [struct] by value assign foo.bar, foo->bar, foo[bar].
*** MesCC now depends on Nyacc 0.82.4.
Greetings,
janneke
[0] https://gitlab.com/janneke/mes
[1] https://www.gnu.org/software/guix
[2] http://bootstrappable.org
[3] https://github.com/oriansj/stage0
[4] https://github.com/schemeway/lalr-scm
[5] https://www.cs.indiana.edu/chezscheme/syntax-case/old-psyntax.html
[6] https://www.nongnu.org/nyacc/
[7] https://www.gnu.org/software/guile/docs/master/guile.html/PEG-Parsing.html
[8] https://gitlab.com/janneke/tinycc
[9] https://lists.gnu.org/archive/html/tinycc-devel/2017-05/msg00103.html
[10] http://www.softwarepreservation.org/projects/LISP/book/LISP%25201.5%2520Programmers%2520Manual.pdf