preliminary documenation on file generators