Low level residue decode pseudo code makes no sense
I can't get a direct implementation of the pseudo code to work at all. There's
obvious problems with it such as:
20. if ([classword_count] is less than [classvals_per_codeword]) AND
([partition_count] is less than [partitions_to_read) then continue at step 11
which loops to the wrong point so that classword_count is only ever used as
value 0. In the end I worked out what the implementation in vorbis/lib/res0.c
does and reimplemented it.
The handling of format 2 isn't documented well. The information is there but
it's all implied and not put into pseudo code. Subtle things like the
do_not_decode_flags specifics for format 2 aren't in code.
It's not all bad - this is actually the only part of the entire documentation
I've found unusable.