Not to get too far off-topic here, but:
On Aug 20, 2004, at 4:22 PM, Jean T. Anderson wrote:
But instead of one file per book, they are organized into many files per
book. forrest consumes the files in the src tree and spits out html
files into the build tree -- and the result is so very many files that
the Derby community may want to revisit this later.
How many files are in the compiled documentation? As the number of files goes up, the value of including all of those files in the tree with the source goes down, particularly if they are available on the website.
Would it be possible to have them output as a single file per book? If it were only 5 or 6 files, it would still be worthwhile (meaning: not annoying) to have the documentation versioned along with the source it documents.
andrew
