Subject: | documentation for raw read() interleave option is misleading |
Misleading is somewhat of an understatement; it almost always breaks
unless you do the opposite of what it says.
Imager/Files.pod states that "normally" raw files are not interleaved,
and proceeds to explain that interleaving can be turned on by using
interleave => 1. The logical assumption after reading this is that
non-interleaved files can be loaded with no special options, however,
looking at the code or running a simple test case indicates that
interleave is enabled by default and needs to be forced to 0 for
"normal" files.