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