From owner-svn-doc-head@FreeBSD.ORG Wed May 30 04:47:58 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A347F106566C; Wed, 30 May 2012 04:47:58 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-4.mit.edu (DMZ-MAILSEC-SCANNER-4.MIT.EDU [18.9.25.15]) by mx1.freebsd.org (Postfix) with ESMTP id 05B508FC16; Wed, 30 May 2012 04:47:57 +0000 (UTC) X-AuditID: 1209190f-b7f306d0000008b4-b2-4fc5a67cfb44 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-4.mit.edu (Symantec Messaging Gateway) with SMTP id 38.81.02228.C76A5CF4; Wed, 30 May 2012 00:47:56 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id q4U4luRX001946; Wed, 30 May 2012 00:47:56 -0400 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q4U4lt5K004055 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 30 May 2012 00:47:56 -0400 (EDT) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id q4U4ls2D010246; Wed, 30 May 2012 00:47:54 -0400 (EDT) Date: Wed, 30 May 2012 00:47:54 -0400 (EDT) From: Benjamin Kaduk To: Glen Barber In-Reply-To: <201205251644.q4PGihZt021547@svn.freebsd.org> Message-ID: References: <201205251644.q4PGihZt021547@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrIIsWRmVeSWpSXmKPExsUixCmqrVuz7Ki/wZTjlhY/Ph5istjffIDN 4sai/UwWu/t7mR1YPGZ8ms8SwBjFZZOSmpNZllqkb5fAlXF6WwdjwSrRislrp7M2MJ4U7GLk 5JAQMJF48PAkG4QtJnHh3nogm4tDSGAfo8Sjx7/ZIZwNjBJnd/+Hcg4wSZz8upMFwmlglPh8 ci5jFyMHB4uAtsTEb3Ugo9gEVCRmvtkINlZEQFFi2dpn7CA2s0CUxJ6ljawgtrBAmMTc3mOs IK2cAlYSH/9bgIR5BRwl7n/8wgJiCwlYSsx9uJ8RxBYV0JFYvX8KC0SNoMTJmU9YIEZaSpz7 c51tAqPgLCSpWUhSCxiZVjHKpuRW6eYmZuYUpybrFicn5uWlFuma6OVmluilppRuYgSHrCT/ DsZvB5UOMQpwMCrx8EroHvUXYk0sK67MPcQoycGkJMr7aj5QiC8pP6UyI7E4I76oNCe1+BCj BAezkgivvwlQjjclsbIqtSgfJiXNwaIkzrtac7e/kEB6YklqdmpqQWoRTFaGg0NJgvfsUqBG waLU9NSKtMycEoQ0EwcnyHAeoOEHQGp4iwsSc4sz0yHypxgVpcR5F4MkBEASGaV5cL2wlPKK URzoFWHe4yBVPMB0BNf9CmgwE9DgaTcPggwuSURISTUwGml4teRE3s/U7r3vq3c296u47h7d dxezdzK7NGwM5wjdZn3/VPOSLeFrc7L/3fwo/cfZ8t+vrW/WXyzpclzodaZC4+yu+XOT1BP5 OirSvSRuNHZ/mtpmsUKb76/B8brjM43z1e+7M2yoXGuV0irg0O2tNiOg/m73w8Tb6p1/e0IX HS7w3F2jxFKckWioxVxUnAgAbXImuQQDAAA= Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r38887 - head/en_US.ISO8859-1/books/fdp-primer/translations X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 30 May 2012 04:47:58 -0000 On Fri, 25 May 2012, Glen Barber wrote: > Modified: head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml Fri May 25 14:40:55 2012 (r38886) > +++ head/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml Fri May 25 16:44:43 2012 (r38887) > @@ -133,21 +133,28 @@ > > > It is strongly recommended that you maintain a local > - copy of the FreeBSD CVS repository (at least the > - documentation part) either using > - CTM or > - CVSup. The "Staying current with > - FreeBSD" chapter in the Handbook explains how to use these > - applications. > + copy of the FreeBSD Subversion repository (at least the > + documentation part). This can be done by running: > + > + &prompt.user; svn checkout svn://svn.FreeBSD.org/doc/head/ head > + > + > + This will require the + role="package">devel/subversion package to > + be installed. > + > > You should be comfortable using > - CVS. This will allow you to see > + svn. This will allow you to see > what has changed between different versions of the files > that make up the documentation. > > - [XXX To Do -- write a tutorial that shows how to use > - CVSup to get just the documentation, check it out, and see > - what has changed between two arbitrary revisions] > + For example, to view the differences between revisions > + r33733 and r33734 of > + en_US.ISO8859-1/books/fdp-primer/book.sgml, > + run: > + > + &prompt.user; svn diff -r33733:33734 en_US.ISO8859-1/books/fdp-primer/book.sgml > > > This particular example might be done more quickly using 'svn diff cv33734', but I do not think the documentation should use that form of the command, since it is less general. I think I would prefer if the example had non-contiguous version numbers, which might also be a good place to mention that this will happen frequently due to the global nature of Subversion's versioning. I might remember to turn these comments into a patch when I dig out from under my bloated INBOX... -Ben