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