Re: Split and cleanup of Porters Handbook

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@elvandar.org
      FreeBSD                    ** remko@FreeBSD.org

      /* Quis custodiet ipsos custodes */
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"