start populating book

FossilOrigin-Name: 6f3f5279812a70a944fc4814348a2c735b387c00a8e5bb8448c5fa2d2fa5a9d3

book/000-Book-Format

@@ -0,0 +1,12 @@
+Formatting uses Markdown.
+
+# Chapter Title
+
+## Section Title
+
+Paragraph text.
+
+```
+example code
+```
+

book/Building-BSD

@@ -0,0 +1,25 @@
+# Building RETRO
+
+## Requirements
+
+- c compiler (tested: clang, tcc, gcc)
+- make
+- standard unix shell
+
+## Process
+
+Run `make`.
+
+This will build the toolchain and then the main `retro`
+executable.
+
+## Executables
+
+In the `bin/` directory:
+
+    retro
+    retro-unu
+    retro-muri
+    retro-extend
+    retro-embedimage
+

book/Building-Linux

@@ -0,0 +1,25 @@
+# Building RETRO
+
+## Requirements
+
+- c compiler (tested: clang, tcc, gcc)
+- make
+- standard unix shell
+
+## Process
+
+Run `make -f Makefile.linux`.
+
+This will build the toolchain and then the main `retro`
+executable.
+
+## Executables
+
+In the `bin/` directory:
+
+    retro
+    retro-unu
+    retro-muri
+    retro-extend
+    retro-embedimage
+

book/Building-Windows

@@ -0,0 +1,19 @@
+## C#: retro.cs
+
+This is an implementation of `retro-repl` in C#. As with
+`retro-repl` it requires the `ngaImage` in the current
+directory when starting.
+
+Building:
+
+    csc retro.cs
+
+You'll need to make sure your path has the CSC.EXE in it,
+or provide a full path to it. Something like this should
+reveal the path to use:
+
+    dir /s %WINDIR%\CSC.EXE
+
+I've only tested building this using Microsoft's .NET tools.
+It should also build and run under Mono.
+

book/Building-macOS

@@ -0,0 +1,25 @@
+# Building RETRO
+
+## Requirements
+
+- c compiler (tested: clang, tcc, gcc)
+- make
+- standard unix shell
+
+## Process
+
+Run `make`.
+
+This will build the toolchain and then the main `retro`
+executable.
+
+## Executables
+
+In the `bin/` directory:
+
+    retro
+    retro-unu
+    retro-muri
+    retro-extend
+    retro-embedimage
+