doc: Release udpate.
* HACKING: Update. * INSTALL: Update. * NEWS: Update. * README: Update. * doc/ANNOUNCE-0.11: New file.
This commit is contained in:
parent
d111d64e50
commit
48e8711c38
57
HACKING
57
HACKING
|
@ -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
|
||||||
|
|
4
INSTALL
4
INSTALL
|
@ -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
11
NEWS
|
@ -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
8
README
|
@ -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
70
doc/ANNOUNCE-0.11
Normal 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
|
Loading…
Reference in a new issue