Date: Sun, 30 Jun 2013 21:24:06 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42096 - head/en_US.ISO8859-1/articles/committers-guide Message-ID: <201306302124.r5ULO6PK038700@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Sun Jun 30 21:24:06 2013 New Revision: 42096 URL: http://svnweb.freebsd.org/changeset/doc/42096 Log: Add and unify IDs in SVN Primer. Add note about $FreeBSD$ string for adding new files. Rewrite confusing svn rm explanation. Add explanation to svn cp. Reviewed by: remko, jilles (both only for $FreeBSD$ note) Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Jun 30 15:08:46 2013 (r42095) +++ head/en_US.ISO8859-1/articles/committers-guide/article.xml Sun Jun 30 21:24:06 2013 (r42096) @@ -85,7 +85,7 @@ Root</emphasis></entry> <entry><literal>svn+ssh://</literal><hostid role="fqdn">svn.FreeBSD.org</hostid><filename>/base</filename> - (see also <xref linkend="subversion-primer"/>).</entry> + (see also <xref linkend="svn-getting-started-base-layout"/>).</entry> </row> <row> @@ -93,7 +93,7 @@ Root</emphasis></entry> <entry><literal>svn+ssh://</literal><hostid role="fqdn">svn.FreeBSD.org</hostid><filename>/doc</filename> - (see also <xref linkend="subversion-primer"/>).</entry> + (see also <xref linkend="svn-getting-started-doc-layout"/>).</entry> </row> <row> @@ -101,7 +101,7 @@ Root</emphasis></entry> <entry><literal>svn+ssh://</literal><hostid role="fqdn">svn.FreeBSD.org</hostid><filename>/ports</filename> - (see also <xref linkend="subversion-primer"/>).</entry> + (see also <xref linkend="svn-getting-started-ports-layout"/>).</entry> </row> <row> @@ -389,7 +389,7 @@ <para>There are a few ways to obtain a working copy of the tree from Subversion. This section will explain them.</para> - <sect3> + <sect3 id="svn-getting-started-direct-checkout"> <title>Direct Checkout</title> <para>The first is to check out directly from the main @@ -456,7 +456,7 @@ </note> </sect3> - <sect3> + <sect3 id="svn-getting-started-checkout-from-a-mirror"> <title>Checkout from a Mirror</title> <para>Check out a working copy from a mirror by @@ -482,7 +482,7 @@ information on how to set one up.</para> </sect3> - <sect3 id="subversion-primer-base-layout"> + <sect3 id="svn-getting-started-base-layout"> <title><literal>RELENG_*</literal> Branches and General Layout</title> @@ -542,7 +542,7 @@ </itemizedlist> </sect3> - <sect3> + <sect3 id="svn-getting-started-doc-layout"> <title>&os; Documentation Project Branches and Layout</title> @@ -583,7 +583,7 @@ </itemizedlist> </sect3> - <sect3> + <sect3 id="svn-getting-started-ports-layout"> <title>&os; Ports Tree Branches and Layout</title> <para>In <literal>svn+ssh://svn.freebsd.org/ports</literal>, @@ -626,7 +626,7 @@ <para>This section will explain how to perform common day-to-day operations with Subversion.</para> - <sect3> + <sect3 id="svn-daily-use-help"> <title>Help</title> <para><acronym>SVN</acronym> @@ -640,7 +640,7 @@ Book</ulink>.</para> </sect3> - <sect3> + <sect3 id="svn-daily-use-checkout"> <title>Checkout</title> <para>As seen earlier, to check out the &os; head @@ -703,7 +703,7 @@ </note> </sect3> - <sect3> + <sect3 id="svn-daily-use-anonymous-checkout"> <title>Anonymous Checkout</title> <para>It is possible to anonymously check out the &os; @@ -719,7 +719,7 @@ mirror sites</ulink>.</para> </sect3> - <sect3> + <sect3 id="svn-daily-use-updating-the-tree"> <title>Updating the Tree</title> <para>To update a working copy to either the latest revision, @@ -729,7 +729,7 @@ &prompt.user; <userinput>svn update -<replaceable>r12345</replaceable></userinput></screen> </sect3> - <sect3> + <sect3 id="svn-daily-use-status"> <title>Status</title> <para>To view the local changes that have been made to the @@ -743,7 +743,7 @@ <screen>&prompt.user; <userinput>svn status --show-updates</userinput></screen> </sect3> - <sect3> + <sect3 id="svn-daily-use-editing-and-committing"> <title>Editing and Committing</title> <para>Unlike Perforce, @@ -772,7 +772,7 @@ </userinput></screen> </sect3> - <sect3 id="subversion-primer-add-remove"> + <sect3 id="svn-daily-use-adding-and-removing"> <title>Adding and Removing Files</title> <note> @@ -798,13 +798,24 @@ <screen>&prompt.user; <userinput>svn add <replaceable>foo</replaceable></userinput></screen> + <note> + <para>Most new source files should include a + <literal>$FreeBSD$</literal> string in the + new file. On commit, <command>svn</command> will expand + the <literal>$FreeBSD$</literal> string, + adding the file path, revision number, date and time of + commit, and the username of the committer. Files which + cannot be modified may be committed without the + <literal>$FreeBSD$</literal> string.</para> + </note> + <para>Files can be removed with <command>svn remove</command>:</para> <screen>&prompt.user; <userinput>svn remove <replaceable>foo</replaceable></userinput></screen> - <para>Subversion does not require <command>rm</command>ing the - file before <command>svn rm</command>ing it, and indeed + <para>Subversion does not require deleting the + file before using <command>svn rm</command>, and indeed complains if that happens.</para> <para>It is possible to add directories with <command>svn @@ -829,15 +840,20 @@ <screen>&prompt.user; <userinput>svn rm <replaceable>bar</replaceable></userinput></screen> </sect3> - <sect3> + <sect3 id="svn-daily-use-copying-and-moving"> <title>Copying and Moving Files</title> - <para>The following (obviously) creates a copy of + <para>The command creates a copy of <filename>foo.c</filename>, named - <filename>bar.c</filename>:</para> + <filename>bar.c</filename>, with the new file also under version control:</para> <screen>&prompt.user; <userinput>svn copy <replaceable>foo.c</replaceable> <replaceable>bar.c</replaceable></userinput></screen> + <para><command>svn cp</command> is equivalent to:</para> + + <screen>&prompt.user; <userinput>cp foo.c bar.c</userinput> +&prompt.user; <userinput>svn add bar.c</userinput></screen> + <para>To move and rename a file:</para> <screen>&prompt.user; <userinput>svn move <replaceable>foo.c</replaceable> <replaceable>bar.c</replaceable></userinput></screen> @@ -848,7 +864,7 @@ &prompt.user; <userinput>svn remove <replaceable>foo.c</replaceable></userinput></screen> </sect3> - <sect3> + <sect3 id="svn-daily-use-log-and-annotate"> <title>Log and Annotate</title> <para><command>svn log</command> will show all the @@ -865,7 +881,7 @@ but output format.</para> </sect3> - <sect3> + <sect3 id="svn-daily-use-diffs"> <title>Diffs</title> <para><command>svn diff</command> displays changes to the @@ -888,7 +904,7 @@ <screen>&prompt.user; <userinput>svn diff -c179454 .</userinput></screen> </sect3> - <sect3> + <sect3 id="svn-daily-use-reverting"> <title>Reverting</title> <para>Local changes (including additions and deletions) can be @@ -898,7 +914,7 @@ the original version.</para> </sect3> - <sect3> + <sect3 id="svn-daily-use-conflicts"> <title>Conflicts</title> <para>If a <command>svn update</command> resulted in a merge @@ -950,7 +966,7 @@ <sect2> <title>Advanced Use</title> - <sect3> + <sect3 id="svn-advanced-use-sparse-checkouts"> <title>Sparse Checkouts</title> <para>The equivalent to <command>cvs checkout -l</command>, @@ -1019,7 +1035,7 @@ <screen>&prompt.user; <userinput>svn update --set-depth=infinity <replaceable>head</replaceable></userinput></screen> </sect3> - <sect3> + <sect3 id="svn-advanced-use-direct-operation"> <title>Direct Operation</title> <para>Certain operations can be performed directly on the @@ -1069,7 +1085,7 @@ &prompt.user; <userinput>svn commit stable/8</userinput></screen> </sect3> - <sect3 id="subversion-primer-merge"> + <sect3 id="svn-advanced-use-merging"> <title>Merging with <acronym>SVN</acronym></title> <para>This section deals with merging code from one branch to @@ -1385,12 +1401,12 @@ $target - head/$source:$P,$Q,$R</screen> in r238987 is to be merged from CURRENT to 9-STABLE. The file resides in <filename class="directory">head/share/man/man4</filename> and - according to <xref linkend="subversion-primer-merge"/> + according to <xref linkend="svn-advanced-use-merging"/> this is also where to do the merge. Note that in this example all paths are relative to the top of the svn repository. For more information on the directory layout, see - <xref linkend="subversion-primer-base-layout"/>.</para> + <xref linkend="svn-getting-started-base-layout"/>.</para> <para>The first step is to inspect the existing mergeinfo.</para> @@ -1467,7 +1483,7 @@ U stable/9/share/man/man4/netmap.4 </sect4> </sect3> - <sect3> + <sect3 id="svn-advanced-use-vendor-imports"> <title>Vendor Imports with <acronym>SVN</acronym></title> <important> @@ -1781,7 +1797,7 @@ U stable/9/share/man/man4/netmap.4 </sect4> </sect3> - <sect3> + <sect3 id="svn-advanced-use-reverting-a-commit"> <title>Reverting a Commit</title> <para>Reverting a commit to a previous version is fairly @@ -1824,7 +1840,7 @@ U stable/9/share/man/man4/netmap.4 cause history to be lost.</para> </sect3> - <sect3> + <sect3 id="svn-advanced-use-fixing-mistakes"> <title>Fixing Mistakes</title> <para>While we can do surgery in an emergency, do not plan on @@ -1850,7 +1866,7 @@ U stable/9/share/man/man4/netmap.4 This is a waste.</para> </sect3> - <sect3> + <sect3 id="svn-advanced-use-setting-up-svnsync"> <title>Setting up a <application>svnsync</application> Mirror</title> @@ -1895,7 +1911,7 @@ U stable/9/share/man/man4/netmap.4 <para>Use <literal>propset</literal> to change things.</para> </sect3> - <sect3> + <sect3 id="svn-advanced-use-committing-high-ascii-data"> <title>Committing High-<acronym>ASCII</acronym> Data</title> <para>Files that have high-<acronym>ASCII</acronym> bits are @@ -1913,7 +1929,7 @@ U stable/9/share/man/man4/netmap.4 <screen>&prompt.user; <userinput>svn propset fbsd:notbinary yes foo.data</userinput></screen> </sect3> - <sect3> + <sect3 id="svn-advanced-use-maintaining-a-project-branch"> <title>Maintaining a Project Branch</title> <para>A project branch is one that is synced to head (or @@ -2034,7 +2050,7 @@ ControlPersist yes</screen> <command>svn:keywords</command> property will be rejected when attempting to commit them to the repository. Be sure to read - <xref linkend="subversion-primer-add-remove"/> regarding + <xref linkend="svn-daily-use-adding-and-removing"/> regarding adding and removing files, in addition to verifying that <filename>~/.subversion/config</filename> contains the necessary "auto-props" entries from
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201306302124.r5ULO6PK038700>