Make docs/ dir, move packedformat desc, add tracker{command,waveforms} notes

diff --git a/tracker/packedformat b/docs/packedformat
similarity index 100%
rename from tracker/packedformat
rename to docs/packedformat

diff --git a/docs/trackercommands b/docs/trackercommands
new file mode 100644 (file)
index 0000000..a335233
--- /dev/null
+++ b/docs/trackercommands
@@ -0,0 +1,18 @@
+ENC    CHAR    COMMAND
+---    ----    -------
+0      '0'     CHAN OFF (param ignored)
+1      'd'     OSC  DUTY (param = top 8 bits, bottom 8 set to 0)
+2      'f'     CHAN VOLUME DERIVATIVE (param)
+3      'i'     CHAN INTERTIA (param << 1)
+4      'j'     CHAN INSTRUMENT OFFSET (param)
+5      'l'     CHAN BEND DERIVATIVE (param)
+6      'm'     CHAN DUTY DERIVATIVE (param << 6)
+7      't'     CHAT INSTRUMENT WAIT (param)
+8      'v'     OSC  VOLUME (param)
+9      'w'     OSC  WAVEFORM (param)
+A      '+'     CHAN INSTRUMENT NOTE (param + tnote - 48)
+B      '='     CHAN INSTRUMENT NOTE (param)
+C      '~'     CHAN VDEPTH AND VRATE (param == ddddrrrr)
+D      n/a
+E      n/a
+F      n/a

diff --git a/docs/trackerwaveforms b/docs/trackerwaveforms
new file mode 100644 (file)
index 0000000..f9f33f4
--- /dev/null
+++ b/docs/trackerwaveforms
@@ -0,0 +1,8 @@
+Waveforms generate values in [-32,31]
+
+ENC    WF_     DUTY    P BITS
+---    ---     ----    ------
+00     TRI     N       TOP 7   Triangle wave
+01     SAW     N       TOP 6   Rising sawtooth
+02     PUL     Y       ALL     Square, duty is width in 16KHz samples
+03     NOI     N       N       Uniform noise