From c7e1fed2b921fb09fa55cf82ccec8535e0bd4caf Mon Sep 17 00:00:00 2001 From: "Kartik K. Agaram" Date: Sun, 27 Jun 2021 07:32:08 -0700 Subject: [PATCH] . --- README.md | 31 +++++++++++++++---------------- linux/bootstrap/README.md | 5 +++++ 2 files changed, 20 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index c4d9a811..13504cc2 100644 --- a/README.md +++ b/README.md @@ -179,18 +179,18 @@ Forks of Mu are encouraged. If you don't like something about this repo, feel free to make a fork. If you show it to me, I'll link to it here. I might even pull features upstream! -- [mu-normie](https://git.sr.ht/~akkartik/mu-normie): with a more standard - build system that organizes the repo by header files and compilation units. - Stays in sync with this repo. -- [mu-x86\_64](https://git.sr.ht/~akkartik/mu-x86_64): experimental fork for - 64-bit x86 in collaboration with [Max Bernstein](https://bernsteinbear.com). - It's brought up a few concrete open problems that I don't have good solutions - for yet. - [uCISC](https://github.com/grokthis/ucisc): a 16-bit processor being designed from scratch by [Robert Butler](https://www.youtube.com/channel/UCh4OpfF7T7UtezGejRTLxCw) and programmed with a SubX-like syntax. - [subv](https://git.s-ol.nu/subv): experimental SubX-like syntax by [s-ol bekic](https://mmm.s-ol.nu) for the RISC-V instruction set. +- [mu-x86\_64](https://git.sr.ht/~akkartik/mu-x86_64): experimental fork for + 64-bit x86 in collaboration with [Max Bernstein](https://bernsteinbear.com). + It's brought up a few concrete open problems that I don't have good solutions + for yet. +- [mu-normie](https://git.sr.ht/~akkartik/mu-normie): with a more standard + build system for the `linux/bootstrap/` directory that organizes the repo by + header files and compilation units. Stays in sync with this repo. ## Desiderata @@ -198,9 +198,14 @@ If you're still reading, here are some more things to check out: - [How to get your text editor set up for Mu and SubX programs.](editor/editor.md) -- [Some 2-minute videos demonstrating Mu programs](https://archive.org/details/@kartik_agaram). - Many of them involve this prototype live-updating programming environment - for a postfix language that I might work on again one day: +- [Videos demonstrating Mu programs and features.](https://archive.org/details/@kartik_agaram) + +- [A summary](mu_instructions) of how the Mu compiler translates statements + to SubX. Most Mu statements map to a single x86 instruction. + ([colorized version](http://akkartik.github.io/mu/html/mu_instructions.html)) + +- A prototype live-updating programming environment for a postfix language + that I might work on again one day: ```sh cd linux @@ -208,12 +213,6 @@ If you're still reading, here are some more things to check out: ./a.elf screen ``` -- [A summary](mu_instructions) of how the Mu compiler translates statements - to SubX. Most Mu statements map to a single x86 instruction. - ([colorized version](http://akkartik.github.io/mu/html/mu_instructions.html)) - -- [Some details on the unconventional organization of this project.](http://akkartik.name/post/four-repos) - - Previous prototypes: [mu0](https://github.com/akkartik/mu0), [mu1](https://github.com/akkartik/mu1). ## Credits diff --git a/linux/bootstrap/README.md b/linux/bootstrap/README.md index dcf1f79d..5ac3cecf 100644 --- a/linux/bootstrap/README.md +++ b/linux/bootstrap/README.md @@ -25,3 +25,8 @@ identical binaries should help gain confidence in Mu. Remember, not all 32-bit Linux binaries are guaranteed to run. I'm not building general infrastructure here for all of the x86 instruction set. SubX is about programming with a small, regular subset of 32-bit x86. + +## Hacking + +This directory is the only C++ code in the project, and has [an unconventional +organization](http://akkartik.name/post/four-repos).