Documentation overhaul

docs/api/apple2-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### A note about Apple II
 

docs/api/bbcmicro-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### A note about BBC Micro
 

docs/api/command-line.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 # Command-line options
 
@@ -15,16 +15,19 @@
 *  `-o <file>` – Output filename, without extension.
 Extension will be added automatically,
 `.prg` for Commodore (including LUnix/LNG),
-`.a2` for Apple,
+`.crt` for Commodore cartridges,
 `.xex` for Atari computers,
-`.bin` for Atari VCS,
-`.nes` for NES,
-no extension for BBC micro program file,
-`.inf` for BBC Micro metadata,
-`.d88` for PC-88 disk images,
-`.com` for CP/M executables,
+`.a2` for Apple,
+`.dsk` for PC-88 disk images,
+`.tap` for ZX-Spectrum tape images,
 `.rom` for MSX cartridge images,
-`.tap` for ZX-Spectrum tape images.
+`.com` for CP/M executables,
+`.nes` for NES/Famicom,
+`.bin` for Atari 2600,
+no extension for BBC micro program file,
+`.inf` for BBC Micro file metadata,
+`.asm` for assembly output,
+`.lbl`, `.nl`, `.fns`, or `.sym` for label file.
 
 * `-s` – Generate also the assembly output. It is not compatible with any assembler, but it serves purely informational purpose. The file has the same nam as the output file and the extension is `.asm`.
 

docs/api/commodore-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### A note about Commodore 64
 

docs/api/cpc-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### A note about Amstrad CPC
 

docs/api/custom-platform.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ## Adding a custom platform
 

docs/api/famicom-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 # Famicom/NES programming guide
 

docs/api/gb-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 # Game Boy programming guide
 

docs/api/getting-started.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 # Getting started
 
@@ -21,6 +21,12 @@ Compile it using the following commandline:
 java -jar millfork.jar hello_world.mfk -o hello_world -t c64
 ```
 
+or if you're using a Windows native build:
+
+```
+millfork hello_world.mfk -o hello_world -t c64
+```
+
 Run the output executable (here using the VICE emulator):
 
 ```
@@ -31,20 +37,7 @@ x64 hello_world.prg
 
 The following options are obligatory when compiling your sources:
 
-* `-o FILENAME` – specifies the base name for your output file, an appropriate file extension will be appended:  
-`prg` for Commodore;
-`crt` for Commodore cartridges;
-`xex` for Atari computers;
-`a2` for Apple;
-`dsk` for PC-88;
-`tap` for ZX Spectrum;
-`rom` for MSX cartridges;
-`com` for CP/M;
-`nes` for Famicom;
-`bin` for Atari 2600;
-`inf` for BBC file metadata;
-`asm` for assembly output;
-`lbl`, `nl`, `fns`, or `sym` for label file
+* `-o FILENAME` – specifies the base name for your output file, an appropriate file extension will be appended.
 
 * `-t PLATFORM` – specifies the target platform.
 Each platform is defined in an `.ini` file in the include directory.

docs/api/lunix-programming-guide.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### A note about LUnix
 

docs/api/rom-vs-ram.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
 
 ### ROM vs RAM targets
 

docs/api/target-platforms.md

@@ -1,4 +1,4 @@
-[< back to index](../index.md)
+[< back to index](../README.md)
                                                       
 # Target platforms