Date: Wed, 14 Jun 2006 18:18:02 +0200 From: Remko Lodder <remko@FreeBSD.org> To: "Simon L. Nielsen" <simon@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: Split and cleanup of Porters Handbook Message-ID: <449036BA.2030803@FreeBSD.org> In-Reply-To: <20060613223307.GB1074@zaphod.nitro.dk> References: <20060613223307.GB1074@zaphod.nitro.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
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 */
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?449036BA.2030803>