Programmers guide in pdf and MS Word formats

.gitignore

@@ -0,0 +1 @@
+release/*

X16 Reference - 02 - Editor.md

@@ -179,7 +179,7 @@ On boot, the US layout (`ABC/X16`) is active:
 | Shift+Alt+`b`     | ²      |
 | Shift+Alt+`/`     | ¿      |
 
-(The X16 logo is code point \xad, SHY, soft-hyphen.)
+(The X16 logo is code point \\xad, SHY, soft-hyphen.)
 
 The following combinations are dead keys:
 

X16 Reference - 09 - Sound Programming.md

@@ -458,9 +458,9 @@ Range|Type|Description
   </tr>
 </table>
 
-## YM2151 Register Details
+### YM2151 Register Details
 
-### Global Parameters:
+#### Global Parameters:
 
 **LR** (LFO Reset)
 
@@ -581,7 +581,7 @@ Register $1B, Bits 0-1
 Sets the LFO waveform:
 0: Sawtooth, 1: Square (50% duty cycle), 2: Triangle, 3: Noise
 
-### Channel Control Parameters:
+#### Channel Control Parameters:
 
 **RL** (Right/Left output enable)
 
@@ -647,7 +647,7 @@ Sensitivity values: (dB)
 -|-|-|-
 0|23.90625|47.8125|95.625
 
-### Operator Control Parameters:
+#### Operator Control Parameters:
 
 Operators are arranged as follows:
 

build-release.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -euo pipefail
+pandoc --version || {
+    echo Install the following commands:
+    echo sudo apt install pandoc texlive texlive-xetex
+}
+mkdir -p release
+rm -f programmers-guide.md
+echo Generating pdf...
+find . -iname "X16 *.md" -print0 | sort --zero-terminated \
+    | xargs -0 pandoc --file-scope    --pdf-engine=xelatex -o release/programmers-guide.pdf
+echo Generating docfile...
+find . -iname "X16 *.md" -print0 | sort --zero-terminated \
+    | xargs -0 pandoc --file-scope   -o release/programmers-guide.docx