Date: Tue, 10 Mar 2009 21:42:50 GMT From: Rene Ladan <rene@FreeBSD.org> To: Perforce Change Reviews <perforce@FreeBSD.org> Subject: PERFORCE change 159028 for review Message-ID: <200903102142.n2ALgoQT008453@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
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,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200903102142.n2ALgoQT008453>