Split and cleanup of Porters Handbook

[Simon L. Nielsen]

Hey,

For quite a while the Porters Handbook book.sgml has just been growing
and has for a while been way to big for comfort (at least to me), and
there has been talk on several occasions on splitting it.  book.sgml
is currently over 10000 lines long and 354KB.  Other than that, a big
part of the indentation is wrong, which is a pain at least for Emacs
users since it partly breaks automatic indentation.

So, I would like to split book.sgml into chapter files like we have
for the FreeBSD Handbook and fix/style the indentation is the process.

Currently the book.sgml,v file is 1.5MB which means that if we have to
repo-copy it for each of the 14 chapters that will result in 21MB
extra repository space, and due to style fixes "cvs annotate" still
won't be able to show the history right anyaway.  Yes, 21MB isn't much
on today's disks, but if it doesn't buy you anything I don't reallly
see a reason to get the extra repo space.

Therefor I suggest simply creating new files for each chapter without
repo-copy.  The last pre-split version of book.sgml will still be in
the repository so you can run cvs annotate on that for history.

So, are there strong objections to doing this, and/or do anyone have
better ideas for handling this?

-- 
Simon L. Nielsen
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20060614/d0f48de6/attachment.sig>