about summary refs log tree commit diff stats
diff options
context:
space:
mode:
authorKartik K. Agaram <vc@akkartik.com>2021-06-27 07:32:08 -0700
committerKartik K. Agaram <vc@akkartik.com>2021-06-27 07:32:08 -0700
commitc7e1fed2b921fb09fa55cf82ccec8535e0bd4caf (patch)
tree7c14cfa4f5be913e0c6fb7142e24191ce8ed913e
parent372367f59a897162912d0646158bdea1e07d6e66 (diff)
downloadmu-c7e1fed2b921fb09fa55cf82ccec8535e0bd4caf.tar.gz
.
-rw-r--r--README.md31
-rw-r--r--linux/bootstrap/README.md5
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).