Split and cleanup of Porters Handbook
Remko Lodder
remko at FreeBSD.org
Wed Jun 14 16:18:05 UTC 2006
Simon L. Nielsen wrote:
> 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?
>
No better ideas, go for it!
--
Kind regards,
Remko Lodder ** remko at elvandar.org
FreeBSD ** remko at FreeBSD.org
/* Quis custodiet ipsos custodes */
More information about the freebsd-doc
mailing list