89ce0166723f1d6103de86d44493b6475d1d02af
[mes.git] / NEWS
1                                                               -*- org -*-
2 #+TITLE: Mes NEWS – history of user-visible changes
3 #+STARTUP: content hidestars
4
5 Copyright © 2016,2017 Jan Nieuwenhuizen <janneke@gnu.org>
6
7   Copying and distribution of this file, with or without modification,
8   are permitted in any medium without royalty provided the copyright
9   notice and this notice are preserved.
10
11 Please send Mes bug reports to janneke@gnu.org.
12
13 * Changes in 0.10 since 0.9
14 ** Core
15 *** 2 new functions
16 logand, lognot.
17 ** Mescc
18 *** Mes now includes M1 sources for full source bootstrapping up to tcc.
19 *** Mescc now depends on Nyacc 0.81.0.
20 *** Mescc now compiles a mes-tcc that compiles a trivial C to a running a.out.
21 *** Mescc now supports several (as used my tinycc) struct by value assignments.
22 *** Mescc now has _start in a separate crt1.c.
23 *** Mescc now supports initializer arithmetic.
24 *** Mescc now supports arrays of struct of arbitrary size.
25 *** Mescc now supports pointer arithmetic.
26 *** Mescc now defines __i386__, __linux__.
27 *** Mescc now supports --*p, ++*p.
28 *** Mescc now supports int foo[bar] = {baz,...}.
29 *** Mescc now supports \x00 in strings in M1.
30 *** Mescc now supports complex enum expressions.  Thanks, rain1!
31 *** Mescc now supports short.
32 *** Mescc now supports foo.bar = foo.baz = bla.
33 *** Mescc now supports foo = bar < baz and comparison permutations.
34 *** Mescc now supports (anonymous) structs in unions.
35 *** Mescc now writes M1 strings if possible.
36 **** 2 improved mlibc functions
37 malloc, realloc.
38 **** 13 new mlibc functions
39 fclose, fgetc, fprintf, fwrite, memcpy, memmove, memset, snprintf, strcat,
40 strchr, strrchr, strtoull, vnsprintf.
41 **** 15 new tinycc-support tests
42 76-pointer-arithmetic.c, 77-pointer-assign.c, 78-union-struct.c,
43 79-int-array.c, 7a-struct-char-array.c, 7b-struct-int-array.c,
44 7c-dynarray.c, 7d-cast-char.c, 7e-struct-array-access.c,
45 7f-struct-pointer-arithmetic.c, 7g-struct-byte-word-field.c,
46 7h-struct-assign.c, 7i-struct-struct.c, 7j-strtoull.c,
47 7k-for-each-elem.c.
48 ** Noteworthy bug fixes
49 *** Mescc has many fixes for foo.bar[baz], foo[bar].baz with ./-> permutations.
50 *** Many bugs and limitations in mescc have been fixed and removed.
51 * Changes in 0.9 since 0.8
52 ** Core
53 *** Mes now builds better in non-Guix[SD] legacy distros/environments.  Thanks, rain1!
54 ** Mescc
55 *** Mescc now compiles a modified tinycc into a running [mostly segfaulting] mes-tcc.
56 https://gitlab.com/janneke/tinycc branch wip-mescc.
57 *** Mescc now supports locals stack frame larger than 1 byte offset.
58 *** Mescc now supports incomplete struct initializers {0}.
59 *** Mescc now supports >>=, <<=, ^=, ~.
60 *** Mescc now supports the comma operator.
61 *** Mescc now supports mullti-line string initializers.
62 *** Mescc now supports unions.
63 *** Mescc now supports arrays in structs.
64 *** Mescc now supports structs in structs.
65 *** Mescc now builds and runs with Guile-2.0 (legacy distro support, Guile-2.2 recommended).
66 *** Mescc has been refactored to use records.
67 *** Mescc now bundles tinycc's test2 test suite, passes one more test [34/55 pass].
68 *** Mescc now has an incremental test suite consisting of 56 tests.
69 *** Mescc now supports stdarg variable argument lists.
70 *** Mescc now has __GNUC__ unset, #f (WAS: 0).
71 *** Mescc now depends on Nyacc 0.80.3.
72 *** Mescc now depends on M1 from [[https://github.com/oriansj/mescc-tools][mescc-tools]] v0.2.
73 *** Mescc now compiles to M1 object files.
74 **** 7 new mlibc functions
75 calloc, close, getcwd, lseek, sprintf, unlink, vprintf.
76 **** 31 new mlibc stubs
77 execvp, fclose, fdopen, fflush, fopen, fprintf, fread, free, fseek,
78 ftell, fwrite, localtime, longjmp, memcpy, memmove, memmove, memset,
79 qsort, remove, setjump, snprintf, sscanf, strchr, strrchr, strstr,
80 strtol, strtoll, strtoul, strtoull, time, vnsprintf.
81 **** 10 new header files
82 alloca.h, float.h, libgen.h, locale.h, stdbool.h, stddef.h, stdint.h,
83 stdnoreturn.h, sys/select.h, sys/wait.h.
84 ** Noteworthy bug fixes
85 *** Many bugs and limitations in mescc have been fixed and removed.
86 * Changes in 0.8 since 0.7
87 ** Mescc
88 *** Mescc now has experimental annotation support for hex2.
89 *** Mescc now depends on the hex2 linker from [[https://github.com/oriansj/mescc-tools][mescc-tools]].
90 Direct ELF output support has been removed.
91 ELF symbol and string table creation has been removed.
92 *** Mescc has been simplified by leveraging use labels in hex2 output.
93 *** Mescc now supports continue in loops.
94 *** Mescc now compiles to hex2 object files.
95 ** Language
96 *** 1 new function
97 list-index.
98 * Changes in 0.7 since 0.6
99 ** Core
100 *** The minimal C reader is now always included; dependencies
101 on i686-unknown-linux-gnu-gcc and binary read-0-32.mo have been
102 dropped, these are now optional.
103 ** Language
104 *** Mes reader now supports octal numbers #oXXX.
105 *** 10 new functions
106 current-output-port, getopt-long, negate, open-output-file,
107 option-ref, set-current-output-port, string-rindex, string-suffix?,
108 with-ouwith-output-to-file, with-output-to-port.
109 ** Mescc
110 *** Mescc can now be installed and used alongside a gcc installation.
111 *** Mescc can now handle const anywhere.
112 *** Mescc now supports array fields in structs.
113 *** Mescc now supports forward declarations and typedef.
114 *** Mescc can now handle comments anywhere.
115 *** Mescc now supports addition and substraction for enum field values.
116 *** Mescc now supports anonymous enums.
117 *** Mescc now supports all C99 header files needed to compile tcc.c.
118 *** build: C sources are now preprocessed separately, then compiled and linked.
119 *** build: mlibc and C sources are now compiled separately and then linked.
120 *** mlibc has been moved from Scheme snippets into C.
121 *** Mescc now supports -c, -D, -E, -I and -o options.
122 **** open now supports optional third mode parameter.
123 ** Noteworthy bug fixes
124 *** string-index now supports function predicate.
125 *** number->string for radix > 10 now produces `a' instead of `:'.
126 * Changes in 0.6 since 0.5
127 ** Core
128 *** configure, build now supports x86 and development for arm with-courage.
129 ** Language
130 *** Nyacc has been unbundled and is now a dependency.
131 *** Mes now supports case-lambda.
132 *** Mes reader now supports abbreviated form for return character #\cr.
133 *** 1 new function
134 string-index.
135 ** Mescc
136 *** Mescc can be used on regular C sources, like tinycc's tests/test2 suite.
137 *** make check passes 33/55 of tinycc's test suite etest/test2 tests.
138 *** Mescc now recognizes `short' as a type.
139 *** Mescc now supports sizeof (<identifier>), sizeof(<expression>).
140 *** Mescc now respects enum field initializers and supports enum variables.
141 *** Mescc now supports binary constants .
142 *** Mescc now supports assignments from ==, != boolean expressions .
143 *** Mescc now supports &, ^.
144 *** Mescc now supports struct pointers.
145 *** Mescc now supports struct definition with immediatete variable declaration.
146 *** Mescc now supports calling (returning correctly from) void functions.
147 *** Mescc now handles case statements breaks without compound correctly.
148 *** Mescc now has better [int/pointer] array support.
149 *** Mescc now has better support for simple (non-array-)structs.
150 *** Mescc now supports multiple declarations in one statement like: int a,b;
151 **** 2 new mlibc functions
152 printf, strcpy.
153 ** Noteworthy bug fixes
154 *** Installed mes and mes.repl now also run outside of source tree again.
155 * Changes in 0.5 since 0.4
156 ** Core
157 *** Support compilation with Mescc.
158 *** Support compilation with -nostdinc, -nostdlib using mlibc.
159 *** Support call-with-current-continuation.
160 *** Support exception handling, catch/throw.
161 *** Give sensible error message when a macro is missing.
162 ** Language
163 *** Map now supports 4 lists.
164 *** The reader supports negative hex numbers.
165 *** 24 new functions
166 access?, assoc-set! c????r, compose, list->char-set,
167 open-input-string, read-string, string-delete, with-throw-handler.
168 ** Mescc
169 *** Mescc can be used separately as a Nyacc-based C compiler backend for Guile.
170 *** Switch to Nyacc frontend, update Nyacc to 0.76.5.
171 *** Mescc now has a test suite, scaffold/t.c.
172 *** Mescc now includes a minimal C library libc/mlib.c libc/mstart.c.
173 *** Mescc can now compile mes.c.
174 ** Noteworthy bug fixes
175 *** The build system (configure, make) has been refactored.
176 *** Support map-4.
177 *** Evaluate arguments of OR only once.
178 *** Fix assq-set!
179 *** Fix ,expand in the REPL.
180
181 * Changes in 0.4 since 0.3
182 ** Core
183 *** Improved performance.
184 Macros are now memoized; after expansion and before eval'ing the
185 expanded form, their input s-expression is replaced by the expansion.
186 This yields a nice performance improvement which finally allowed
187 moving all non-essential bits from the C-core into Scheme...including
188 the reader.  The Scheme reader is much, much slower than the previous
189 C version, making Mes--again-- feel slow.  Think of that as a feature.
190 *** Bootstrap with minimal reader in C.
191 The C-reader needs only support reading of words and lists
192 (s-expressions), line-comments to read the initial [[file:module/mes/read-0.mes][Scheme reader]] which
193 then takes over and handles reading of quoting, characters, strings,
194 block-comments.
195 *** Reduced size.
196 Total C size: ~1500LOC.  The main Mes evaluator is now ~1000LOC
197 including cell creation and garbage collector.  This code is able to
198 execute a Scheme program that has been loaded into memory.  Another
199 ~500LOC is spent to load a minimal Scheme program and to dump it, to
200 provide a small posix interface, math functions and do some error
201 reporting.
202 *** Programs can be dumped and loaded using --dump and --load.
203 ** Language
204 *** Minimal syntactic exception support for Nyacc.
205 *** Minimal syntactic fluids support for Nyacc.
206 *** Keywords are now supported.
207 *** Cond now supports =>.
208 *** Guile's optargs: lambda* and define* are now supported.
209 *** #;-comments are now supported.
210 *** Non-nested #| |#-comments are now supported.
211 *** Quasisyntax is now supported.
212 *** R7RS syntax-rules with custom ellipsis, with-ellipsis are now supported.
213 *** 9 new [partial] modules
214 (mes fluids), (mes nyacc), (mes optargs), (mes pmatch), (mes peg),
215 (srfi srfi-13), (srfi srfi-9-psyntax), (srfi srfi-26), (srfi srfi-43),
216 (rnrs arithmetic bitwise), (sxml xpath)
217 *** 36 new functions
218 1+, 1-, abs, and=>, append-reverse, ash, char<=?, char<?, char>=?,
219 char>?, even?, filter, delete, delq, vector-copy, fold, fold-right,
220 getenv, iota, keyword->symbol list-head, list-tail, negative?, odd?,
221 positive?, remove!, remove, string->number, string-copy,
222 string-prefix?, string=, string=?, symbol->keyword symbol-append,
223 symbol-prefix?, unless, write, zero?.
224 ** Noteworthy bug fixes
225 *** Macros are now memoized.
226 *** An error is reported when using a wrong number of arguments with a call.
227 *** Cond now evaluates its test clauses only once.
228 *** Append can also handle one argument.
229 *** For-each now supports 2 list arguments.
230 *** Map now supports 3 list arguments.
231 *** Backslash in string is supported.
232 *** Closure is not a pair.
233 *** All standard characters are supported.
234 *** Mescc now also runs in Guile.
235 * Changes in 0.3 since 0.2
236 ** Core
237 *** Number-based rather than pointer-based cells.
238 *** Garbage collector aka Jam scraper.
239 A variant on SICP's stop and copy Garbage Colletor (Jam Scraper?)
240 algorithm has been implemented.
241 *** The reader has been moved to Scheme.
242 ** Language
243 *** Simple loadable modules.
244 *** Srfi-9 and match use handwritten syntax-rules (mes-use-module (mes syntax)).
245 *** Optional syntax-case using psyntax (mes-use-module (mes psyntax)).
246 ** Noteworthy bug fixes
247 *** Srfi-0 has been fixed.
248 * Changes in 0.2 since 0.1
249 ** Core
250 *** Names of symbols and strings are list of characters [WAS: c-string].
251 *** Sc-expand from pre-R6RS's psyntax has been integrated.
252 *** Undefined variable error now shows the name of the undefined variable.
253 *** There is now only one SCM type for builtin functions.
254 *** Macro expansion has been cleaned-up.
255 ** Language
256 *** Mes now provides a subset of R6RS.
257 *** Mes now provides syntax-case.
258 *** Mes now provides `load'.
259 ** Noteworthy bug fixes
260 *** Using values as second parameter of builtin function yields first value.
261 *** Quoted internals (e.g. 'if 'lambda) are now symbols.
262 *** Syntax error now exits.
263 *** Make+Bash voodoo has been replaced by build-aux/mes-snarf.scm.
264 *** Apply now accepts multiple list arguments.
265 *** Apply of character, inernal, number, string is an error.
266 *** Quasisyntax reading
267
268 * Changes in 0.1 (since progress report #2)
269 ** Core
270 *** expand_macro is now a separate function.
271 *** A smaller core can now compiled using BOOT=1.
272 The smaller core does not provide define, define-macro, or quasiquote;
273 these are provided from a Scheme version of implemented eval/apply.
274 ** Language
275 *** Mes now provides a subset of R5RS.
276 *** Mes now provides let-syntax.
277 *** Mes now provides match.
278 *** Mes now provides quasisyntax, unsyntax and unsyntax-splicing.
279 ** User interface
280 *** Mes now provides a REPL, run:
281     scripts/repl.mes
282 *** Mes compiler can be run as a script:
283     scripts/mescc.mes doc/examples/main.c
284 *** Macro expansion can be inspected in the REPL, e.g.:
285     ,expand (and 0 1)
286 ** Noteworthy bug fixes
287 *** Performance: scripts/mescc.mes now takes 2s to compile main.c (was 1'20").
288 *** Symbols are now truly unique.
289   * '(), #t, #f are no longer symbols.