documentation edits; edited file.allocate() to prevent runaway block accesses which results in a block never being de-allocated