akkartik
/
mu
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
mu/linux
History
Kartik K. Agaram 71e4f38129 7842 - new directory organization 
Baremetal is now the default build target and therefore has its sources
at the top-level. Baremetal programs build using the phase-2 Mu toolchain
that requires a Linux kernel. This phase-2 codebase which used to be at
the top-level is now under the linux/ directory. Finally, the phase-2 toolchain,
while self-hosting, has a way to bootstrap from a C implementation, which
is now stored in linux/bootstrap. The bootstrap C implementation uses some
literate programming tools that are now in linux/bootstrap/tools.

So the whole thing has gotten inverted. Each directory should build one
artifact and include the main sources (along with standard library). Tools
used for building it are relegated to sub-directories, even though those
tools are often useful in their own right, and have had lots of interesting
programs written using them.

A couple of things have gotten dropped in this process:
  - I had old ways to run on just a Linux kernel, or with a Soso kernel.
    No more.
  - I had some old tooling for running a single test at the cursor. I haven't
    used that lately. Maybe I'll bring it back one day.

The reorg isn't done yet. Still to do:
  - redo documentation everywhere. All the README files, all other markdown,
    particularly vocabulary.md.
  - clean up how-to-run comments at the start of programs everywhere
  - rethink what to do with the html/ directory. Do we even want to keep
    supporting it?

In spite of these shortcomings, all the scripts at the top-level, linux/
and linux/bootstrap are working. The names of the scripts also feel reasonable.
This is a good milestone to take stock at.
 		2021-03-03 22:21:03 -08:00
..
advent2020 7842 - new directory organization 2021-03-03 22:21:03 -08:00
bootstrap 7842 - new directory organization 2021-03-03 22:21:03 -08:00
browse 7842 - new directory organization 2021-03-03 22:21:03 -08:00
raytracing 7842 - new directory organization 2021-03-03 22:21:03 -08:00
tile 7842 - new directory organization 2021-03-03 22:21:03 -08:00
000init.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
100.txt 7842 - new directory organization 2021-03-03 22:21:03 -08:00
101_write.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
102test.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
103kernel-string-equal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
104new-segment.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
105string-equal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
106stream.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
107trace.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
108write.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
109stream-equal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
110stop.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
110stop.subx. 7842 - new directory organization 2021-03-03 22:21:03 -08:00
110stop.subx.0 7842 - new directory organization 2021-03-03 22:21:03 -08:00
111read.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
112read-byte.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
113write-stream.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
114error.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
115write-byte.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
116write-buffered.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
117write-int-hex.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
118parse-hex-int.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
119error-byte.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
120allocate.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
121new-stream.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
122read-line.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
123slice.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
124next-token.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
125write-stream-data.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
126write-int-decimal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
127next-word.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
128subx-words.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
129emit-hex.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
130emit.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
131table.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
132slurp.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
133subx-widths.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
134emit-hex-array.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
135next-word-or-string.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
200.txt 7842 - new directory organization 2021-03-03 22:21:03 -08:00
201register-names.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
202write-int.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
203stack.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
300.txt 7842 - new directory organization 2021-03-03 22:21:03 -08:00
301array-equal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
302stack_allocate.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
303kernel-string.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
304screen.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
305keyboard.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
306files.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
307size.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
308allocate-array.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
309stream.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
310copy-bytes.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
311decimal-int.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
312copy.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
313index-bounds-check.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
314divide.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
315slice.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
400.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
401test.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
402time.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
403unicode.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
404stream.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
405screen.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
406int32.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
407right-justify.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
408float.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
409print-float-hex.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
410file.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
411string.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
412print-float-decimal.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
README.md 7842 - new directory organization 2021-03-03 22:21:03 -08:00
arith.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
assort 7842 - new directory organization 2021-03-03 22:21:03 -08:00
assort.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
braces 7842 - new directory organization 2021-03-03 22:21:03 -08:00
braces.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
calls 7842 - new directory organization 2021-03-03 22:21:03 -08:00
calls.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
crenshaw2-1.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
crenshaw2-1b.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
dquotes 7842 - new directory organization 2021-03-03 22:21:03 -08:00
dquotes.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex1.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex1.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex2.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex2.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex3.2.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex3.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex3.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex4.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex5.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex6.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex7.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex8.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex9.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex10.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex11.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex12.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex13.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
ex14.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
factorial.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
factorial.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
factorial2.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
factorial3.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
factorial4.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
hello.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
hex 7842 - new directory organization 2021-03-03 22:21:03 -08:00
hex.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
mu-init-test.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
mu-init.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
mu.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
pack 7842 - new directory organization 2021-03-03 22:21:03 -08:00
pack.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
parse-int.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
print-file.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
random.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
rpn.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
sigils 7842 - new directory organization 2021-03-03 22:21:03 -08:00
sigils.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
stats.txt 7842 - new directory organization 2021-03-03 22:21:03 -08:00
subx-params.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
survey_baremetal 7842 - new directory organization 2021-03-03 22:21:03 -08:00
survey_baremetal.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
survey_elf 7842 - new directory organization 2021-03-03 22:21:03 -08:00
survey_elf.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
test_apps 7842 - new directory organization 2021-03-03 22:21:03 -08:00
test_apps_emulated 7842 - new directory organization 2021-03-03 22:21:03 -08:00
tests 7842 - new directory organization 2021-03-03 22:21:03 -08:00
tests.subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
texture.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate_debug 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate_emulated 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate_subx 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate_subx_debug 7842 - new directory organization 2021-03-03 22:21:03 -08:00
translate_subx_emulated 7842 - new directory organization 2021-03-03 22:21:03 -08:00
tui.mu 7842 - new directory organization 2021-03-03 22:21:03 -08:00

README.md

Some apps written in SubX and Mu. Check out:

  • tile: An experimental live-updating postfix shell environment that updates as you type. Prototype. Look at this to see what is currently possible, not how I recommend building software.

    tile app

  • browse: A text-mode browser for a tiny subset of Markdown.

  • ex*: small stand-alone examples that don't need any of the shared code at the top-level. They each have a simple pedagogical goal. Read these first.

  • factorial*: A simple program to compute factorials in 5 versions, showing all the different syntax sugars and what they expand to.

  • Code unique to phases of our build toolchain:

    • Core SubX: hex, survey_elf, pack, dquotes, assort, tests
    • Syntax sugar for SubX: sigils, calls, braces
    • More ambitious translator for a memory-safe language (in progress): mu

  • Miscellaneous test programs.

All SubX apps include binaries. At any commit, an example's binary should be identical bit for bit with the result of translating the corresponding .subx file. The binary should also be natively runnable on a Linux system running on Intel x86 processors, either 32- or 64-bit. If either of these invariants is violated, it's a bug.