documentation, improve user io, tweak transposition tables