functionally completed PreAllocatingFileOutputStream.java; but is too slow
removed PreAllocatingFileOutputStream as it was not an improvement; captured results of experiment under new docs directory
compilation is now directed straight to a jar file; takes about the same length of time as compiling to separate files.  Which is fab, as it avoids a separate packaging phase.  0.8s for jc vs 4s maven.