From owner-p4-projects@FreeBSD.ORG  Tue Mar 10 21:42:52 2009
Return-Path: <owner-p4-projects@FreeBSD.ORG>
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id CA0071065678; Tue, 10 Mar 2009 21:42:51 +0000 (UTC)
Delivered-To: perforce@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 779641065672
	for <perforce@FreeBSD.org>; Tue, 10 Mar 2009 21:42:51 +0000 (UTC)
	(envelope-from rene@FreeBSD.org)
Received: from repoman.freebsd.org (repoman.freebsd.org
	[IPv6:2001:4f8:fff6::29])
	by mx1.freebsd.org (Postfix) with ESMTP id 207978FC14
	for <perforce@FreeBSD.org>; Tue, 10 Mar 2009 21:42:51 +0000 (UTC)
	(envelope-from rene@FreeBSD.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id n2ALgplh008455
	for <perforce@FreeBSD.org>; Tue, 10 Mar 2009 21:42:51 GMT
	(envelope-from rene@FreeBSD.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n2ALgoQT008453
	for perforce@freebsd.org; Tue, 10 Mar 2009 21:42:50 GMT
	(envelope-from rene@FreeBSD.org)
Date: Tue, 10 Mar 2009 21:42:50 GMT
Message-Id: <200903102142.n2ALgoQT008453@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	rene@FreeBSD.org using -f
From: Rene Ladan <rene@FreeBSD.org>
To: Perforce Change Reviews <perforce@FreeBSD.org>
Cc: 
Subject: PERFORCE change 159028 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Mar 2009 21:42:54 -0000

http://perforce.freebsd.org/chv.cgi?CH=159028

Change 159028 by rene@rene_self on 2009/03/10 21:42:31

	Add a WIP text about the change of the src repository from CVS to SVN.
	Section 3 and 16 need to be updated.

Affected files ...

.. //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#16 edit

Differences ...

==== //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#16 (text+ko) ====

@@ -121,10 +121,15 @@
 	      <literal>RELENG_7</literal> (7.X-STABLE), 
 	      <literal>HEAD</literal> (-CURRENT)
 	    </entry>
+	  </row>
 
-	    <entry>These tags correspond to the SVN tags
-	      <literal>stable/6</literal>, <literal>stable/7</literal>,
-	      and <literal>head</literal> respectively.
+	  <row>
+	    <entry><emphasis>Noteworthy SVN Tags</emphasis></entry>
+
+	    <entry>
+	      <literal>stable/6</literal> (6.X-STABLE),
+	      <literal>stable/7</literal> (7.X-STABLE),
+	      <literal>head</literal> (-CURRENT)
 	    </entry>
 	  </row>
 	</tbody>
@@ -438,49 +443,20 @@
 
 	<para>Practical FreeBSD examples:</para>
 
-<!-- TODO convert to SVN, add examples for doc and/or ports
 	<itemizedlist>
 	  <listitem>
-	    <para>Check out the <filename>miscfs</filename> module,
-	      which corresponds to <filename>src/sys/miscfs</filename>:</para>
+	    <para>Check out the <filename>Mk</filename> module,
+	      which corresponds to <filename>ports/Mk</filename>:</para>
 
-	    <screen>&prompt.user; <userinput>cvs co miscfs</userinput></screen>
+	    <screen>&prompt.user; <userinput>pcvs co ports/Mk</userinput></screen>
 
-	    <para>You now have a directory named <filename>miscfs</filename>
-	      with subdirectories <filename>CVS</filename>,
-	      <filename>deadfs</filename>, <filename>devfs</filename>, and so
-	      on.  One of these (<filename>linprocfs</filename>) is
-	      empty.</para>
+	    <para>You now have a directory named <filename>ports/Mk</filename>
+	      with subdirectory <filename>CVS</filename>.</para>
 	  </listitem>
 
-	  <listitem>
-	    <para>Check out the same files, but with full path:</para>
-
-	    <screen>&prompt.user; <userinput>cvs co src/sys/miscfs</userinput></screen>
 
-	    <para>You now have a directory named <filename>src</filename>,
-	      with subdirectories <filename>CVS</filename> and
-	      <filename>sys</filename>.  The <filename>src/sys</filename> directory has
-	      subdirectories <filename>CVS</filename> and
-	      <filename>miscfs</filename>, etc.</para>
-	  </listitem>
-
 	  <listitem>
-	    <para>Check out the same files, but prunes empty
-	      directories:</para>
-
-	    <screen>&prompt.user; <userinput>cvs co -P miscfs</userinput></screen>
-
-	    <para>You now have a directory named
-	      <filename>miscfs</filename> with subdirectories
-	      <filename>CVS</filename>, <filename>deadfs</filename>,
-	      <filename>devfs</filename>... but note that there is no
-	      <filename>linprocfs</filename> subdirectory, because there
-	      are no files in it.</para>
-	  </listitem>
-
-	  <listitem>
-	    <para>Check out the directory <filename>miscfs</filename>, but
+	    <para>Check out the directory <filename>modules</filename>, but
 	      none of the subdirectories:</para>
 
 	    <screen>&prompt.user; <userinput>cvs co -l miscfs</userinput></screen>
@@ -528,7 +504,7 @@
 	    <para>You will not be able to commit modifications.</para>
 	  </listitem>
 	</itemizedlist>
--->
+
 	<para>Note that cvs stores metadata in subdirectories named
 	  <filename>CVS</filename>.</para>
 
@@ -906,8 +882,28 @@
 	  </tgroup>
 	</table>
 
+	<para>The following are some Subversion examples related to the
+	  src repository.  More (in-depth) information can be found at
+	  <ulink
+	    url="http://wiki.freebsd.org/SubversionPrimer">Subversion
+	    Primer</ulink> and <ulink
+	    url="http://wiki.freebsd.org/SubversionMissing">List of
+	    things missing in Subversion when compared to CVS</ulink>.
+	  The notes at <ulink
+	     url="http://people.freebsd.org/~peter/svn_notes.txt"></ulink>
+	  might also be useful.</para>
+
+	<itemizedlist>
+	  <listitem>
+	    <para>Check out the <literal>head</literal> branch:</para>
+
+	    <screen>&prompt.user; <userinput>svn co svn+ssh://svn.freebsd.org/base/head /usr/src</userinput></screen>
+	  </listitem>
+	</itemizedlist>
+
 	<para>Use the <option>-f</option> option if you realize that
-	  you left out important information from the commit message.</para>
+	  you left out important information from the commit message.
+	  This seems only possible with CVS.</para>
 
 	<para>Good commit messages are important. They tell others
 	  why you did the changes you did, not just right here and now,