PERFORCE change 159028 for review

[Rene Ladan]

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

Change 159028 by rene at 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,