From owner-freebsd-doc@FreeBSD.ORG Sat Oct 8 09:02:17 2011 Return-Path: Delivered-To: doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4A6C2106567F; Sat, 8 Oct 2011 09:02:17 +0000 (UTC) (envelope-from marc@blackend.org) Received: from smtp6-g21.free.fr (unknown [IPv6:2a01:e0c:1:1599::15]) by mx1.freebsd.org (Postfix) with ESMTP id 015B68FC14; Sat, 8 Oct 2011 09:02:12 +0000 (UTC) Received: from emphyrio.blackend.org (unknown [88.179.1.53]) by smtp6-g21.free.fr (Postfix) with ESMTP id 4EDBD823E4; Sat, 8 Oct 2011 11:02:05 +0200 (CEST) Received: from emphyrio.blackend.org (localhost [127.0.0.1]) by emphyrio.blackend.org (8.14.5/8.14.4) with ESMTP id p9893phc002246; Sat, 8 Oct 2011 11:03:51 +0200 (CEST) (envelope-from marc@emphyrio.blackend.org) Received: (from marc@localhost) by emphyrio.blackend.org (8.14.5/8.14.4/Submit) id p9893p3Q002245; Sat, 8 Oct 2011 11:03:51 +0200 (CEST) (envelope-from marc) Date: Sat, 8 Oct 2011 11:03:51 +0200 From: Marc Fonvieille To: Doug Barton Message-ID: <20111008090351.GA1960@emphyrio.blackend.org> References: <20111007141312.GJ26743@acme.spoerlein.net> <4E8F0AA2.3020704@freebsd.org> <4E8F8873.4030006@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4E8F8873.4030006@FreeBSD.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 8.2-STABLE User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Ulrich =?iso-8859-1?Q?Sp=F6rlein?= , Rene Ladan , Gavin Atkinson , doc@FreeBSD.org, doceng@FreeBSD.org Subject: Re: Conversion to SVN X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 08 Oct 2011 09:02:17 -0000 On Fri, Oct 07, 2011 at 04:17:07PM -0700, Doug Barton wrote: > On 10/07/2011 14:15, Gavin Atkinson wrote: > > On Fri, 7 Oct 2011, Rene Ladan wrote: > >> Op 07-10-2011 16:13, Ulrich Sp?rlein schreef: > >>> it looks like I'm not the only one thinking about moving the doc/www > >>> repos from CVS to SVN, and other people actually have not only thought > >>> about it but already played around with conversions. > >>> > >>> gavin did some preliminary conversions and it turns out that we end up > >>> with ~50k revisions and about 650MB of changes (IIRC). There are also > >>> lots of weird branches, so perhaps we could size that down a bit. > >>> > >>> What I, personally, would like to see is us using the same svn repo as > >>> src. That means we would have to stop svn.freebsd.org for the > >>> conversion, turn off email sending, dump 50k revisions into it (under > >>> /doc and /www perhaps? where should branches/tags end up?), then turn > >>> everything back on. > > > > The more I think about this, the less I like the idea. I really don't > > like the idea of having revision numbers which no longer increase with > > commit date (i.e. having revisions 1-250,000 correspond to the existing > > src tree, 250,000-300,000 being the imported doc tree, and then the > > combined repo being 300,001 onwards). > > I'm sorry, I don't understand your concern here. The commit ids > increment monotonically in svn, and the number is global to the whole > repo. Given that the individual files won't be increasing to a > deterministic value, I don't understand why we care what the actual > number is. > [...] Till now, in this thread, no one really thought about translators. Having many version of the same doc will kill translators effort cause they could not follow. It's already difficult to follow the current doc tree, so I imagine what will happen when there will be a -CURRENT, -STABLE, -WHATEVER branch to follow... The other concern is about the numbers mentioned above, if you use to translate docs, the current CVS numbering scheme is really interesting to follow revision of one file, with SVN we'll loose that. This said I'm not against a VCS change but it should be done in a wise way and not to add things that we could not support cause of lack of manpower or interest. And before doing the change, some things should be done: complete separation between release docs and doc/, a possible move from SGML to XML, a trim or update of outdated things, a move from teTeX to a more modern LaTeX (if XML tools allow it), etc. Well, a lot of work... -- Marc